面包芯语

手把手教你记录单片机系统日志信息（附源码）

strongerHuang 2024-08-27 21:17
TI MCU方案：能源基础设施实时控制 【免注册下载】创新MCU提升高压系统的实时性能

关注+星标公众号，不错过精彩内容

素材来源 | 网络


很多场景都需要记录日志，在单片机这种存储资源有限的环境下，就需要一种轻量级的存储方法。

系统日志
在嵌入式设备应用场景中，系统日志时常可以监控设备软件的运行状态，及时记录问题点以及关键信息，方便开发人员后期定位以及解决问题。

本文将讲述一种简易的系统日志记录方法，用于保存设备的系统日志，视具体嵌入式设备情况而定，可存储在MCU内部Flash、外部Flash、EEPROM等，本文采用外部Flash作为示例展开介绍。

思路分析
对于系统日志可以当成文件系统，可以划分为三个重要部分：目录区、参数区、日志区。
  • 目录区：根据日期进行归类，记录当天的日志的存储地址、日志索引、日志大小，通过目录可以获取整个日志文件的概况；
  • 参数区：存储记录日志写位置、目录项个数、写状态等参数；
  • 日志区：这是我们主要的存储区，记录系统的日志，支持环写。这三个区域都需要占用部分内存，可以自行分配大小。

实现的效果如下图所示，设置通过指令可查询到整个日志目录区的概况。
查询系统日志目录：AT+CATALOG?
LOG_ID:存储日志按日期分类，该ID用于查询对应日期日志,从1开始计数；
LOG_DATE:系统日志存储日期；
LOG_ADDR:系统日志存储外部FLASH地址；
LOG_OFFSET:系统日志存储偏移量（各日期日志大小，单位：字节）。


查询指定日期系统日志：AT+CATALOG=
LOG_ID:在查询系统日志目录时获取，当LOG_ID为0时，为查询整个系统日志。


另外提供移除系统日志（清除日志目录）指令：AT+RMLOG，后面将讲述具体实现。

FLASH内存划分
FLASH内存需要看具体设备进行合理划分，目录区、参数区与日志区实现环形存储，延长擦写寿命。
#define FLASH_SECTOR_SIZE      ((uint32_t)0x001000)#define FLASH_BLOCK_32K_SIZE    ((uint32_t)0x008000)#define FLASH_BLOCK_64K_SIZE    ((uint32_t)0x010000)#define SECTOR_MASK               (FLASH_SECTOR_SIZE - 1)         /*扇区掩码 ------*/#define SECTOR_BASE(addr)         (addr & (~SECTOR_MASK))        /*扇区的基地址 --*/#define SECTOR_OFFSET(addr)       (addr & SECTOR_MASK)           /*扇区内的偏移 --*/
#define BLOCK_32K_BASE(addr)    (addr & (~(FLASH_BLOCK_32K_SIZE)))#define BLOCK_64K_BASE(addr)    (addr & (~(FLASH_BLOCK_64K_SIZE)))
typedef enum {    FLASH_BLOCK_4K  = 0,          /**< flash erase block size 4k */    FLASH_BLOCK_32K = 1,          /**< flash erase block size 32k */    FLASH_BLOCK_64K = 2           /**< flash erase block size 64k */}flash_block_t;
/* flash 空间索引 */typedef enum{    FLASH_CATALOG_ZONE = 0,    FLASH_SYSLOG_PARA_ZONE,    FLASH_SYSLOG_ZONE,    FLASH_ZONEX,}flash_zone_e;
typedef struct{    flash_zone_e zone;    uint32_t start_address;    uint32_t end_address;}flash_table_t;
/* 地址划分 */static const flash_table_t flash_table[] = {  { .zone = FLASH_CATALOG_ZONE,       .start_address = 0x03200000, .end_address = 0x032FFFFF},    { .zone = FLASH_SYSLOG_PARA_ZONE,   .start_address = 0x03300000, .end_address = 0x033FFFFF},    { .zone = FLASH_SYSLOG_ZONE,        .start_address = 0x03400000, .end_address = 0x03FFFFFF},  };

Flash底层实现擦除、读写操作接口，由读者自行实现。
flash_table_t *get_flash_table(flash_zone_e zone){  int i = 0;  for (i = 0; i < flash_zone_count; i++) {    if (zone == flash_table[i].zone)       return (flash_table_t *)&flash_table[i];  }
  return NULL;  }
int flash_erase(flash_zone_e zone, uint32_t address, flash_block_t block_type){  flash_table_t *flash_table_tmp = get_flash_table(zone);
  if (flash_table_tmp == NULL)    return -1;
  if (address < flash_table_tmp->start_address ||address > flash_table_tmp->end_address)     return -1;
  return bsp_spi_flash_erase(address, block_type);}
int flash_write(flash_zone_e zone, uint32_t address, const uint8_t*data, uint32_t length){  flash_table_t *flash_table_tmp = get_flash_table(zone);
  if (flash_table_tmp == NULL)     return -1;
  if ((address < flash_table_tmp->start_address) ||((address + length) > flash_table_tmp->end_address))     return -1;
  return bsp_spi_flash_buffer_write(address, (uint8_t *)data, length);}
int flash_read(flash_zone_e zone, uint32_t address, uint8_t*buffer, uint32_t length){  flash_table_t *flash_table_tmp = get_flash_table(zone);
  if (flash_table_tmp == NULL)    return -1;
  if ((address < flash_table_tmp->start_address) ||((address + length) > flash_table_tmp->end_address))    return -1;
  bsp_spi_flash_buffer_read(buffer, address, length);  return 0;}

