https://harmonyos.51cto.com/#zz
使用的器件：Hi3861 + AHT20 + SSD1306
配好开发环境轻松做完点灯任务后，便想搞个像样点的应用，然后……决定做一个测量温湿度计，开始觉得这个实现比较简单，通过Hi3861读取AHT20测出的温湿度值，然后通过OLED显示出来。
首先我的嵌入式开发知识非常少，曾经做过几年Java开发，玩过一点51单片机，在Linux上部署过一些Web服务。仅此而已，所以我的知识无法宏观上把这个事情想的很清楚，只能一步一步的试。如果你也是新入手嵌入式开发的朋友，那我的过程可能会对你有借鉴。
先构建一个技术轮廓：每种电子传感器都是包括3类端口，(1)第1类电源：必需要2根电源线给模块供电，正负极，有的模块有多组供电;(2)第2类控制：然后有的模块会有一些控制端口，每种模块都不经相同，有的模块直接读数是没有这种控制端口的;(3)第3类通信线：跟核心单片机通信的信号端口，根据采用的通信协议不同，端口数量不同。要使用的AHT20和SSD1306采用的都是I2C通信协议，所以都是2根通信线。
我所用到的模块都很简单，主要涵盖的都是这3类端口，所以不管看到模块打扮成什么样，所要解决的主要问题都是类似的。主要做的就是通过通信端口向模块读写数据。
模块的配置：各种模块控制和存储数据都是由一组组8位的寄存器控制的，每个寄存器里有8位，每一位可以存储1或者0，组成1个字节值，每种模块都有自己的功能设置和存储设置，可以想象成高阶语言里的关键字，寄存器值就是它本来的样子，一组组数字直接看是不会看懂它代表什么意思的，所以要依靠模块提供的技术手册做指导，一边看手册一边设置，单片机开发就这是这么朴实无华。
关于通信协议：要使用的这2个模块采用的都是I2C通信协议，2根线一根信号一根时钟，通信双方就是通过互相占用通信线，相互发送高低电平传递消息，就是他们不能同步通信的，一方发送一方只能接收。因为用的线少所以通信过程非常繁琐，一方喊话问某地址的模块是否在线，然后等待，对方如果收到喊话，然后给个应答，当收到应答，再发送指令告诉他准备干什么，然后等待确认，模块收到后发确认…………，这个过程我在51上模拟过，好痛苦啊，一个时钟信号一个数据信号的数……，但是!!!在鸿蒙上所有的繁琐过程都被封装好了，我们只需要简单的调用系统提供的I2C操作方法，具体过程完全不用考虑，经过使用，真的好用，非常好用，好简单啊!所以I2C基本流程熟悉一下即可，在开发过程中具体的工作非常少。
SSD1306
首先是点亮屏幕，一旦能使用屏幕了，等于单片机对你打开了一扇窗户。SSD1306并不是OLED，它是驱动OLED显示的控制芯片，很多模块本身就是一个复杂的单片机，我们用的OLED屏幕是128*64像素组成的，本质上你可以简单的理解为高阶点灯。对SSD1306的控制也是通过I2C实现的，虽然它支持很多种通信协议，但是惜端如金的Hi3861采用了端口占用最少的I2C。
我们只是需要向SSD1306发送数据，没有反馈值。所以通信过程比较简单SSD1306的地址0x78，0x00为接收命令，0x40为接收数据。把这个高度重复的过程做到1个函数里，直接调用就好。
- // I2C协议 读写函数 只有写需求, cd = 0 写指令 cd = 1 写数据 byt 要写入的值
- void SSD1306_I2C_W(unsigned char cd, unsigned char byt)
- {
- unsigned int state = 0; // I2C 运行 状态
- WifiIotI2cIdx id = WIFI_IOT_I2C_IDX_0; //I2C 通道 0
- unsigned short deviceAddr = 0x78; // SSD1306 地址
- WifiIotI2cData i2cData = {0}; // 接收发送信息的数组 查 wifiiot_i2c.h 看详细说明
- unsigned char buf[] = {0x00, byt}; //默认 0x00 写入 指令集 byt 要写入的指令
- if(cd == 1) // 输入 数据
- {
- buf[0] = 0x40; // 0x40 表示写入的是数据 byt 就是要写入的数据
- }
- i2cData.sendBuf = buf;
- i2cData.sendLen = 2;
- state = I2cWrite(id, deviceAddr, &i2cData);
- if(state != WIFI_IOT_SUCCESS)
- {
- printf("[SSD1306_I2C_W] write error ： < %d > !!! \r\n", state); // 如果状态异常 就打印 错误信息
- }
- // return state; // 也可以作为返回值
- }
驱动命令比较多，这是遇到的第一个障碍，看了手册，还有网络上各种例子，各式各样，虽然大同小异但是更是一头雾水。然后……以手册流程图为准自己写。不要怕，大胆试，好不好用试了才知道。
有的设置是需要成对出现的，一个命令配一个参数，但是很多例子全部放在一起，一边看参数一边对照命令表……崩溃，虽然我现在也没搞懂有些命令的功能，但是以手册默认值为准，最后运行的很好。哈。
驱动流程：
大多例子都是默认用页显示的方式，开始我也是用页显示的方式，用用就根据自己的需要改成水平方式了，建1个2维数组存放显示的信息，显示函数跟画面函数分离，这样做画面的时候专注做画面。这样还有个好处，就是以后代码的重用会比较方便。这样做还是为了简单实现在任意坐标显示，以后画个波显示更方便一点。
这里补充1点，我开始按以前做小游戏的习惯做的画面控制，单片机还是模块好像都吃不消，看来还是越简单越好。
然后要用到1个辅助工具，PCtoLCD2002完美版-(字符模式)，这个字模工具超好用，这里向作者表示由衷的感情，让最繁琐的工作变得非常轻松。使用的时候注意点选项设置，主要是方向，写段代码测一下就好了。
SSD1306一次接收1个字节的数据，表示对1列8个像素的开关控制，每个字节数据转成二进制代码，比如0xFF二进制1111 1111，每个1都代表点亮1个像素。0x00二进制0000 0000，就是关闭8个像素。
AHT20
先看一下AHT20的技术手册，这个手册可以百度到(国内最小的半导体温湿度传感器AHT20研发成功，百度的结果，哈哈)，在官网还可以下载到它的例程，这个模块功能很简单，所以手册看的很轻松。
列一下工作流程：
1、上电等待40ms
2、发送0x71 查看AHT20状态指令
查看状态值 [3] 是否为 1
如果为1可以发送测量指令
如果为0需要初始化：发送0xBE + 0x08 + 0x00初始化，初始化过程需要等待10ms
3、发送0xAC + 0x33 + 0x00测量指令，测量过程需要等待80ms
再发送0x71查看状态值[7]是否为0，如果为0表示测量完毕，否者等待。
接收测量结果，收到7个字节的数据。
主要2个步骤，查状态，以及测量读结果。
我看到一个文章讲I2C协议是有专利权的，所以一般的产品使用这个协议都会或多或少的改一点，但是基本过程是一样的，并不会影响使用，这只是传闻我并没有证实。
AHT20地址0x38换成2进制格式 111000，向左移1位结果是1110000，如果在最后1位就是[0]位设为0(1110000)，就是发送读信息，如果[0]位设置为1(1110001)就是写信息。
公式：0x38<<1 | 0x1 = 0x70 写地址; 0x38<<1 |0x0 = 0x71 读地址;
- // 每个参数 都写在函数里 是为了方便理解阅读 最后做最终版 要尽量减少冗余操作
- // i2c写入、读出操作； rw=0 写入 rw=1 读出； *buff 数据数组，读入就是指令集，返回就是空数组； leng 数组的长度 不可以为0；
- void AHT20_I2C_RW(unsigned char rw, unsigned char *buff, unsigned int leng)
- {
- unsigned int state = 0; // I2C 运行 状态值 ，单列出来是为了方便作为返回值 做判断
- WifiIotI2cIdx id = WIFI_IOT_I2C_IDX_0; //设置I2C使用的通道
- unsigned short writAddr = 0x70; // aht20 ((0x38<<1)|0x0) 写入地址
- unsigned short readAddr = 0x71; // aht20 ((0x38<<1)|0x1) 读出地址
- WifiIotI2cData i2cData = {0}; // 参考 wiffiiot_i2c.h 的说明 位置在 \base\iot_hardware\interfaces\kits\wifiiot_lite
- if(rw == 0) // 写入
- {
- i2cData.sendBuf = buff; //unsigned char* 发送 数据 指针
- i2cData.sendLen = leng; //unsigned int 发送 数据 长度
- state = I2cWrite(id, writAddr, &i2cData); //i2c写入方法 会有1个状态返回值 WIFI_IOT_SUCCESS = 0 代表成功 出错会返回错误代码 需要加入 wifiiot_errno.h 头文件
- }
- else if(rw == 1) // 读出
- {
- i2cData.receiveBuf = buff; //unsigned char* 接收 数据 指针
- i2cData.receiveLen = leng; //unsigned int 接收 数据 长度
- state = I2cRead(id, readAddr, &i2cData); //i2c读出方法
- }
- if(state != WIFI_IOT_SUCCESS) // 如果返回值 不等于 WIFI_IOT_SUCCESS 打印state 查询 wifiiot_errno.h 看错哪了
- {
- printf("[AHT20_I2C_RW] ERROR !!! %d ： %d \r\n", rw, state); // 打印 错误信息
- }
- }
这里要重点!重点!重点!的说一下，接收状态值，不要!不要!不要!再发送0x71指令了，直接I2C读，就会给你传1个状态值，默认的状态值的第[7]位是0，当你发送测量指令的时候，会变成1，进入测量状态，当测量完以后会重新置为0。开始因为一直无法读取到正确的状态值……#￥%&#￥%#@%#，一言难尽啊，已经过去了。
- // 返回 AHT20 的状态值 i是第几位 0~7
- unsigned char AHT20_Status(unsigned char i)
- {
- unsigned char buff[] = {0};
- unsigned char leng = 1;
- AHT20_I2C_RW(1, buff, leng);
- unsigned char s; //返回状态值 0、1
- s = (buff[0] >> i) & 0x01; //状态值是1个字节数据，我们只需要知道某位的具体值就行 i就是第几位
- //printf("[AHT20_Status] AHT20_Status 0x%x [%d : %d] !!! \r\n", buff4[0], i, s); // 此行 调试用 打印 状态值
- return s;
- }
结果会返回7个字节数据，第1个字节是状态信息，第2个、第3个、以及第4个字节的高4位[7][6][5][4]共同组成了湿度值，第4个字节的低4位[3][2][1][0]、第5位、第6位组成温度值，最后第7个字节是效验位。
然后效验，主要是目的是检验接收到的数据是否在传输的过程中出现错误，具体原理和公式以及代码不仔细说了，过程太碎了，几次测试，代码没问题，具体过程百度一下好多资料，检验的时候一定要包括第1个状态字节。
检验这步骤不是必须的，但是我开始的时候发现读到的数错的离谱，开始不清楚是我代码写的问题还是模块本身的问题，然后就把检验这个步骤也写上了，最后发现模块没问题，代码也没问题，问题是模块上有个气体传感器会发热，所以温度值高。真的好晕。
最后一步就是就是把读到的数值转化为正常的10进制值。
技术手册湿度的公式后面有个%号，那个是湿度百分比的意思，我还纠结过×100%有啥意义呢?当你没最后完全走通的时候就像在黑暗里摸索，一个小坑都能把你绊的够呛。
转化的过程要注意数值的类型，本来这个取值就是取很小的零头，如果类型用错了，就给抹掉了。哈。
- // AHT20 测量温湿度值
- unsigned char AHT20_Measure(float *ht)
- {
- // 发送 测量指令
- unsigned char buff1[] = {0xac, 0x33, 0x00};
- unsigned char leng1 = 3;
- AHT20_I2C_RW(0, buff1, leng1); // 默认状态值第[7]位是0,发送完测量指令后状态值[7]会置1
- usleep(80*1000); //等待 80ms 时钟偏快的 所以这个时间内 总是不能完成测量
- unsigned char t = 10; //等待时间的值
- while(AHT20_Status(7) != 0) //检查 状态值第[7]位是否从1变为0，如果没变就等待5ms，如果已经置0说明测量完成
- {
- usleep(10*1000); //10ms 这个时间不要设置太长，也不要设置太短，太长时间，小器件很难长时间存储测量结果，太短反复应答也能会影响测量的稳定性，一般情况等1次就会过
- if(--t == 0) // 如果等待时间很长依然没有变0，说明设备可能出现异常，为了避免死机，返回0，重新测量 这个情况我还没遇到
- {
- return 0;
- }
- }
- // 接收 测量结果
- unsigned char buff2[7] = {0};
- unsigned char leng2 = 7;
- AHT20_I2C_RW(1, buff2, leng2); // 读返回结果，一共7个字节，第1个字节是状态值 最后1个字节是效验值
- unsigned char i, j;
- unsigned char crc = 0xFF; // 效验 初值
- // CRC 效验 固定算法
- for(i=0; i<6; i++)
- {
- crc ^= (buff2[i]);
- for(j=8; j>0; --j)
- {
- if(crc & 0x80)
- {
- crc = (crc << 1) ^ 0x31;
- }
- else
- {
- crc = (crc << 1);
- }
- }
- }
- if(buff2[6] != crc) //CRC值不对 说明传输过程可能有干扰 出错了
- {
- //printf(" CRC8 NO \r\n");
- return 0; // 效验不正确 回执1个错误信息
- }
- unsigned int dat1 = 0; // 湿度
- unsigned int dat2 = 0; // 温度
- dat1 = (dat1 | buff2[1]) << 8;
- dat1 = (dat1 | buff2[2]) << 8;
- dat1 = (dat1 | buff2[3]) >> 4;
- dat2 = (dat2 | buff2[3]) << 8;
- dat2 = (dat2 | buff2[4]) << 8;
- dat2 = (dat2 | buff2[5]) & 0xfffff;
- // 这1大段搬来搬去的 主要是因为 buff2[3] 前4位属于湿度 后4位属于 温度
- // 单片机处理能力有限，主要是针对寄存器值的处理，使用位运算，这样能节省算力
- // 处理数据 单列出来 便于理解，代码写的太简练 不容易看懂 最终 不需要这么繁琐
- float hum = 0; // 温度
- float tem = 0; // 湿度
- // 2^20=1048576 要先类型转换 暂时先这么写 以后再改得顺溜点
- hum = ((float)dat1 / (float)1048576) * (float)100; // 湿度
- tem = ((float)dat2 / (float)1048576) * (float)200 - (float)50; // 温度
- ht[0] = hum;
- ht[1] = tem;
- return 1; // 测量完毕
- }
软复位，无需关闭再次打开电源的情况下重新启动传感器。就是软重启，长时间停用的再次访问的时候使用，我这个小应用基本用不到，但是还是写上吧。输入指令0xBA需要等待20ms。
剩下工作就是把AHT20的代码和SSD1306的代码整合到一起。这里要说1点，I2C支持串联多个设备，所以AHT20和SSD1306在一条I2C线上共同使用是没有问题的。
C语言从来不是我主要的使用语言，所以超级菜啊，一边写一边看C 语言教程。装个Dev-C++编译器，有些功能先写个测试代码看看。开始写代码，不要考虑效率问题，就只想怎么更适合阅读。开始写主要的目的是试错，写一步编译一步，不要一次写全所有功能。
我觉得鸿蒙系统编译报错功能非常好，我的每个错误都能被准确的指出来。开始专用的查BUG功能对新手来说很难，可以用printf串口打印功能就行，真的好用，因为鸿蒙是多任务系统，所有的功能都是一个单独的任务，即使你的代码运行跑坏了，但是系统不会崩，打印功能依然会给你打印出信息来。第一次用真觉得好高级，能直接看到单片机的回话了。
最后不断对代码迭代优化，最终的目的让代码可以更好的被重用。以后还要用的嘛，重复的工作就不要做了。编程过程对我这种新手来说，真是经历情况太多，开发过程发生的各种事以后以后单开一篇碎碎念再讲吧。
知识有限又刚刚尝试，所以肯定会有很多错误，欢迎给我指正。开始觉得弄这个很简单，但是很快被现实教育，然后开始认真读各位大佬的教程，收获很大，这里由衷的感谢。
https://harmonyos.51cto.com/#zz
