Skip to content
Beijing Xingzhen Technology logo

Cloud Platform Operation Manual

Cloud Platform Operation Manual Website Address

Xingzhen Technology, your best intelligent upgrade partner

1. Create Device Based on Existing Product

If based on an existing product, creating a device will be very simple and fast, the process is as shown in the figure below:

1.0.1图片

2. Create New Product

2.0.1图片

Create new product process

The following uses a simple device as an example to illustrate the process of creating a device: Modbus parameters

No.Parameter NameAddress TypeAddressDescription
1Cooling Outlet Temperature3x10.1℃ (resolution)

Product ID: XZ-TEST01

Product Name: Test Sample

Device ID: HY202BF0DE17F

Device Name: Sample Device

2.1 Create Product

2.1.1图片

Step 1: Create product

2.1.2图片

Step 2: Edit product information

2.1.3图片

Step 3: Enter product editing interface

2.2 Add Product Parameters

Note: You can also import parameters in batches through excel table, refer to 2.13 Batch Import Parameters

2.2.1图片

Step 1: Add product parameters according to the above figure

2.2.2图片

Step 2: Complete adding product parameters

2.3 Edit Mobile Device Details Configuration

2.3.1图片

Step 1: Create new group

2.3.2图片

Step 2: Configure group information

2.3.3图片

Step 3: Configure display controls

2.4 Edit Mobile Remote Control

This example has no remote control parameters. For details, please refer to 5. Configuration Controls chapter.

2.5 Edit Gateway Communication Parameters

2.5.1图片

Edit and save communication parameters

2.6 Complete Product Creation

2.6.1图片

Save configuration, complete product creation

2.7 Create Device

2.7.1图片

Step 1: Create device

2.7.2图片

Step 2: Edit device information

2.7.3图片

Step 3: Click "Complete" to finish device creation

2.8 Hardware Debugging Environment Preparation

2.8.1图片

Step 1: Connect DTU to PC, power on DTU

2.8.2图片

Step 2: Device simulator establishes communication with DTU

2.9 Remote Sync Configuration Parameters

2.9.1图片

Step 1: Confirm DTU communication is normal (GPRS light flashes quickly)

2.9.2图片

Step 2: Select "Remote sync configuration parameters"

2.9.3图片

Step 3: Confirm to get communication parameters to confirm communication is normal

2.9.4图片

Step 4: Sync modbus parameters to device

2.9.5图片

Step 5: Confirm modbus data is correct

2.9.6图片

Step 6: Display modbus communication data, indicating sync completion

2.10 Bind Device

Before binding the device, please register in the official account or APP first.

2.10.1图片

Step 1: Enter management interface, click "+" Step 2: Click "Scan and Bind" Step 3: Scan the QR code on the front of DTU

2.11 Test Verification

2.11.1图片

Step 1: View device details

2.11.2图片

Step 2: Change cooling outlet temperature register value

2.11.3图片

Step 3: Verify if mobile interface displays correct data

2.12 Return to Product Editing Mode

If test verification fails, you can re-edit the product. Before re-editing the product, first destroy the device created based on the product and return to product editing mode.

2.12.1图片

Step 1: Destroy device

2.12.2图片

Step 2: Edit device

2.13 Batch Import Parameters

In order to speed up the efficiency of adding product parameters, excel table batch import parameter function is provided. Please contact the administrator for the excel table template.

2.13.1图片

Step 1 Prepare for import

2.13.2图片

Step 2 Import and refresh

3. Configuration Controls

3.1. Mobile Device Details

3.1.0

3.1.1. Create New Group

Whether to display by default: Select "Yes", then enter the mobile remote control interface when the default expanded display of the group parameters select "No", then enter the mobile remote control interface when the default collapsed display of the group parameters

3.1.1.1图片

Create new group

3.1.1.2图片

Edit group information

3.1.2. Edit Bit Indicator Control

3.1.2.1图片

Bit indicator control

3.1.3. Edit Bit Indicator Control

3.1.3.1图片

Multi-state indicator control

3.1.4. Numeric Display Control

3.1.4.1图片

Numeric display control

Figure: Mobile device details configuration editing process

3.2. Mobile Remote Control

3.2.0图片

3.2.1. Create New Group

Whether to display by default: Select "Yes", then enter the mobile remote control interface when the default expanded display of the group parameters select "No", then enter the mobile remote control interface when the default collapsed display of the group parameters

3.2.1.1图片

Step 1: Add group

3.2.1.2图片

Step 2: Edit group information

3.2.1.3图片

Step 3: New group created successfully

3.2.2. Add Control

3.2.2.1图片

Add control

3.2.3. Edit Control - Numeric Input and Display

Tip: Parameter selection can input parameter ID to improve selection efficiency

3.2.3.1图片

Edit numeric input and display control

3.2.4. Edit Control - Button

