CCS C Compiler Manual PCB / PCM / PCH

Functional Overview
Program Eeprom
The Flash program memory is readable and writable in some chips and is just readable in
some. These options lets the user read and write to the Flash program memory. These
functions are only available in flash chips.
Relevant Functions:
read_program_eeprom(address)
write_program_eeprom(address, value)
erase_program_eeprom(address)
Reads the program memory location (16 bit or 32 bit depending
the device).
Writes value to program memory location address.
Erases FLASH_ERASE_SIZE bytes in program memory.
write_program_memory(address,dataptr,count) Writes count bytes to program memory from dataptr to address.
When address is a mutiple of FLASH_ERASE_SIZE an erase is
performed.
read_program_memory(address,dataptr,count) Read count bytes from program memory at address to dataptr.
Relevant Preprocessor:
#ROM address={list}
#DEVICE(WRITE_EEPROM=ASYNC)
Can be used to put program memory data into the hex file.
Can be used with #DEVICE to prevent the write function from
hanging. When this is used make sure the eeprom is not written
inside and outside the ISR.
Relevant Interrupts:
INT_EEPROM
Interrupt fires when eeprom write is complete.
Relevant Include Files:
None, all functions built-in
Relevant getenv() parameters
PROGRAM_MEMORY
READ_PROGRAM
FLASH_WRITE_SIZE
FLASH_ERASE_SIZE
Size of program memory
Returns 1 if program memory can be read
Smallest number of bytes written in flash
Smallest number of bytes erased in flash
Example Code:
For 18F452 where the write size is 8 bytes and erase size is 64 bytes
#rom 0xa00={1,2,3,4,5}
//inserts this data into the hex file.
erase_program_eeprom(0x1000);
//erases 64 bytes strting at 0x1000
write_program_eeprom(0x1000,0x1234); //writes 0x1234 to 0x1000
61