milekz/tk102 repository overview

⁠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⁠

Dcoker ENV PG_DBNAME=aa PG_USER=bb PG_PASS=dd PG_HOST=127.0.0.1 PG_PORT=5432

⁠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/⁠.