This Tracker Edge-based demo listens for BLE tags / beacons that advertise identifying information. It collects a list of tags it has seen and forwards that to the Particle Cloud periodically, when the Tracker device has a geolocation and a Particle Cloud connection.
In addition, this app can collect temperature and humidity information from an attached Tracker M8 Temperature/Humidity sensor
This app allows you to correlate the location of the Tracker with the tags it has seen and the local temperature and humidity conditions. This may be useful for eg warehouse or temperature-controlled inventory management.
The full source code is available in the tagsurveyor github repo
Here's a view of how this app reports beacons in the Particle Console:
Note that for safe shipping purposes, this app supports the Tracker shipping
mode command: From the Particle Console, while the device is connected to
the cloud, you can send the following from the "cmd" function: {"cmd":"enter_shipping"}
This will cause the Tracker to power off and disconnect the battery
so that the device will not awaken during shipment.
Connecting the Tracker to USB
will reawaken it.
This application may be built with Device OS version 3.0.0.
- Clone this repository
- Init & Update Submodules
git submodule update --init --recursive
- Open Particle Workbench
- Run the
Particle: Import Project
command, follow the prompts, to select this project'sproject.properties
file and wait for the project to load - Run the
Particle: Configure Workspace for Device
command and select a compatible Device OS version and thetracker
platform when prompted (docs) - Connect your Tracker to your computer with a usb cable
- Compile & Flash using Workbench
This application may be built with Device OS version 3.0.0.
-
Clone this repository
-
Init & Update Submodules
git submodule update --init --recursive
-
Cloud build (for Tracker) with CLI :
particle compile --target 3.0.0 tracker --saveTo tagsurveyor_tracker.bin
-
Connect your Tracker to your computer with a usb cable
-
Use the CLI to flash the device using dfu:
particle usb dfu && particle flash --usb tagsurveyor_tracker.bin
The firmware uses the GNU GCC toolchain for ARM Cortex-M processors, standard peripheral libraries and Arduino's implementation of Wiring.
Unless stated elsewhere, file headers or otherwise, all files herein are licensed under an Apache License, Version 2.0. For more information, please read the LICENSE file.
If you have questions about software licensing, please contact Particle support.
This firmware is released under Apache License, Version 2.0, what does that mean for you?
- You may use this commercially to build applications for your devices! You DO NOT need to distribute your object files or the source code of your application under Apache License. Your source can be released under a non-Apache license. Your source code belongs to you when you build an application using this reference firmware.
When am I required to share my code?
- You are NOT required to share your application firmware binaries, source, or object files when linking against libraries or System Firmware licensed under LGPL.
Why?
- This license allows businesses to confidently build firmware and make devices without risk to their intellectual property, while at the same time helping the community benefit from non-proprietary contributions to the shared reference firmware.
Questions / Concerns?
- Particle intends for this firmware to be commercially useful and safe for our community of makers and enterprises. Please Contact Us if you have any questions or concerns, or if you require special licensing.
(Note! This FAQ isn't meant to be legal advice, if you're unsure, please consult an attorney)
This application must be built with device OS version 2.0.0-rc.3 and above.
- Clone this repository
$ git clone [email protected]:particle-iot/tracker-edge.git && cd ./tracker-edge
- Init & Update Submodules
$ git submodule update --init --recursive
- Open Particle Workbench
- Run the
Particle: Import Project
command, follow the prompts, and wait for the project to load - Run the
Particle: Configure Workspace for Device
command and select a compatible Device OS version and thetracker
platform when prompted (docs) - Connect your device
- Compile & Flash!
Want to contribute to the Particle tracker edge firmware project? Follow this link to find out how.
Having problems or have awesome suggestions? Connect with us here..
Enterprise customers can contact support.