基于STM8的IIC协议--实例篇--时钟模块(DS3231)读取
1. 综述
由上篇博客可知道IIC协议如何用代码实现，本篇博客就不涉及协议内容，只讲解如何使用。
本次的实验传感为：DS3231（时钟模块），对于时钟模块的具体信息我也就不多介绍，大家可以自行度娘，具体功能无非就是让单片机中能够起到获取时间的作用。该模块是可以由IIC协议去驱动的，再加上所要的操作也是比较简单，部分刚接触IIC协议的小伙伴可以拿来练手的一个模块。
2. 明确任务顺序
个人习惯，在每驱动一个新传感的时候，我会将我要完成的传感分为几个任务点。接下来就展示一下我在写DS3231模块时的任务栏。
一．硬件部分 1.完成排针焊接 2.完成传感引角和单片机引角的接线 二．软件部分 1. 找到该传感的官方手册并认真阅读 2. 找到并定义该传感的地址（7位地址、8位地址）
3. 找到并定义该传感器的寄存器地址 4. 完成读写函数的代码 5. 测试传感是否有响应
6. 查看手册，了解传感的工作模式
7. 完成传感参数初始化 8. 传感数据的获取
根据上面这些小任务一一解决，这样一来，大多数传感就能成功驱动了，这里在给一个建议，驱动传感器的代码最好不要一次性全部写完再进行测试，这样成功率不高，并且会大大增加你找问题的难度，将每个功能函数测试完再进行下一个功能函数的编写，会大大加大你的效率。
3. 具体任务实现步骤
3.1. 硬件部分
在STM8S103芯片中，我所定义的IIC协议中的SDA引角为PD3,SCL引角为PD4，该时钟模块所需提供的电源为3.3V。所以接线图如下。
3.2. 软件部分
（1）官方手册
我这里提供的是全英版的官方手册，多看点英文对你有好处的。
链接：https://pan.baidu.com/s/1Oo6o68SoVr7gt8tPZIoQxw 提取码：uzih
（2）器件地址
在说明手册中，我们可以在第16页的右下角找到下面这句话：
The slave address byte contains the 7-bit DS3231 address, which is 1101000, followed by the direction bit (R/W), which is 0 for a write.
这句话的大意为，从机的7位地址为1101000，后跟一位读写位，读写位为0时是写位。即7位地址的为0x68，8位地址为0xD0。
（3）寄存器地址
DS3231的寄存器地址都在这了，大家可根据所需要用的功能定义相应的寄存器。
以下是我在头文件所定义的格式，因为我只需要获取时间，不需要进行其他操作，所以部分寄存器没有使用。
1 #define DS3231_Address 0xD0 //设备地址 2 #define Seconds_Register 0x00 //秒钟寄存器 3 #define Minutes_Register 0x01 //分钟寄存器 4 #define Hour_Register 0x02 //小时寄存器 5 #define Day_Register 0x03 //星期寄存器 6 #define Date_Register 0x04 //日期寄存器 7 #define Month_Register 0x05 //月份寄存器（第七位是世纪位） 8 #define Year_Register 0x06 //年份寄存器
4. 例程
4.1 编译环境
我的编译环境是IAR，这款软件是现在STM8的主流平台，比较推荐。不过我打算等到STCubeMX更新出比较方便的版本后再去使用Keil5，因为我在用STM32的时候就是利用Keil5，的确很方便，你们也可以学着用一下。
4.2 主芯片
我的主芯片是STM8S系列中的103，其中STM8S的003、005、和103、105，配置一样（外设和CPU频率，FLASH），在代码相同的情况下均可进行烧写。
4.3 库文件的添加
我们的工程可以在IAR中的官方例程中复制，操作过程：打开STM8S_StdPeriph_Lib（这是一个官方的库文件，下载IAR STM8包的时候就携带，里面有库文件和相对应的例程），将Libraries文件复制到你工程所在的文件下，并将有关于ADC的库文件添加到你的工程列表当中。添加完成后，就可以开始编写代码了（如果你将全部的库文件都添加进来的话，编译程序后库文件还有红点报错的话，这是因为你选的芯片上没有该功能，你需要将其删掉才能不报错。）如图。
4.4 代码
4.4.1 SDA、SCL引角的定义
我这里将SDA、SCL都设置为了推挽输出，具体为什么可与参考上一片IIC协议讲解。
1 //IIC引脚 2 GPIO_Init(IIC_SCL_GPIO_Port, IIC_SCL_Pin, GPIO_MODE_OUT_PP_HIGH_FAST); 3 GPIO_Init(IIC_SDA_GPIO_Port, IIC_SDA_Pin, GPIO_MODE_OUT_PP_HIGH_FAST);
4.4.2 DS3231句柄定义
为了能够方便数据的管理，所以我定义了DS3231的一个句柄。
1 typedef struct DS3231 2 { 3 uint8_t uSeconds; //秒 4 uint8_t uMinutes; //分钟 5 uint8_t uHour; //小时 6 uint8_t uDay; //星期 7 uint8_t uData; //日期 8 uint8_t uMouth; //月份 9 uint8_t uyear; //年份 10 uint8_t uTime[3]; //将秒、分钟、小时、日期包括在内 11 12 13 }DS3231_HandleTypeDef;
4.4.3 BCD格式和B格式转换
在手册中可以看到，写入到DS3231中的格式是BCD格式，而读取到的却是B格式，所以我们需要两个函数将其转换，也方便我们察看数据的结果。
1 uint8_t Byte_Transform_BCD(uint8_t uData) 2 { 3 uint8_t i, j, uBCD_Code; 4 5 i = uData / 10; 6 j = uData % 10; 7 uBCD_Code = j + ( i << 4 ); 8 9 return uBCD_Code; 10 11 } 12 13 uint8_t BCD_Transform_Byte(uint8_t uData) 14 { 15 uint8_t uByte_Code; 16 17 uByte_Code = (uData & 0x0f); 18 uData >>= 4; 19 uData &= 0x0f; 20 uData *= 10; 21 uByte_Code += uData; 22 23 return uByte_Code; 24 25 }
4.4.4读写函数编写
读写函数我们如果不去看手册说明的话是无法编写代码的，所以我们需要去看手册，根据手册中的IIC命令顺序进行编写代码。
这幅图为 IIC数据传输概述。
写函数流程图：
这个流程图是在DS3231中的官方图，根据图中的命令可以写出代码，其中，代码中出现IIC_HandleTypedef * iicHandle等参数，是IIC的句柄，具体可看上一篇博客，下面所出现的也是一样的意思。
1 uint8_t vSen_DS3231_Write_Bytes(IIC_HandleTypedef * iicHandle, uint8_t Register_Address, uint8_t Data_Byte) 2 { 3 4 vIIC_Start_Signal(iicHandle); //1. IIC_Start ; 起始信号 5 vIIC_SendByte(iicHandle, Slave_Address); //2. IIC_Send Device Address(W); 发送（设备地址）告诉总线即将操作的设备 6 7 if(!bIIC_ReadACK(iicHandle)) //3. IIC_ReadAck ; 等待响应 8 { 9 vIIC_Stop_Signal(iicHandle); 10 return FALSE; 11 } 12 13 vIIC_SendByte(iicHandle, Register_Address); //4. IIC_Send Register Address ; 发送（寄存器） 告诉设备我们即将操作的寄存器 14 bIIC_ReadACK(iicHandle); //5. IIC_ReadAck ; 等待响应 15 vIIC_SendByte(iicHandle, Data_Byte); //6. IIC_Send the data to Reg ; 发送（数据） 写入数据到指定设备的寄存器中 16 bIIC_ReadACK(iicHandle); //7. IIC_ReadAck ; 等待响应 17 vIIC_Stop_Signal(iicHandle); //8. IIC_Stop ; 结束信号 18 19 20 return TRUE; 21 22 }
读函数流程图：
1 uint8_t vSen_DS3231_Read_Bytes(IIC_HandleTypedef * iicHandle, uint8_t Register_Address) 2 { 3 uint8_t uRev_Register_Data = 0x00; 4 5 vIIC_Start_Signal(iicHandle); //1. IIC_Start ; 起始信号 6 vIIC_SendByte(iicHandle, Slave_Address); //2. IIC_Send Device Address(W); 发送（设备地址）告诉总线即将操作的设备 7 8 if(!bIIC_ReadACK(iicHandle)) //3. IIC_ReadAck ; 等待响应 9 { 10 vIIC_Stop_Signal(iicHandle); 11 return FALSE; 12 } 13 14 vIIC_SendByte(iicHandle, Register_Address); //4. IIC_Send Register Address ; 发送（寄存器） 告诉设备我们即将操作的寄存器 15 vIIC_Ack(iicHandle); //5. IIC_Ack ; 主动响应 16 vIIC_Start_Signal(iicHandle); //6. IIC_Start ; 起始信号
17 vIIC_SendByte(iicHandle, Slave_Address+1); //7. IIC_Send Device Address(R); 发送（设备地址）告诉总线即将操作的设备 18 vIIC_Ack(iicHandle); //8. IIC_Ack ; 主动响应 19 uRev_Register_Data = uIIC_RecvByte(iicHandle); //9. IIC_ReadByte ; 读取寄存器中的数据 20 vIIC_NAck(iicHandle); //10. IIC_Nack ; 主动不应答 21 vIIC_Stop_Signal(iicHandle); //11. IIC_Stop ; 结束信号 22 23 return uRev_Register_Data; 24 25 }
完成读写函数的编写后，那么我们就可测试传感是否通信成功，具体可检测的方法有挺多，最直观的是用示波器察看波形，若在读写函数发送器件地址后，有接下来的发送寄存器地址和数据等操作波形的话，即有返回到ACK，则单片机与传感通信成功。这里再说一个不需要用到的示波器的操作，同样的，在读写函数发送器件地址后，用Uart发送功能，在串口助手上打印一个数，若有数显示，则没有return 跳出函数，证明SDA的电平被器件拉低，也是有ACK返回的情况，则单片机于传感通信成功。
4.4.5 修改时间
我们在读取时间之前需要对时间进行一个手动输入的方法去给予时钟模块一个初始值，这样才能开始计时，这个函数可以当作修改时间的功能，具体代码可以自行编写，我这里的代码就写成全部修改。
1 void vSen_DS3231_Modify_Time(IIC_HandleTypedef * iicHandle, uint8_t uyear, uint8_t uMouth, uint8_t uData, uint8_t uDay, uint8_t uHour, uint8_t uMinutes, uint8_t uSeconds) 2 { 3 4 vSen_DS3231_Write_Bytes(iicHandle, Year_Register, Byte_Transform_BCD(uyear)); //修改年份 5 6 vSen_DS3231_Write_Bytes(iicHandle, Month_Register, Byte_Transform_BCD(uMouth)); //修改月份 7 8 vSen_DS3231_Write_Bytes(iicHandle, Date_Register, Byte_Transform_BCD(uData)); //修改日期 9 10 vSen_DS3231_Write_Bytes(iicHandle, Day_Register, Byte_Transform_BCD(uDay)); //修改星期 11 12 vSen_DS3231_Write_Bytes(iicHandle, Hour_Register, Byte_Transform_BCD(uHour)); //修改小时 13 14 vSen_DS3231_Write_Bytes(iicHandle, Minutes_Register, Byte_Transform_BCD(uMinutes)); //修改分钟 15 16 vSen_DS3231_Write_Bytes(iicHandle, Seconds_Register, Byte_Transform_BCD(uSeconds)); //修改秒钟 17 18 }
4.4.6 获取时间
获取时间就直接读取相应的寄存器获取数值即可，最后将其输出就行。
1 void vSen_DS3231_Get_Times(IIC_HandleTypedef * iicHandle, DS3231_HandleTypeDef * hDS3231) 2 { 3 hDS3231->uyear = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Year_Register)); //获取年份 4 5 hDS3231->uMouth = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Month_Register)); //获取月份 6 7 hDS3231->uData = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Date_Register)); //获取日期 8 9 hDS3231->uDay = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Day_Register)); //获取星期 10 11 hDS3231->uHour = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Hour_Register)); //获取小时 12 13 hDS3231->uMinutes = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Minutes_Register)); //获取分钟 14 15 hDS3231->uSeconds = BCD_Transform_Byte(vSen_DS3231_Read_Bytes(iicHandle, Seconds_Register)); //获取秒钟 16 17 }
4.4.7 DS3231初始化
1 /******************************************************************************* 2 * Function Name : vSen_DS3231_IIC_Init 3 * Description : DS3231 Init 4 * Input : IIC_HandleTypedef * iicHandle, GPIO_TypeDef * pSCL_Port, uint16_t uSCL_Pin, GPIO_TypeDef * pSDA_Port, uint16_t uSDA_Pin 5 * Output : None 6 * Return : None 7 ********************************************************************************/ 8 void vSen_DS3231_Init(IIC_HandleTypedef * iicHandle, DS3231_HandleTypeDef * hDS3231, GPIO_TypeDef * pSCL_Port, uint16_t uSCL_Pin, GPIO_TypeDef * pSDA_Port, uint16_t uSDA_Pin) 9 { 10 11 vIIC_Handle_Init(iicHandle, pSCL_Port, uSCL_Pin, pSDA_Port, uSDA_Pin); //初始化IIC协议句柄 12 13
14 // 年份 月份 日期 星期 时钟 分钟 秒钟 15 vSen_DS3231_Modify_Time(iicHandle, 19, 5, 10, 5, 21, 45, 00); //DS3231初始化时间 16 17 }
4.5 成果展示
因为我这里用的是数码管显示，但数码管格数不够，就只显示了时分秒三个数值。
5. 结尾
DS3231模块已经成功驱动了，毕竟这个模块是比较容易的一个IIC传感，基本不用配置什么寄存器，直接写入再直接读取即可，算是一个IIC小入门难度，不过其他传感也大同小异，都非常类似。
对STM8的I2C传感模块驱动讲解到这里结束，感谢各位看官的点击。
如果觉得有所收获请点下推荐，若认为该博客中存在错误的说明或者对博客中某方面有疑问请留言。
作 者：浩宇99✌ 出 处：https://www.cnblogs.com/zhenghaoyu/p/10841542.html
版权声明：本文原创发表于 博客园，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则视为侵权。
