[BIN]-data-10103 Integration Guide

Sensor Overview

[BIN]-data-10103 is integrated with ThinkLink through Source file does not provide it in Source file does not provide it mode. This guide documents the current deployable artifacts and their source-traceable versions.

Item	Value
Project	_bin__data_10103
Vendor	Source file does not provide it
Model	[BIN]-data-10103
Business Code	Not applicable
Integration Mode	Source file does not provide it
Protocol	Source file does not provide it

Model catalog

Search for these models in ThinkLink by name or ID.

Model type	Name	id_name	Platform model ID
RPC	[BIN]-参数配置-10103	mt_set_trash_para_10103	62184372278661125
Thing Model	[BIN]-data-10103	mt_bin_data_10103	62183093347291141
Thing Model	[MT-10103-TRANSH资产] 区域聚合	mt_bin_data_asset_10103	119677174411063304
Parameter Thing Model	[BIN]-para-10103	mt_transh_para_10103	62183707154321413

Features and Application Scope

This project covers [BIN]-data-10103 through Source file does not provide it. Its capability boundary, fields, and deployable models follow the current descriptor, requirements, and model sources.

Deployment and Data Acquisition

Telemetry and Register Definitions

The source does not provide a standalone telemetry table; use the current thing models listed in the model inventory.

Parameter Definitions

No project-specific parameters are defined.

Requirements Evidence

The following key facts were extracted from the requirements source; line references support verification.

Category	Source Fact	Source
Deployment	- Power: Source file does not provide it	requirement/requirements.md:17
Protocol/Data	- Protocol: Source file does not provide it	requirement/requirements.md:19
Protocol/Data	- Interface: Source file does not provide it	requirement/requirements.md:20
Protocol/Data	- Baud rate: Not applicable	requirement/requirements.md:21
Deployment	Validate model IDs, identifiers, payload fields, RPC behavior, triggers, and templates against a real device or platform test asset before production deployment.	requirement/requirements.md:75
Deployment	- Power: source file does not provide it	requirement/requirements.md:83
Protocol/Data	- Protocol: source file does not provide it	requirement/requirements.md:85
Protocol/Data	- Interface: source file does not provide it	requirement/requirements.md:86
Deployment	Every item above must be checked during deployment. No missing value is promoted to a confirmed fact.	requirement/requirements.md:88

Thing Model and RPC Code

RPC: mt_set_trash_para_10103

id_name: mt_set_trash_para_10103 · ID: 62184372278661125

javascript

import {RPCHelper, Utils} from '#tklHelper';
import {Buffer} from "buffer";

function rpc_script({ device, params, alarms, logger, org_params }) {
let classMode = (device && device.shared_attrs && device.shared_attrs.class_mode) || "ClassA";
    let sleepMs = classMode === "ClassA" ? 500 : 5000;
    let paraDef = {
        app_70:{
            name: "上行周期", fieldName: "periodDataUP", unit:"秒", dataType: "uint32le", coefficient: 1, decimal:0,
            optionList: {}
        },
        app_74:{
            name: "查询周期", fieldName: "periodDataQuery", unit:"秒", dataType: "uint32le", coefficient: 1, decimal:0,
            optionList: {}
        },
        app_110:{
            name: "重量阈值", fieldName: "covWeight", unit:"kg", dataType: "uint32be", coefficient: 1, decimal:0,
            optionList: {}
        },
        app_114:{
            name: "距离阈值", fieldName: "covDepth", unit:"mm", dataType: "uint16be", coefficient: 1, decimal:0,
            optionList: {}
        }
    }
    let frames=RPCHelper.buildFrame({
        paraDef:paraDef,
        params:params});
    let redoBuffer=RPCHelper.redo()
    let dnBuffer=Buffer.alloc(frames.writeBuffer.length+frames.readBuffer.length+redoBuffer.length);
    frames.writeBuffer.copy(dnBuffer,0)
    frames.readBuffer.copy(dnBuffer,frames.writeBuffer.length)
    redoBuffer.copy(dnBuffer,frames.writeBuffer.length+frames.readBuffer.length);
    console.log(dnBuffer.toString("hex"))
    let msg=RPCHelper.makeMSG({
        msgType:Utils.msgType.paras,
        device:device,
        dnBuffer:dnBuffer,
        sleepTime:sleepMs,
    })
    return [
        msg
    ]
}
rpc_script({
    device: { server_attrs: {}, shared_attrs: {} },
    params: {},
    alarms: [],
    logger: console,
    org_params: {}
})

