|
pic.conf - The configuration file for PIC microcontroller definitions |
|
The pic.conf file is a configuration file for the Odyssey PIC programming tool. It contains sections, each defining the programming parameters for a particular PIC microcontroller device. The format of pic.conf is documented here for quick reference. |
|
The file consists of sections and variables. A section begins with the name of the section in square brackets and ends at the next section header. It is the same format used by odyssey.conf. In each section are a set of variable=value assignments. Each of these defines a specific parameter of the PIC. The following is a listing of all the currently defined variable names and their types. If a PIC doesn’t support some feature, the variables do not need to be defined for that feature. |
|
memtype (string) |
|
The type of memory in the PIC. This can have one of the values "eprom", "flash", or "flashe". "eprom" can be used for any eprom/OTP device. "flash" can be used for any type of electronically erasable device. "flashe" is similar to "flash" but in the programming cycle, the END_PROG command is required. |
|
wordsize (integer) |
|
The size of an instruction word in bits. |
|
codesize (integer) |
|
The number of words of program memory. |
|
eesize (integer) |
|
The number of bytes of data EEPROM. If the device doesn’t have a data EEPROM, this can be set to 0 or not specified at all. |
|
progcount (integer) |
|
The maximum number of times to attempt to program a memory location before reporting an error. Defined in the programming spec. |
|
progmult (integer) |
|
The multiplier for the number of times to overprogram. Defined in the programming spec. |
|
progtime (integer) |
|
The number of microseconds in each programming attempt for one memory location. To be on the safe side, the maximum value from the datasheet should be used for flash devices. |
|
erasetime (integer) |
|
The number of microseconds that a bulk erase takes. |
|
configmask (integer) |
|
A bitmask of all valid (non-reserved) configuration bits. |
|
configsave (integer) |
|
A bitmask of persistent bits in the configuration word. These bits will be saved before and restored after a chip erase. They will also not be modifiable when programming the device. |
|
cp_mask (integer) |
|
A bitmask of all the code protection bits. |
|
cp_all (integer) |
|
The value of the code protection bits when all program memory is code protected. |
|
cp_none (integer) |
|
The value of the code protection bits when no program memory is code protected. |
|
cpd_mask (integer) |
|
A bitmask of the bit(s) that enable data memory code protection. |
|
cpd_on (integer) |
|
The value of the cpd bit(s) when data code protection is enabled. |
|
cpd_off (integer) |
|
The value of the cpd bit(s) when data code protection is disabled. |
|
bkbug_mask (integer) |
|
A bitmask for the bit(s) which enable the on-chip background debugger. |
|
bkbug_on (integer) |
|
The value of the bkbug bits when the debugger is enabled. |
|
bkbug_off (integer) |
|
The value of the bkbug bits when the debugger is disabled. |
|
odyssey is distributed under the terms of the GNU General Public License version 2. |
|
Mark Aikens <marka@desert.cx> |
|
odyssey(1) |