参数与结构体定义
日志数据存储时间戳，便于问题定位，需要实现RTC接口调用。
typedef struct {  uint16_t   Year;    /* 年份:YYYY */  uint8_t    Month;    /* 月份:MM */  uint8_t    Day;    /* 日:DD */  uint8_t     Hour;    /* 小时:HH */  uint8_t     Minute;    /* 分钟:MM */  uint8_t   Second;    /* 秒:SS */}time_t;   
int bsp_rtc_get_time(time_t *date);

参数区应当保证数据的正确性，应加入参数校验存储，定义校验结构体。
#define SYSTEM_LOG_MAGIC_PARAM    0x87654321  /* 日志参数标识符 */typedef struct {  uint32_t magic;    /* 参数标识符 */  uint16_t crc;    /* 校验值 */  uint16_t len;    /* 参数长度 */} single_sav_t;

参数区需记录当前日志记录的写位置，以及目录项个数，还有日志区和目录区环写状态，并且存储最新时间等等。
/* 日志区参数 */typedef struct {  uint32_t   write_pos;             /* 写位置 */  uint32_t   catalog_num;            /* 目录项个数 */  uint8_t    log_cyclic_status;    /* 系统日志环形写状态 */     uint8_t    catalog_cyclic_status; /* 日志目录环形写状态 */  time_t     log_latest_time;     /* 存储最新时间 */}system_log_t;
/* 目录区参数 */typedef struct {  uint32_t log_id;     /* 日志索引 */    uint32_t log_addr;    /* 日志地址 */  uint32_t log_offset;  /* 日志偏移大小，单位：字节 */  time_t   log_time;    /* 日志存储时间 */}system_catalog_t;
/* 系统日志参数 */typedef struct {  single_sav_t crc_val;  system_log_t system_log;  system_catalog_t system_catalog;}sys_log_param_t;
typedef struct {  uint8_t system_log_print_enable; /* 系统日志打印使能 */  uint16_t system_log_print_id;    /* 打印指定id系统日志 */  uint32_t system_log_param_addr;  /* 当前日志写地址 */} sys_ram_t;
sys_ram_t  SysRam;sys_log_param_t SysLogParam;
sys_ram_t  *gp_sys_ram = &SysRam;sys_log_param_t *gp_sys_log = &SysLogParam;

实现接口说明
CRC校验接口，可以自定义实现。
/* 16位CRC校验高位表 */static const uint8_t auchCRCHi[]={0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,
0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40,0x01,0xc0,0x80,0x41,0x01,0xc0,0x80,0x41,0x00,0xc1,0x81,0x40};
/* 16位CRC校验低位表 */static const uint8_t auchCRCLo[]={0x00,0xc0,0xc1,0x01,0xc3,0x03,0x02,0xc2,0xc6,0x06,0x07,0xc7,0x05,0xc5,0xc4,0x04,0xcc,0x0c,0x0d,0xcd,0x0f,0xcf,0xce,0x0e,0x0a,0xca,0xcb,0x0b,0xc9,0x09,0x08,0xc8,0xd8,0x18,0x19,0xd9,0x1b,0xdb,0xda,0x1a,0x1e,0xde,0xdf,0x1f,0xdd,0x1d,0x1c,0xdc,0x14,0xd4,0xd5,0x15,0xd7,0x17,0x16,0xd6,0xd2,0x12,0x13,0xd3,0x11,0xd1,0xd0,0x10,0xf0,0x30,0x31,0xf1,0x33,0xf3,0xf2,0x32,0x36,0xf6,0xf7,0x37,0xf5,0x35,0x34,0xf4,0x3c,0xfc,0xfd,0x3d,0xff,0x3f,0x3e,0xfe,0xfa,0x3a,0x3b,0xfb,0x39,0xf9,0xf8,0x38,0x28,0xe8,0xe9,0x29,0xeb,0x2b,0x2a,0xea,0xee,0x2e,0x2f,0xef,0x2d,0xed,0xec,0x2c,0xe4,0x24,0x25,0xe5,0x27,0xe7,0xe6,0x26,0x22,0xe2,0xe3,0x23,0xe1,0x21,0x20,0xe0,
0xa0,0x60,0x61,0xa1,0x63,0xa3,0xa2,0x62,0x66,0xa6,0xa7,0x67,0xa5,0x65,0x64,0xa4,0x6c,0xac,0xad,0x6d,0xaf,0x6f,0x6e,0xae,0xaa,0x6a,0x6b,0xab,0x69,0xa9,0xa8,0x68,0x78,0xb8,0xb9,0x79,0xbb,0x7b,0x7a,0xba,0xbe,0x7e,0x7f,0xbf,0x7d,0xbd,0xbc,0x7c,0xb4,0x74,0x75,0xb5,0x77,0xb7,0xb6,0x76,0x72,0xb2,0xb3,0x73,0xb1,0x71,0x70,0xb0,0x50,0x90,0x91,0x51,0x93,0x53,0x52,0x92,0x96,0x56,0x57,0x97,0x55,0x95,0x94,0x54,0x9c,0x5c,0x5d,0x9d,0x5f,0x9f,0x9e,0x5e,0x5a,0x9a,0x9b,0x5b,0x99,0x59,0x58,0x98,0x88,0x48,0x49,0x89,0x4b,0x8b,0x8a,0x4a,0x4e,0x8e,0x8f,0x4f,0x8d,0x4d,0x4c,0x8c,0x44,0x84,0x85,0x45,0x87,0x47,0x46,0x86,0x82,0x42,0x43,0x83,0x41,0x81,0x80,0x40};
/* 实现crc功能函数 */static uint16_t CRC16(uint8_t* puchMsg, uint16_t usDataLen){  uint8_t uchCRCHi=0xff;  uint8_t uchCRCLo=0xff;  uint16_t uIndex;
  while(usDataLen--) {    uIndex=uchCRCHi^*(puchMsg++);    uchCRCHi=uchCRCLo^auchCRCHi[uIndex];    uchCRCLo=auchCRCLo[uIndex];  }
  return uchCRCHi<<8|uchCRCLo;}