Thing Model: [BIN]-data-10103

id_name: mt_bin_data_10103 · ID: 62183093347291141

javascript

import {PayloadParser, RPCHelper} from '#tklHelper';
import {Buffer} from "buffer";

function payload_parser(device, msg, thingModelId, noticeAttrs, org_params) {
let frameInfo={
        port:22, dataLen:16,
        tagList:[{   index:0, tag:0x83}, {   index:1, tag:0x23}]
    }
    let appInfo = [
        {
            name: "重量值", field_name: "weight", unit:"kg", index: 6, type: "int32be",
            coefficient: "precision", decimal:2,
            options: {},
            remark: "32位有符号整数，表示重量值（不含小数点）。需根据精度字段确定小数点位置。如精度为2（0.00），则1532表示15.32"
        }, {
            name: "精度",field_name: "precision", unit:"",
            index: 10, coefficient: 1, type: "uint16be",
            options: {0: 1, 1: 0.1, 2: 0.01, 3: 0.001},
            remark: "小数点精度设置，决定重量值的小数位数"
        }, {
            name: "状态",field_name: "weightStatus1",unit:"",
            index: 13, coefficient: 1, type: "bitBE0-0",
            options: {
                0:"称重不稳定" ,
                1:"称重稳定"
                //"bit0": "0:称重不稳定, 1:称重稳定",
                //"bit1": "0:非零点, 1:零点",
                //"bit2": "0:没有超重, 1:超重",
                //"bit3": "0:无按键, 1:有按键触发",
                //"bit4": "0:开机有零点, 1:开机无零点",
                //"bit5": "0:称重无效, 1:称重有效",
            },
            remark: "模块状态寄存器，bit0-bit5有特定含义，bit6-15保留"
        },
        {
            name: "状态",field_name: "weightStatus2",unit:"",
            index: 13, coefficient: 1, type: "bitBE5-5",
            options: {
                0:"称重无效",
                1:"称重有效"
            },
            remark: "模块状态寄存器，bit0-bit5有特定含义，bit6-15保留"
        },
        {
            name: "深度", field_name: "depth", unit:"mm",
            index: 14, type: "uint16be",
            options: {},
            remark: "垃圾距离垃圾盖的距离"
        }
    ]
  //  let payload = Buffer.from(msg?.userdata?.payload, "base64");
  //  let port = msg?.userdata?.port || null;
    let payParser=new PayloadParser({
        device:device,
        msg:msg,
        frameInfo:frameInfo,
        appInfo:appInfo,
    })
    let tdata= payParser.telemetry();
    if (tdata==undefined){ return null}
    if (tdata.precision!==undefined){
        if (tdata.precision===0xFFFF) {tdata.precision=0; tdata.weight=0}
    }
    let result = {
        telemetry_data: tdata,
        server_attrs: null,
        shared_attrs: {class_mode: msg?.userdata?.class},
    };
    // ── rpcHook (设备对接通用规则) ──
    if (typeof RPCHelper.buildRpcHookAction === "function") {
      const __a = RPCHelper.buildRpcHookAction({ device, msg, thingModelId, idName: "mt_bin_data_10103", name: "[BIN]-data-10103", parsed: { telemetry_data: result.telemetry_data, server_attrs: result.server_attrs, shared_attrs: result.shared_attrs } });
      if (__a) { result.actions = result.actions || []; result.actions.push(__a); }
    }
    return result;
}
console.log(payload_parser(
    { telemetry_data: {} },
    { userdata: { port: 11, payload: "" } },
    "1",
    { telemetry_data: true },
    {}
))

