Skip to content

Latest commit

 

History

History
66 lines (41 loc) · 2.69 KB

README.md

File metadata and controls

66 lines (41 loc) · 2.69 KB
Raw

tk102-server

Server to handle the GPS strings sent by tk102-2/B compatible GPS trackers (tk103, tk104 ?).

The python script listens on a port and handles connections.

Implements the following protocol:

  1. tracker sends: ##,imei:_IMEI_,A;
  2. server responds: LOAD

THEN

  1. tracker sends: _IMEI_;
  2. server responds: ON

OR

  1. tracker sends: imei:_IMEI_,tracker,1212220931,,F,083137.000,A,5620.2932,N,01253.7255,E,0.00,0;
  2. coordinates and other values are calculated and stored.

If server does not receive _IMEI_; every 90 seconds, it times out (after 182 seconds), and kills the thread handling the tracker.

Sending commands

A command can be send to a tracker by writing something to a file in the tracker's directory.

  • cmd : read by the thread for commands. After a command is read, the cmd file is copied to cmd_TIMESTAMP where TIMESTAMP is the current unix epoch timestamp. For example, 'echo "C600" > cmd' sets the interval on the tracker to 10 minutes. It sends the command: **,_IMEI_,C,600s to the tracker. The following are implemented:
  1. Cnnn : sets tracker interval to nnn seconds
  2. E : clears alarm message
  3. G : sets move alarm

Bookkeeping

Every new thread creates a tk102pid_PID directory which contains the following bookkeeping information:

  • last contains the PID of the process, the file's timestamp is used by main thread to check timeout. Each time a heart beat is received, the file is 'touched'.
  • imei contains the trackers imei number.
  • info last lat/lon/... received by tracker, in Python "pickle" format.
  • bytes total number of bytes received by and sent to the tracker.

After the tracker has disappeared, a file called exit is created in the directory to signify that the directory contents are no long "live". It will be removed on the next start-up of the server.

Other

Protocol partly from this google doc

Licence

LICENSE

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.