常见问题

本文介绍了在涂鸦 IoT 开发平台产品创建开发流程和模组调试过程中，您可能经常遇到的问题及排查解决思路，及平台提供的功能和反馈入口。

涂鸦 IoT 开发平台使用相关

怎么使用虚拟设备调试？

虚拟设备调试是指需求沟通前期，没有实际设备时，通过智能生活 App 在云端启动虚拟设备做功能验证和效果展示的一种调试方案。具体操作步骤如下：

1. 登录 涂鸦 IoT 开发平台产品列表。
2. 选择一款 开发中 的产品，单击 操作 列中的 进入开发。
3. 根据页面指引，选择 设备调试 进入调试页面。
4. 页面内找到 虚拟设备列表，单击 新增虚拟设备调试，使用智能生活 App 扫描二维码，添加虚拟设备。
   
5. 进入 设备调试 页面，根据页面显示模拟设备 DP 上报，配合虚拟设备面板可以完成简单功能调试。
   

怎么获取设备日志？

调试或使用过程出现设备控制指令异常的情况，可以先在涂鸦 IoT 开发平台的设备日志页面查询设备信息，初步确认下上报和下发信息是否正确。操作步骤如下：

1. 登录 涂鸦 IoT 开发平台产品列表。

2. 选择一款 开发中 的产品，单击 操作 列中的 设备日志。

   

3. 根据页面指引，输入设备 ID 进行搜索。

   
   设备日志查询只适用于当前涂鸦 IoT 账号下的产品，且必须完成配网后使用设备 ID 进行查询，免费版本的日志查询功能只支持查询 7 天内产生的日志。

产品功能相关

产品功能有哪些分类，是什么？

• 标准功能：标准功能是指该类别产品支持的常用功能。

• 自定义功能：若所需的产品功能不在标准功能内，可以通过自定义功能实现。

• 云功能：目前支持的云功能包括云定时和网页跳转功能。

什么是产品多语言？怎么管理？

根据产品目标销售区域的语言，自行配置该产品的多语言 App 界面文案，包括产品名称、产品功能、设备面板、配网引导、设备消息推送、固件升级等相应的文案。详情请参考 多语言管理。

如何推送设备的告警消息和状态信息？

自定义产品的告警条件，实时监控产品状态。运行产品时，如果某项功能的值超出常规状态，或者您需要通知用户某些实时信息时，即可第一时间将消息触达用户，保障产品正常运行。详情请参考 推送设备消息。

如何设置设备配网信息？

设置产品的配网信息，设计一个 PID 维度的配网二维码。详情请参考 设置配网信息。

怎么添加 App 快捷开关？

介绍了产品的快捷开关配置和常用功能配置的操作方式。配置后，能方便 App 用户快捷控制设备。详情请参考 设置快捷开关。

怎么配置场景联动？

自定义设置功能点是否支持智能场景触发条件以及执行任务。详情请参考 配置场景联动。

涂鸦有哪些测试方式？

涂鸦提供了云测 App 方式和自行测试的方式。详情请参考 测试服务。

调试问题相关

模组日志使用

模组日志是指模组运行固件过程中的记录，也称为 Log，通过 Log 可以知道模组运行过程中的操作记录，如果模组工作出现异常问题，也能通过 Log 中的错误代码及相关记录进行分析。抓取异常问题发生的完整 Log 并做分析是常见的问题解决思路。

模组上电工作后，通过模组的日志打印口可输出模组运行日志，日志打印口符号一般是 Log_TXD，具体脚位参考对应模组规格书。日志打印配置如下，常见波特率：115200 或 74880。数据位：8 位。停止位：1 位。无校验，无流控，如下图显示。

配网失败排查思路

• 请检查设备是否正常通电并开机。
• 请确保设备处在待配网状态下(检查 MCU 与模组的串口交互信息，确认信息正确)。
• 请登录 涂鸦 IoT 开发平台 检查产品开发流程中的硬件开发，确保有选择模组及固件信息。
• 请确认设备所在网络环境信号强并且稳定。排查办法：将手机或者 iPad 与待配网设备置于同一个局域网络下，并将手机或 iPad 放到设备边上，尝试打开网页，查看浏览是否流畅稳定。
• 如果网络正常，但是设备配网失败，请确认路由器是否过载。可以尝试关闭某个设备的 Wi-Fi 功能空出通道重新配置
• 请确认输入的路由器密码是否正确，注意 Wi-Fi 账号或者是密码前后是否有空格和大小写问题。
• Wi-Fi 需要开启广播，不可设置为隐藏，并且确保是使用 2.4G 的 Wi-Fi 频段添加设备。（检查 2.4G 频段和 5G 频段是否共用为一个 Wi-Fi 账号，如果是，建议修改为不同的账号，并在配网时更改为 2.4G 频段的网络。）
• 确保路由器无线设置中加密方式为 WPA2-PSK 类型，认证类型为 AES，或两者皆设置为自动。无线模式不能为 11n only。
• 若路由器开启无线 MAC 地址过滤，可尝试将设备移出路由器的 MAC 过滤列表，保证路由器没有禁止设备联网，或者关闭 MAC 地址过滤。
• 确保路由器开启了 DHCP 服务，没有开启的话会导致 IP 地址被占用。

上报失败排查思路

• 请检查设备是否正常开机工作，且连接到网络。
• 请检查设备上报信息格式是否正确，数据格式参考 状态数据单元。
• 如果有在平台修改过 DP 功能，请确认设备移除重新配网使用。
• 请检查上报数据是否是连续同一 DP 的数据，是的话需联系涂鸦内部人员开通免过滤语法或改用同步上报指令上报。

服务与支持

服务与支持 属于涂鸦的智能服务体系，旨在全面提升服务质量与服务效率。其中 技术工单 作为平台沟通工具，为您使用平台保驾护航。当您在了解涂鸦、产品方案制定或开发等任何阶段遇到问题，技术支持团队都会为您提供专业的支持。同时，您可以在这里及时查看问题的处理进展，确保问题处理进度可跟踪，历史已处理问题可追溯。

• 文档中心：覆盖了从产品开发到量产销售的帮助文档，一站式解决您的各类问题。
• 帮助中心：针对产品开发及日常使用，提供颗粒度更细的点对点问答。
• 平台公告：各类重要平台公告。
• 智能客服：涂鸦智能机器人。
• 技术工单：针对所选择的问题类型配备了相应的技术团队解答。
• 在线客服：您可在此与智能客服、人工沟通希望加急的工单 ID 及加急原因。