Document Version: V1.0

Revision History

Document Header

Terms and Abbreviations

1. Overview

Use this procedure when the payload codec for a LoRaWAN sensor is not already available in E2C Field. You will place the manufacturer's raw codec source beside the E2C Trinity Codec Converter, generate a .toml codec file, import the file into E2C Field, test it with a known uplink payload, and publish it.

After you complete the procedure, the codec appears in E2C Field and can be selected when you create a device profile for the corresponding sensor.

2. Before You Start

Prepare the following items:

• A Windows PC with e2c-trinity-codec-converter.exe v1.0.0. Download it from E2C Field APP Download.
• The manufacturer's raw codec source folder for the sensor model you are adding:
• For a Milesight sensor, download the SensorDecoders folder from Milesight SensorDecoders.
• For a Dragino sensor, download the dragino-end-node-decoder folder from Dragino End Node Decoder.
• A sample uplink payload in hexadecimal format that is known to belong to the exact sensor model. Obtain it from the sensor manufacturer's documentation or a controlled test device.
• Administrator access to the E2C Field web interface on the Robustel gateway.

Important: Do not rename or reorganize files inside the manufacturer's source folder. The converter scans the folder structure from its current directory.

3. Step-by-Step Instructions

3.1 Workflow Overview

3.2 Step 1: Prepare the Converter Directory

Purpose: Allow the converter to find the manufacturer's raw codec source.

1. Create or open a working directory on the Windows PC.
2. Place e2c-trinity-codec-converter.exe in that directory.
3. Place the manufacturer's complete raw codec source folder in the same directory as the executable.
4. Confirm that the executable and source folder are at the same directory level, as shown below.

Figure 3-1 Converter executable and manufacturer source folders in the same directory

Use the following directory structure:

3.3 Step 2: Generate the TOML Codec File

Purpose: Package the selected manufacturer's decoder into the .toml format accepted by E2C Field.

1. Double-click e2c-trinity-codec-converter.exe.
2. In Vendor, select the sensor manufacturer. In this example, select Milesight.
3. In Model, select the exact sensor model. In this example, select AM102.
4. Review Output File and confirm the proposed filename and directory.
5. Click Generate Codec TOML.
6. In the Log panel, confirm that the first result line is [SUCCESS] and that the log identifies the selected vendor, model, and output path.
7. In the converter directory, confirm that the generated .toml file exists. For this example, the output file is milesight-am102-codec.toml.

Figure 3-2 Successful codec conversion and generated TOML file

3.4 Step 3: Import the Codec into E2C Field

Purpose: Load the generated codec definition into the E2C Field payload codec library.

1. Log in to the E2C Field web interface on the Robustel gateway.
2. Go to LNS Configuration > Payload Codecs.
3. Click Import Codec.
4. Select Import from file.
5. Select the .toml file generated in Step 2. For this example, select milesight-am102-codec.toml.
6. Confirm that E2C Field displays a green check mark beside the filename and fills in Name, Brand, and Series.
7. Review the JavaScript Code Preview. Do not publish the codec yet.

Figure 3-3 Imported codec details and JavaScript code preview in E2C Field

3.5 Step 4: Test and Publish the Codec

Purpose: Prove that the imported codec can decode a known payload before making it available on the gateway.

1. In the Import Codec dialog, open the Uplink Test tab.
2. In Input Payload (HEX), paste a sample hexadecimal uplink payload for the exact sensor model. The sample hexadecimal code can usually be found in the specifications of the sensor.
3. Click Run Decode.
4. In Output Console, confirm that the result is structured JSON with readable field names and values. The exact fields depend on the sensor model and payload.
5. If the output is correct for the known sample, click Publish.

Figure 3-4 Successful uplink test with readable JSON output

Important: Publish the codec only after a known payload produces the values documented by the sensor manufacturer. A syntactically valid JSON result alone does not prove that the values are correct for a different model or firmware revision.

4. Verification

Verify the result in both the import dialog and the payload codec library:

1. Before publishing, check Output Console in the Uplink Test tab.

• What to observe: The console contains structured JSON rather than an error message.
• Success criterion: The decoded fields and values match the manufacturer's expected result for the sample payload.

2. After clicking Publish, return to LNS Configuration > Payload Codecs.

• What to observe: The imported codec is available under the expected name, brand, and series.
• Success criterion: You can select the codec when creating the device profile for the matching LoRaWAN sensor.

5. Troubleshooting