保存系统日志参数，每实现写日志操作后都需要保存当前的参数值，防止意外丢失。
void save_system_log_param(void){  uint32_t i = 0;  uint32_t addr = 0;  uint32_t remainbyte = 0;  uint32_t start_addr;  int len = sizeof(sys_log_param_t);  uint8_t *pdata = (uint8_t *)&SysLogParam;  flash_table_t *flash_tmp = get_flash_table(FLASH_SYSLOG_PARA_ZONE);
  /* 校验参数 */  gp_sys_log->crc_val.magic = SYSTEM_LOG_MAGIC_PARAM;  gp_sys_log->crc_val.len = sizeof(sys_log_param_t) - sizeof(single_sav_t);  gp_sys_log->crc_val.crc = CRC16(&pdata[sizeof(single_sav_t)], gp_sys_log->crc_val.len);
  start_addr = gp_sys_ram->system_log_param_addr;  /* 剩余内存不够写，则重新从起始地址开始写，实现环形存储功能  */  if ((start_addr + len) > flash_tmp->end_address) {     start_addr = flash_tmp->start_address;  }  gp_sys_ram->system_log_param_addr = start_addr + len;  /* 首地址存储，擦除整个系统日志参数存储区，如果划分的内存较大，可能出现第一次擦写等待时间较长，     但实际应用嵌入式设备应该不会占用太多的内存存储系统日志，只当为辅助使用，有额外应用可自行实现 */  if (flash_tmp->start_address == start_addr) {    /*for (i = flash_tmp->start_address; i < flash_tmp->end_address; i+= FLASH_SECTOR_SIZE)       flash_erase(FLASH_SYSLOG_PARA_ZONE, SECTOR_BASE(i), FLASH_BLOCK_4K);    */    addr = flash_tmp->start_address;    do {      if ((addr + FLASH_BLOCK_64K_SIZE) <= flash_tmp->end_address) {        flash_erase(FLASH_SYSLOG_PARA_ZONE, BLOCK_64K_BASE(i), FLASH_BLOCK_64K);        addr += FLASH_BLOCK_64K_SIZE;      } else if ((addr + FLASH_BLOCK_32K_SIZE) <= flash_tmp->end_address) {        flash_erase(FLASH_SYSLOG_PARA_ZONE, BLOCK_32K_BASE(i), FLASH_BLOCK_32K);        addr += FLASH_BLOCK_32K_SIZE;      } else if ((addr + FLASH_SECTOR_SIZE) <= flash_tmp->end_address) {        flash_erase(FLASH_SYSLOG_PARA_ZONE, SECTOR_BASE(i), FLASH_BLOCK_4K);        addr += FLASH_SECTOR_SIZE;      } else {        break;      }    } while (addr < flash_tmp->end_address);    }
  remainbyte = FLASH_SECTOR_SIZE - (start_addr % FLASH_SECTOR_SIZE);  if (remainbyte > len) {    remainbyte = len;  }  while (1) {    flash_write(FLASH_SYSLOG_PARA_ZONE, start_addr, pdata, remainbyte);    if (remainbyte == len) {      break;    } else {      pdata += remainbyte;      start_addr += remainbyte;      len -= remainbyte;      remainbyte = (len > FLASH_SECTOR_SIZE) ? FLASH_SECTOR_SIZE : len;    }  }}

导入系统日志默认参数接口，初始化默认参数或者移除日志。
void load_system_log_default_param(void){  /* 系统日志默认参数 */  /* 目录环写状态标志 */  gp_sys_log->system_log.catalog_cyclic_status = 0x00;  /* 目录项个数 */  gp_sys_log->system_log.catalog_num = 0;  /* 日志环写标志 , 1:环写状态 */  gp_sys_log->system_log.log_cyclic_status = 0;  /* 设置默认值，实际会重新从RTC获取最新时间 */  gp_sys_log->system_log.log_latest_time.Year = 2019;  gp_sys_log->system_log.log_latest_time.Month = 5;  gp_sys_log->system_log.log_latest_time.Day = 8;  gp_sys_log->system_log.log_latest_time.Hour = 13;  gp_sys_log->system_log.log_latest_time.Minute = 14;  gp_sys_log->system_log.log_latest_time.Second = 10;  /* 日志写位置从0开始 */  gp_sys_log->system_log.write_pos = 0;
  gp_sys_log->system_catalog.log_addr = 0;  gp_sys_log->system_catalog.log_id = 0;  gp_sys_log->system_catalog.log_offset = 0;  gp_sys_log->system_catalog.log_time.Year = 2019;  gp_sys_log->system_catalog.log_time.Month = 5;  gp_sys_log->system_catalog.log_time.Day = 8;  gp_sys_log->system_catalog.log_time.Hour = 12;  gp_sys_log->system_catalog.log_time.Minute = 12;  gp_sys_log->system_catalog.log_time.Second = 14;
  gp_sys_log->crc_val.magic = SYSTEM_LOG_MAGIC_PARAM;
  /* 导入默认参数后进行保存 */  save_system_log_param();}

