Skip to main content

Suntech (ST300, ST340, ST600, SA200 and ST4300 universal)

Status: Works today: built into ZAITRACK for every organisation.

KindVersionPublisherLicence
Device codec1.0.1ZAITRACKApache-2.0

What it does​

Suntech trackers on their ';'-separated ASCII messages, one per '\r': the older protocol with the model's header (SA200STT, ST300STT, ST340STT, ST500STT, ST600STT; STT status, EMG emergency, EVT input event, ALT alert, UEX serial data, ALV keep-alive, CMD;Res answers) and the universal protocol of the ST4300 / ST4340 and recent ST300 firmware (STT;;;..., ALT, UEX, ALV, RES), ASCII or binary (0x81 status, 0x82 alert, 0x83 keep-alive). Position, speed, course, satellites, fix, odometer, ignition, inputs and outputs, main and backup voltage, hour meter; emergencies and alerts by name. Commands: outputs 1..4 (engine cut and restore), the status report now, a command id or a universal command as typed. An EMG is acknowledged (AckEmerg) so the tracker stops repeating it. The ST410 / ST419 cell layout and the ST910's are refused by name.

  • Devices: vehicle_tracker
  • Transport: tcp, udp
  • Commands: engine-cut, engine-restore, output-set, locate-now, diagnostics-run, vendor-passthrough
  • Capabilities: telemetry.position, telemetry.io, command.engine-cut, command.passthrough

How to use it​

Built in: register the device in the console and choose its protocol. Where it connects, and its settings: https://docs.zaitrack.app/fleet/connect/suntech.

Its listing: https://marketplace.zaitrack.app/browse/suntech-codec.

Configuration​

None: built in, it has no settings of its own; a device's own settings are on its Connect page.

Credentials​

None.

Limits​

Built in, it runs inside codec-runtime itself today. These are the limits it asks for as a WASM module in codec-runtime's sandbox:

  • Memory: 32 MB
  • Time per call: 100 ms
  • Instructions per call (fuel): 2,000,000,000
  • Largest message: 65,536 bytes
  • Calls per second: 8,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/suntech-st300