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
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.
For development, it is recommended to use Arduino IDE or PlatformIO. Refer to Developers Guide for some related information. Please note that Freematics Arduino Builder is provided AS-IS and has no support or warranty from Freematics.
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.
Unable to access OBD data
Please make sure the device is connected to a vehicle that uses one of supported vehicle data buses listed on the product page.
Unable to get GPS signal
Please make sure that the GPS receiver is exposed to open sky. There is normally very poor signal indoor even by the window.
Unable to connect to cellular network
Please make sure the cellular module is present and supports the band that your mobile network operator operates on. APN must be correctly set. Some operators may require APN password has specified.
Unable to upload code to device
This could happen when the device is not plugged in OBD port and is solely powered by USB cable. Some computer’s USB port can’t supply enough current surge and some long USB cable which has high resistance may also cause voltage to drop. It is recommended to plug the device into OBD port of real car or OBD simulator/emulator so it can be properly powered. For powering by USB only, it is recommended to use a USB hub with external power supply. Reducing upload baud rate would also help in most cases.