ThingsCloud

https://www.thingscloud.xyz/docs/
Admin
ThingsCloud is a unified IoT device access platform that helps enterprises quickly build customized...
Tokens:694,388
Snippets:6,055
Trust Score:6.9
Update:4 months ago
Show doc for...
Tokens:
Raw
### Cloud.getDeviceInfo() Example

Source: https://www.thingscloud.xyz/docs/guide/rules/built-in-cloud-func.html

Example of reading current device information.

```javascript
{
    "id": "sw52w1ps",           // 设备 ID
    "name": "DTU-5728",         // 设备名称
    "type": "dms60h1k",         // 所属设备类型 ID
    "tags": {},                 // 设备 Tags
    "device_key": "867135052265477",    // 设备唯一标识符
    "device_code": "82595616",  // 设备码，用户可输入设备码或扫码添加设备
    "sub_device_addr": "",      // 子设备地址，仅对子设备有效。
    "sub_device_addr_hex": ""   // 子设备地址 HEX 格式，仅对 Modbus 子设备有效。
}


```

--------------------------------

### Configuration Example for Sending Properties to Devices

Source: https://www.thingscloud.xyz/docs/guide/automations/actions-overview.html

This example demonstrates how to configure an action to send properties to a device, specifically setting the brightness of an indoor light by referencing the light value from an outdoor light sensor.

```text
Action: Send Properties
Device: Indoor Light
Property: Brightness
Operation: Reference
Source Device: Outdoor Light Sensor
Source Property: Light Value

Effect: Indoor light brightness = Outdoor light sensor's light value
```

--------------------------------

### HTTP GET Request Example

Source: https://www.thingscloud.xyz/docs/basics/protocol/http-https.html

A simple HTTP GET request example, showing the request method, URL, and host.

```http
GET /index.html HTTP/1.1
Host: example.com


```

--------------------------------

### unixTimestampMills Example

Source: https://www.thingscloud.xyz/docs/guide/rules/built-in-cloud-func.html

Examples of getting Unix timestamps in milliseconds.

```javascript
Cloud.Utils.unixTimestampMills()     // 当前时间戳（毫秒），例如：1703121965000
Cloud.Utils.unixTimestampMills("2023-01-01")     // 1672502400000
Cloud.Utils.unixTimestampMills("2023-01-01 12:00")   // 1672545600000
Cloud.Utils.unixTimestampMills("2023-01-01 12:00:00")     // 1672545600000
```

--------------------------------

### Cloud.Utils.byteToBits Examples

Source: https://www.thingscloud.xyz/docs/guide/rules/built-in-cloud-func.html

Examples demonstrating the conversion of an 8-bit unsigned integer to a byte's binary sequence.

```javascript
Cloud.Utils.byteToBits(1)   // [0,0,0,0,0,0,0,1]
Cloud.Utils.byteToBits(3)   // [0,0,0,0,0,0,1,1]
Cloud.Utils.byteToBits(15)  // [0,0,0,0,1,1,1,1]
```

--------------------------------

### unixTimestamp Example

Source: https://www.thingscloud.xyz/docs/guide/rules/built-in-cloud-func.html

Examples of getting Unix timestamps in seconds.

```javascript
Cloud.Utils.unixTimestamp()     // 当前时间戳（秒），例如：1703121965
Cloud.Utils.unixTimestamp("2023-01-01")     // 1672502400
Cloud.Utils.unixTimestamp("2023-01-01 12:00")   // 1672545600
Cloud.Utils.unixTimestamp("2023-01-01 12:00:00")     // 1672545600
```

--------------------------------

### Arduino IDE Library Manager Installation

Source: https://www.thingscloud.xyz/docs/tutorials/connect-device/esp32-arduino-sdk.html

Install the ThingsCloud_ESP_SDK via the Arduino Library Manager.

```text
ThingsCloud
```

--------------------------------

### Example: Publishing Temperature and Humidity Data