Thing Model: mt_bin_data_asset_10103

id_name: mt_bin_data_asset_10103 · ID: 119677174411063304

javascript

import {PayloadParser, RPCHelper} from '#tklHelper';

// 资产(VIRTUAL)聚合物模型 — 通用 agg_spec 驱动聚合器，见 docs/references/workflow/asset-aggregation-model.md
// device=资产, msg=源设备快照, thingModelId=本物模型ID, noticeAttrs=变更标记。
// 聚合规格在资产 server_attrs.agg_spec：zone_depth_avg=空间均值(depth)；zone_weight_sum=时点累加(weight)；online_count=在线数(—)
function payload_parser(device, msg, thingModelId, noticeAttrs) {
    if (!noticeAttrs || !noticeAttrs.telemetry_data) {
        return { telemetry_data: null, server_attrs: null, shared_attrs: null };
    }
    const sa      = device?.server_attrs || {};
    const spec    = sa.agg_spec || {};
    const members = { ...(sa.members || {}) };
    const staleMs = sa.stale_ms != null ? sa.stale_ms : 600000;
    const now     = (typeof Date !== "undefined" && Date.now) ? Date.now() : null;

    // 合并源设备各物模型的最新快照为一个扁平对象
    const srcTd = {};
    const all = msg?.telemetry_data || {};
    for (const k in all) { Object.assign(srcTd, all[k]); }

    // 收集 spec 引用到的全部源字段，把本帧带到的值并进该成员快照
    const want = {};
    for (const out in spec) { if (spec[out].src) want[spec[out].src] = true; }
    const got = {}; let touched = false;
    for (const f in want) { if (srcTd[f] !== undefined && srcTd[f] !== null) { got[f] = srcTd[f]; touched = true; } }
    if (touched && msg && msg.eui) {
        const prev = (members[msg.eui] && members[msg.eui].v) || {};
        const seq  = (members[msg.eui] && members[msg.eui].ts) || 0;
        members[msg.eui] = { v: Object.assign({}, prev, got), ts: now != null ? now : seq + 1 };
    }

    const euis = Object.keys(members);
    const fresh = euis.filter(function (e) {
        if (now == null || staleMs <= 0) return true;
        const ts = members[e].ts;
        return ts != null && ts <= now && (now - ts) <= staleMs;
    });
    const num = function (x) { return (x != null && !isNaN(x)) ? Number(x) : null; };

    const out = {};
    for (const field in spec) {
        const op = spec[field].op, src = spec[field].src;
        if (op === "count_online") { out[field] = fresh.length; continue; }
        const pool = (op === "sum_cumul") ? euis : fresh;
        const vals = pool.map(function (e) { return num(members[e].v && members[e].v[src]); }).filter(function (x) { return x != null; });
        if (op === "avg")        out[field] = vals.length ? Number((vals.reduce(function (a, b) { return a + b; }, 0) / vals.length).toFixed(2)) : null;
        else if (op === "sum_snap" || op === "sum_cumul") out[field] = vals.length ? Number(vals.reduce(function (a, b) { return a + b; }, 0).toFixed(3)) : null;
        else if (op === "max")   out[field] = vals.length ? Math.max.apply(null, vals) : null;
        else if (op === "min")   out[field] = vals.length ? Math.min.apply(null, vals) : null;
        else if (op === "or")    out[field] = pool.some(function (e) { const x = members[e].v && members[e].v[src]; return x != null && x != 0; }) ? 1 : 0;
        else if (op === "count_on") out[field] = pool.filter(function (e) { const x = members[e].v && members[e].v[src]; return x != null && x != 0; }).length;
        else out[field] = null;
    }
    let result = { telemetry_data: out, server_attrs: { members: members }, shared_attrs: null };
    // ── rpcHook (设备对接通用规则) ──
    if (typeof RPCHelper.buildRpcHookAction === "function") {
      const __a = RPCHelper.buildRpcHookAction({ device, msg, thingModelId, idName: "mt_bin_data_asset_10103", name: "[MT-10103-TRANSH资产] 区域聚合", parsed: { telemetry_data: result.telemetry_data, server_attrs: result.server_attrs, shared_attrs: result.shared_attrs } });
      if (__a) { result.actions = result.actions || []; result.actions.push(__a); }
    }
    return result;
}

