Initial Provisioning [Yabby3]
Written by Matthew Clark-Massera
Updated at October 2nd, 2023
Table of Contents
This guide is intended to assist new users in getting an Yabby3 online for the first time. Once you have some experience with the device, this process may change slightly.
e.g. you may wish to queue firmware and parameter updates before inserting a SIM and batteries - so that the device picks up new settings once it gets online.
In the Box
You will get a compact box containing the Yabby3. The 6 housing screws will be in a small packet inside the housing.
Screw Type: 2.5mm x 8mm - Pozi-Pan-Head Screws.
Provisioning Process
Electrostatic Discharge (ESD) Warning
The components used in the Yabby3 can be damaged by Electrostatic Discharge (ESD). Suitable anti-static precautions (such as a grounded wrist strap) need to be taken when inserting the SIM card or handling the printed circuit board. Avoid touching any of the components or the GPS & GSM antennas. The manufacturer's warranty does not cover ESD damage.
1. Provision on Tracking Platform
While this is not specifically required to 'fire up' a device, it is generally helpful to do this step first as it will mean if all goes according to plan, we'll simply see our device appear online in this platform.
Telematics Guru users can follow the guide here Creating Assets in Telematics Guru
2. Insert SIM Card
The Yabby3 uses a Nano (4FF) SIM Card.
The Yabby3 operates on LTE-M or NB-IoT networks, and as such requires a specific SIM card from these networks.
Which SIM card to use?
For information on selecting a SIM card, see SIM Providers: LTE-M/Nb-IoT + Roaming, and Setup
Locate the silver SIM holder on the PCB. There is an image on the silkscreen which shows the SIM orientation
Slide the SIM into the holder with the keyed corner first and the SIM contacts orientated down to the main board.
3. Insert Batteries
Battery Selection
The Yabby3 requires 3 x AAA batteries. Selecting a suitable set of batteries is critical to the overall device performance.
For information on which batteries to select, see: Battery Recommendations [Yabby3]
Key Requirements:
- 3-5.5V Input Voltage Range
- LiFeS2 (i.e. Energizer Ultimate Lithium) or Alkaline battery types supported.
If in doubt, speak to our support team. Energizer Ultimate Lithium batteries are a great 'default' option for most use cases.
Insert the batteries, following the markings on the battery holder indicating the polarity. The springs are the negative terminals.
4. Getting Online
Once the batteries are inserted, the internal LED will come on and flash. The device will do the following:
- Connect to the server: If the SIM card works the device will connect to the OEM Server and attempt to download any firmware and parameter updates then fetch fresh GPS aiding data.
- Get a GPS Fix: The device will attempt to get a GPS fix. You can speed this up by moving to an area with good GPS signal.
- Reconnect to the server: The device will attempt to connect again to upload the result of the GPS Fix.
If the device does not complete these steps in 10 minutes, it will go to sleep and try again on the next heartbeat or the next trip start.
We are online!
Once these steps are completed, if all has gone to plan, we will be able to see the device on the map on our tracking platform.
The OEM Installer Page
Some users/installers may not have access to our end tracking platform, so the OEM Installer page can be used. It allows for a quick device check without giving away any sensitive information. It's also a handy tool for those with OEM/TG access
Go to www.oemserver.com/installer and search for the serial number to confirm that it has
- Connected
- Committed
- Got a GPS Fix
Troubleshooting
In the rare event the device does not connect, commit, or get a GPS fix. Troubleshooting steps are detailed below.
Device does not connect
- Check the LED is flashing, if the LED is not flashing, either:
- The batteries inserted are dead. Test with a battery tester to check, or try a fresh set
- The device may have an issue, in which case contact DM for RMA information
- The device has not properly reset. Remove batteries for 20 seconds, and reinsert.
- Confirm your SIM card is active
- It is worth trying a SIM card from another connected DM device if possible (as that SIM is proven working)
- Try a fresh set of batteries (they may have enough power to flash the LED but not enough to upload data)
- If it is your first time using a new type of SIM or network, you may need to apply certain network settings with a DMLink Cable
Device does not Commit
Typically, this is due to the device not yet being configured on the end server. Make sure this has been done.
See Since Committed/Since Connected and Troubleshooting for troubleshooting steps.
Device does not get a GPS Fix
If after leaving the device for 5-10 minutes to attempt to get a GPS fix (the very first one can take a short while)
- Take the device outdoors, with a clear view of the sky.
- Remove batteries for 20 seconds, and reinsert. This restarts the device and it will immediately attempt to get a fix, and it should now be in great GPS signal, and get a fix.
- Failing this, the device may have an issue with the GPS. See GPS Troubleshooting, or contact DM Support.