This guide is intended to help you get started with Freematics ONE+ with least effort. For more information about developing with Freematics ONE+, refer to Developers Guide.

 

Download Arduino library and sample sketches

Download the latest source code package from here or just clone the Github repository. Extract the downloaded package somewhere and you should see sketches and libraries in separate directories.

 

Install Freematics Arduino Builder

Freematics Arduino Builder is a quick tool for compiling Arduino sketch and uploading the compiled binary to Arduino board or Freematics ONE+ in this case. Basically you don’t need to do anything like environment setup or library import with it to compile the sketches you have just obtained. Simply download the installer and proceed with it. Once done, launch the program.

Of course you can use standard Arduino IDE or PlatformIO to do the job. Refer to Developers Guide for some related information.

 

Connect Freematics ONE+ to computer

Connect Freematics ONE+ to your computer with USB cable. A serial port will appear just like an Arduino board. If not, download and install USB serial driver from here.

 

Using Freematics ONE+ as a vehicle data logger

A data logger sketch is located in datalogger sub-directory. It reads data from OBD-II, motion sensor and GPS (if present) and writes the data to files on microSD card (if card present).

To use the sketch, click Load Sketch button and choose datalogger.ino to load. A configuration UI should come out as following.

You can change options to enable or disable certain features provided by the sketch. Once done, click the serial port button corresponding to Freematics ONE+ to start compiling and uploading. If you are not sure which port to choose when there are more than one, disconnect the device, click Refresh button and see which one disappears and then connect again.

     

Once completed, you can click Open button to open the serial monitor to see the running result. Normally you should have Freematics ONE+ connected to your car’s OBD-II port to see the sketch running.

Using Freematics ONE+ as a telemetry data logger over WIFI or cellular network

A telemetry data logger sketch is located in telelogger sub-directory. It reads data from OBD-II, motion sensor and GPS (if present), writes the data to files on microSD card (if card present) and send the data to a server overa WIFI or cellular network. We have developed and released Freematics Hub a free vehicle telemetry server software which works out-of-box with Freematics ONE+ running telelogger, capable of receiving, storing and illustrating real-time data transmitted from multiple devices.

If you don’t want to setup your own server but just want to test the device, you can use our server (hub.freematics.com) for testing.

Now load the sketch into Arduino Builder by clicking Load Sketch button and choose telelogger.ino. A configuration UI will come out as following.

If you are going to use WIFI for Internet connection, change networking option to WIFI and change the SSID and password to that of your WIFI hotspot. If you are going to use cellular network (and you have cellular module in your Freematics ONE+ with SIM card inserted), change networking option to SIM800 (GPRS) or SIM5360 (WCDMA) according to what cellular module you have. It’s important to set the correct APN of your mobile network operator.

If you have setup Freematics Hub, change the Server Host to the actual domain name or IP address of the computer running Freematics Hub. If you don’t have a server setup yet, just leave it the default. If needed, change other options for enabling/disabling some features. Once all done, click the serial port button corresponding to Freematics ONE+ to start compiling and uploading.

     

Once completed, you can click Open button to open the serial monitor to see the running result. You need to have Freematics ONE+ connected to your car’s OBD-II port and the number of bytes being sent will be displayed in serial monitor.

At this time, you will also see data showing up in Freematics Hub.