Freematics Hub is a cross-platform telematics server software which receives real-time data from multiple remote telematics devices like Freematics ONE+ and provide 3rd-party applications with simple REST APIs to access live and history data from all devices. Freematics Hub is highly efficient and low-demanding on system resources. It can be deployed on all types of computers, whether it’s a cloud server, desktop PC or SBC.

Benefits of using Freematics Hub

  • Reference client implementation in form of Arduino sketches
  • Access to real-time and history data by simple REST APIs over HTTP/HTTPS
  • No need for application to maintain connection with telematics devices
  • Dedicated telemetry transport protocol for high throughput and low latency vehicle data transmission with minimum data overhead
  • Remote command queue support, sending commands to device or remotely querying data
  • No public cloud, all data in your hand!

 

API

Freematics Hub implements a set of REST API for sending data to or receiving data from Freematics Hub. The GUI itself is completely built with the API. For more information, please refer to Freematics Hub API Reference.

 

Software

Freematics Hub can be downloaded as a software package and install on any computer with a supported OS (currently Windows and Linux releases provided). It has a simple GUI for quick testing and evaluation of Freematics hardware products.

Freematics Hub running on Windows

Freematics Hub running on Ubuntu Linux

The GUI of Freematics Hub shows basic information of all telematics devices which are feeding data. More detailed real-time data can be viewed by a web-based UI. To see it, open the URL displayed in the console, or click on the VIN in the device list from the GUI when it appears.

15203164_633189226862766_2006367074178906345_n

Freematics Hub stores all received data locally in separate files (by session/trip) in separate sub-directories (by vehicle ID). On Windows, the default data directory is %APPDATA%\FreematicsHub\Data. On Linux, the default data directory is Data in the executable directory.

Freematics Hub can be launched from command line with arguments for configuration.

Usage: freematicshub
 -h : display this help screen
 -p : specifiy http port [default 8080]
 -u : specifiy udp port [default 8081]
 -l : specify log file directory
 -d : specify data file directory
 -m : specifiy max clients [default 32]
 -M : specifiy max clients per IP
 -s : specifiy download speed limit in KB/s [default: none]
 -n : specifiy HTTP authentication user name for remote access [default: admin]
 -w : specifiy HTTP authentication password for remote access
 -g : do not launch GUI

 

Download

 

Installation

On Windows, Freematics Hub can be installed by the installer which is very straight-forward. After installed, click on desktop icon to launch the server.

On Linux, please refer to the following instruction. The script run.sh is used to start server and GUI together.

Demo/Reference Client

Arduino Sketch

Telelogger is the reference client implementation working with Freematics Hub, developed in form of Arduino sketches for Freematics ONE and Freematics ONE+ respectively.

In-browser Simulator

In case you don’t have any Freematics device in hand, a Javascript simulator is developed for testing Freematics Hub with mobile devices like smartphones or tablets. It obtains geo-location and motion sensor data from the mobile device running it and send the data to Freematics Hub. The simulator is included in the Freematics Hub server package and shall be opened from the Freematics Hub server host due to same-origin restriction of common web browsers.

 

Services

Freematics Hub is an open-source software developed by us. It’s free for use and redistribution under GPL license. We also provide following commercial services.

  • Technical support on deployment and integration
  • Development for additional features or API
  • Licensing for 3rd-party integration

Please contact us for free consultation.

 

Links