This project is a TCP server designed to communicate with OBD2 trackers installed in vehicles. The server receives data transmitted by the trackers, processes it, and stores it in a structured format. This allows for real-time tracking and analysis of vehicle data, providing valuable insights for fleet management, vehicle diagnostics, and more.
To install the project locally, follow these steps:
-
Install Ruby on your Linux machine by running the following command:
sudo apt-get install ruby-full
-
Clone the repository to your local machine:
git clone https://github.com/uozalp/GPS-Server.git
-
Navigate to the project directory:
cd GPS-Server -
Install the required gems:
bundle install
-
Start the server:
ruby TCPServer.rb
Alternatively, you can set it up as a service using systemd. Here's an example of a systemd service file for the project:
[Unit]
Description=OBD2 Tracker
After=network.target
[Service]
Type=simple
User=z-gps
WorkingDirectory=/var/lib/gps
EnvironmentFile=-/var/lib/gps/.environment
ExecStart=/usr/bin/nohup /var/lib/gps/.rvm/rubies/ruby-2.5.1/bin/ruby /var/lib/gps/TCPServer.rb &
ExecStop=/bin/kill -s QUIT $MAINPID
RestartSec=3
Restart=on-failure
[Install]
WantedBy=multi-user.target
Save this as /etc/systemd/system/obd2.service and give it the appropriate permissions (0644). You can then start the service with systemctl start obd2.service and enable it to run at boot with systemctl enable obd2.service.
The project uses a MySQL database named GPS. It includes the following tables:
Fields include: uuid, uuid_text, submitDatetime, vehicleDatetime, ihdr, deviceId, protocol, validity, latitude, longitude, distance, vehicleSpeed, calculatedSpeed, direction, mcc, mnc, lac, cid, performance, hex.
Fields include: id, deviceId, Thread, TCPSocket, IP, Connected, Keepalive, Closed, Status.
Fields include: id, make, model, year, vin, license_plate, color, owner_name, owner_phone, owner_email.
This project is licensed under the terms of the MIT license.