1、简介 Tuya MCU SDK Arduino Library 基于涂鸦Wi-Fi 通用对接方案进行开发的，设备 MCU 通过串口与 Wi-Fi 模组连接实现设备联网。涂鸦模组中的固件应为通用固件，通用固件支持9600，115200两种波特率自适应。 [![/uploads/article/20230314/ac43e2017f72f3792134446a766487b8.png](https://static.developers.pub/fd20b8838af74be5aec7fd57d0ec5295 "/uploads/article/20230314/ac43e2017f72f3792134446a766487b8.png")](http://mvry.cn/uploads/article/20230314/ac43e2017f72f3792134446a766487b8.png) > 注意点： > 涂鸦模块的开发方式，据说后期可以单独模块开发。 > 串口通讯 ##### 2、配置Arduino环境 2.1 下载Arduino sdk ### 方式一： > https://gitee.com/ant_onio/tuya-wifi-mcu-sdk-arduino-library [点击下载](https://gitee.com/ant_onio/tuya-wifi-mcu-sdk-arduino-library)[](https://gitee.com/ant_onio/tuya-wifi-mcu-sdk-arduino-library)[![/uploads/article/20230314/d0143de768ec980e69ac3cd059ddabcb.png](https://static.developers.pub/1a45f4650bba4d929ee88535ee025890 "/uploads/article/20230314/d0143de768ec980e69ac3cd059ddabcb.png")](http://mvry.cn/uploads/article/20230314/d0143de768ec980e69ac3cd059ddabcb.png) > > 解压到自己的电脑路径（此电脑->文档->Arduino->libraries） ## 方式二（推荐）： Arduino IDE -> 工具 -> 管理库 -> 搜索 tuya-> 安装最新版本 [![/uploads/article/20230314/adbb712144e10704ef18f7587794fba2.png](https://static.developers.pub/4314c1c8a6d8492f99d402108fe613bd "/uploads/article/20230314/adbb712144e10704ef18f7587794fba2.png")](http://mvry.cn/uploads/article/20230314/adbb712144e10704ef18f7587794fba2.png) 3、剖析SDK 记住一点，这种方式是mcu + module 串口通信开发方式> · 简单来说，肯定数据是不断处理串口通信，那么从另外一个点来说就是模组已经内置了串口协议数据处理逻辑。博哥大概代码看了一下： [![/uploads/article/20230314/dd287a91376cf3ff1789ad5082cf1a6c.png](https://static.developers.pub/6e601a8c1a944ad1a5a5b5901da92564 "/uploads/article/20230314/dd287a91376cf3ff1789ad5082cf1a6c.png")](http://mvry.cn/uploads/article/20230314/dd287a91376cf3ff1789ad5082cf1a6c.png) 3.1 TuyaUart —— 处理和模组进行串口通信（了解即可）class TuyaUart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
public:
// 主要是定义串口通信buffer缓存大小
volatile unsigned char wifi_uart_rx_buf[PROTOCOL_HEAD + WIFI_UART_RECV_BUF_LMT]; //Serial data processing buffer
volatile unsigned char wifi_uart_tx_buf[PROTOCOL_HEAD + WIFIR_UART_SEND_BUF_LMT]; //Serial receive buffer
volatile unsigned char wifi_data_process_buf[PROTOCOL_HEAD + WIFI_DATA_PROCESS_LMT]; //Serial port send buffer

TuyaUart(void);~TuyaUart(void);
void wifi_protocol_init(void);

// 接收数据
unsigned char uart_receive_input(unsigned char data);
void uart_receive_buff_input(unsigned char value[], unsigned short data_len);
unsigned char take_byte_rxbuff(void);
unsigned char with_data_rxbuff(void);

// 传输发送数据
void uart_transmit_output(unsigned char value);
void wifi_uart_write_data(unsigned char *in, unsigned short len);
void wifi_uart_write_frame(unsigned char fr_type, unsigned char fr_ver, unsigned short len);
unsigned short set_wifi_uart_byte(unsigned short dest, unsigned charbyte);
unsigned short set_wifi_uart_buffer(unsigned short dest, const unsigned char *src, unsigned short len);

/* serial set */
bool _isHWSerial;

// 串口设置
void set_serial(HardwareSerial *serial);
void set_serial(SoftwareSerial *serial);
void begin(long baud_rate);
charread(void);
size_t write(char value);
int available(void);

private:
volatile unsigned char *rx_buf_in;
volatile unsigned char *rx_buf_out;
Stream *_port;
};

3.2 TuyaTools —— 工具类方法（了解即可）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
classTuyaTools
{
public:
TuyaTools(void);
~TuyaTools(void);

unsignedcharhex_to_bcd(unsignedchar Value_H, unsignedchar Value_L);
// 计算字符串长度
unsigned long my_strlen(unsigned char *str);
// 设置字符串
void *my_memset(void *src, unsigned char ch, unsigned short count);
// 内存拷贝
void *my_memcpy(void *dest, const void *src, unsigned short count);
// 字符串拷贝
char *my_strcpy(char *dest, const char *src);
// 字符串对比
int my_strcmp(char *s1, char *s2);
// int 转字节数组
void int_to_byte(unsigned long number, unsigned char value[4]);
// 字节数组 转int
unsigned long byte_to_int(const unsigned char value[4]);
unsigned char get_check_sum(unsigned char *pack, unsigned short pack_len);

private:
};

3.3 TuyaDataPoint —— 处理数据节点（上传、下发）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
classTuyaDataPoint
{
public:
// TuyaDataPoint(void);
// ~TuyaDataPoint(void);
// 下发节点数据
unsigned charmcu_get_dp_download_bool(const unsigned charvalue[], unsigned short len);
unsigned charmcu_get_dp_download_enum(const unsigned charvalue[], unsigned short len);
unsigned long mcu_get_dp_download_value(const unsigned charvalue[], unsigned short len);

// 上报节点数据
unsigned charmcu_dp_raw_update(unsigned chardpid, const unsigned charvalue[], unsigned short len);
unsigned charmcu_dp_bool_update(unsigned chardpid, unsigned charvalue);
unsigned charmcu_dp_value_update(unsigned chardpid, unsigned long value);
unsigned charmcu_dp_string_update(unsigned chardpid, const unsigned charvalue[], unsigned short len);
unsigned charmcu_dp_enum_update(unsigned chardpid, unsigned charvalue);
unsigned charmcu_dp_fault_update(unsigned chardpid, unsigned long value);

private:
};

注意区分一下数据类型。 DP为 Data Point 的缩写，即数据点，偶尔被称为 DP 点，表示智能设备所具备的功能点。 > · 涂鸦智能将每个功能点抽象成数据点，数据点定义成不同的类型，例如布尔、枚举、数值等。 > · 数据点具备读写属性。例如，一个两路的开关，可以抽象成两个数据点，每个数据点类型为布尔型，可取值为 True 或 False。 > · 数据点可读写，读表示获取开关目前的值，写表示改变开关目前的值。 DPID:指定通信协议下 DP 事件的 ID。节点类型：

1
2
3
4
5
6
#defineDP_TYPE_RAW 0x00//RAW type
#defineDP_TYPE_BOOL 0x01//bool type
#defineDP_TYPE_VALUE 0x02//value type
#defineDP_TYPE_STRING 0x03//stringtype
#defineDP_TYPE_ENUM 0x04//enum type
#defineDP_TYPE_BITMAP 0x05//fault type

3.4 TuyaWifi —— 处理wifi网络相关操作，重点内容在Arduino中使用该库进行编程开发时，必须在你的Arduino工程文件中包含 TuyaWifi.h 头文件。一般很多sdk的开发方式都是： > 1、创建对象构造方法 > 2、初始化 init > 3、回调配置、信息注册 register、callbackHandler > 4、不断轮询处理响应 3.4.1 unsigned char TuyaWifi::init(unsigned char *pid, unsigned char *mcu_ver) —— 初始化 PID通过在 Tuya IoT平台上创建产品获取，wifi类的长度一般为16，mcu_ver 这个参数是软件的版本号。 3.4.2 void set_dp_cmd_total(unsigned char download_cmd_array[][2], unsigned char download_cmd_num) —— 配置节点在 [Tuya IoT平台](http://mvry.cn/iot.tuya.com)创建产品，获取产品DP点信息。 DP为 Data Point 的缩写，即数据点，偶尔被称为 DP 点，表示智能设备所具备的功能点。 ·涂鸦智能将每个功能点抽象成数据点，数据点定义成不同的类型，例如布尔、枚举、数值等。 · 数据点具备读写属性。例如，一个两路的开关，可以抽象成两个数据点，每个数据点类型为布尔型，可取值为 True 或 False。 · 数据点可读写，读表示获取开关目前的值，写表示改变开关目前的值。 DPID:指定通信协议下 DP 事件的 ID。 MCU SDK需要知道你创建了哪些DP点，他们是什么类型的。 3.4.3 void mcu_set_wifi_mode(unsigned char mode) —— 配网模式

1
2
3
4
5
6
7
8
/**
* @description: MCU set wifi working mode
* @param{unsigned char} mode : enter mode
* 0(SMART_CONFIG):enter smartconfig mode
* 1(AP_CONFIG):enter AP mode
* @return{*}
*/
voidTuyaWifi::mcu_set_wifi_mode(unsignedchar mode);

3.4.4 void dp_process_func_register(tuya_callback_dp_download _func) —— 下发回调注册当APP控制设备的时候，会从云端下发对应的DP命令到设备，设备对数据进行解析后，对下发的命令执行相对于的动作。对下发命令的处理，通过回调函数来调用，所以我们需要把你的处理函数注册一下。伪代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
//register DP download processing callback function
my_device.dp_process_func_register(dp_process);

/**
* @description: DP download callback function.
* @param {unsigned char} dpid
* @param {const unsigned char} value
* @param {unsigned short} length
* @return {unsigned char}
*/
unsigned char dp_process(unsigned char dpid, const unsigned char value[], unsigned short length)
{
switch (dpid) {
case DPID_BOOL:
DebugSerial.println("Bool type:");
dp_bool_value = my_device.mcu_get_dp_download_data(dpid, value, length);
DebugSerial.println(dp_bool_value);
/* After processing the download DP command, the current status should be reported. */
my_device.mcu_dp_update(DPID_BOOL, dp_bool_value, 1);
break;

case DPID_VALUE:
DebugSerial.println("Value type:");
dp_value_value = my_device.mcu_get_dp_download_data(DPID_VALUE, value, length);
DebugSerial.println(dp_value_value);
/* After processing the download DP command, the current status should be reported. */
my_device.mcu_dp_update(DPID_VALUE, dp_value_value, 1);
break;

case DPID_ENUM:
DebugSerial.println("Enum type:");
dp_enum_value = my_device.mcu_get_dp_download_data(dpid, value, length);
DebugSerial.println(dp_enum_value);
/* After processing the download DP command, the current status should be reported. */
my_device.mcu_dp_update(DPID_ENUM, dp_enum_value, 1);
break;

case DPID_STRING:
DebugSerial.println("String type:");
/* */
for (unsigned int i=0; i



这里得注意一个方法：

> mcu_get_dp_download_data （`下发DP数据处理`）

对字节数组进行数据解析。

3.4.5 mcu_dp_update —— 真正上报设备状态

1
2
3
4
5
6
7
8
9
10
11
/* char * */
unsignedcharmcu_dp_update(unsignedchar dpid, constunsignedchar value[], unsigned short len); /* char raw */
/* unsigned long / long */
unsignedcharmcu_dp_update(unsignedchar dpid, unsignedlong value, unsigned short len);
unsignedcharmcu_dp_update(unsignedchar dpid, long value, unsigned short len);
/* unsigned char / char */
unsignedcharmcu_dp_update(unsignedchar dpid, unsignedchar value, unsigned short len);
unsignedcharmcu_dp_update(unsignedchar dpid, char value, unsigned short len);
/* unsigned int / int */
unsignedcharmcu_dp_update(unsignedchar dpid, unsignedint value, unsigned short len);
unsignedcharmcu_dp_update(unsignedchar dpid, int value, unsigned short len);

基本上大同小异。注意一下dpid和数据类型即可。

3.4.6 dp_update_all_func_register —— 上报设备状态函数注册

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
#include 

TuyaWifi my_device;

#define DPID_SWITCH 20
//Record the current statusof the led
unsigned charswitch_value = 0;
...
void setup()
{
...
//register DP download processing callback function
my_device.dp_update_all_func_register(dp_update_all);
...
}

/**
* @description: Upload all DP statusof the current device.
* @param{*}
* @return{*}
*/
void dp_update_all(void)
{
my_device.mcu_dp_update(DPID_SWITCH, switch_v

3.4.7 mcu_get_wifi_work_state —— 获取wifi连接状态

3.4.8 void TuyaWifi::uart_service(void) —— 轮询串口数据

1
2
3
4
5
6
/**
* @description: Wifi serial port processing service
* @param{*}
* @return{*}
*/
void TuyaWifi::uart_service(void)

在arduino loop中调用。不断检测串口数据。

4、官方案例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
/*
* @FileName: DataPointType.ino
* @Author: Tuya
* @Email:
* @LastEditors: Tuya
* @Date: 2021-04-19 14:31:52
* @LastEditTime: 2021-04-2819:47:36
* @Copyright: HANGZHOU TUYA INFORMATION TECHNOLOGY CO.,LTD
* @Company:
* @Description:
* @Github:https://github.com/tuya/tuya-wifi-mcu-sdk-arduino-library
*/

#include 
#include 

TuyaWifi my_device;
SoftwareSerial DebugSerial(8,9);

/* Current LED status*/
unsigned charled_state = 0;
/* Connect network button pin */
int wifi_key_pin = 7;

/* Data point define */
#define DPID_BOOL 101
#define DPID_VALUE 102
#define DPID_ENUM 103
#define DPID_STRING 104
#define DPID_RAW 105
#define DPID_FAULT 106

/* Current device DP values */
unsigned char dp_bool_value = 0;
long dp_value_value = 0;
unsigned char dp_enum_value = 0;
unsigned char dp_string_value[8] = {"Hi,Tuya"};
unsigned char dp_raw_value[8] = {0x01, 0x23, 0x45, 0x67, 0x89, 0xab, 0xcd, 0xef};
int dp_fault_value = 0x01;

/* Stores all DPs andtheir types. PS: array[][0]:dpid, array[][1]:dp type.
* dp type(TuyaDefs.h) : DP_TYPE_RAW, DP_TYPE_BOOL, DP_TYPE_VALUE, DP_TYPE_STRING, DP_TYPE_ENUM, DP_TYPE_BITMAP
*/
unsigned chardp_array[][2] = {
{DPID_BOOL, DP_TYPE_BOOL},
{DPID_VALUE, DP_TYPE_VALUE},
{DPID_ENUM, DP_TYPE_ENUM},
{DPID_STRING, DP_TYPE_STRING},
{DPID_RAW, DP_TYPE_RAW},
{DPID_FAULT, DP_TYPE_BITMAP},
};

unsigned charpid[] = {"xxxxxxxxxxx"}; // 填上自己的产品ID
unsigned charmcu_ver[] = {"1.0.0"};

/* last time */
unsigned long last_time = 0;

void setup()
{
Serial.begin(9600);
DebugSerial.begin(9600);

//Initialize led port, turn off led.
pinMode(LED_BUILTIN, OUTPUT);
digitalWrite(LED_BUILTIN, LOW);

//Initialize networking keys.
pinMode(wifi_key_pin, INPUT_PULLUP);

// 三部曲 —— 初始化、配置、注册回调
//Enter the PID andMCU software version
my_device.init(pid, mcu_ver);
//incoming all DPs andtheir types array, DP numbers
my_device.set_dp_cmd_total(dp_array, 6);
//register DP download processing callback function
my_device.dp_process_func_register(dp_process);
//register upload all DP callback function
my_device.dp_update_all_func_register(dp_update_all);

last_time = millis();
}

void loop()
{
// 不断轮询
my_device.uart_service();

//Enter the connection network mode when Pin7 is pressed.
if(digitalRead(wifi_key_pin) == LOW) {
delay(80);
if(digitalRead(wifi_key_pin) == LOW) {
my_device.mcu_set_wifi_mode(SMART_CONFIG);
}
}

/* LED blinks when network is being connected */
if((my_device.mcu_get_wifi_work_state() != WIFI_LOW_POWER) && (my_device.mcu_get_wifi_work_state() != WIFI_CONN_CLOUD) && (my_device.mcu_get_wifi_work_state() != WIFI_SATE_UNKNOW)) {
if(millis() - last_time >= 500) {
last_time = millis();
/* Toggle current LED status */
if(led_state == LOW) {
led_state = HIGH;
} else{
led_state = LOW;
}

digitalWrite(LED_BUILTIN, led_state);
}
}

delay(10);
}

/**
* @description: DP download callback function.
* @param{unsignedchar} dpid
* @param {constunsignedchar} value
* @param{unsignedshort} length
* @return {unsignedchar}
*/
unsignedchardp_process(unsigned char dpid, const unsigned char value[], unsigned short length)
{
switch (dpid) {
case DPID_BOOL:
DebugSerial.println("Bool type:");
dp_bool_value = my_device.mcu_get_dp_download_data(dpid, value, length);
DebugSerial.println(dp_bool_value);
/* After processing the download DP command, the current status should be reported. */
my_device.mcu_dp_update(DPID_BOOL, dp_bool_value, 1);
break;

case DPID_VALUE:
DebugSerial.println("Value type:");
dp_value_value = my_device.mcu_get_dp_download_data(DPID_VALUE, value, length);
DebugSerial.println(dp_value_value);
/* After processing the download DP command, the current status should be reported. */
my_device.mcu_dp_update(DPID_VALUE, dp_value_value, 1);
break;

case DPID_ENUM:
DebugSerial.println("Enum type:");
dp_enum_value = my_device.mcu_get_dp_download_data(dpid, value, length);
DebugSerial.println(dp_enum_value);
/* After processing the download DP command, the current status should be reported. */
my_device.mcu_dp_update(DPID_ENUM, dp_enum_value, 1);
break;

case DPID_STRING:
DebugSerial.println("String type:");
/* */
for(unsigned int i=0; i

Tuya MCU SDK Arduino Library

Tuya MCU SDK Arduino Library

关于作者 📝

目录

评论