小程序使用说明

目前 九星云仅支持微信小程序 ，其他小程序暂不支持。

打开九星云小程序的方式：

1. 在微信中搜索“九星物联网”，打开九星物联网小程序。
2. 使用微信扫描设备上的小程序码。
3. 扫描下方的小程序二维码图片。

添加设备

首先将JX-A02设备按照设备上的接线图进行接线，之后通电，等待指示灯亮起（ 红色 ）。

注意

设备上电时储能电容先进行充电储能， 首次上电大致会在10-20秒之后指示灯才亮起 ，这是正常现象！

进入小程序后点击底部tab栏 最中间的绿色加号来添加设备，支持扫码添加和手动添加 两种方式：

• 扫码添加 ：调起摄像头，扫描设备上的设备码即可完成添加。
• 手动添加：需要手动输入设备上标记的出厂编号 。

添加成功后即可在设备列表中看到刚刚添加的设备，点击此设备，即可进入设备控制页面，如下所示：

添加设备入口	首页展示	设备控制台

提示

添加设备后控制台可能会显示设备处于离线状态，等待3-5秒后下拉刷新就会变成在线，这是正常现象。

定时（布防/撤防）

JX-A02支持布防/撤防功能，在撤防状态下，设备检测到断电或缺相时，并不会产生断电以及缺相报警。同时支持设置布防和撤防时间段，也就是定时布防/撤防。

设备初次使用默认为布防状态，没有设置定时布防/撤防时间段。

在控制台点击左下角的定时按钮，进入布防设置。目前定时布防/撤防设置仅支持设置一个时间段。

报警推送设置

报警推送配置用来配置报警类型和触发报警后的推送方式。主要配置功能汇总如下：

• 报警类型：总共有四类，对应设备断电和上电以及缺相和缺相恢复。
  • 断电报警：当设备处于布防状态下，检测到设备断电了，会触发此报警。
  • 上电报警：当设备处于布防状态下，设备上电后触发此报警。
  • 缺相报警：当设备处于布防状态下，检测到设备某一电相断路了，会触发此报警。
  • 缺相恢复报警：当设备处于布防状态下，检测到设备缺相恢复后会触发此报警。
• 推送途径：当触发报警后，会按照配置的推送途径进行报警信息推送。
  • 微信推送：当设备所属的用户或被分享的用户关注了九星物联网的微信公众号后，开启微信推送消息开关，即可接受到报警消息。
  • 短信推送：设备产生报警时，会往设置的报警号码推送报警内容。报警号码要开启短信选项，支持设置多个报警号码。
  • 语音推送（拨打电话）：设备产生报警时，会往设置的报警号码拨打电话，并播放报警语音。报警号码要开启呼叫选项，支持设置多个报警号码。

提示

微信推送、短信推送和语音拨打电话推送都是属于系统资源的一种，每个用户每月都有一定的免费额度，次月重置，超出免费额度后不再推送报警消息。如果超出，需要购买资源包后才能继续接收报警推送信息。

提示

接收微信推送需要将微信绑定(可在个人信息页面查看绑定与解绑关系)，并关注九星物联网公众号，可直接在微信中搜索，或扫描下方二维码：

报警记录

设备所有触发的报警都可以在设置——>报警记录中查看到，如果配置了推送，也可在九星物联网公众号或短信记录中查看到。

高级功能

监控

设备可以绑定摄像头，实现设备监控功能。在添加设备或者编辑设备时选择要绑定的摄像头即可。之后在设置——>设备控制——>监控中即可实时预览摄像头。

提示

关于如何将摄像头添加到九星云中，请转至文档：摄像头管理

固件升级

JX-A02设备支持远程OTA（固件升级），可以在线更新设备固件。支持升级到发布的任意版本（无论是升级还是降级），可通过设置——>设备管理——>固件升级路径来到固件管理页面，之后选择想要升级的固件版本即可。

提示

无论设备是否在线，都可以进行固件升级。如果设备在线，则设备收到升级指令后直接升级，如果设备不在线，会在设备下次上线时进行升级。

设备分享

用户可以将属于自己的设备分享给其他用户一起管理，方便多人维护的场景。将设备分享给其他用户支持两种分享方式：

1. 通过微信邀请分享：用户将发送邀请信息给微信用户/微信群，该邀请连接在2小时内有效，支持多人同时接收邀请。
2. 九星云帐号分享：用户输入其他用户的九星云帐号，无需被邀请人接受，直接完成分享。

设备分享功能的进入路径为：设置——>设备管理——>设备分享

分享给其他用户时，支持权限控制。如果什么权限都没有开放，被分享的用户只能查看，不能进行操作。扩展权限如下所示：

• 设备控制：打开此开关，被分享的用户可以对设备有控制权限，例如设置布防状态、定时布防、设备升级等。
• 设备编辑：拥有此权限，被分享的用户可以编辑设备的信息，例如对设备名称进行更改。

提示

