为了帮大家快速上手WIoTa，解决AT接口使用和二次开发过程中遇到的问题，在这里开一个汇总贴。把平时经常遇到的问题做个产总结和归档。避免多位同学在同一个地方踩坑。
本贴的宗旨是：你上手，我上心，大家都别上头~
1. Q：从github上取下来的代码异步协议在跑自带Demo程序的时候，串口出现乱码是怎么回事？
A: 这是因为Demo代码里面开启了低功耗模式，模组进低功耗之后会降低系统主频，造成的串口波特率变化。对应API函数为：
` uc_wiota_set_lpm_mode(1); // enter lpm mode`
处理办法是注释掉该条语句，或者参数给成0。不让模组进入低功耗状态。
修改代码重新编译之后，程序串口输出正常显示。
另一个可能原因是模组休眠时，串口的发送FIFO中还有数据没有发送完成，导致重新启动之后，继续发送之前的剩余数据。这有可能会造成数据错位的问题，导致持续乱码。
处理方法有两个：要么在休眠前，等待串口数据发送完成，要么在系统启动的时候，清一下FIFO。以下是在发休眠前等待数据发送完完的例子：
2. Q：用WIoTa转485的DTU硬件，通过AT指令操作，经常出现发送数据失败的问题。
现象如下图：
上图中，可以看到用AT指令发送数据的时候，经常出现失败的情况。同时，原本发送指令过程中模组回复的符号">"也未能正确接收。经常收到“非法指令”的提示。
A: 这是由于硬件电路中采用了自动收发切换电路，如下图所示。但是在AT指令流程中，没有考虑到485传输的半双工模式。
在做数据发送的过程中，模组会给上位机回复“>”符号，提示模组准备好了接收数据，如果上位机在模组返回该符号的时候，正好处于数据发送状态，则485电路的收发切换会导致模组不能正常接收上位的给的数据，出现错位的情况，从而导致模组判断指令非法。
处理方法：将数据发送指令分成两个次传递，第一次传递AT+WIOTASEND，等收到模组返回的提示后，第二次再传递要发送的数据。如下图所示：
3. Q:用WIoTa同步协议部署多网关应用的话，需要注意哪些问题？
A: 多网关同区域部署的话，需要考虑频点干扰问题。
（1）建议相邻区域的网关之前频点隔离做到2MHz以上。
（2）每个网关之间的子系统ID相互区分也可以降低互相干扰的问题。
（3）如果条件允许，建议打开网关间的时钟同步功能，可以进一步降低互想之间的干扰。目前，WIoTa同步协议支持通过GPS和以太网进行时钟同步。WIoTa的AP模组自带GPS授时功能，应用部署时，需要将GPS天线引出。以太网时钟同步需要用户网关支持以太网。
4. Q: WIoTa模组有时候会有复位不成功或者不复位后功能异常的问题，如何避免？
A: 目前有一种可能是串口漏电，导至复位时，模组不能全部掉电。即在对模组进行复位期间，外部TTL串口向模组的RX口有漏电进来。
处理方法：（1）在复位前，先将与模组连接的IO口拉低，再进行复位。（2）在TTL电路中加二级管等元件，防止电流倒灌。
5. Q: 为何WIoTa做通信距离测试的时候，结果有时会有较大的差异？
A: 无线通信的距离受多种因素影响，在系统的带宽和编码等配置不变的情况下，引起结果差异的外界因素也有很多，比如：
（1）天线匹配：一般的天线有效带宽可能只在10MHz范围之内，系统设置的频点在这之外的话，会有可能造成通信结果的差异；
（2）空口噪声：如果测试期间选定频点有较高的噪声，也会影响通信测试结果。
（3）天气因素：雨天和大雾天对无线信号的传播也会有较大影响。
因此，在做通信效果测试或做应用产品时，需要充分考虑这些因素。做好应用的天线匹配，针对应用场景做好频点的选取等。
6. Q：WIoTa通信协议可以用在国外不？
A：各个国家的非授权频点资源会有差异，目前在国内WIoTa模组默认按照470~510MHz频段做的适配，各用户需要把天线选择到该频段进行应用开发。如果是在国外使用，433MHz频段相对比较普遍，同时WIoTa协议也可以支持其他Sub1GHz的频段。在出货时，需要适当调整模组上的匹配电路，有批量出货需要的客户请联系销售。
7. Q：为何我的AP配置频点是160，IoTE设置的频点是100，但是IoTE还能连上AP发送数据？
A：目前已知在12M间隔会有比较大的谐波，用户在实际部署网络的时候，应尽量避免频点间隔12M以及其整数倍的频点。
8. Q: 为何用串口连模组测试低功耗的时候，会发现经常会有误唤醒状态？固件版本为异步2.6
状态和设置如下图所示：
系统在监听几次过后，自动就启动了。
A: 造成这该问题的可能原因有几种：
（1）空口中有其他用户在发唤醒信号，且配置跟当前接收端匹配。
（2）系统配置的设置的灵敏度偏高，导致虚警率高，引起系统误唤醒。
（3）供电问题，模组上接了两个不同源的电源，可能会导致电源干扰接收，产生虚警。比如，该例中，模组电源采用的电源是直流分析仪，而为了检测串口打印，在电脑上接了USB转TTL模组，并把两个TTL模块的GND和电源GND并在一起。就出现了虚警的问题。
处理方法：
（1）根据应用需求，合理配置唤醒参数；
（2）测试时，流程电源同源的问题。
9. Q: 为何在做低功耗唤醒的时候，发送侧给了指令过后，系统未能在设置的时间内正常结束发送？固件版本异步v2.6.
现象：测试时发被唤醒侧在总次被唤醒后，再进低功耗空口唤醒状态时会马上被唤醒，经过排查发现发送侧一直处理唤醒信号发送状态，如下图所示：
发送侧给的指令如下图所示：
A: 如指令空口截图所示，用户在发送侧给指令AT+WIOTALPM=1,0这个指令时，重复输入的间隔小于AT+WIOTAPAGINGTX中给定的单次发送时长，这会导致之前的发送流程无法正常结束，系统进入持续发送状态。
处理方法：
（1）用户在该版本固件使用此功能时，注意两次唤醒指令之前的时间间隔要大于信号发送的时长。
（2）升级新版本的固件。后续固件版本会优化该逻辑，防止该状态的发生。
10. Q：使用交流电源转直流给模组供电时，需要注什么？
A：需要注意电源转换后给模组提供尽量干净的电源，目前 WIoTa评估版采用LDO提供3.3V DC电源纹波在50mV左右。应用现场的硬件条件尽量降低纹波，对射频性能会比较友好。以往案例测试发现，当3.3V电源的的纹波达到500mV时，snr会恶化10dB左右，当3.3V电源纹波在200mV左右时，snr恶化在1~2db左右。
处理方法：通过单点地、添加磁珠、共轭电感等方式，尽可能滤除电源纹波噪声。
关于纹波的介绍可参考：电源中纹波和谐振产生的原因及危害分析 - 模拟技术 - 电子发烧友网
11. Q：如果评估我的网络容量呢？同步协议的系统需要部署多少个AP?异步协议的网络单次发送需要多长时间？
A：网络容量评估需要从业务模型和无线环境等方面进行评估。其中，无线环境是指在应用实际部署场景条件下，网络覆盖的范围以及在此范围内终端的分布情况。
在终端数量确定的情况下，系统的容量取决于业务模型，比如每个终端多久要发送一次数据，每次发送数据的数据长度。附件是一个容量评估计算工具，供参考。
业务模型理论值计算_v1.6.1.zip (39.2 KB)
12. Q：通过单机连接模组时，有时候会出现，有上电复位失败的问题，导致模组不能正常工作，AT指令无响应
A：模组上电时，需要保持外部引脚没有外灌电流，不然会导致上电复位异常。对于外部有单外机连接uart引脚的情况。有几种操作方式。
（1）通过修改外部单处机的引脚状态来规避。在对模组进行上电时，把与模组串口相连的单个机引脚设置为输出状态，并输出低电平。
（2）通过模组复位引脚进行复位，把模组的RESET脚拉低可以对模组进行硬复位。
（3）通过增加保护电路来防止电流倒灌，在模组串口的RX和TX上都加上二级管，起到阻断作用。一种参考接法如下图所示：
参考二：左边是UART_TX，右边是UART_RX，VDDA和VDDB分别是各自芯片的供电电源
（4）上电过程中的电源毛刺造成芯片启动异常，该现象也常见于系统短时断电再上电无法启动。建议通过在模组外面增加复位芯片或看门狗芯片，在电源正常之前拉低模组复位脚，来强制对模组进行复位。常用的复位芯片如CN809.
13. Q: 为何烧录器有时候不能正常烧录？
A: 可能的原因有：
- 烧录器驱动丢失。由于当前驱动器驱动跟电脑USB接口绑定，所以烧录器在初始安装驱动时接入的USB接口需要作为烧录的专门接口，后续烧录如果根据USB接口，会出现不能识别的情况。处理方法是在更换的USB接口上，重新安装一次驱动。
- 模组未能正常复位，FLASH未能正常访问。现象是烧录完成后校验不通过（卡在进度92%）。处理方法是点击烧录后，手动复位一下模组。若模组在低功耗休眠状态，可点击烧录后，再给模组上电（插入烧录排线）。
注：新版本的烧录软件v3.2.0以后已经解决这个问题。
14. Q: 为何系统启动需要花100ms的时间？
A：系统启动时，默认会进行RTC校准，该过程会花费比较长的时间。在不需要精确定时的情况下，可以跳过此过程。关闭过后，系统启动时间在20ms内。
15. Q：SDK中没有设置Paging模式时开启外部中断的模式，如果要同时使用空中唤醒和外部中断的话，需要怎么操作？
A：目前，UCM200的外部唤醒可以使用CS脚、UART_RX和Wakeup脚。如果要同时使用外部唤醒和空中唤醒，可以使用CS脚拉低的方式来实现，此时不需要打开外部中断。
16. Q：为何我在IoTE上做二次开发后，做收发测试过程中，程序会自动跑死？*
串口2收到提示：
gen first data mode assert: D:/jpwang/wiota_riscv/PS/platform/adapter/src/adp_mem.c 112
A: 这个ASSERT报错是因为内存开辟失败，用户在做二次开发时，需要流程内存使用情况。
一是自己的线程中所申请的内存在用完后需要释放；
二是WIoTa在收到消息时，会申请内存，用户在自己的消息接收回调函数中，需要对内存进行释放。
17. Q：为何用异步协议测试的时候发3个字节数据时，不管目的地址设置成什么，对端都能收到消息？*
A：出现这个现象的原因是协议在当前版本下（异步v2.7）对第一个子帧没有做地址校验的动作，所以单播消息所有终端都能收到。当消息长度超过3字节后，这个现象将消失。
目前的规避方法是客户发送的数据量，不要少于3个字节。由于当前的异步单次发送的协议帧结构最小子帧数量为3个子帧，因此对于小数据的发送不会降低发送效率。
18. Q: 使用VS Code环境加scons编译AP固件时报错，无法正常编译
A：已知用scons的版本在4.5以上时会出现这个问题，是python数据类型不兼容导致。解决方案有两个。（1）用rt thread的env(版本1.2)工具来编译； （2）降低scons的版本到4.4。
19. Q：使用CS脚做唤醒休眠测试发现如果CS脚电平抖动或毛刺多的话，容易出现休眠失败的情况。
A：该问题是由于CS脚的电平毛刺的原因，有概率在进休眠时可能处于低电平状态，导致芯片被拉起休眠失败。
该问题存在于异步2.9和同步2.7及以前的版本，在二次开发过程中，使用了休眠逻辑的场景。新版本会修复该问题。
临时处理方法：
在执行休眠指令后，加入如下代码：
uc_wiota_sleep_enter(0,0);
while(REG(0x1a10a000) & (1<<27))
{
REG(0x1a10a000) |= (1<<26);
REG(0x1a10a000) &= ~(1<<1);
REG(0x1a10a000) |= (1<<1);
}
20. SPI接口调试的时候插上烧录器不通，是怎么回事？
UC8288芯片的SPI口有SPI Master和SPI Slave，这两个SPI接口在芯片引脚上有复用，而烧录器接口会使用芯片的SPI Slave接口进行程序的烧写，因此，用户在使用芯片的SPI口时，调试过程中尽量不要接烧录器，以免信号受到干扰导致SPI通信异常。