Buttons are divided into three types:

  1. Set value type When the user presses the button, a certain value is set
  2. Alternating type When the user presses the button, the button value is displayed and set alternately.
  3. Switch type Left and right pull switch button.

3.2.4.1图片

Add button - Set value type

3.2.4.2图片

Add button - Alternating type

3.2.4.3图片

Add button - Switch type

3.2.5. Edit Control - Dropdown Selection

3.2.5.1图片

Add button - Dropdown selection

3.2.6. Edit Control - Checkbox

3.2.6.1图片

Add button - Checkbox

3.2.7. Edit Control - Adjust Order

3.2.7.1图片

Adjust control order

4. Appendix 1 Product Parameter Configuration Rules

No.NameValueDescription
1Parameter Name
2Parameter ID0~65536 numbersProduct-level unique, automatically generated by the system
3Address Type0xRead-write coil
1xRead-write discrete
3xRead input register
3x_BitRead 1 bit of input register
4xRead-write holding register
4x_BitRead 1 bit of holding register
4AddressDefault 0When the address type is 3x_Bit or 4x_Bit, the address type is A.B format, A represents the address number, B represents the B bit of the address, where B ranges from 0~15.
5Length1~32Default 1, no more than 32
5Decimal Point0~4Default 0
6Reporting ModeTimed reportingReport at each timing time
Immediate reporting when changedReport when data changes, when data does not change, report according to the reporting interval.
Report when data equals a certain value or when changedReport when data equals a certain value, enter the value in the "Equals value" edit box
7Reporting Period60 secondsWhen the reporting mode is: "Timed reporting", "Report when data equals a certain value or when changed", the default display starts from 60 seconds
When the reporting mode is "Immediate reporting when changed", the display starts from 600 seconds
120 seconds
180 seconds
600 seconds
660 seconds
720 seconds
1800 seconds
8UnitMultiple preset units are optional by default, and can also be self-recorded
9Data TypeSwitchOnly can take values of 0, 1, address type should be: 0x, 1x, 3x_Bit, 4x_Bit
16-bit integer16-bit integer, address type: 3x, 4x
16-bit positive integer16-bit positive integer, address type: 3x, 4x
ASCIIASCII code, address type: 3x
10Read-Write TypeRead-onlyAll address types
Read-Write4x, 0x
Write-only4x, 0x
11Historical DataDisplayCan display data curves, historical data; can export historical data
Not displayDo not display data curves, historical data; cannot export historical data
12Whether to allow setting alarm thresholdYesCan set alarm conditions, system alarm when alarm conditions are triggered
NoNo alarm
13Alarm threshold settingYesIf "Whether to allow setting alarm threshold" is selected as "No", it will not be displayed, otherwise a dialog box will pop up, and alarm conditions can be edited. Single or multiple conditions can be selected.
No
14PermissionManufacturerCan select parameter visible users. When unchecked, this type of user does not display this parameter
Dealer
End user
15RemarksRemark information

5. Appendix 2 Configuration Development Skills

5.1. Skill 1: Make Good Use of Search Function

Skill 1: Make good use of search function 5.1.1图片

Skill 1: Make good use of search function - Search by parameter ID

Some devices have many parameters. When editing controls, searching parameters by parameter ID can quickly select them.

5.2. Skill 2: Make Good Use of Continuous Parameter IDs

When creating parameters, the system automatically generates ID numbers, these ID numbers are usually continuously increasing (if not manually changed), so search control parameters through continuous parameter IDs.

5.3. Skill 3: Make Good Use of Reporting Mode

Data reporting modes are divided into: timed reporting, immediate reporting when changed, reporting when data equals a certain value or when changed. Appropriate reporting mode can save traffic and improve user experience.

  • Timed reporting Used for analog quantity reporting, such as temperature, humidity, etc.

  • Immediate reporting when changed Used for configuration quantities or infrequently changed data reporting, such as device status, time configuration, temperature configuration, output IO status, input IO status, etc.

  • Report when data equals a certain value or when changed Used for fault alarm switch quantities.

5.4. Skill 4: Make Good Use of Virtual Test Function

When developing new product configuration, you can first not connect to DTU hardware, directly use the "Virtual Test" function to verify whether the data and data display are correct.

5.4.1图片

Step 1: Click "Details" in device information query

5.4.2图片

Step 2: Input data and report

5.4.3图片

Step 3: Mobile verification

5.5. Skill 5: Quickly Check if Parameters are Configured Correctly

6. Contact Us

Company Information

  • Company Name: Beijing Xingzhen Technology Co., Ltd.
  • Company Address: Room 519, Building 1, No. 10 Longyu North Street, Changping District, Beijing
  • R&D Center: A16-3A, Chuangxinggang Changban University Innovation Park, No. 21 Changyuan Road, Tianhe District, Guangzhou
  • Contact Person: Li Zhongyou
  • Phone: 15625178785 (same as WeChat)
Official AccountLi Zhongyou WeChat QR Code

Xingzhen Developer Docs · Continuously updated