Registers

CPUDB_get_register_bit_name(reg,num) Stands for a register bit name, reg stands for a register name, num stands for a number of bit from zero to the highest bit; if the num refers to a bits group, function returns <BG><i> where <BG> is name of the bits group and <i> is index of a bit in the bits group (starting from zero); an error return an empty string (
Note: Any unused pins are stored under "Unused" within CPUDB).
CPUDB_get_register_bits_name(reg,num) Stands for register bit names, reg stands for a register name, num stands for a number of bit from zero to the highest bit; an error will return an empty string (
Note: Any unused pins are stored under "Unused" within CPUDB)
CPUDB_get_register_bits_size(reg,num) Stands for register bit width, reg stands for a register name, num stands for a number of bit from zero to the highest bit; an error will return an empty string.
CPUDB_get_register_bit_offset(reg,bitname) Bit position/positions within the register (from zero), reg stands for a register name, bitname stands for a bit or bit group name; an error will return an empty string.
CPUDB_get_register_bit_mask(reg,bitname) Returns a value of (1 << %CPUDB_get_register_bit_offset(reg,bitname)) expression; an error will return an empty string; should not be applied to bit groups.
CPUDB_get_register_bits_mask(reg,bitsgroupname) Returns a mask for a bit group (or even a single bit); an error will return an empty string.
CPUDB_get_register_bit_reset(reg,num) Bit value/values following resetting within the register (from zero) as per CPU-DB, except for 0 and 1 values, this may return the following codes: P (0 after supply, other reset will not change the value), Q (1 after supply, not changed by other reset), C (mode-dependant), ? (not defined), reg stands for a register name, num stands for a number from zero to the highest bit; if num ‚all' the function will return a value (binary number) for every bit within the register (the lowest bit on the right); an error will return an empty string.
CPUDB_get_register_bit_access(reg,num) Access to a bit or bits within the register (from zero), reg stands for a register name, num stands for a number from zero to the highest bit; if num ‚all' the function will return a value for every bit within the register (the lowest bit on the right); possible values: R (read-only), W (write-only), X (read-write), U (unused), M (mode dependant), F (register in flash, read-only), E (register in flash, no access), 1 (read/write once), V (write-once); an error will return an empty string.
CPUDB_get_register_bit_hint(reg,num) Stands for a register bit description, reg stands for a register name, num stands for a number of bit from zero to the highest bit; an error will return an empty string.
CPUDB_get_register_bits_hint(reg,num) Stands for register bit descriptions, reg stands for a register name, num stands for a number of bit from zero to the highest bit; an error will return an empty string.
CPUDB_get_register_width(reg) Returns register width - a decimal number; an error will return an empty string (if the register does not exist).
CPUDB_get_register_addr(reg) Returns register address - a decimal number; an error will return an empty string (if the register does not exist).
CPUDB_get_register_addr_offset(reg) Returns register address without register base; if register not found, returns empty string.
CPUDB_get_register_unused_bits_mask(reg) Returns mask (as a decimal number) of all reserved bit-fields in register passed as command parameter; reg stands for a register name; on error, will return an empty string (if the register does not exist)
CPUDB_is_register_in_FLASH(reg) Returns yes/no if the register is in FLASH; an error will return an empty string (if the register does not exist).
CPUDB_is_write_once_register(reg) Returns yes/no if the register contains at least a single write-once bit; an error will return an empty string (if the register does not exist).