如果设备是分享来的，会有一个特殊的绿色小人标志哦！

设备日志

设备在运行过程中所产生的日志可以通过设置——>设备管理——>设备日志来查看。

上报第三方平台

提示

基础使用可以无需关注此功能。

上报第三方平台功能用于将JX-A02的数据信息上报给第三方服务器，目前支持三种最通用的协议：TCP协议（客户端模式）、UDP协议（客户端模式）以及MQTT协议。

JX-A02设备支持同时以不同协议上报到多个服务器，最多支持同时往6个服务器上报。上报第三方平台主要的数据有四类：

1. 断电包：这个是核心功能，设备检测到断电，并且处于布防状态下，会根据配置往第三方平台发送断电包的内容，第三方平台可以根据此数据来获悉设备断电了。
2. 数据包：设备按照周期（或数据变化时）往平台上报的内容。通过插值方式可以将设备的所有信息和状态上报给第三方平台。
3. 注册包：设备与第三方平台连接成功后，发送的一包数据包。主要用于TCP和UDP协议下的设备认证，对于MQTT协议，可以通过ClientID以及用户名和密码来进行认证。
4. 心跳包：仅在TCP和UDP协议有效，用于维持连接，MQTT协议无此功能。当然，心跳包中也可以通过插值的方式来携带设备数据。

关于上述所说的插值以及可选插值详见文档：可选插值

TCP 上报配置

• 服务器地址：第三方服务器的IP 地址或域名。
• 端口号：第三方服务器的端口号。
• 心跳包：每隔一段时间（心跳间隔）向服务器发送一包心跳包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 心跳间隔：心跳包发送的时间间隔。
• 注册包：设备第一次连接上 TCP 服务器时发送一包注册包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 断电包：设备检测到断电，并且处于布防状态下会发送一包注册包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 上报内容：纯文本格式，支持插值输入，详见可选插值。
• 上报周期：上报内容定时上报的周期间隔时间，单位：秒。
• KeepAlive：TCP协议的KeepAlive字段，默认为0，通常不用配置，如需配置，建议配置值在600秒以上。
• 空闲重连：当超过配置的时间没有数据通信时，重新建立TCP连接，默认为0，表示不启用。
• 启用SSL：是否启用SSL加密传输。

UDP 上报配置

• 服务器地址：第三方服务器的IP 地址或域名。
• 端口号：第三方服务器的端口号。
• 心跳包：每隔一段时间（心跳间隔）向服务器发送一包心跳包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 心跳间隔：心跳包发送的时间间隔。
• 注册包：设备入网后往 UDP 服务器发送一包注册包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 断电包：设备检测到断电，并且处于布防状态下会发送一包注册包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 上报内容：纯文本格式，支持插值输入，详见可选插值。
• 上报周期：上报内容定时上报的周期间隔时间，单位：秒。

MQTT 上报配置

• 服务器地址：第三方服务器的IP 地址或域名。
• 端口号：第三方服务器的端口号。
• ClientID：MQTT连接时的ClientID，不填写默认采用设备的IMEI号。
• username：MQTT连接时的用户名
• password：MQTT连接时的密码
• 注册包：MQTT连接成功后发送的第一包数据，内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 断电包：设备检测到断电，并且处于布防状态下会发送一包注册包。内容支持纯文本/16 进制还有插值等方式输入，详见可选插值。
• 上报内容：纯文本格式，支持插值输入，详见可选插值。
• 上报周期：上报内容定时上报的周期间隔时间，单位：秒。
• 心跳间隔：MQTT维持长连接的心跳包发送间隔，即KeepAlive时间间隔。
• 接收超时：MQTT接收服务器下发数据包超时时间。
• 订阅主题：MQTT订阅的消息主题，支持通配符。
• 发布主题：MQTT发布的消息主题，支持通配符。
• QoS级别：MQTT消息质量级别，支持0、1和2三种级别。默认为0。
• retain：是否为retain消息。
• 遗嘱消息：客户端断开连接时发送的消息。
• 会话标志位：即Clean Session功能，该功能是用来控制会话状态生命周期的标志位，为 true 时表示创建一个新的会话，在客户端断开连接时，会话将自动销毁。为 false 时表示创建一个持久会话，在客户端断开连接后会话仍然保持，直到会话超时注销。
• SSL：是否启用更安全的SSL加密传输，注意：此功能需要服务器支持。
• SSL证书：当启用SSL并且需要客户端校验证书时，需要配置证书内容。

TCP上报示例	UDP上报示例	MQTT上报示例

第三方平台控制

尽管上报的数据包是可以使用任意格式，里面的内容也是可以任意填写，但是如果第三方平台想要控制设备，则必须发送JSON格式的控制数据，JX-A02所支持的控制数据点如下：

字段	含义	说明
buzzer	警笛（蜂鸣器）控制	0——关闭警笛；1——打开警笛。打开警笛后蜂鸣器长鸣
guard	布防/撤防状态控制	0——撤防；1——布防

设备续费