1. Ask Simple Hardware
  2. IOFrog step-by-step setups

Step-by-step setup: Tracking

How to set up the device for tracking? How to do tracking with IOFrog?

Supported in: SimplePack 2.0SimplePack 3.0 Plus

Intended for: End users and integrators & platform providers to understand device behavior before direct implementation and fine-tuning (for those who want to integrate the device into their own platform, the firmware documentation is here: API 6 and API 5)

Use case description: We will use the SimplePack mode Trace me - this can be generally used for tracing the journey of lorries and any cargo imaginable. Let's say you want to monitor a package you sent via the post office. The device behaves like this: first, a message is sent when the package moves and while it's moving, a periodical message is sent every 10 minutes. If the package stops and no movement is detected any longer, the device will send an end of movement message after 10 minutes. All the messages can be shown on a map in IOFrog so you can see the exact journey your package has taken.

Detailed business case: TBD

Prerequisites:

Before-you-start checklist (you should have everything on the list if you went through the first message guide - https://ask.simplehw.eu/first-message):

☑️ Hardware/devices

☑️ Sigfox connectivity

☑️ Sigfox coverage where you need it

☑️ IOFrog platform account and access

☑️ Correctly set-up callbacks in the Sigfox backend (if you're using your own connectivity)

☑️ You're receiving messages from your devices

✅ Everything is fine!

Step-by-step guide:

1. Go to the IOFrog platform and login with your account

2. After you login, head over to your profile in the top right and make sure your Experience level is at least Explorer, otherwise you will not be able to change device downlink - if necessary, increase your level and hit Update to save the changes

3. Go to the All devices tab and click on device Setup

4. In the downlink tab, set the mode to Trace me (0...0104 in the top bar), hit Update

5. Press the button of your device for 10+ (SP 2.0) or 6+ (SP 3.0 Plus) seconds, this will trigger downlink with the new settings - the LED will keep blinking for about a minute

SimplePack 2.0                                      SimplePack 3.0 Plus

         

6. Now you need to press the button to activate the device (just for test - you need to see if your device received the downlink payload correctly or not), you should see a Start of arming and Armed messages and when you open device history or the All devices tab, the mode should be set to Trace me and the last message should be Armed

7. If you received these two messages, the device is set up correctly and you can disarm/deactivate it with a long press (2-6 seconds), you should receive a Disarmed message

8. Now comes the part where you place the device where you need it: depends on what cargo you're monitoring, but generally the device should avoid direct contact with any metal objects (you can read more here: https://ask.simplehw.eu/device-placement)

9. Once placed, activate the device by pressing the button and try moving the cargo around to make sure you are receiving all three messages.

There, all done!

Suggestions: 

  • If you're getting false reports of usage or limited reports, try playing around with accelerometer sensitivity settings (the higher the number, the less sensitive the sensor)
  • If you're losing a lot of messages, set up 3x alert repetition. This will better the performance of your device and you should lose less messages

Public data sharing: TBD

Private device sharing: You can share the device to your colleague's IOFrog account by opening the Setup interface and filling in their email in the Share tab

Need our help with customizing the settings?

Fill in this form! https://ask.simplehw.eu/use-case-definition