Support Home Portal Log in
Open navigation

Oyster2 - Getting Started

The Oyster2 is a compact, rugged GPS tracking device that has been designed for tracking containers, trailers, skip bins, and other assets where super-long battery life is required without sacrificing the frequency of updates and performance.

This getting started guide is only for the Oyster2 cellular version which comes in 2G or 4G Cat-M1/Nb-IoT.

The Oyster2 has the capacity to hold 48000 records in it's memory in case the unit moves out of reception. These records won't be removed until a sucessfully confirmed receival by the end server has been transmitted.

See the Oyster2 product page on for more specifications.

Datasheet & High Resolution Images

  Oyster2 Downloads

View the latest tech-specs and high resolution device images for the Oyster2

This article will help you get up and running to test the Oyster2.

In The Box

You'll get a compact box containing the Oyster2. The 6 housing screws will be in a small packet inside the housing

Setting It Up

Sim Card

The Oyster2 uses a Micro SIM card – form factor 3FF. The SIM holder is on the underside of the PCB, so the device will need to be lifted out of the housing to insert the SIM.


When handling the Oyster2 be careful not to touch the GPS antenna, to minimise the risk of damaging the sensitive GPS amplifiers with static discharge. It is recommended to wear an anti-static wrist strap. 

Then slide the SIM into the holder with the keyed corner first and the SIM contacts orientated down to the main board.

To easily get up and running:

  • The SIM should not have a PIN on it, unless you use the device specific PIN.
  • The SIM should have credit or airtime.


Make sure once you're online, you should Set the Network Profile (APN and bandmasks) for the best performance.


The Oyster2 uses 3 x 1.5-3.6V AA batteries and does not have reverse voltage protection so take care to insert the batteries with the correct polarity, the springs being the negative terminals.

Do not use Alkaline Batteries

It is very important to use 1.5V Lithium, or 3.6V Lithium thionyl chloride (LTC) AA batteries. If you use normal Alkaline AA batteries then they will only operate for about 50% of their useful life.

Once inserted, the LED should flash continuously. If it does not, it means the unit has not yet reset. In this case, remove the batteries for a minute or two to allow any residual charge to drain, and then reinsert them. Failure to reset the unit will prevent proper resetting of the battery life statistics.

The Oyster2 is fitted with a Coulomb Counter which tracks the devices energy consumption. It is hard to predict the battery life of LTC batteries from voltage alone due to their flat discharge curve, the Battery Meter enables an accurate battery level to be determined for great features such as:

  1. Accurate Low Battery Alerts - Alerts can be set at any level which provides enough time for new batteries to be fitted.
  2. Battery Life Predictions - The Oyster2 can simply be deployed in the application with the desired settings for a short time (a week or so). The energy usage over this time can be determined, and from there battery life can predicted accurately
    Read more about this feature here - Battery Management | Oyster2 - Battery Capacity Estimate and Low Battery Flag

Getting Online

Once the batteries are inserted, the internal LED will come on and flash. The device will do the following:

  1. 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.
  2. 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.
  3. 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. Go to and search for the serial number to confirm that it has connected recently.

If the LED flashes but the Oyster2 does not connect, check the SIM is in the holder correctly and check that the SIM is working.

Opening and Closing the Housing

Once online, all that remains is to seal the housing. Seal the device carefully to achieve the IP-67 rating.Ensure that the clear silicon seal is in good condition, is lying flat, and is not fouled by any plastic debris or other material.

  1. Close the housing, and gently squeeze it shut. Foam on the lid will compress against the batteries, holding them firmly in place.
  2. Tighten the 6 screws to a uniform tightness. On the first assembly, the screws may be quite stiff. An electric screwdriver with a torque limiting clutch is recommended. The torque setting should be 0.7Nm. The screws used are a thermoplastic screw: 3.5mm x 12mm (BN82428). If you are after a stainless steel variant, the product code to source is BN82429.
  3. If you wish to replace the batteries and open the housing, be sure to check that the silicon seal is in good condition before closing the housing again.

Device Installation

The Oyster2 can be mounted on the asset to be tracked using screws, bolts, cable ties, or industrial adhesives. When choosing a mounting point, you have two competing goals:

  • To minimise the chances of the device being accidentally crushed or dislodged.
  • To maximise the GPS and mobile reception and provide adequate ventilation.

Since the Oyster2 is a battery powered device, reception is critical to its performance. While other members of the DM product family rely on their high-quality GPS receivers for enhanced accuracy and the ability to operate in very low signal, the primary concern for the Oyster2 is the battery used during each GPS fix. 

If possible, choose a mounting point that will not result in elevated temperatures.

For instance, mounting the Oyster2 in direct sunlight on the dash of an non-ventilated cabin may cook the batteries, leading to abnormally short service life.

Default Settings

Changing Settings

This is handled via our OEM Server interface. See How to change the update rate on the Oyster2, Remora2 and Yabby

By default, the Oyster2 is setup for trip tracking. The following default settings apply:

  • Out of Trip: 12 hour heartbeats. This is a GPS point and an upload every 12 hours.
  • In Trip:
    • Start trip threshold of 250m
    • Upload on trip start.
    • GPS points every 2 minutes
    • Upload every 30 minutes.
    • End a trip after 5 minutes of no movement.
    • Upload on trip end.

These settings and many more are configurable in the OEM Admin Interface. The defaults provide a good starting point but it is important to monitor and tweak your settings to ensure the battery life is acceptable. Incorrect settings can flatten the batteries quickly. Contact support for help with this.

Default I/O Mappings

The Digital and Analogue mappings for the Oyster are explained below. Please note the minor differences between Telematics Guru mappings and what is received in the raw data. Telematics Guru manipulates the raw data.

Telematics Guru

On Telematics Guru, the defaults are shown graphically below. These can be viewed and edited under the IO Mappings tab when editing an asset (click the gear icon on the manage assets screen, and select edit). For the Analogue Mappings, the analogue number is on the left. The meaning for that number is given in the name. The type, unit and conversion factor explain how to interpret the number. The conversion factor can be thought of as the multiplier to convert the raw number to the right unit. For the Digital Mappings, the digital input/output number is on the left. Note inputs vs outputs. All Oyster default mappings are inputs. The digital input/output bit explains the position in the Digital Data bit field.

There are some important notes regarding the mappings in Telematics Guru

  • The Profile Counters (Analogue 11 and up) will move to a dedicated message that will be sent less often. This is pending in May 2017.
  • The Status bits (Digital 24 and up) are copied from the special status bits field, which are 2 dedicated bytes in the Digital Data field. See below for more explanation. 

Raw Data from OEM

The raw data will appear slightly differently to what is show above in Telematics Guru. Here are the key differences:

  1. Analogues 1-10 come in the 16 bit analogue field ID.
  2. Analogues 11-20 come in the 32 bit analogue field ID.
  3. Digital Inputs come in the Digital Data field, as 4 bytes. This is a total of 32 inputs. The status bits shown above (Trip State; Battery) are not in these 32 bits.
  4. Digital Outputs come in the Digital Data field as 2 bytes. This is a total of 16 outputs. The
  5. The Status bits come in the Digital Data field, as 2 bytes. This is a total of 16 bit flags:
    1. Trip State is bit 0 of the status bits
    2. Battery Good is bit 1 of the status bits.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.