设备开机或者复位都会进行导入系统日志参数操作，恢复日志读写参数，参数区为频繁读写操作区域，每一次写操作都会进行一次偏移，有效的导入参数方法是从参数区结束地址到起始地址进行扫描，扫描不到合法的参数则会导入默认日志参数。
/* 参数初始化，在终端启动时调用 */int load_system_log_param(void){  uint32_t i = 0;  single_sav_t psav;  uint32_t end_addr;  uint32_t interal = sizeof(sys_log_param_t);  int data_len = sizeof(sys_log_param_t) - sizeof(single_sav_t);  uint8_t *pram = (uint8_t *)&SysLogParam;  flash_table_t *flash_tmp = get_flash_table(FLASH_SYSLOG_PARA_ZONE);
  end_addr =flash_tmp->end_address - (flash_tmp->end_address - flash_tmp->start_address) % interal;  for (i = end_addr - interal; i > flash_tmp->start_address; i -= interal) {    flash_read(FLASH_SYSLOG_PARA_ZONE, i, (uint8_t *)&psav, sizeof(single_sav_t));    if ((psav.magic == SYSTEM_LOG_MAGIC_PARAM) && (psav.len ==data_len)) {            flash_read(FLASH_SYSLOG_PARA_ZONE, i + sizeof(single_sav_t), &pram[sizeof(single_sav_t)], data_len);      if (psav.crc != CRC16(&pram[sizeof(single_sav_t)], data_len))         continue;      gp_sys_ram->system_log_param_addr = i;      log_info("Load System Log Param Addr[0x%08x]!", gp_sys_ram->system_log_param_addr);      return 0;    }  }
  /* 扫描不到合法的参数，导入默认系统日志参数 */  load_system_log_default_param();  /* 获取日志写地址 */  gp_sys_ram->system_log_param_addr = flash_tmp->start_address;  log_info("Load System Log Param Addr(Default)[0x%08x]!", gp_sys_ram->system_log_param_addr);  return 1;}

读写系统日志目录接口，读写指定日志索引目录信息。实际实现会定义最新的目录信息存储在日志参数区，当日期发生改变，则表示当前目录信息已经完结，将最新的目录信息录入日志目录区保存，最多每天写入一次目录区。
/* 读取日志目录区指定日志索引目录信息 */int system_catalog_read(system_catalog_t *catalog, uint32_t id){  uint32_t addr;  int rlen = sizeof(system_catalog_t);  uint8_t *pbuf = (uint8_t *)catalog;  flash_table_t *flash_tmp = get_flash_table(FLASH_CATALOG_ZONE);
  if (0 == id)     return -1;  addr = flash_tmp->start_address + (rlen * (id - 1));  if (addr > flash_tmp->end_address)     return -1;
  return flash_read(FLASH_CATALOG_ZONE, addr, pbuf, rlen);}
/* 写日志目录区目录信息 */int system_catalog_write(system_catalog_t *catalog, uint32_t id){  uint32_t start_offset;  uint32_t start_addr;  uint32_t start_base;  uint32_t remainbyte;  int wlen = sizeof(system_catalog_t);  uint8_t *pdata = (uint8_t *)catalog;  flash_table_t *flash_tmp = get_flash_table(FLASH_CATALOG_ZONE);
  if (0 == id) return -1;  start_addr = flash_tmp->start_address + wlen * (id - 1);  if ((start_addr + wlen) > flash_tmp->end_address) {    start_addr = flash_tmp->start_address;  }
  /* 本扇区剩余空间大小 */  remainbyte = FLASH_SECTOR_SIZE - (start_addr % FLASH_SECTOR_SIZE);  /* 写入数据长度小于本扇区剩余长度，直接写入 */  if (remainbyte > wlen) {    remainbyte = wlen;  }  /* 写目录次数不会太频繁，视具体情况改写操作实现 */  while (1) {    start_base = SECTOR_BASE(start_addr);      start_offset = SECTOR_OFFSET(start_addr);    flash_read(FLASH_CATALOG_ZONE, start_base, sector_buf, FLASH_SECTOR_SIZE);    flash_erase(FLASH_CATALOG_ZONE, start_base, FLASH_BLOCK_4K);    memcpy((char *)§or_buf[start_offset], pdata, remainbyte);    flash_write(FLASH_CATALOG_ZONE, start_base, sector_buf, FLASH_SECTOR_SIZE);    if (remainbyte == wlen) {      break;    } else {      pdata += remainbyte;      start_addr += remainbyte;      wlen -= remainbyte;      remainbyte = (wlen > FLASH_SECTOR_SIZE) ? FLASH_SECTOR_SIZE : wlen;    }  }
  return 0;}

打印系统日志目录区信息，可实现通过指令查询到目录区信息。

int system_catalog_all_print(void){  int i = 0;  system_catalog_t catalog;
  printf("System Log Command Information:\r\n");  printf("Query Specifies Log : AT+CATALOG=\r\n");  printf("Query All Log : AT+CATALOG=<0>\r\n\r\n");  printf("Query All System Catalog:\r\n");  printf("LOG_ID    LOG_DATE    LOG_ADDR    LOG_OFFSET  \r\n");  for (i = 0; i < gp_sys_log->system_log.catalog_num; i++) {    /* 当前最新目录信息 */        if (i == (gp_sys_log->system_catalog.log_id - 1)) {      catalog = gp_sys_log->system_catalog; /* 获取当前最新目录信息 */    } else {      system_catalog_read(&catalog, i + 1);    }    printf("%d    %04d-%02d-%02d    0x%08X    %d  \r\n",       catalog.log_id, catalog.log_time.Year, catalog.log_time.Month, catalog.log_time.Day,       catalog.log_addr, catalog.log_offset);    memset((char *)&catalog, 0, sizeof(system_catalog_t));  }  return 0;}