// --- local debug ---（两台成员先后上报；平台会把返回的 members 持久化回 device，这里手动模拟）
const agg_spec = {
  "zone_depth_avg": {
    "op": "avg",
    "src": "depth"
  },
  "zone_weight_sum": {
    "op": "sum_snap",
    "src": "weight"
  },
  "online_count": {
    "op": "count_online",
    "src": ""
  }
};
const device = { name: "MT-10103-TRANSH资产-1", server_attrs: { agg_spec, stale_ms: 1800000, members: {} } };
const r1 = payload_parser(device, { eui: "MEMBER_A", telemetry_data: { m1: {"depth":1,"weight":1} } }, "tmid", { telemetry_data: true });
device.server_attrs.members = r1.server_attrs.members;            // 平台持久化
console.log("成员A上报后:", JSON.stringify(r1.telemetry_data));
const r2 = payload_parser(device, { eui: "MEMBER_B", telemetry_data: { m1: {"depth":2,"weight":2} } }, "tmid", { telemetry_data: true });
device.server_attrs.members = r2.server_attrs.members;
console.log("成员B上报后(2台聚合):", JSON.stringify(r2.telemetry_data));
void PayloadParser;

Parameter Thing Model: [BIN]-para-10103

id_name: mt_transh_para_10103 · ID: 62183707154321413

javascript

import {PayloadParser, RPCHelper} from '#tklHelper';

function payload_parser(device, msg, thingModelId, noticeAttrs, org_params) {
let paraInfo =  {
        app_70:{name: "上行周期", fieldName: "periodDataUP", unit:"秒", dataType: "uint32le", coefficient: 1, decimal:0},
        app_74:{name: "查询周期", fieldName: "periodDataQuery", unit:"秒", dataType: "uint32le", coefficient: 1, decimal:0},
        app_110:{name: "重量阈值", fieldName: "covWeight", unit:"kg", dataType: "uint32be", coefficient: 1, decimal:0},
        app_114:{name: "距离阈值", fieldName: "covDepth", unit:"mm", dataType: "uint16be", coefficient: 1, decimal:0}
    }
    let payParser=new PayloadParser({
        frameInfo:{},
        device:device,
        msg:msg,
        paraInfo:paraInfo,
    })
    const pdata= payParser.paras();
    let result = {
        telemetry_data: pdata,
        server_attrs: null,
        shared_attrs: {class_mode: msg?.userdata?.class},
    };
    // ── rpcHook (设备对接通用规则) ──
    if (typeof RPCHelper.buildRpcHookAction === "function") {
      const __a = RPCHelper.buildRpcHookAction({ device, msg, thingModelId, idName: "mt_transh_para_10103", name: "[BIN]-para-10103", parsed: { telemetry_data: result.telemetry_data, server_attrs: result.server_attrs, shared_attrs: result.shared_attrs } });
      if (__a) { result.actions = result.actions || []; result.actions.push(__a); }
    }
    return result;
}
console.log(payload_parser(
    { telemetry_data: {} },
    { userdata: { port: 11, payload: "" } },
    "1",
    { telemetry_data: true },
    {}
))

Thing Model Field Definitions

Thing Model	Field	Type	Unit	Name
mt_bin_data_10103	depth	number	mm	Depth
mt_bin_data_10103	weight	number	kg	Weight
mt_bin_data_10103	weightStatus1	string		Stability Status
mt_bin_data_10103	weightStatus2	string		Weighing Status
mt_bin_data_asset_10103	zone_depth_avg	number	mm	Zone Depth
mt_bin_data_asset_10103	zone_weight_sum	number	kg	Zone Weight
mt_bin_data_asset_10103	online_count	number		Zone Online Count
mt_transh_para_10103	covDepth	number	mm	Depth Change Threshold
mt_transh_para_10103	covWeight	number	kg	Weight Change Threshold
mt_transh_para_10103	periodDataUP	number		Upload Period
mt_transh_para_10103	periodDataQuery	number		Query Period

