GW-LS-RF 4G Rice Field Water Level Gauge MQTT Protocol

API Integration Guide

Link: https://s.apifox.cn/73f6516e-148e-4566-a43c-cf4e9d0b764f

Please contact the manufacturer to obtain the API login account and password.

Payload JSON Specification

Field Description

📢 Bold items represent key fields

Field	Description	Read‑Write Type	Data Type	Remarks
ICCID	SIM card serial number	Read‑only	String
VBAT	Battery voltage / controller supply voltage	Read‑only	float	Example value: 12.05V
CSTAMP	Timestamp	Read‑only	int32	Timestamp of device‑reported data
CSQ	Signal strength	Read‑only	int32	Value range: 0‑31
WLEVEL	Water level	Read‑only	int32	Water‑level value, unit: mm

Data Update Description

Default data reporting interval: 60 minutes

Uplink Data JSON

{
    "CSTAMP": 1764831240,
    "VBAT": 12.02,
    "CSQ": 27,
    "ICCID": "898608391624D1231038",
    "WLEVEL": 50
}

Direct MQTT Server Connection (IoT Platform Required)

Login Parameters

📌 Configure the following parameters into the gateway according to the device MQTT parameters provided by the docking platform.

• Client ID:
• Username:
• Password:
• Controller Uplink Publish TOPIC:
• Controller Downlink Subscribe TOPIC:
• MQTT Server Address:
• MQTT Port:

Configure the above parameters into the smart gateway.

After configuration, the device will be shown as online on the platform.

Uplink JSON Format Reference (Sent via Uplink Publish TOPIC)

After going online, the gateway sends uplink JSON data through the uplink publish topic. The platform shall parse data according to the field definitions and uplink JSON sample.

Example: To check signal strength, the uplink publish topic is: 925089001 The platform receives JSON data via topic 925089001. The CSQ field in the thing‑model represents signal strength with a value of 29; parse other fields accordingly.