Skip to main content

TK103 / KX402

Status: In development: its code is written and tested on its own, but it does not work end to end on the platform yet. It cannot be installed.

KindVersionPublisherLicence
Device codec1.0.5ZAITRACKApache-2.0

What it does​

KX402 V1.5 TCP enrolment, heartbeat and fixed-width GPS profile. In development; query, intervals, geofence and AT00 restart require host-reserved serials. Restart uses the high-risk command approval policy. Other TK103 dialects remain unavailable.

  • Devices: vehicle_tracker
  • Transport: tcp
  • Commands: diagnostics-run, config-update, vendor-passthrough
  • Capabilities: telemetry.position

How to use it​

Not yet: see its status above.

Configuration​

SettingTypeRequiredAllowed values and default
profile—nodefault "kx402-v1.5"
serialstringnoHost-reserved command attempt serial. Required for encoding; not a device identity.
modelstringno—
passwordstringno—
immobiliser_doutintegerno—

Credentials​

None.

Limits​

It runs in codec-runtime's WASM sandbox, within these limits (the platform's own ceilings bound them too):

  • Memory: 32 MB
  • Time per call: 50 ms
  • Instructions per call (fuel): 50,000,000
  • Largest message: 1,042 bytes
  • Calls per second: 2,000
  • Network: no network access

Troubleshooting​

  • The device does not connect. Check the host and port its Connect page gives for your region, that the SIM has data and the APN is set, and that the device sends to that host (some send to the last server they were given).
  • It connects but no position arrives. The device must be registered with this protocol and the IMEI or serial it reports: a device the platform does not know, or a retired one, is refused when it connects. Trackers shows it as Check (never reported) until its first position.
  • Positions arrive with the wrong time. The protocol's timestamps are UTC; a device set to local time reports hours off. Set it to UTC.
  • A command does not reach the device. Only the commands listed under Commands are sent; the device must be online, and some models need the command enabled in their own configuration.

Source​

adapters/codecs/tk103