Advamation C Library

AM_ERROR am_logging(char const *log_domain, FILE **f, enum am_log_level level, char const *logfile, enum am_log_level logfile_level)

• log_domain: configure logging for this domain (see G_LOG_DOMAIN in GLib-documentation)
• f: output pointer for logfile (so different logfiles can be used)
• level: log-level for "print"
• logfile: filename of the logfile (NULL: no logfile)
• logfile_level: log-level for the logfile

static FILE *f_log = NULL;
am_logging(G_LOG_DOMAIN, &f_log, level, logfile, logfile_level);

uint8_t am_crc_smbus(uint8_t crc, uint8_t byte)

• crc: current CRC (or 0)
• byte: data-byte

new crc

const char* am_int2str_lookup(const struct am_int2str *map, int32_t key, bool or_enable)

• map: mapping, must end with {0, NULL} !
• key: integer to convert
• or_enable: If TRUE and no entry with the key is found, matching the key to a or'd combination of some entries is tried, and the remaining integer is appended.

the string/or-combinated string, or NULL

A returned "or-combinated" string is truncated to 255 bytes (with the last 2 characters being ".."), and will be overwritten by the next call!

simple example:

const struct am_int2str mapping[] = {
    {MY_VAL01, "MY_VAL1"},
    {MY_VAL02, "foo"},
    {MY_VAL04, "bar"},
    {0, NULL}
};
printf("\"%s\"\n", am_int2str_lookup(mapping, MY_VAL02, FALSE));
printf("\"%s\"\n", am_int2str_lookup(mapping, MY_VAL02|MY_VAL04, FALSE));
printf("\"%s\"\n", am_int2str_lookup(mapping, MY_VAL02|MY_VAL04, TRUE));
printf("\"%s\"\n", am_int2str_lookup(mapping, MY_VAL02|MY_VAL04|128, TRUE));

result:

"foo"
"(null)"
"foo|bar"
"foo|bar|128"

const char* am_int2str_group_lookup(const struct am_int2str_group *group, const char *name, int32_t key, bool or_enable)

• group: mapping-group, must end with {NULL, NULL} !
• name: name of the mapping to use
• key: key to translate

the string, or NULL if the group or key is not found

am_int2str

simple example:

const struct am_int2str_group mapping_group[] = {
    {"_FALLBACK_",  _M{ {-1, "ERROR"},
                        { 0, "OK"},
                        {0,NULL}} },
    {"MY_MAP1",     _M{ {100, "foo"},
                        {101, "bar"},
                        {0,NULL}} },
    {NULL,NULL}
};

char *str1 = am_int2str_group_lookup(mapping_group, "MY_MAP1", 101);
//-> "bar"
char *str2 = am_int2str_group_lookup(mapping_group, "MY_MAP1", -1);
//-> "ERROR"

int am_int2str_rlookup(struct am_int2str const *map, char const *str, int fallback)

• map: mapping, must end with {0, NULL} !
• str: string to convert
• fallback: value to return if the string is not found

the integer, or the default value

void am_print_uint_bin(uint32_t uint, int n_bits)

• uint: unsigned integer to print
• n_bits: number of bits to print