This section deals with the GCBASIC Preferences Editor (Prefs Editor). The Prefs Editor is the software that enables the user to select programmers, select the options when compiling, select the assembler, and other settings. The Prefs Editor uses an INI file to read and store the compiler settings. The INI structure is explained in the first section, then the Prefs Editor in detail.
ABOUT THE INI FILES
You can provide the compiler with an INI file with a number of settings and programmers.
The following section provides 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 - preserve 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 post 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 below shows an example [tool] assembler section.
[tool=pic-as]
'An assembler
type = assembler
'Location of the assembler 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 assembler
type = assembler
'Location of the assembler using a parameter substitution.
command = %mpasmlocation%\mpasmx.exe
'Parameters
params = /c- /o- /q+ /l+ /x- /w1 "%FileName%"The section below shows an example [patch] section.
This section shows an explicit set of patches applied to the PIC-AS assembler.
[patch=asm2picas]
desc = PICAS correction entries. Format is STRICT as follows: Must have quotes and the equal sign as the delimiter. 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 below 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
'Working directory using a parameter substitution.
workingdir = %mplabxipedirectory%
'Useif constraints - this shows none
useif =
'Mandated programming config constraints - this shows none
progconfig =