高级功能
透传自定义数据
◆可透传任意格式自定义数据，请与app开发者自行约定
iot\_s32 iot\_tx\_data \( iot\_u32\* data\_seq,iot\_u8\* data,iot\_u32 data\_len \)
| 参数 | 说明 |
|---|---|
| data_seq | 传出参数，本条数据的序列号，如果需要确定数据何时上传成功，可记录此发送序列号，与收到的进行对比。 |
| data | 自定义字符，支持字符串、二进制数据，特殊字符数据 |
| data_len | 自定义数据长度 |
| 返回值 | 0 ：成功；-1：失败 |
接收自定义数据
◆接收来自app的透传数据，格式请与app开发者自行约定
◆回调函数中不可执行太多耗时代码。
void iot\_rx\_data\_cb \( iot\_u8\* data,iot\_u32 data\_len \)
| 参数 | 说明 |
|---|---|
| data | 自定义数据，仅支持字符型 |
| data_len | 自定义数据长度 |
| is_app | 表示数据是否是APP发送来的，1表示是APP发送的，0表示不是。 |
上传数据（极速版本）
◆功能和4.1差不多，因为BLE MESH是针对小数据量的网络协议，如果使用4.1的接口对于非代理节点的设备传输数据有很大的延迟，因此如果对于速度要求比较高的功能建议使用极速版本。
◆极速版本一次只能上传一个数据点的数据
◆目前支持的类型包括整数型、布尔型、枚举型、浮点型。
iot\_s32 iot\_ble\_mesh\_fast\_tx\_dp\_data\( iot\_u8 dp\_id,const iot\_u8\* data,iot\_u32 data\_len \);
| 参数 | 说明 |
|---|---|
| dp_id | 数据点 |
| data | 该数据点的具体内容 |
| data_len | 数据长度 |
接收数据（极速版本）
◆功能和4.3差不多，其他请参考5.3说明
void iot\_ble\_mesh\_fast\_rx\_dp\_data \( iot\_u8 dp\_id,iot\_u8\* data,iot\_u32 data\_len,iot\_u8 is\_app \);
| 参数 | 说明 |
|---|---|
| dp_id | 数据点 |
| data | 该数据点的具体内容 |
| data_len | 数据长度 |
| is_app | 表示数据是否是APP发送来的，1表示是APP发送的，0表示不是。 |
发布数据（极速版本）
◆功能和4.2差不多，其他请参考5.3说明
iot\_s32 iot\_ble\_mesh\_fast\_publish\_dp\_data \( iot\_u8 dp\_id,const iot\_u8\* data,iot\_u32 data\_len \);
| 参数 | 说明 |
|---|---|
| dp_id | 数据点 |
| data | 该数据点的具体内容 |
| data_len | 数据长度 |
保存数据至本地
iot\_s32 iot\_local\_save \( iot\_u32 data\_len, const void \* data \)
| 参数 | 说明 |
|---|---|
| data_len | 自定义数据长度，范围1-4064 |
| data | 需要保存的自定义数据 |
| 返回值 | 0 ：成功；-1：失败 |
加载本地数据
iot\_s32 iot\_local\_load \( iot\_u32 data\_len, void \* data \)
| 参数 | 说明 |
|---|---|
| data_len | 需要加载的数据长度，需小于实际保存的数据长度 |
| data | 需要加载的自定义数据 |
| 返回值 | 0 ：成功；-1：失败，加载数据出错或data_len大于实际数据长度 |
清空本地数据
iot\_s32 iot\_local\_reset \( void \)
| 参数 | 说明 |
|---|---|
| 返回值 | 0 ：成功；-1：失败 |