AVR-LibC
2.2.0
Standard C library for AVR-GCC
|
AVR-LibC Documentation |
AVR-LibC Development Pages |
||||
Main Page |
User Manual |
Library Reference |
FAQ |
Example Projects |
File List |
Macros | |
#define | BOOTLOADER_SECTION __attribute__ ((__section__(".bootloader"))) |
#define | boot_spm_interrupt_enable() (__SPM_REG |= (uint8_t)_BV(SPMIE)) |
#define | boot_spm_interrupt_disable() (__SPM_REG &= (uint8_t)~_BV(SPMIE)) |
#define | boot_is_spm_interrupt() (__SPM_REG & (uint8_t)_BV(SPMIE)) |
#define | boot_rww_busy() (__SPM_REG & (uint8_t)_BV(__COMMON_ASB)) |
#define | boot_spm_busy() (__SPM_REG & (uint8_t)_BV(__SPM_ENABLE)) |
#define | boot_spm_busy_wait() do{}while(boot_spm_busy()) |
#define | GET_LOW_FUSE_BITS (0x0000) |
#define | GET_LOCK_BITS (0x0001) |
#define | GET_EXTENDED_FUSE_BITS (0x0002) |
#define | GET_HIGH_FUSE_BITS (0x0003) |
#define | boot_lock_fuse_bits_get(address) |
#define | boot_signature_byte_get(addr) |
#define | boot_page_fill(address, data) __boot_page_fill_normal(address, data) |
#define | boot_page_erase(address) __boot_page_erase_normal(address) |
#define | boot_page_write(address) __boot_page_write_normal(address) |
#define | boot_rww_enable() __boot_rww_enable() |
#define | boot_lock_bits_set(lock_bits) __boot_lock_bits_set(lock_bits) |
#define | boot_page_fill_safe(address, data) |
#define | boot_page_erase_safe(address) |
#define | boot_page_write_safe(address) |
#define | boot_rww_enable_safe() |
#define | boot_lock_bits_set_safe(lock_bits) |
The macros in this module provide a C language interface to the bootloader support functionality of certain AVR processors. These macros are designed to work with all sizes of flash memory.
Global interrupts are not automatically disabled for these macros. It is left up to the programmer to do this. See the code example below. Also see the processor datasheet for caveats on having global interrupts enabled during writing of the Flash.
Check if the SPM interrupt is enabled.
#define boot_lock_bits_set | ( | lock_bits | ) | __boot_lock_bits_set(lock_bits) |
Set the bootloader lock bits.
lock_bits | A mask of which Boot Loader Lock Bits to set. |
For example, to disallow the SPM instruction from writing to the Boot Loader memory section of flash, you would use this macro as such:
#define boot_lock_bits_set_safe | ( | lock_bits | ) |
Same as boot_lock_bits_set() except waits for eeprom and spm operations to complete before setting the lock bits.
#define boot_lock_fuse_bits_get | ( | address | ) |
Read the lock or fuse bits at address
.
Parameter address
can be any of GET_LOW_FUSE_BITS, GET_LOCK_BITS, GET_EXTENDED_FUSE_BITS, or GET_HIGH_FUSE_BITS.
#define boot_page_erase | ( | address | ) | __boot_page_erase_normal(address) |
Erase the flash page that contains address.
#define boot_page_erase_safe | ( | address | ) |
Same as boot_page_erase() except it waits for eeprom and spm operations to complete before erasing the page.
#define boot_page_fill | ( | address, | |
data | |||
) | __boot_page_fill_normal(address, data) |
Fill the bootloader temporary page buffer for flash address with data word.
#define boot_page_fill_safe | ( | address, | |
data | |||
) |
Same as boot_page_fill() except it waits for eeprom and spm operations to complete before filling the page.
#define boot_page_write | ( | address | ) | __boot_page_write_normal(address) |
Write the bootloader temporary page buffer to flash page that contains address.
#define boot_page_write_safe | ( | address | ) |
Same as boot_page_write() except it waits for eeprom and spm operations to complete before writing the page.
Check if the RWW section is busy.
#define boot_rww_enable | ( | ) | __boot_rww_enable() |
Enable the Read-While-Write memory section.
#define boot_rww_enable_safe | ( | ) |
Same as boot_rww_enable() except waits for eeprom and spm operations to complete before enabling the RWW mameory.
#define boot_signature_byte_get | ( | addr | ) |
Read the Signature Row byte at address
. For some MCU types, this function can also retrieve the factory-stored oscillator calibration bytes.
Parameter address
can be 0-0x1f as documented by the datasheet.
Check if the SPM instruction is busy.
#define boot_spm_busy_wait | ( | ) | do{}while(boot_spm_busy()) |
Wait while the SPM instruction is busy.
Disable the SPM interrupt.
#define BOOTLOADER_SECTION __attribute__ ((__section__(".bootloader"))) |
Used to declare a function or variable to be placed into a new section called .bootloader. This section and its contents can then be relocated to any address (such as the bootloader NRWW area) at link-time.
#define GET_EXTENDED_FUSE_BITS (0x0002) |
address to read the extended fuse bits, using boot_lock_fuse_bits_get
#define GET_HIGH_FUSE_BITS (0x0003) |
address to read the high fuse bits, using boot_lock_fuse_bits_get
#define GET_LOCK_BITS (0x0001) |
address to read the lock bits, using boot_lock_fuse_bits_get
#define GET_LOW_FUSE_BITS (0x0000) |
address to read the low fuse bits, using boot_lock_fuse_bits_get