This section deals with the GCBASIC Preferences Editor (Pref Editor). The Prefs Editor is the software enables the user to select programmers, select the options when compiling, select the assembler and other settings. The Prefs Editor uses an ini to read and store the compiler settings. The INI structure is explained the first section, then, the Prefs Editor in detail.
ABOUT THE INI FILES
You can provide the compiler an INI file with a number of settings and programmers.
The following section provide details of the specifics within an example INI file. The comments are NOT part of an INI file.
The settings are in the INI section called [gcbasic].
[gcbasic]
programmer = arduinouno, pickitpluscmd1, lgt8f328p-1, xpress, pickit2cmdline, nsprog - the currently selected available programmers
showprogresscounters = n - show percent values as compiler runs. requires Verbose = y
verbose = y - show verbose compiler information
preserve = n - preservice source program in ASM
warningsaserrors = n - treat Warnings from scripts as errors. Errors will cause the compiler to cease on an Error(s)
pauseaftercompile = n - pause after compiler. Do not do this with IDEs
flashonly = n - Flash the chip is source older that hex file
assembler = GCASM - currently selected Assembler
hexappendgcbmessage = n - appends a message in the HEX file
laxsyntax = n - use lax syntax when Y, the compiler will not check that reserved words are being used
mutebanners = n - mutes the post compilation messages
evbs = n - show extra verbose compiler information, requires Verbose = y
nosummary = n - mutes almost all messages psot compilation
extendedverbosemessages = n - show even more verbose compiler information, requires Verbose = y
conditionaldebugfile = - creates CDF file
columnwidth = 180 - ASM width before wrapping
picasdebug = n - adds PIC-AS preprocessor message to .S file
datfileinspection = y - inspects DAT for memory validation
methodstructuredebug = n - show method structure start & end for validation
floatcapability = 1 - 1 = singles
- 2 = doubles
- 4 = longint
- 8 = uLongINT
compilerdebug = 0 - 1 = COMPILECALCADD
- 2 = VAR SET
- 4 = CALCOPS
- 8 = COMPILECALCMULT
- 16 = AUTOPINDIR
- 32 = ADRDX
- 64 = GCASM
- 128 = COMPILESUBCALLS
- 256 = COMPILEUPDATESUBMAPThe section shows an example [tool] assembler section.
[tool=pic-as]
'An assember
type = assembler
'Location of the assember using a parameter substitution.
command = %picaslocation%\pic-as.exe
'Parameters
params = -mcpu=%ChipModel% "%Fn_NoExt%.S" -msummary=-mem,+psect,-class,-hex,-file,-sha1,-sha256,-xml,-xmlfull -Wl -mcallgraph=std -mno-download-hex -o"%Fn_NoExt%.hex" -Wl,-Map="%Fn_NoExt%.map" -Wa,-a
[tool=mpasm]
'An assember
type = assembler
'Location of the assember using a parameter substitution.
command = %mpasmlocation%\mpasmx.exe
'Paramters
params = /c- /o- /q+ /l+ /x- /w1 "%FileName%"The section shows an example [patch] section.
This section shows and explicit set of patches applied to PIC-AS assembler.
[patch=asm2picas]
desc = PICAS correction entries. Format is STRICT as follows: Must have quotes and the equal sign as the delimeter. PartName +COLON+"BadConfig"="GoodConfig" Where BadConfig is from .s file and GoodConfig is from .cfgmap file
16f88x:"intoscio = "="FOSC=INTRC_NOCLKOUT"
16f8x:"intrc = IO"="FOSC=INTOSCIO"
12f67x:"intrc = OSC_NOCLKOUT"="FOSC=INTRCIO"The section shows an example [programmer] section.
[tool = pk4_pic_ipecmd_program_release_from_reset]
'Description
desc = MPLAB-IPE PK4 CLI for PIC 5v0
'A programmer
type = programmer
'Command line using a parameter substitution.
command = %mplabxipedirectory%\ipecmd.exe
'Parameters using a parameter substitution.
params = -TPPK4 -P%chipmodel% -F"%filename%" -M -E -OL -W5
'Worting direcroty using a parameter substitution.
workingdir = %mplabxipedirectory%
'Useif constraints - this shows none
useif =
'Mandated programming config constraints - this shows none
progconfig =