如何通过Mstar平台对RTC时钟进行调试？

很多嵌入式设备在使用过程中，会碰到未联网的状态，但是有需要保证时间的正常，或者定时开关机功能。这个时候就需要添加RTC 时钟模块。下面通过mstar 平台的rx8130ce 型号时钟调试为例，一起分享。
RTC HW 连接






从HW提供的原理图设计时，提供了两款RTC 时钟芯片，地址分别是0x64,0xD0。





从提供的PCB 板上，UT3 未上件。 我们进一步查询I2C 的连接走线。





分析完原理图，要确保硬件的一下几点正常：

• RTC 的power 连接正常，电池（待机/断电时供电）和主板（上电时）
  
  
• RTC 的I2C 和主芯片的连接正常；
  
  
• RTC 的I2C 地址 的确定；
  
  
  

I2C 地址配置




找到pin 脚定义，然后配置总线，设置delay 时间，接着在总线下面挂载设备。

//Bus Info Define
#define BOARD_I2C_SWBUS_NUM 3
#define BOARD_I2C_HWBUS_NUM 0
#define BOARD_I2C_DEVICE_NUM 6


static SWI2CBus_t BOARD_I2C_SWBUS[BOARD_I2C_SWBUS_NUM]=
{
//Example for SW I2C => { 1, PAD_DDCR_CK, PAD_DDCR_DA, 60, }, //SW_I2C /SCL_PAD /SDA_PAD /Delay
// Bus-0
{PAD_DDCR_CK, PAD_DDCR_DA, 100}, //IS_SW_I2C /SCL_PAD /SDA_PAD /Delay
// Bus-1
{PAD_TGPIO0 , PAD_TGPIO1, 100},
// Bus-2
{PAD_GPIO19 , PAD_GPIO20,100},
// Bus-3
//{PAD_GPIO2 , PAD_GPIO3,100},
};


static HWI2CBus_t BOARD_I2C_HWBUS[BOARD_I2C_HWBUS_NUM];


//Device Info Define
static I2CDeviceInfo_s Board_I2C_Dev[BOARD_I2C_DEVICE_NUM] =
{
//Example => { TUNER1, 1, 0xC2 }, //gID(U32) /i2c_bus(U8) /slave_id(U8)
{TUNER1 , 1, 0xC0}, //gID(U32) /i2c_bus(U8) /slave_id(U8)
// AD82088
{AMP_SLAVER_ID , 1, 0x62}, // 0x31 << 1 --> 0x62
// RTC
{RTC_I2C_ID , 1, 0x64},
// temp R/W
{TMP102_CHIP_R , 1, 0x90},
{TMP102_CHIP_W , 1, 0x91},
// TCA9535
{TCA9539_I2C_ID , 2, 0xE8}, // 0x74 << 1 = 0xE8
};

I2C 的读写




注意上面的RTC8130_SECADDR 是 RTC 的寄存器地址，跟时间日期相关的几个寄存器地址如下：

#define RTC8130_SLAVEADDR 0x64
#define RTC8130_SECADDR 0x10
#define RTC8130_MINADDR 0x11
#define RTC8130_HOURADDR 0x12
#define RTC8130_WEEKADDR 0x13
#define RTC8130_DATEADDR 0x14
#define RTC8130_MONTHADDR 0x15
#define RTC8130_YEARADDR 0x16
这些地址在协议里面会有说明。
RTC 时间数据格式






分析datasheet 中RTC 时间格式，其中秒，分，时，天，月，年 都是BCD 码格式存储。周 的存储方法不一样，按照所在的bit 位标记为第几周，一个月最多跨6 周。

• 
  
  

设置时间
static MAPI_U8 HEX2BCD(MAPI_U8 cHEXData)
{
MAPI_U8 cTemp;
cTemp = ((cHEXData / 10) << 4) | (cHEXData % 10);
return cTemp;
}


先将16进制的数据转换成BCD 码，然后设置到对应寄存器中。