读取指定日志目录索引信息接口，可指定日志索引或者读取全部日志数据。
int system_log_task(int argc){  int rlen = 0;  uint32_t offset, start_addr, end_addr;  system_catalog_t catalog;  flash_table_t *flash_tmp =get_flash_table(FLASH_SYSLOG_ZONE);
  if (0 == gp_sys_ram->system_log_print_enable)     return 1;
  gp_sys_ram->system_log_print_enable = 0x00;  if (gp_sys_ram->system_log_print_id == ALL_LOG_PRINT) {    /* log回环写标志,打印整个LOG存储区 */    if (0x01 == gp_sys_log->system_log.log_cyclic_status) {       start_addr = flash_tmp->start_address;      end_addr = flash_tmp->end_address;      offset = end_addr - start_addr;    } else {      start_addr = flash_tmp->start_address;      end_addr = start_addr + gp_sys_log->system_log.write_pos;      offset = gp_sys_log->system_log.write_pos;    }  } else { /* 读取指定ID日志 */    if (gp_sys_ram->system_log_print_id == gp_sys_log->system_catalog.log_id) {      catalog = gp_sys_log->system_catalog;    } else {      system_catalog_read(&catalog, gp_sys_ram->system_log_print_id);    }    start_addr = catalog.log_addr;    offset = catalog.log_offset;  }  
  if (0 == offset)    return 1;
  while (1) {    rlen = (offset > 512) ? 512 : offset;    system_log_read(sector_buf, start_addr, rlen);    HAL_Delay(80);    /* 目录信息通过调式串口打印 */    bsp_debug_send(sector_buf, rlen);    start_addr += rlen;    offset -= rlen;    if (0 == offset)       break;  }  return 0;}

存储系统日志接口，实现更新存储日期，当写位置为扇区地址，则擦除一个扇区作为存储日志，这样避免每写一次就擦除一次。
int system_log_write(uint8_t *wbuf, int wlen){  uint32_t start_addr;  uint8_t *pdata = wbuf;  uint32_t remainbyte;  int system_catalog_max_id;  flash_table_t *flash_tmp =get_flash_table(FLASH_SYSLOG_ZONE);
  /* 计算目录区的最大存储目录项个数 */  system_catalog_max_id = ((flash_tmp->end_address - flash_tmp->start_address) / sizeof(system_catalog_t));  start_addr = flash_tmp->start_address + gp_sys_log->system_log.write_pos;  /* 存储数据地址大于规划内存地址范围处理 */  if ((start_addr + wlen) > flash_tmp->end_address) {     start_addr = flash_tmp->start_address;    /* 写位置偏移量重置 */    gp_sys_log->system_log.write_pos = 0;    /* LOG回环存储标志置位 */    gp_sys_log->system_log.log_cyclic_status = 0x01;   }  /* 写位置偏移 */  gp_sys_log->system_log.write_pos += wlen; 
  if ((gp_sys_log->system_log.log_latest_time.Year != gp_sys_log->system_catalog.log_time.Year) ||    (gp_sys_log->system_log.log_latest_time.Month != gp_sys_log->system_catalog.log_time.Month) ||    (gp_sys_log->system_log.log_latest_time.Day != gp_sys_log->system_catalog.log_time.Day)) {
    /* 日期改变，记录目录信息，当log_id为0，则不写入 */    system_catalog_write(&gp_sys_log->system_catalog, gp_sys_log->system_catalog.log_id);    /* 记录存储日期 */    gp_sys_log->system_catalog.log_time = gp_sys_log->system_log.log_latest_time;
    if ((gp_sys_log->system_catalog.log_id + 1) >= system_catalog_max_id) {      gp_sys_log->system_log.catalog_num = system_catalog_max_id; /* 目录循环写，目录数应为最大 */      gp_sys_log->system_log.catalog_cyclic_status = 1; /* 目录回环写标志 */    } else {      if (0 == gp_sys_log->system_log.catalog_cyclic_status) {        /* 获取目录数 */        gp_sys_log->system_log.catalog_num = gp_sys_log->system_catalog.log_id + 1;       }    }
    /* 存储最新目录项信息 */    gp_sys_log->system_catalog.log_id = (gp_sys_log->system_catalog.log_id + 1) % system_catalog_max_id;    gp_sys_log->system_catalog.log_addr = start_addr;    gp_sys_log->system_catalog.log_offset = wlen;   } else {    gp_sys_log->system_catalog.log_offset += wlen;   }
  /* 写位置为存储起始地址并且不为扇区首地址 */  if ((flash_tmp->start_address == start_addr) && (SECTOR_OFFSET(flash_tmp->start_address))){    flash_read(FLASH_SYSLOG_ZONE, SECTOR_BASE(start_addr), sector_buf, FLASH_SECTOR_SIZE);    flash_erase(FLASH_SYSLOG_ZONE, SECTOR_BASE(start_addr), FLASH_BLOCK_4K);    /* 将扇区头部至起始地址区间的数据回写 */    flash_write(FLASH_SYSLOG_ZONE, SECTOR_BASE(start_addr), §or_buf[0], SECTOR_OFFSET(start_addr));   }  /* 写位置为扇区首地址，则擦除一个扇区的存储区    */  if (0 == SECTOR_OFFSET(start_addr)) {    flash_erase(FLASH_SYSLOG_ZONE, SECTOR_BASE(start_addr), FLASH_BLOCK_4K);  }
  /* 本扇区剩余空间大小 */  remainbyte = FLASH_SECTOR_SIZE - (start_addr % FLASH_SECTOR_SIZE);  /* 写入数据长度小于本扇区剩余长度，直接写入 */  if (remainbyte > wlen) {    remainbyte = wlen;  }  while (1) {    flash_write(FLASH_SYSLOG_ZONE, start_addr, pdata, remainbyte);    if (remainbyte == wlen) {      break;    } else {      pdata += remainbyte;      start_addr += remainbyte;      wlen -= remainbyte;      remainbyte = (wlen > FLASH_SECTOR_SIZE) ? FLASH_SECTOR_SIZE : wlen;      /* 扇区首地址则擦除整个扇区，该扇区数据不保存 */      if (0 == SECTOR_OFFSET(start_addr)) {        flash_erase(FLASH_SYSLOG_ZONE, SECTOR_BASE(start_addr), FLASH_BLOCK_4K);      }    }  }
  /* 环形存储参数 */  save_system_log_param();  return 0;}