Source: https://www.thingscloud.xyz/docs/guide/connect-device/mqtt.html

Example of a device publishing both temperature and humidity data for the same timestamp.

```json
[
    {"ts": 1714534200, "values": { "temperature": 22.5, "humidity": 68.3 } },
]
```

--------------------------------

### Example: Publishing Temperature Data

Source: https://www.thingscloud.xyz/docs/guide/connect-device/mqtt.html

Example of a device publishing temperature data for a specific past timestamp.

```json
[
    {"ts": 1714534200, "values": { "temperature": 22.5 } },
]
```

--------------------------------

### Example of get attribute topic with ID

Source: https://www.thingscloud.xyz/docs/guide/connect-device/mqtt.html

An example of the 'attributes/get/<id>' topic with a specific ID.

```mqtt
attributes/get/1000
```

--------------------------------

### Example 4: Lifecycle Event (Device Startup)

Source: https://www.thingscloud.xyz/docs/guide/device-manage/device-events.html

An example of a lifecycle event message reported when a device starts up or restarts.

```JSON
{
    "method": "device_startup",
    "params": {
        "firmware_version": "v2.1.0",
        "boot_reason": "power_on",
        "ip_address": "192.168.1.100",
        "rssi": -65
    }
}

```

--------------------------------

### Example: Send device code when the device boots up

Source: https://www.thingscloud.xyz/docs/guide/rules/attrs-rpt.html

This cloud function example demonstrates how to send a device code to a device upon boot-up. It checks for the 'start_ts' attribute (indicating boot time) and then uses `Cloud.getDeviceInfo()` to retrieve the device's code, which is then sent as the 'device_code' attribute.

```javascript
module.exports = function (report_attributes) {
    /**
     * report_attributes:   上报的属性对象，作为函数参数传入
     * push_attributes:     构造下发的属性对象，作为函数返回值，下发到硬件
     */
    var push_attributes = {};

    // 判断设备是否上报了开机时间戳，仅在开机时下发设备码
    if (report_attributes.start_ts !== undefined) {
        // 获取当前设备信息
        var device_info = Cloud.getDeviceInfo();
        // 将设备码下发给设备
        push_attributes.device_code = device_info.device_code;
    }

    return push_attributes;
}
```

--------------------------------

### Cloud.Utils.bitsToByte Examples

Source: https://www.thingscloud.xyz/docs/guide/rules/built-in-cloud-func.html

Examples demonstrating the conversion of a byte's binary sequence to an unsigned integer.

```javascript
Cloud.Utils.bitsToByte([0,0,0,0,0,0,0,1])   // 1
Cloud.Utils.bitsToByte([0,0,0,0,0,0,1,1])   // 3
Cloud.Utils.bitsToByte([0,0,0,0,1,1,1,1])   // 15
```

--------------------------------

### Cloud.Utils.dateStartOf

Source: https://www.thingscloud.xyz/docs/guide/rules/built-in-cloud-func.html

Gets the start time of a specified time unit.

```javascript
Cloud.Utils.dateStartOf("month", "YYYY-MM-DD HH:mm:ss")     // 2023-01-01 00:00:00
Cloud.Utils.dateStartOf("day", "YYYY-MM-DD")   // 2023-01-10
```

--------------------------------

### Read Holding Registers Request Example

Source: https://www.thingscloud.xyz/docs/basics/protocol/modbus-tcp.html

An example of a Modbus TCP request to read 3 holding registers starting from address 100.

```plaintext
00 01 00 00 00 06 01 03 00 64 00 03
```

--------------------------------

### 克隆仓库

Source: https://www.thingscloud.xyz/docs/tutorials/connect-device/esp32-micropython-sdk-tutorials.html

克隆 SDK 仓库或直接下载 Python 文件。

```bash
# 克隆仓库
git clone https://github.com/IoT-ThingsCloud/thingscloud-micropython-sdk.git

# 或直接下载 thingscloud_mqtt_lib.py 文件

```
Tokens:
Raw