me3616.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429
  1. /** ******************************************************************************
  2. * @file me3616.h
  3. * @author 度云未来 DOIOT
  4. * @brief ME3616模块AT指令简易串口驱动
  5. ******************************************************************************
  6. * @attention
  7. * <h2><center>&copy; Copyright (c) 2019 成都度云未来
  8. * All rights reserved.</center></h2>
  9. * 注意:本程序针对cubemx 生成的hal库快速开发
  10. * 环境:keil5.0
  11. * STM32Cube FW_F1 V1.8.0
  12. * 文件版本:2.30
  13. ********************************************************************************/
  14. /*硬件复位和开机的引脚宏定义*/
  15. #define PWR_IO_PORT GPIOA
  16. #define RST_IO_PORT GPIOA
  17. #define PWR_IO_PIN GPIO_Pin_0
  18. #define RST_IO_PIN GPIO_Pin_1
  19. #define config_Antiphase_flug 0 /*开机硬件电平反相使能*/
  20. //#define config_TCP_Enable 1 /*使能TCP*/
  21. #define config_Multi_channel_Tcp 0 /*多通道TCP使能*/
  22. #define config_TCP_Enable_heart 0 /*开启TCP心跳*/
  23. #define config_CEREG 0 /*定期TCP网络检查*/
  24. #define config_EPS 0 /*定期网络检查*/
  25. #define config_Check_Rest 0 /*检查和复位*/
  26. #define config_TCP_Enable_Disconn_recon 0 /*打开TCP断线重连*/
  27. //#define config_LMW2M_Enable 0 /*使能LMW2M*/
  28. #define config_ALY_MQTT_Enable 0 /*使能阿里云MQTT[需要对应的固件]*/
  29. #define config_MQTT_Enable 1 /*使能MQTT*/
  30. #define config_CHINESE_LOG 0 /*使能中文log*/
  31. /** -------------------------------调整这里以裁剪程序--------------------------------*/
  32. #define process_fifo_max_s 64 /*处理数据函数所使用的小号缓存*/
  33. #define process_fifo_max_m 64 /*处理数据函数所使用的中号缓存*/
  34. #define process_fifo_max_L 64 /*处理数据函数所使用的大号缓存*/
  35. #define SoftRest_fun 0 /*使能软件开机函数*/
  36. #define GetEPS_fun 1 /*使能EPS函数*/
  37. #define GetCSQ_fun 1 /*使能获取CSQ函数*/
  38. #define GetCCID_fun 1 /*使能获取CCID函数*/
  39. #define Hvertion_data 0 /*使能硬件信息存储栈*/
  40. #define Svertion_data 0 /*使能软件信息存储栈*/
  41. #define MAC_information 0 /*使能MAC信息存储栈*/
  42. #define IMEI_information 1 /*使能IMEI信息存储栈*/
  43. #define ICCID_information 1 /*使能ICCID信息存储栈*/
  44. #define ICCID_ME3616_INFOrmation 1
  45. #define IMEI_ME3616_INFOrmation 1
  46. /** -------------------------------API 注释------------------------------------------------------
  47. * @brief ME3616 用来声明一个句柄,本文件已经默认声明了一个全局句柄为 me3616
  48. *
  49. * 调用 ME3616_Init(); 完成初始化
  50. * TCP
  51. me3616.TCP. TCP的相关类
  52. me3616.TCP.tcp_init(); 创建一个TCP连接
  53. me3616.TCP.tcp_close(); 关闭一个TCP连接
  54. me3616.TCP.send_Str(char*); 发送ascii字符串
  55. me3616.TCP.send_Hex(char*); 发送hex字符串
  56. me3616.POWER(uint8_t flug); 硬件开机 flug =1,阻塞等待开机完成再返回,0,立即返回
  57. me3616.HRST(uint8_t flug); 硬件复位 flug =1,阻塞等待开机完成再返回,0,立即返回
  58. me3616.SRST(uint8_t flug); 软件复位 flug =1,阻塞等待开机完成再返回,0,立即返回
  59. me3616.EPS(); 打印网络状态,并更新一次标志位寄存器
  60. me3616.CSQ(); 打印信号强度,并更新一次标志位寄存器
  61. me3616.CCID(); 打印CCID,并更新一次存储寄存器
  62. me3616.PIN(); 打印PIN状态,并更新一次标志位寄存器
  63. *-------------------------------------------------------------------------------------------------*/
  64. typedef struct
  65. {
  66. #if(config_TCP_Enable)
  67. /*网络状态类*/
  68. uint8_t TCP_State; /*TCP连接状态*/
  69. #if(config_Multi_channel_Tcp)/*多通道使能*/
  70. uint8_t TCP_Socket[5];/*TCP socket 通道*/
  71. uint8_t Mult_socket_state;
  72. #else
  73. uint8_t TCP_Socket;/*TCP socket 通道*/
  74. #endif
  75. uint8_t UDP_State; /*TCP连接状态*/
  76. uint8_t UDP_Socket;/*TCP socket 通道*/
  77. uint8_t Net_init; /*网络连接状态*/
  78. #endif
  79. #if(config_MQTT_Enable)
  80. uint8_t mqtt_id;
  81. uint8_t MQTT_State;
  82. char mqtt_ip[32];
  83. char mqtt_port[6];
  84. #endif
  85. /*硬件类*/
  86. uint8_t pwr; /*开机状态*/
  87. uint8_t rssi; /*信号强度等级*/
  88. uint8_t ber; /*误码率*/
  89. uint8_t eps; /*网络状态*/
  90. uint8_t pin; /*pin状态*/
  91. int dBm; /*精确的网络信号强度*/
  92. #if(ICCID_information)
  93. char iccid[50];
  94. #endif
  95. #if(IMEI_information)
  96. char imei[50];
  97. #endif
  98. char imsi[50];
  99. #if(MAC_information)
  100. char mac[50];
  101. #endif
  102. #if(Hvertion_data)
  103. char Hvertion[50];
  104. #endif
  105. #if(Svertion_data)
  106. char Svertion[50];
  107. #endif
  108. #if(config_LMW2M_Enable)
  109. /*lwm2m的message id*/
  110. char msgid[20];
  111. #endif
  112. }ME3616_state;
  113. typedef struct{
  114. #if(ICCID_information)
  115. _Bool iccid;
  116. #endif
  117. #if(IMEI_information)
  118. _Bool imei;
  119. #endif
  120. _Bool imsi;
  121. #if(MAC_information)
  122. _Bool mac;
  123. #endif
  124. #if(Hvertion_data)
  125. _Bool Hvertion;
  126. #endif
  127. #if(Svertion_data)
  128. _Bool Svertion;
  129. #endif
  130. #if(config_MQTT_Enable)
  131. _Bool mqtt_ip;
  132. _Bool mqtt_port;
  133. #endif
  134. _Bool pwr; /*开机状态*/
  135. _Bool rssi; /*信号强度*/
  136. _Bool ber; /*误码率*/
  137. _Bool eps; /*网络状态*/
  138. _Bool pin; /*pin状态*/
  139. _Bool dBm;
  140. _Bool rest;
  141. #if defined (config_TCP_Enable_Disconnection_reconnection)
  142. _Bool tcp_recon;
  143. #endif
  144. #if(config_LMW2M_Enable)
  145. /*lwm2m的message id*/
  146. _Bool msgid;
  147. #endif
  148. }Flug;
  149. #if(config_TCP_Enable)
  150. typedef struct{
  151. /*发送一个ASCII字符串*/
  152. uint8_t (*SendStr)(char *str);
  153. /*发送一个hex字符串*/
  154. uint8_t (*SendHex)(char *str);
  155. /*开始连接TCP*/
  156. uint8_t (*CreateChannel)(char *port,char *ip);
  157. /*关闭TCP连接*/
  158. uint8_t (*CloseChannel)();
  159. uint8_t (*GetData)(uint8_t data[]);
  160. }TCP;
  161. #endif
  162. typedef struct{
  163. uint8_t (*Connect)();
  164. uint8_t (*SendStr)(char *data);
  165. }LWM2M;
  166. typedef struct{
  167. uint8_t (*Connect)();
  168. uint8_t (*SendStr)(char *data,char *topic);
  169. }ALY_MQTT;
  170. #if(config_MQTT_Enable)
  171. typedef struct{
  172. uint8_t (*SetNet)(char *ip,char *port);
  173. uint8_t (*Connect)(char *_productID,char *_deviceID,char *_secret);
  174. uint8_t (*Sub)(char * topic);
  175. uint8_t (*Pub)(char * topic,char *data, uint32_t len);
  176. }MQTT;
  177. #endif
  178. typedef struct
  179. {
  180. #if(config_LMW2M_Enable)
  181. /*和LWM2M相关操作的句柄*/
  182. LWM2M LWM2M;
  183. #endif
  184. #if(config_TCP_Enable)
  185. /*和TCP相关操作的句柄*/
  186. TCP TCP;
  187. #endif
  188. #if(config_MQTT_Enable)
  189. MQTT MQTT;
  190. #endif
  191. void (*imei_iccid_get)(char *imei, char *iccid);
  192. #if(config_ALY_MQTT_Enable)
  193. ALY_MQTT ALY_MQTT;
  194. #endif
  195. /*全部标志位的句柄*/
  196. ME3616_state State;
  197. /*装载位装载记录的标志位*/
  198. Flug flug;
  199. /*硬件开机函数指针*/
  200. uint8_t (*PowerOn)(uint8_t flug);
  201. /*硬件复位函数指针*/
  202. uint8_t (*HardRest)(uint8_t flug);
  203. #if(SoftRest_fun)
  204. /*软件复位函数指针*/
  205. uint8_t (*SoftRest)(uint8_t flug);
  206. #endif
  207. #if(GetEPS_fun)
  208. /*获取网络状态并打印的函数指针*/
  209. uint8_t (*GetEPS)();
  210. #endif
  211. #if(GetCSQ_fun)
  212. /*获取网络强度并打印的函数指针*/
  213. uint8_t (*GetCSQ)();
  214. #endif
  215. /*获取精确网络强度并打印的函数指针*/
  216. int (*GetCESQ)();
  217. #if(GetCCID_fun)
  218. /*获取CCID的函数指针*/
  219. uint8_t (*GetCCID)();
  220. #endif
  221. /*获取PIN状态的函数指针*/
  222. uint8_t (*GetPIN)();
  223. #if(IMEI_information)
  224. /*获取IMEI状态的函数指针*/
  225. uint8_t (*GetIMEI)();
  226. #endif
  227. #if(Svertion_data)
  228. /*获取软硬件版本*/
  229. uint8_t (*Version)();
  230. #endif
  231. }ME3616;
  232. extern ME3616 me3616;
  233. /** @brief ME3616句柄的构造函数*/
  234. ME3616 * ME3616_Init(void);
  235. #if defined (config_Check_Rest)
  236. uint8_t ME3616_Check_State(void);
  237. #endif
  238. /** @brief ME3616硬件开机,flug=1,阻塞等待,flug=0,立即返回*/
  239. uint8_t ME3616_Power_On(uint8_t flug);
  240. /** @brief ME3616硬件复位,flug=1,阻塞等待,flug=0,立即返回*/
  241. uint8_t ME3616_HARD_Rest(uint8_t flug);
  242. /** @brief ME3616软件复位,flug=1,阻塞等待,flug=0,立即返回*/
  243. uint8_t ME3616_SOFT_Rest(uint8_t flug);
  244. /** @brief 读取网络状态并打印相关数据,会返回模组第二位的状态位<state>*/
  245. uint8_t ME3616_READ_EPS(void);
  246. /** @brief ME3616读取网络信号强度*/
  247. uint8_t ME3616_READ_CSQ(void);
  248. /** @brief ME3616读取精确的网络信号强度* */
  249. int ME3616_READ_CESQ(void);
  250. /** @brief ME3616读取SIM卡的CCID */
  251. uint8_t ME3616_READ_CCID(void);
  252. /** @brief ME3616查询pin状态* @param return 1 为ready,0 其他* */
  253. uint8_t ME3616_READ_PIN(void);
  254. #if(IMEI_information)
  255. /** @brief ME3616查询IMEI状态*/
  256. uint8_t ME3616_READ_IMEI(void);
  257. #endif
  258. /**
  259. * @brief ME3616查询软硬件版本*/
  260. uint8_t ME3616_READ_Revision(void);
  261. void ME3616_IMEI_ICCID_INFO_GET(char *imei, char *iccid);
  262. #if(config_TCP_Enable)
  263. /**
  264. * @brief ME3616关闭一个套接字
  265. * @param socket:套接字的句柄编号
  266. * */
  267. uint8_t ME3616_Close_Socket(uint8_t socket);
  268. /**
  269. * @brief ME3616关闭一个套接字[内部调用]* */
  270. uint8_t Close_TCP_Socket(void);
  271. /** @brief ME3616创建一个套接字*/
  272. uint8_t ME3616_Create_Socket(int IPvX,int TCP_UDP,int protocol);
  273. /** @brief ME3616连接到一个Socket*/
  274. int ME3616_Connect_Socket(uint8_t socket,char *port,char *ip);
  275. /**
  276. * @brief ME3616创建一个TCP连接*/
  277. uint8_t ME3616_Connect_TCP(char *port,char *ip);
  278. /**
  279. * @brief ME3616调用TCP通道发送一条ASCII数据*/
  280. uint8_t ME3616_TCP_SEND_String(char *str);
  281. /**
  282. * @brief ME3616调用TCP通道发送一条十六进制数据*/
  283. uint8_t ME3616_TCP_SEND_Hex(char *str);
  284. /**
  285. * @brief ME3616非透传下的数据进行提纯*/
  286. uint8_t ME3616_TCP_DATA_purification(uint8_t data[]);
  287. #endif
  288. /*-----------------------------------------------------------------------------------*/
  289. /** @brief ME3616创建一个LWM2M协议的object*/
  290. uint8_t ME3616_LWM2M_CREATE(void);
  291. /** @brief ME3616 LWM2M协议发起observe请求 */
  292. uint8_t ME3616_LWM2M_LADD(void);
  293. /**@brief ME3616 LWM2M协议开始连接服务器【这个函数会阻塞较长时间】*/
  294. uint8_t ME3616_LWM2M_OPEN(void);
  295. /**@brief ME3616 LWM2M 去注册*/
  296. uint8_t ME3616_LWM2M_CLOSE(void);
  297. /** @brief ME3616 [LWM2M协议] 删除OneNET instance */
  298. uint8_t ME3616_LWM2M_MIPLDELETE(void);
  299. /** @brief ME3616 [LWM2M协议] 连接ONENET服务器* */
  300. uint8_t ME3616_LWM2M_Connect(void);
  301. /** @brief ME3616 [LWM2M协议] 发送一条数据 */
  302. uint8_t ME3616_LWM2M_Send(char *data);
  303. /** @brief ME3616打印套接字错误码*/
  304. void ESOERR_PRINT(int code);
  305. /*-----------------------------------------------------------------------------------*/
  306. #if (config_ALY_MQTT_Enable)
  307. /** @brief 配置阿里云MQTT三元组*/
  308. uint8_t Configuration_ALY_MQTT(char *ProductKey,char *appdemo,char *DeviceSecret);
  309. /** @brief ME3616 连接阿里云MQTT*/
  310. uint8_t Connect_ALY_MQTT(void);
  311. #endif
  312. /*-----------------------------------------------------------------------------------*/
  313. #if(config_MQTT_Enable)
  314. /** @brief ME3616设置MQTT的服务器端口和ip地址*/
  315. uint8_t MQTT_Set_Net(char *ip,char *port);
  316. /** @brief ME3616使用三元组连接MQTT服务器*/
  317. uint8_t MQTT_Connet(char *_productID,char *_deviceID,char *_secret);
  318. uint8_t MQTT_SUB(char * topic);
  319. uint8_t MQTT_PUB(char * topic,char *data, uint32_t len);
  320. #endif
  321. /*-----------------------------------------------------------------------------------*/
  322. #define ME3616_INFO(fmt,arg...) printf("<<-ME3616 INFO->> [%d]"fmt"\r\n",__LINE__, ##arg)//trace_otp_trace1(uart_msg_send, 4, fmt, ##arg);
  323. //printf("<<-EEPROM-INFO->> "fmt"\n",##arg)
  324. #define ME3616_ERROR(fmt,arg...) printf("<<-ME3616-ERROR->> [%d]"fmt"\r\n",__LINE__, ##arg)
  325. #define ME3616_DEBUG(fmt,arg...) do{\
  326. if(EEPROM_DEBUG_ON)\
  327. printf("<<-ME3616-DEBUG->> [%d]"fmt"\r\n",__LINE__, ##arg);\
  328. }while(0)