OpenTracker 2 User Manual Release 1.
www.geolink.io Table of Contents Introduction ...................................................................................................................................................... 4 Hardware Introduction .................................................................................................................................... 5 Board Overview ............................................................................................................................................
www.geolink.io Arduino IDE .................................................................................................................................................. 24 Adding Opentracker 2 as Board to Arduino IDE ...................................................................................... 24 Installing necessary Libraries .................................................................... Error! Bookmark not defined. Increase the serial buffer ............................................
www.geolink.io Introduction The OpenTracker v2 is the first 100% Arduino compatible, fully open source, commercial grade GPS/GLONASS vehicle tracker development board that comes with a free web interface for tracking. The OpenTracker v2 hardware includes the same powerful 32-bit ARM Controller as the Arduino DUE, a GSM/GPRS modem for wireless connectivity, a GPS/GLONASS module with Assisted-GPS, CAN-BUS, plenty of I/O, and a wide operating temperature range of -35°C to +80°C.
www.geolink.io Hardware Introduction Board Overview Internal Expansion Pins USB Programming Connector Quectel M95 GSM/GPRS Modem GSM Antenna Connector Indicator LEDs microSIM Slot Main Connector GPS Antenna Connector ATMEL Processor JTAG Quectel L76 GPS/GLONASS Module Processor The ATMEL SAM3A4C ARM Cortex-M3 CPU is a 84MHz 32-bit ARM Core microcontroller with 256KB embedded dual-bank Flash (2 x 128 kbytes) and 64 kbytes embedded SRAM. Processor datasheets are available at http://www.atmel.
www.geolink.
www.geolink.io Quick Start Guide Install Arduino IDE The Arduino IDE is an integrated development environment used for OpenTracker. If you plan to modify the program code or write your own there is no way around it. Please note: The tracker comes pre-programmed, if you only want to get started tracking just skip this step. OpenTracker requires Arduino IDE 1.6.4 or later. The download should be just below 100MB while downloading the installer and the installation process you may move on the next steps.
www.geolink.io Connect USB Cable Use a micro USB Type B cable and plug it into the board as shown in the picture below. This is an optional step. Only necessary if new software has to be installed or developed. Connect MOLEX Cable Ensure the Latch on the connector is faced up as shown in the picture below. Push the connector until it clicks. 8 OpenTracker 2 User Manual (1.
www.geolink.io Connect Power source OpenTracker supports 12V/24V nominal power supplies (the full range is 9 – 32 Volts DC). Please connect Positive (+) terminal to Pin 1 and Negative (–) terminal to Pin 6, as in the picture below. Start up the tracker Please ensure to insert the correct data, as wrong information can cause higher costs and even be a source of connection problems.
www.geolink.io Change SMS password Optionally, change SMS password by sending following SMS command: #pass,smspass=NEW_PASSWORD Example: #pass,smspass=mynewpass After changing the SMS password, the SMS commands should begin with your new password, like: #mynewpass,COMMAND=ARGUMENTS Please note, depending on the status of the device, it may take a while until the SMS response is sent. To speed up the process you may turn off ignition or temporarily disconnect VDET. 10 OpenTracker 2 User Manual (1.
www.geolink.io SMS Commands Summary of the SMS commands for the initial configuration. The unit will accept only one command at a time and send a reply on successful command execution (this may take a while).
www.geolink.io External I/O Main Connector Type We use the Molex 0430451006 Connector on our board. Micro-Fit 3.0™ Family Fully isolated contacts Full polarization Positive locks 3.00mm (.118") Pitch Up to 5.0A per circuit 600V AC rating UL 94V-0, CSA, TUV approved Main Connector Pin assignment CAN BUS Interface OpenTracker features a standard CAN Bus interface on the main connector.
www.geolink.io Open Collectors (relay connection) Operating conditions MIN MAX Switching voltage 0VDC 32VDC Switching current - 500mA In this example were using relays with a rated switching voltage of 12VDC. Also the 12V is used to be switched, meaning were will turn on/off 12V rated devices like Lights/Motors/Horns etc. To do that you will need to connect the first coil contact to 12V and the second to OpenTracker as shown in the picture below.
www.geolink.io Hands on recommendation for Relay usage Only use car relays and certified cables inside vehicles! A relay socket will ensure proper connection! Don´t do it yourself if you are unsure what you are doing. Ask a car mechanic to do this connections for you instead. Please note: It is not our responsibility to ensure you connect the relay the appropriate way. Always ensure you read the specifications of the relay you intend to use and the devices you want to operate.
www.geolink.io Inputs The two inputs on the Main Connector (IN1 and IN2) are analog inputs and are able to measure voltages up to 32 volts. Operating conditions Analog input Resolution (Vpin = Vinput * 22 / (220+22)) V input 8 bit MIN MAX 0VDC 32VDC Using the Inputs (IN1 / IN2) This example shows how to read the analog inputs on the Main Connector (External IO) and print the output to the debug port. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27.
www.geolink.io 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 16 // print the results to the serial monitor: debug_print(F("IN1 = " )); debug_print(outputValue); debug_print(F("V (")); debug_print(sensorValue); debug_print(F(")")); debug_port.println(" "); // Read IN2 Value // read the analog in value: sensorValue = analogRead(AIN_EXT_IN2); // map it to the range of the analog out: outputValue = sensorValue * (242.0f / 22.0f * ANALOG_VREF / 1024.
www.geolink.io Voltage detection VDET (ignition detection) The voltage detection is designed to give feedback about the power status. If the Pin VDET is connected to the Ignition line of a car the Tracker is able to detect a logical 1 (Ignition off) or a logical 0 (ignition on) on S_DETECT. This is useful to put the tracker asleep or wake it up. VDET is a Digital input.
www.geolink.io Battery monitoring (AIN_S_INLEVEL) OpenTracker hast got the possibility to monitor the input voltage. This is done via the power input (VIN) and no additional cables have to be connected to the tracker. Using Battery Monitoring The following example shows how to measure the Supply voltage and print it to the debug port. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37.
www.geolink.io Customizable EXT PIN Using EXT PIN The EXT Pin on the main connector has no function. It is routed to the internal I/O connector. This may be used for anything the user desires. For example with a 1-wire communication or additional analog lines. Simply connect the IO_TO_EXT Pin on the Internal I/O pin header to your custom setup. Please note: When connecting any Internal I/O Pin to the IO_TO_EXT that those have 3.3V levels and are directly connected to the MCU.
www.geolink.io LEDs OpenTracker has two LEDs for status indication. The Green LED named NET indicates the network status of the M95 modem and cannot be used for other purpose as connected directly to the GSM Modem. The Red LED can be programmed to indicate various information. Using the LEDs PWR LED (red) The power LED can be programmed. Please see below the Arduino Example: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. #include
www.geolink.io Internal I/O The Internal I/O 20-pin Expansion connector is a standard 2.54mm Pin header which is not populated. It features the following pinout: 1 x SPI 2 x UART 1 x I2C Analog PWM GPIO (nReset) (Erase) 3.3V 4V VIN GND PLEASE NOTE: IMPORTANT NOTE! The I/O voltage levels are not 5V tolerant! Only use 3.3V levels! The internal I/O are left for custom Expansions done by the user to add functionalities used in special applications. Schematic User Manual (1.
www.geolink.io USB Interface The USB connector is used to program and debug the OpenTracker board. To be able to communicate with the tracker via USB the tracker needs to be connected to a power supply as well. 1. Install Arduino IDE 1.5.7 or later on the workstation used. 2. Use a micro USB Type B cable and plug it into the board. 3.
www.geolink.io JTAG Interface OpenTracker has got a JTAG interface which may be used for programming and debugging. The JTAG connector is a not populated 10-pin .050 inch pitch male header. The recommended Debugger is the Atmel SAM-ICE for Atmel SAMA5, SAM3, SAM4, SAM7 and SAM9 ARM® core-based microcontrollers in connection with ARM-JTAG-20-10 connector Adapter from Olimex. More info at: Atmel SAM-ICE http://www.atmel.com/tools/atmelsam-ice.aspx?tab=overview ARM-JTAG-20-10 https://www.olimex.
www.geolink.io Software Arduino IDE If you just want to use OpenTracker to Track your device you do not need to do these steps. It is all there and configured for this use. But if you want to take advantage of all IO and additional features follow the instructions below and you are ready to develop your own software with Arduino IDE. Adding OpenTracker 2 as Board to Arduino IDE Make sure you have a recent Arduino IDE (version 1.6.4 or later).
www.geolink.io Troubleshooting Reset Soft bricked board – Flash locked During development process it may happen the board will be bricked and compiler output will look like: Erase flash Write 51852 bytes to flash Flash page is locked [ ] 0% (0/203 pages) put DueFlashStorage.cpp to arduino-1.5.6-r2/libraries/DueFlashStorage Please follow the below instructions to solve this. How to Reset a Soft bricked board You can try to force a mass erase on the MCU Flash.
www.geolink.io Operating Conditions Parameter MIN MAX Operating temperature - 35°C + 80°C Storage temperature - 45°C + 90°C Power supply + 9 VDC 12 VDC / 24 VDC Supply current (I GSM/GPS on @ 12V / 24V) 400 mA / 200 mA Supply current (I GSM/GPS off @ 12V / 24V) 100 mA / 50 mA Supply current (I sleep @ 12V / 24V) + 32 VDC 5 mA Internal Expansion I/O voltage level 0 VDC - 3.
www.geolink.io How to get support Please feel free to contact us with any questions, queries or suggestions. If your question is about technical support or troubleshooting for one of our products, we kindly ask you to check first our documentation for a possible solution. If you cannot find the solution you are looking for, then please write to support@geolink.io providing all possible details. © Geolink all right reserved.