Skip to main content

Falcom (Fox, Bolero, Disco)

Status: Works today.

KindVersionPublisherLicence
Device codec1.0.0ZAITRACKApache-2.0

What it does​

Falcom Fox, Bolero and Disco trackers on the report lines ROAM configured them to send, one per CR LF: $ ,

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

How to use it​

In Adapter Studio, an organisation's owner or admin opens Installations → Install an adapter and gives falcom-fox and its settings. It runs once installed.

Configuration​

SettingTypeRequiredAllowed values and default
poll_commandstringnodefault "$PFAL,Sys.Counter0.set=1"
immobiliser_on_commandstringnodefault "$PFAL,IO6.Set=low"
immobiliser_off_commandstringnodefault "$PFAL,IO6.Set=high"

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: 100 ms
  • Instructions per call (fuel): 2,000,000,000
  • Largest message: 4,096 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/falcom-fox