RPC Parameter Definitions

RPC	Parameter	Type	Description	Default	Unit
mt_set_trash_para_10103	covDepth	number	Depth Change Threshold	300	mm
mt_set_trash_para_10103	covWeight	number	Weight Change Threshold	1	kg
mt_set_trash_para_10103	periodDataUP	number	Upload Period	900
mt_set_trash_para_10103	periodDataQuery	number	Query Period	300

Trigger Definitions

No project-specific triggers are defined.

Third-Party Platform Subscription

MQTT Topic: /v32/{Organization Account}/tkl/up/telemetry/{eui}

json

{
  "eui": "6353012af10a9331",
  "active_time": "2026-07-13T08:35:48.000Z",
  "thingModelId": "Use the platform model ID from the model inventory",
  "thingModelIdName": "Use the current telemetry model id_name",
  "telemetry_data": {
    "snr": 13.5,
    "rssi": -51,
    "battery": 3.37
  }
}

Template Selection and Verification

Search ThinkLink by project name, business code, or the id_name and ID values in the model inventory. After deployment, use real uplinks to verify fields, units, RPCs, and trigger behavior.

Supplementary Notes

Requirements and decisions: requirement/requirements.md.

LoRaWAN Gateway

Product Manuals

Current Configuration

Current Platform Access

Legacy WebServer

LoRaWAN EB Collector

LoRaWAN Sensor

Platform

Network Server

Device

Agriculture

BMS

Customize

Industry

ManThink

Meter

[BIN]-data-10103 Integration Guide

Sensor Overview

Model catalog

Features and Application Scope

Deployment and Data Acquisition

Telemetry and Register Definitions

Parameter Definitions

Requirements Evidence

Thing Model and RPC Code

RPC: mt_set_trash_para_10103

Thing Model: [BIN]-data-10103

Thing Model: mt_bin_data_asset_10103

Parameter Thing Model: [BIN]-para-10103

Thing Model Field Definitions

RPC Parameter Definitions

Trigger Definitions

Third-Party Platform Subscription

Template Selection and Verification

Supplementary Notes

LoRaWAN Gateway

Product Manuals

Current Configuration

Current Platform Access

Legacy WebServer

LoRaWAN EB Collector

LoRaWAN Sensor

Agriculture

BMS

Customize

Industry

ManThink

Meter

[BIN]-data-10103 Integration Guide ​

Sensor Overview ​

Model catalog ​

Features and Application Scope ​

Deployment and Data Acquisition ​

Telemetry and Register Definitions ​

Parameter Definitions ​

Requirements Evidence ​

Thing Model and RPC Code ​

RPC: mt_set_trash_para_10103 ​

Thing Model: [BIN]-data-10103 ​

Thing Model: mt_bin_data_asset_10103 ​

Parameter Thing Model: [BIN]-para-10103 ​

Thing Model Field Definitions ​

RPC Parameter Definitions ​

Trigger Definitions ​

Third-Party Platform Subscription ​

Template Selection and Verification ​

Supplementary Notes ​

[BIN]-data-10103 Integration Guide

Sensor Overview

Model catalog

Features and Application Scope

Deployment and Data Acquisition

Telemetry and Register Definitions

Parameter Definitions

Requirements Evidence

Thing Model and RPC Code

RPC: mt_set_trash_para_10103

Thing Model: [BIN]-data-10103

Thing Model: mt_bin_data_asset_10103

Parameter Thing Model: [BIN]-para-10103

Thing Model Field Definitions

RPC Parameter Definitions

Trigger Definitions

Third-Party Platform Subscription

Template Selection and Verification

Supplementary Notes