SecAdd = RTC8130_SECADDR; // 0x10
TimeTable[RTC_SECOND] = HEX2BCD(RTC8130_TimeData.param[RTC_SECOND]) & 0x7F;
TimeTable[RTC_MINUTE] = HEX2BCD(RTC8130_TimeData.param[RTC_MINUTE]) & 0x7F;
TimeTable[RTC_HOUR] = HEX2BCD(RTC8130_TimeData.param[RTC_HOUR]) & 0x3F;
TimeTable[RTC_WEEK] = RTC8130_TimeData.param[RTC_WEEK] & 0x7F ;
TimeTable[RTC_DATE] = HEX2BCD(RTC8130_TimeData.param[RTC_DATE]) & 0x3F;
TimeTable[RTC_MONTH] = HEX2BCD(RTC8130_TimeData.param[RTC_MONTH]) & 0x1F;
TimeTable[RTC_YEAR] = HEX2BCD(RTC8130_TimeData.param[RTC_YEAR]) & 0xFF;


ret = iptr->WriteBytes(1,&SecAdd,7,&TimeTable[RTC_SECOND]);


获取时间
mapi_i2c *iptr = NULL;
MAPI_U8 regAddr = RTC8130_SECADDR;


RX8130_PRINTF(printf("[%s][%d] RX81390 Enter .n",__FUNCTION__,__LINE__));


iptr = mapi_i2c::GetI2C_Dev(RTC_I2C_ID);
if(iptr == NULL)
{
printf("[%s][%d] RX81390 Invalid I2c rtc addr .n", __FUNCTION__,__LINE__);
return MAPI_FALSE;
}


ret = iptr->ReadBytes(1, ®Addr, 7, TimeTable);
if(MAPI_FALSE == ret)
{
printf("[%s][%d] RX81390 Read ret = %dn", __FUNCTION__,__LINE__,ret);
return MAPI_FALSE;
}


RTC8130_TimeData.param[RTC_SECOND] = BCD2HEX(TimeTable[0]);
RTC8130_TimeData.param[RTC_MINUTE] = BCD2HEX(TimeTable[1]);
RTC8130_TimeData.param[RTC_HOUR] = BCD2HEX(TimeTable[2]);
RTC8130_TimeData.param[RTC_WEEK] = TimeTable[3] & 0x7F;
RTC8130_TimeData.param[RTC_DATE] = BCD2HEX(TimeTable[4]);
RTC8130_TimeData.param[RTC_MONTH] = BCD2HEX(TimeTable[5]);
RTC8130_TimeData.param[RTC_YEAR] = BCD2HEX(TimeTable[6]);


将读取到的BCD码转换成16进制数据给上层使用。


static MAPI_U8 BCD2HEX(MAPI_U8 cBCDData)
{
MAPI_U8 cTemp;
cTemp = ((cBCDData >> 4) * 10) + ( cBCDData & 0x0F);
return cTemp;
}


另外要主要周，年的范围。例如， 年的最大值 165
（80+40+20+10+8+4+2+1），那么实际使用的需要补齐。
2019 年则传入RTC时是19，1970 传入应该是70 。一般定时也不多超过100年，所以还是能够满足实际要求的。

RTC 初始配置

RX8130_CONFIG g_RX8130_CONFIGData[] =
{
{0x30,0x80},//enable DTE
{0x1c,0x04},
{0x1d,0x06},
{0x1e,0x00},
{0x1f,0x00},
};


iptr = mapi_i2c::GetI2C_Dev(RTC_I2C_ID);
if(iptr == NULL)
{
printf("[%s][%d] RX81390 Invalid I2c mcu addr .n",__FUNCTION__,__LINE__);
return ret;
}

for(i=0; i {
unAddr = g_RX8130_CONFIGData .RX8130_Address;
unData = g_RX8130_CONFIGData.RX8130_InitData;
ret = iptr->WriteBytes(1, &unAddr, 1, &unData);
RX8130_PRINTF(printf("[%s][%d] RX8130 Write [0x%02x : 0x%02X] ret = %dn",__FUNCTION__,__LINE__,unAddr,unData,ret));
}
return ret;