系统调试对接
为了更好记录系统日志，将应用调试等级结合一块，实现记录错误调试信息以及需要保存的关键信息。定义的调试等级有：关闭调试等级、错误调试等级、警告调试等级、关键调试等级、debug调试等级，而LOG_RECORD_LEVEL将主动保存日志并输出信息，LOG_ERROR_LEVEL会存储对应的日志信息，但需要根据应用调试等级输出信息。设置与读取应用调试等级由读者自行定义。
#define LOG_CLOSE_LEVEL        0x00 /* 关闭调试信息 */#define LOG_ERROR_LEVEL        0x01 /* 错误调试信息 */#define LOG_WARN_LEVEL        0x02 /* 警告调试信息 */#define LOG_INFO_LEVEL        0x03 /* 关键调试信息 */#define LOG_DEBUG_LEVEL        0x04 /* debug调试信息 */#define LOG_RECORD_LEVEL      0x10 /* 保存日志并输出信息 */  #define LOG_PRINT_LEVEL        0xff
#define SET_LOG_LEVEL(LEVEL)    (gp_sys_param->system_print_level = LEVEL)#define GET_LOG_LEVEL()        (gp_sys_param->system_print_level)
#define log_debug(fmt, args...)    log_format(LOG_DEBUG_LEVEL, fmt, ##args)#define log_info(fmt, args...)    log_format(LOG_INFO_LEVEL, fmt, ##args)#define log_warn(fmt, args...)    log_format(LOG_WARN_LEVEL, fmt, ##args)#define log_error(fmt, args...)    log_format(LOG_ERROR_LEVEL, fmt, ##args)#define log_record(fmt, args...)  log_format(LOG_RECORD_LEVEL, fmt, ##args)#define printf(fmt, args...)    log_format(LOG_PRINT_LEVEL, fmt, ##args)
typedef struct {  int level;  char *fmt_str;}system_print_fmt_t;
system_print_fmt_t system_print_fmt_list[] = {  { .level = LOG_ERROR_LEVEL,   .fmt_str = ":"},  { .level = LOG_WARN_LEVEL,    .fmt_str = ":"},  { .level = LOG_INFO_LEVEL,    .fmt_str = ":"},  { .level = LOG_DEBUG_LEVEL,   .fmt_str = ":"},  { .level = LOG_RECORD_LEVEL,  .fmt_str = ":"},};
int log_format(uint8_t level, const char *fmt, ...){  #define TIME_PREFIX_SIZE  (21)  #define PRINT_MAX_SIZE    (1024 + TIME_PREFIX_SIZE)
    va_list args;    int num = 0, i = 0, fmt_index = 0;    int fmt_str_len = 0, ret = -1;    int file_str_len = 0, line_str_len = 0;    char line_buf[20] = {0};    static char buf[PRINT_MAX_SIZE];  static QueueHandle_t sem = NULL;  time_t time = {0};
  /* 针对os系统 */  if (NULL == sem) {        sem = xSemaphoreCreateCounting(1, 1); /* always think of success */  }
  xSemaphoreTake(sem, portMAX_DELAY);
  ret = -1;  fmt_str_len = 0;  if (level != LOG_PRINT_LEVEL) {    if ((GET_LOG_LEVEL() < level) && (level != LOG_RECORD_LEVEL) && (level != LOG_ERROR_LEVEL))      goto exit_end;
    for (i = 0; i < SYSTEM_PRINT_FMT_LIST_MAX; i++) {      if (level == system_print_fmt_list[i].level) {        fmt_index = i;        break;      }    }    if (i > SYSTEM_PRINT_FMT_LIST_MAX) {      goto exit_end;    }
    fmt_str_len = strlen(system_print_fmt_list[fmt_index].fmt_str);    strncpy((char *)&buf[TIME_PREFIX_SIZE], system_print_fmt_list[fmt_index].fmt_str, fmt_str_len);  }
    va_start(args, fmt);    num = vsnprintf((char *)&buf[fmt_str_len + TIME_PREFIX_SIZE], PRINT_MAX_SIZE - fmt_str_len - TIME_PREFIX_SIZE - 2, fmt, args);    va_end(args);
    if (num <= 0) {    goto exit_end;    }
  if (level != LOG_PRINT_LEVEL) {    num += fmt_str_len;    buf[num + TIME_PREFIX_SIZE] = '\r';    buf[num + TIME_PREFIX_SIZE + 1] = '\n';    num += 2;  }
  if ((GET_LOG_LEVEL() < level) && (level == LOG_ERROR_LEVEL)) {    //do nothing  } else {    ret = bsp_debug_send((uint8_t*)&buf[TIME_PREFIX_SIZE], num);    }
  if ((LOG_ERROR_LEVEL == level) || (LOG_RECORD_LEVEL == level)) {    bsp_rtc_get_time(&time);    sprintf(&buf[0], "[%04d-%02d-%02d %02d:%02d:%02d",      time.Year, time.Month, time.Day,time.Hour, time.Minute, time.Second);    buf[TIME_PREFIX_SIZE - 1] = ']';    gp_sys_log->system_log.log_latest_time = time;    system_log_write((uint8_t *)buf, num + TIME_PREFIX_SIZE);  }  
exit_end:  xSemaphoreGive(sem);  return ret;}

结语
本文提供的一种简易嵌入式设备系统日志记录方法，代码量不多，实现简单，针对不同的设备需要合理规划内存使用。

根据软件运行状态，合适加入调试信息并保存对应的日志信息，方便开发人员了解系统或软件运行状况，协助开发分析数据资源从而更好完善系统，提高定位以及解决问题的效果。
来源地址：
https://blog.csdn.net/LiaRonBob/article/details/102766871
声明：本文素材来源网络，版权归原作者所有。如涉及作品版权问题，请与我联系删除。

------------ END ------------


●专栏《嵌入式工具》
●专栏《嵌入式开发》
●专栏《Keil教程》
●嵌入式专栏精选教程

关注公众号回复“加群”按规则加入技术交流群，回复“1024”查看更多内容。
点击“阅读原文”查看更多分享。

登录阅读全文
免责声明： 该内容由专栏作者授权发布或作者转载，目的在于传递更多信息，并不代表本网赞同其观点，本站亦不保证或承诺内容真实性等。若内容或图片侵犯您的权益，请及时联系本站删除。侵权投诉联系：  nick.zong@aspencore.com！
strongerHuang 作者黄工，高级嵌入式软件工程师，分享嵌入式软硬件、物联网、单片机、开发工具、电子等内容。
评论
  • Linux系统更换开机logo方法教程，触觉智能RK3562开发板演示
    本文介绍Linux系统更换开机logo方法教程，通用RK3566、RK3568、RK3588、RK3576等开发板，触觉智能RK3562开发板演示，搭载4核A53处理器，主频高达2.0GHz；内置独立1Tops算力NPU，可应用于物联网网关、平板电脑、智能家居、教育电子、工业显示与控制等行业。制作图片开机logo图片制作注意事项（1）图片必须为bmp格式；（2）图片大小不能大于4MB；（3）BMP位深最大是32，建议设置为8；（4）图片名称为logo.bmp和logo_kernel.bmp；开机
    Industio_触觉智能 2025-01-06 10:43 72浏览
  • 国产固态继电器如何满足物联网应用的需求
    物联网(IoT)的快速发展彻底改变了从智能家居到工业自动化等各个行业。由于物联网系统需要高效、可靠且紧凑的组件来处理众多传感器、执行器和通信设备，国产固态继电器(SSR)已成为满足中国这些需求的关键解决方案。本文探讨了国产SSR如何满足物联网应用的需求，重点介绍了它们的优势、技术能力以及在现实场景中的应用。了解物联网中的固态继电器固态继电器是一种电子开关设备，它使用半导体而不是机械触点来控制负载。与传统的机械继电器不同，固态继电器具有以下优势：快速切换：确保精确快速的响应，这对于实时物联网系统至
    克里雅半导体科技 2025-01-03 16:11 176浏览
  • 硅电容系列一：硅电容概述
    这篇内容主要讨论三个基本问题，硅电容是什么，为什么要使用硅电容，如何正确使用硅电容？1.  硅电容是什么首先我们需要了解电容是什么？物理学上电容的概念指的是给定电位差下自由电荷的储藏量，记为C，单位是F，指的是容纳电荷的能力，C=εS/d=ε0εrS/4πkd（真空）=Q/U。百度百科上电容器的概念指的是两个相互靠近的导体，中间夹一层不导电的绝缘介质。通过观察电容本身的定义公式中可以看到，在各个变量中比较能够改变的就是εr，S和d，也就是介质的介电常数，金属板有效相对面积以及距离。当前
    知白 2025-01-06 12:04 110浏览
  • 德鲁克著作的解读：从“人”与“事”看管理的本质
    彼得·德鲁克被誉为“现代管理学之父”，他的管理思想影响了无数企业和管理者。然而，关于他的书籍分类，一种流行的说法令人感到困惑：德鲁克一生写了39本书，其中15本是关于管理的，而其中“专门写工商企业或为企业管理者写的”只有两本——《为成果而管理》和《创新与企业家精神》。这样的表述广为流传，但深入探讨后却发现并不完全准确。让我们一起重新审视这一说法，解析其中的矛盾与根源，进而重新认识德鲁克的管理思想及其著作的真正价值。从《创新与企业家精神》看德鲁克的视角《创新与企业家精神》通常被认为是一本专为企业管
    优思学院 2025-01-06 12:03 76浏览
  • 带驱动隔离器的自动化生产设备的未来
    自动化已成为现代制造业的基石，而驱动隔离器作为关键组件，在提升效率、精度和可靠性方面起到了不可或缺的作用。随着工业技术不断革新，驱动隔离器正助力自动化生产设备适应新兴趋势，并推动行业未来的发展。本文将探讨自动化的核心趋势及驱动隔离器在其中的重要角色。自动化领域的新兴趋势智能工厂的崛起智能工厂已成为自动化生产的新标杆。通过结合物联网（IoT）、人工智能（AI）和机器学习（ML），智能工厂实现了实时监控和动态决策。驱动隔离器在其中至关重要，它确保了传感器、执行器和控制单元之间的信号完整性，同时提供高
    腾恩科技-彭工 2025-01-03 16:28 166浏览
  • 国产数字隔离器在发电厂设备中的作用
    在快速发展的能源领域，发电厂是发电的支柱，效率和安全性至关重要。在这种背景下，国产数字隔离器已成为现代化和优化发电厂运营的重要组成部分。本文探讨了这些设备在提高性能方面的重要性，同时展示了中国在生产可靠且具有成本效益的数字隔离器方面的进步。什么是数字隔离器？数字隔离器充当屏障，在电气上将系统的不同部分隔离开来，同时允许无缝数据传输。在发电厂中，它们保护敏感的控制电路免受高压尖峰的影响，确保准确的信号处理，并在恶劣条件下保持系统完整性。中国国产数字隔离器经历了重大创新，在许多方面达到甚至超过了全球
    克里雅半导体科技 2025-01-03 16:10 122浏览
  • Matter 标准：破生态枷锁，启家居智能新时代
    在智能家居领域中，Wi-Fi、蓝牙、Zigbee、Thread与Z-Wave等无线通信协议是构建短距物联局域网的关键手段，它们常在实际应用中交叉运用，以满足智能家居生态系统多样化的功能需求。然而，这些协议之间并未遵循统一的互通标准，缺乏直接的互操作性，在进行组网时需要引入额外的网关作为“翻译桥梁”，极大地增加了系统的复杂性。 同时，Apple HomeKit、SamSung SmartThings、Amazon Alexa、Google Home等主流智能家居平台为了提升市占率与消费者
    华普微HOPERF 2025-01-06 17:23 88浏览
  • 光耦合器如何增强医疗设备的安全性
    光耦合器，也称为光隔离器，是一种利用光在两个隔离电路之间传输电信号的组件。在医疗领域，确保患者安全和设备可靠性至关重要。在众多有助于医疗设备安全性和效率的组件中，光耦合器起着至关重要的作用。这些紧凑型设备经常被忽视，但对于隔离高压和防止敏感医疗设备中的电气危害却是必不可少的。本文深入探讨了光耦合器的功能、其在医疗应用中的重要性以及其实际使用示例。什么是光耦合器？它通常由以下部分组成：LED（发光二极管）：将电信号转换为光。光电探测器（例如光电晶体管）：检测光并将其转换回电信号。这种布置确保输入和
    腾恩科技-彭工 2025-01-03 16:27 171浏览
  • 国产高性能CPU--米尔瑞芯微RK3576赋能AIoT、工业、智能显示终端
    随着市场需求不断的变化，各行各业对CPU的要求越来越高，特别是近几年流行的 AIOT，为了有更好的用户体验，CPU的算力就要求更高了。今天为大家推荐由米尔基于瑞芯微RK3576处理器推出的MYC-LR3576核心板及开发板。关于RK3576处理器国产CPU，是这些年的骄傲，华为手机全国产化，国人一片呼声，再也不用卡脖子了。RK3576处理器，就是一款由国产是厂商瑞芯微，今年第二季推出的全新通用型的高性能SOC芯片，这款CPU到底有多么的高性能，下面看看它的几个特性：8核心6 TOPS超强算力双千
    米尔电子嵌入式 2025-01-03 17:04 48浏览
  • PLC组态的方式与比较
    PLC组态方式主要有三种，每种都有其独特的特点和适用场景。下面来简单说说： 1. 硬件组态   定义：硬件组态指的是选择适合的PLC型号、I/O模块、通信模块等硬件组件，并按照实际需求进行连接和配置。    灵活性：这种方式允许用户根据项目需求自由搭配硬件组件，具有较高的灵活性。    成本：可能需要额外的硬件购买成本，适用于对系统性能和扩展性有较高要求的场合。 2. 软件组态   定义：软件组态主要是通过PLC
    丙丁先生 2025-01-06 09:23 71浏览
  • 封闭式电机行业发展现状及市场潜力分析报告
    根据Global Info Research项目团队最新调研，预计2030年全球封闭式电机产值达到1425百万美元，2024-2030年期间年复合增长率CAGR为3.4%。 封闭式电机是一种电动机，其外壳设计为密闭结构，通常用于要求较高的防护等级的应用场合。封闭式电机可以有效防止外部灰尘、水分和其他污染物进入内部，从而保护电机的内部组件，延长其使用寿命。 环洋市场咨询机构出版的调研分析报告【全球封闭式电机行业总体规模、主要厂商及IPO上市调研报告，2025-2031】研究全球封闭式电机总体规
    GIRtina 2025-01-06 11:10 80浏览
  • 如何区分315MHz和433MHz遥控模块？
    每日可见的315MHz和433MHz遥控模块，你能分清楚吗？众所周知，一套遥控设备主要由发射部分和接收部分组成，发射器可以将控制者的控制按键经过编码，调制到射频信号上面，然后经天线发射出无线信号。而接收器是将天线接收到的无线信号进行解码，从而得到与控制按键相对应的信号，然后再去控制相应的设备工作。当前，常见的遥控设备主要分为红外遥控与无线电遥控两大类，其主要区别为所采用的载波频率及其应用场景不一致。红外遥控设备所采用的射频信号频率一般为38kHz，通常应用在电视、投影仪等设备中；而无线电遥控设备
    华普微HOPERF 2025-01-06 15:29 81浏览
  • MCU应用第008篇 Eclipse环境下MCU寄存器描述文件的存储位置
        为控制片内设备并且查询其工作状态，MCU内部总是有一组特殊功能寄存器（SFR，Special Function Register）。    使用Eclipse环境调试MCU程序时，可以利用 Peripheral Registers Viewer来查看SFR。这个小工具是怎样知道某个型号的MCU有怎样的寄存器定义呢？它使用一种描述性的文本文件——SVD文件。这个文件存储在下面红色字体的路径下。    例：南京沁恒  &n
    电子知识打边炉 2025-01-04 20:04 79浏览
我要评论
0
点击右上角，分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