protocol.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525
  1. /**
  2. * @file protocol.h
  3. * @brief declaration of fuction in protocol.c
  4. * @author qinlang
  5. * @date 2022.05.06
  6. * @par email:
  7. * @par email:qinlang.chen@tuya.com
  8. * @copyright HANGZHOU TUYA INFORMATION TECHNOLOGY CO.,LTD
  9. * @par company
  10. * http://www.tuya.com
  11. */
  12. #ifndef __PROTOCOL_H_
  13. #define __PROTOCOL_H_
  14. #ifdef __cplusplus
  15. extern "C"
  16. {
  17. #endif
  18. /******************************************************************************
  19. 配置产品类别须知:
  20. 1:根据实际设计电路板,设置产品SKU,必须修改参数“switchSKU”为对应产品类别
  21. 2:根据涂鸦ZigBee固件类别,需设置对应的宏定义
  22. OTA设置须知:
  23. 1.开启OTA(需先下载“BootLoader”程序),宏定义“SUPPORT_MCU_OTA”打开,并设置编译下载环境参数
  24. 2.关闭OTA, 注释宏定义“SUPPORT_MCU_OTA”,并设置编译下载环境参数
  25. ******************************************************************************/
  26. //#define REALSE 1 // 生产模式,看门狗打开
  27. // #define BEACON_TEST 1 //开启信标产测
  28. // #define switchSKU 0x01//////产品SKU, 混合面板bit7=1;纯场景面板,bit3=1;--del by zzw 20240319,取消SKU设计以宏定义类别为准
  29. // 01:ZIGBEE-1键,02:ZIGBEE-2键,03:ZIGBEE-3键,06:ZIGBEE-6键(纯开关+混合场景)
  30. // 6键轻触系列 --通用定义
  31. //#define ZIGBEE_ZTU_T1_SW 1//一路开关,产品ID: 20bwwjts
  32. //#define ZIGBEE_ZTU_T2_SW 1//二路开关,产品ID: qjy7kox3
  33. #define ZIGBEE_ZTU_T3_SW 1//三路开关,产品ID: rereby5a
  34. //#define ZIGBEE_ZTU_T6_SCENCE_SW 1 // 6路混合场景,产品ID: m757kw7n
  35. ///< product INFORMATION
  36. ///< mcu version
  37. #ifdef ZIGBEE_ZTU_T2_SW // 希智账户,3键零火开关
  38. #define PRODUCT_KEY "lpeoucc7" // 开发平台创建产品后生成的16位字符产品唯一标识
  39. #define MCU_VER "1.0.1" // MAX 3.3.15 BIT 7~0 XX.XX.XXXX
  40. #endif
  41. #ifdef ZIGBEE_ZTU_T1_SW // 希智账户,3键零火开关
  42. #define PRODUCT_KEY "lvz4kebs" // 开发平台创建产品后生成的16位字符产品唯一标识
  43. #define MCU_VER "1.0.1" // MAX 3.3.15 BIT 7~0 XX.XX.XXXX
  44. #endif
  45. #ifdef ZIGBEE_ZTU_T6_SCENCE_SW // 希智账户,6键零火开关
  46. #define ZIGBEE_ZTU_T3_SW 1//三路开关,产品ID: rereby5a
  47. #define PRODUCT_KEY "02h4nx1r" // 开发平台创建产品后生成的16位字符产品唯一标识
  48. #define MCU_VER "1.0.1" // MAX 3.3.15 BIT 7~0 XX.XX.XXXX
  49. #else
  50. #define ZIGBEE_3SWITCH_SW 1 //3开关
  51. #endif
  52. #if (defined ZIGBEE_ZTU_T3_SW) && (defined ZIGBEE_3SWITCH_SW) // 臣仕账户,3键零火开关
  53. #define PRODUCT_KEY "azmnd8xq" // 开发平台创建产品后生成的16位字符产品唯一标识
  54. #define MCU_VER "1.0.1" // MAX 3.3.15 BIT 7~0 XX.XX.XXXX
  55. #endif
  56. #define ZIGBEE_UART_QUEUE_LMT 256 // using to save data received from uart
  57. // modified by zzw 20240126 256->128,OTA恢复
  58. #define ZIGBEE_UART_RECV_BUF_LMT 128 //
  59. #define ZIGBEE_UART_SEND_BUF_LMT 128 //
  60. typedef enum
  61. {
  62. MCU_TYPE_DC_POWER = 1,
  63. MCU_TYPE_LOWER_POWER,
  64. MCU_TYPE_SCENE
  65. } MCU_TYPE_E;
  66. /**
  67. * if mcu need to support the time function, this macro definition should be opened
  68. * and need complete mcu_write_rtctime function
  69. *
  70. */
  71. // #define SUPPORT_MCU_RTC_CHECK //start time calibration
  72. /**
  73. * if mcu need to support OTA, this macro definition should be opened
  74. */
  75. #define SUPPORT_MCU_OTA // support mcu ota
  76. // modify by zzw 20240302 开启MCU OTA功能
  77. /**
  78. * if mcu need to support mcu type checking, this macro definition should be opened
  79. *
  80. */
  81. // #define CHECK_MCU_TYPE //support mcu type check
  82. /**
  83. * if mcu need to support zigbee network parameter setting, this macro definition should be opened
  84. *
  85. */
  86. // #define SET_ZIGBEE_NWK_PARAMETER //support zigbee nwk parameter setting
  87. /**
  88. * if mcu need to send a broadcast data, this macro definition should be opened
  89. *
  90. */
  91. // #define BROADCAST_DATA_SEND //support broadcast data sending
  92. /**
  93. * DP data list,this code will be generate by cloud platforms
  94. */
  95. #ifdef ZIGBEE_ZTU_T1_SW // 希智账户,1键零火开关
  96. // 开关 1(可下发可上报)
  97. // 备注:
  98. #define DPID_SWITCH_1 1
  99. // 开关 2(可下发可上报)
  100. // 备注:
  101. #define DPID_SWITCH_2 1
  102. // 开关 3(可下发可上报)
  103. // 备注:
  104. #define DPID_SWITCH_3 3
  105. // 开关上电状态设置(可下发可上报)
  106. // 备注:
  107. #define DPID_RELAY_STATUS 14
  108. // 指示灯亮度(可下发可上报)
  109. // 备注:
  110. #define DPID_LIGHT_MODE 15
  111. // 人感开关(可下发可上报)
  112. // 备注:
  113. #define DPID_BACKLIGHT_SWITCH 16
  114. // 点动开关(延时关)(可下发可上报)
  115. // 备注:/#1通道号(bit--0开关,bit7-bit1--通道号)
  116. /// #2#3点动倒计时时间
  117. #define DPID_SWITCH_INCHING 19
  118. // 开关1上电状态设置(可下发可上报)
  119. // 备注:
  120. #define DPID_RELAY_STATUS_1 29
  121. // 开关2上电状态设置(可下发可上报)
  122. // 备注:
  123. #define DPID_RELAY_STATUS_2 30
  124. // 开关3上电状态设置(可下发可上报)
  125. // 备注:
  126. #define DPID_RELAY_STATUS_3 31
  127. //增加电量(可下发可上报)
  128. //备注:
  129. #define DPID_ADD_ELE 20
  130. //当前电流(只上报)
  131. //备注:
  132. #define DPID_CUR_CURRENT 21
  133. //当前功率(只上报)
  134. //备注:
  135. #define DPID_CUR_POWER 22
  136. //当前电压(只上报)
  137. //备注:
  138. #define DPID_CUR_VOLTAGE 23
  139. #define DPID_LIGHT_LEVEL 115
  140. #endif
  141. #ifdef ZIGBEE_ZTU_T2_SW // 希智账户,2键零火开关
  142. // 开关 1(可下发可上报)
  143. // 备注:
  144. #define DPID_SWITCH_1 1
  145. // 开关 2(可下发可上报)
  146. // 备注:
  147. #define DPID_SWITCH_2 2
  148. // 开关 3(可下发可上报)
  149. // 备注:
  150. #define DPID_SWITCH_3 2
  151. // 开关上电状态设置(可下发可上报)
  152. // 备注:
  153. #define DPID_RELAY_STATUS 14
  154. // 指示灯亮度(可下发可上报)
  155. // 备注:
  156. #define DPID_LIGHT_MODE 15
  157. // 人感开关(可下发可上报)
  158. // 备注:
  159. #define DPID_BACKLIGHT_SWITCH 16
  160. // 点动开关(延时关)(可下发可上报)
  161. // 备注:/#1通道号(bit--0开关,bit7-bit1--通道号)
  162. /// #2#3点动倒计时时间
  163. #define DPID_SWITCH_INCHING 19
  164. // 开关1上电状态设置(可下发可上报)
  165. // 备注:
  166. #define DPID_RELAY_STATUS_1 29
  167. // 开关2上电状态设置(可下发可上报)
  168. // 备注:
  169. #define DPID_RELAY_STATUS_2 30
  170. // 开关3上电状态设置(可下发可上报)
  171. // 备注:
  172. #define DPID_RELAY_STATUS_3 31
  173. //增加电量(可下发可上报)
  174. //备注:
  175. #define DPID_ADD_ELE 20
  176. //当前电流(只上报)
  177. //备注:
  178. #define DPID_CUR_CURRENT 21
  179. //当前功率(只上报)
  180. //备注:
  181. #define DPID_CUR_POWER 22
  182. //当前电压(只上报)
  183. //备注:
  184. #define DPID_CUR_VOLTAGE 23
  185. #define DPID_LIGHT_LEVEL 115
  186. //当前电流-开关2(只上报)
  187. //备注:
  188. #define DPID_CUR_CURRENT_2 116
  189. //当前功率-开关2(只上报)
  190. //备注:
  191. #define DPID_CUR_POWER_2 117
  192. //增加电量-开关2(可下发可上报)
  193. //备注:
  194. #define DPID_ADD_ELE_2 118
  195. #endif
  196. #if (defined ZIGBEE_ZTU_T3_SW) && (defined ZIGBEE_3SWITCH_SW)
  197. // #ifdef ZIGBEE_ZTU_T3_SW // 希智账户,3键零火开关
  198. // 开关 1(可下发可上报)
  199. // 备注:
  200. #define DPID_SWITCH_1 1
  201. // 开关 2(可下发可上报)
  202. // 备注:
  203. #define DPID_SWITCH_2 2
  204. // 开关 3(可下发可上报)
  205. // 备注:
  206. #define DPID_SWITCH_3 3
  207. // 开关上电状态设置(可下发可上报)
  208. // 备注:
  209. #define DPID_RELAY_STATUS 14
  210. // 指示灯亮度(可下发可上报)
  211. // 备注:
  212. #define DPID_LIGHT_MODE 15
  213. // 人感开关(可下发可上报)
  214. // 备注:
  215. #define DPID_BACKLIGHT_SWITCH 16
  216. // 点动开关(延时关)(可下发可上报)
  217. // 备注:/#1通道号(bit--0开关,bit7-bit1--通道号)
  218. /// #2#3点动倒计时时间
  219. #define DPID_SWITCH_INCHING 19
  220. // 开关1上电状态设置(可下发可上报)
  221. // 备注:
  222. #define DPID_RELAY_STATUS_1 29
  223. // 开关2上电状态设置(可下发可上报)
  224. // 备注:
  225. #define DPID_RELAY_STATUS_2 30
  226. // 开关3上电状态设置(可下发可上报)
  227. // 备注:
  228. #define DPID_RELAY_STATUS_3 31
  229. //增加电量(可下发可上报)
  230. //备注:
  231. #define DPID_ADD_ELE 20
  232. //当前电流(只上报)
  233. //备注:
  234. #define DPID_CUR_CURRENT 21
  235. //当前功率(只上报)
  236. //备注:
  237. #define DPID_CUR_POWER 22
  238. //当前电压(只上报)
  239. //备注:
  240. #define DPID_CUR_VOLTAGE 23
  241. #define DPID_LIGHT_LEVEL 115
  242. //当前电流-开关2(只上报)
  243. //备注:
  244. #define DPID_CUR_CURRENT_2 116
  245. //当前功率-开关2(只上报)
  246. //备注:
  247. #define DPID_CUR_POWER_2 117
  248. //增加电量-开关2(可下发可上报)
  249. //备注:
  250. #define DPID_ADD_ELE_2 118
  251. //当前电流-开关3(只上报)
  252. //备注:
  253. #define DPID_CUR_CURRENT_3 119
  254. //当前功率-开关3(只上报)
  255. //备注:
  256. #define DPID_CUR_POWER_3 120
  257. //增加电量-开关3(可下发可上报)
  258. //备注:
  259. #define DPID_ADD_ELE_3 121
  260. #endif
  261. #ifdef ZIGBEE_ZTU_T6_SCENCE_SW // 希智账户,6键零火开关
  262. //场景1(可下发可上报)
  263. //备注:
  264. #define DPID_SCENE_1 1
  265. //场景2(可下发可上报)
  266. //备注:
  267. #define DPID_SCENE_2 2
  268. //场景3(可下发可上报)
  269. //备注:
  270. #define DPID_SCENE_3 3
  271. //场景4(可下发可上报)
  272. //备注:
  273. #define DPID_SCENE_4 4
  274. //场景5(可下发可上报)
  275. //备注:
  276. #define DPID_SCENE_5 5
  277. //场景6(可下发可上报)
  278. //备注:
  279. #define DPID_SCENE_6 6
  280. //模式1(可下发可上报)
  281. //备注:
  282. #define DPID_MODE_1 18
  283. //模式2(可下发可上报)
  284. //备注:
  285. #define DPID_MODE_2 19
  286. //模式3(可下发可上报)
  287. //备注:
  288. #define DPID_MODE_3 20
  289. //开关1(可下发可上报)
  290. //备注:
  291. #define DPID_SWITCH_1 24
  292. //开关2(可下发可上报)
  293. //备注:
  294. #define DPID_SWITCH_2 25
  295. //开关3(可下发可上报)
  296. //备注:
  297. #define DPID_SWITCH_3 26
  298. //指示灯亮度(可下发可上报)
  299. //备注:
  300. #define DPID_LIGHT_MODE 37
  301. //上电状态设置(可下发可上报)
  302. //备注:
  303. #define DPID_RELAY_STATUS 38
  304. //开关1上电状态设置(可下发可上报)
  305. //备注:
  306. #define DPID_RELAY_STATUS_1 39
  307. //开关2上电状态设置(可下发可上报)
  308. //备注:
  309. #define DPID_RELAY_STATUS_2 40
  310. //开关3上电状态设置(可下发可上报)
  311. //备注:
  312. #define DPID_RELAY_STATUS_3 41
  313. //点动开关(延时关)(可下发可上报)
  314. //备注:
  315. #define DPID_SWITCH_INCHING 101
  316. //增加电量(可下发可上报)
  317. //备注:
  318. #define DPID_ADD_ELE 102
  319. //当前电压(只上报)
  320. //备注:
  321. #define DPID_CUR_VOLTAGE 103
  322. //当前功率(只上报)
  323. //备注:
  324. #define DPID_CUR_POWER 104
  325. //当前电流(只上报)
  326. //备注:
  327. #define DPID_CUR_CURRENT 105
  328. //增加电量-开关2(可下发可上报)
  329. //备注:
  330. #define DPID_ADD_ELE_2 106
  331. //当前电流-开关2(只上报)
  332. //备注:
  333. #define DPID_CUR_CURRENT_2 107
  334. //当前功率-开关2(只上报)
  335. //备注:
  336. #define DPID_CUR_POWER_2 108
  337. //增加电量-开关3(可下发可上报)
  338. //备注:
  339. #define DPID_ADD_ELE_3 109
  340. //当前电流-开关3(只上报)
  341. //备注:
  342. #define DPID_CUR_CURRENT_3 110
  343. //当期功率-开关3(只上报)
  344. //备注:
  345. #define DPID_CUR_POWER_3 111
  346. #define DPID_LIGHT_LEVEL 115
  347. #endif
  348. void base64_decode_three_bytes(const char input[4], unsigned char output[3]);
  349. void HexToDisHex(unsigned char *pbDest, unsigned char *pbSrc, int nLen);
  350. void DisHexToHex(unsigned char *pbDest, unsigned char *pbSrc, int nLen);
  351. /**
  352. * @brief encapsulates a generic send function, developer should use their own function to completing this fuction
  353. * @param[in] {value} send signle data
  354. * @return void
  355. */
  356. void uart_transmit_output(unsigned char value);
  357. /**
  358. * @brief Upload all dp information of the system, and realize the synchronization of APP and muc data
  359. * @param[in] {void}
  360. * @return void
  361. */
  362. void all_data_update(void);
  363. void all_power_data_update(void);
  364. /**
  365. * @brief mcu check local RTC time
  366. * @param[in] {time} timestamp
  367. * @return void
  368. */
  369. void mcu_write_rtctime(unsigned char time[]);
  370. /**
  371. * @brief Zigbee functional test feedback
  372. * @param[in] {void}
  373. * @return void
  374. */
  375. void zigbee_test_result(void);
  376. /**
  377. * @brief this function will handle uart received frame data
  378. * @param[in] {dpid} dp id
  379. * @param[in] {value} dp data
  380. * @param[in] {length} lenght of dp data
  381. * @return handle result
  382. */
  383. unsigned char dp_download_handle(unsigned char dpid, const unsigned char value[], unsigned short length);
  384. /**
  385. * @brief get received cmd total number
  386. * @param[in] {void}
  387. * @return received cmd total number
  388. */
  389. unsigned char get_download_cmd_total(void);
  390. /**
  391. * @brief received zigbee net_work state handle
  392. * @param[in] {zigbee_work_state} zigbee current network state
  393. * @return void
  394. */
  395. void zigbee_work_state_event(unsigned char zigbee_work_state);
  396. /**
  397. * @brief received reset zigbee response
  398. * @param[in] {state} response state
  399. * @return void
  400. */
  401. void mcu_reset_zigbee_event(unsigned char state);
  402. /**
  403. * @brief check mcu version response
  404. * @param[in] {void}
  405. * @return void
  406. */
  407. void response_mcu_ota_version_event(void);
  408. #ifdef SUPPORT_MCU_OTA
  409. /**
  410. * @brief mcu ota update notify response
  411. * @param[in] {offset} offset of file
  412. * @return void
  413. */
  414. void response_mcu_ota_notify_event(unsigned char offset);
  415. /**
  416. * @brief received mcu ota data request response
  417. * @param[in] {fw_offset} offset of file
  418. * @param[in] {data} received data
  419. * @return void
  420. */
  421. // void reveived_mcu_ota_data_handle(unsigned int fw_offset,char *data);
  422. /**
  423. * @brief mcu send ota data request
  424. * @param[in] {offset} offset of file
  425. * @return void
  426. */
  427. void mcu_ota_fw_request_event(unsigned char offset);
  428. /**
  429. * @brief mcu ota data result notify
  430. * @param[in] {offset} offset of file
  431. * @return void
  432. */
  433. void mcu_ota_result_event(unsigned char offset);
  434. /**
  435. * @brief mcu ota data handle
  436. * @param[in] {fw_offset} frame offset
  437. * @param[in] {data} received data
  438. * @return void
  439. */
  440. void ota_fw_data_handle(unsigned int fw_offset, char *data1, unsigned char data_len); // modified by zzw 51不允许用“data”做变量名
  441. #endif
  442. #ifdef BEACON_TEST
  443. /**
  444. * @brief beacon test notify,which used in testing
  445. * @param[in] {void}
  446. * @return void
  447. */
  448. void mcu_received_beacon_test_handle(void);
  449. #endif
  450. #ifdef CHECK_ZIGBEE_NETWORK
  451. /**
  452. * @brief check zigbee nwkstate,before start join nwk, check nwk if state is not 0x02,can start jion,
  453. * else delay 5s
  454. *
  455. * @param[in] {void}
  456. * @return void
  457. */
  458. void mcu_check_zigbee_nwk_state(void);
  459. #endif
  460. #ifdef READ_DP_DATA_NOTIFY
  461. /**
  462. * @brief when gateway repower or relink clould, or zigbee module join sucess, repower, this commod will notify
  463. * mcu, to sys dp data, mcu itself decide whether report.
  464. *
  465. * @param[in] {void}
  466. * @return void
  467. */
  468. void read_dp_data_notify_hanlde(void);
  469. #endif
  470. #ifdef __cplusplus
  471. }
  472. #endif
  473. #endif