Getting started with Thingy:91
This guide helps you get started with Thingy:91. It tells you how to update the Thingy:91 application and modem firmware and connect the Thingy:91 to nRF Cloud.
Requirements for setting up the Thingy:91
Make sure you have all the required hardware and that your computer has one of the supported operating systems.
Hardware
nano-Subscriber Identity Module (SIM) card that supports LTE-M or Narrowband Internet of Things (NB-IoT) (The Thingy:91 comes shipped with an iBasis SIM card.)
Micro-USB 2.0 cable
Computer
Software
Microsoft Windows 10
macOS X, latest version
Ubuntu Linux, latest Long Term Support (LTS) version
Preparing for setup
Before you start updating the modem firmware and application on the Thingy:91, you must do some preliminary configurations.
Complete the following steps to prepare the Thingy:91 for setup:
Install the nRF Connect Programmer application on the computer:
Download and install nRF Connect for Desktop.
Open nRF Connect for Desktop.
Find Programmer in the list of applications and click Install.
Download the firmware:
Download the zip file containing the latest Thingy:91 application and modem firmware.
Extract the zip file to a folder of your choice.
The
CONTENTS.txt
file in the extracted folder contains the location and names of the different firmware images.Note
You can also use these precompiled firmware image files for restoring the firmware to its initial image.
Prepare the Thingy:91 hardware:
Open the box and take out the Thingy:91 and the iBasis Subscriber Identity Module (SIM) card it comes shipped with.
Plug the Thingy:91 into the computer using a micro-Universal Serial Bus (USB) cable.
Power the Thingy:91 on by switching SW1 to the ON position.
Updating firmware
Thingy:91 (v1.5.0 or lower) comes preloaded with the nRF9160: Asset Tracker firmware and modem firmware on the nRF9160 System in Package (SiP), and the Connectivity bridge application firmware on the nRF52840 System on Chip (SoC) that enable the device to use the environment sensors and track the device using Global Positioning System (GPS). The data is transmitted to nRF Cloud.
Before you start using the Thingy:91, it is recommended that you update the application firmware to nRF9160: Asset Tracker v2. You must also update the modem firmware. You can do this through Universal Serial Bus (USB) (MCUboot) or an external debug probe using the Programmer application.
Note
To update the Thingy:91 through USB, the nRF9160 SiP and nRF52840 SoC bootloaders must be factory-compatible. The bootloaders might not be factory-compatible if the nRF9160 SiP or nRF52840 SoC has been updated with an external debug probe. To restore the bootloaders, program the nRF9160 SiP or nRF52840 SoC with the Thingy:91 firmware files through an external debug probe.
Updating firmware through USB
You can update the Thingy:91 application and modem firmware over Universal Serial Bus (USB) by using MCUboot, which is a secure bootloader that can be used to update applications without an external debugger.
Before you start, make sure the Thingy:91 is connected to the computer with a micro-USB cable.
Note
Do not unplug the Nordic Thingy:91 during this process.
To update the firmware, complete the following steps:
Open nRF Connect for Desktop and launch the Programmer application.
Scroll down in the menu on the left and make sure Enable MCUboot is selected.
Update the nRF52840 System on Chip (SoC) application:
Switch off the Thingy:91.
Press SW4 while switching SW1 to the ON position.
In the Programmer navigation bar, click Select device. A drop-down menu appears.
In the menu, select the entry corresponding to your device.
Note
The device entry might not be the same in all cases and can vary depending on the application version.
In the menu on the left, click Add file in the File section, and select Browse. A file explorer window appears.
Navigate to the folder you downloaded and extracted from the Nordic Semiconductor website in the Download firmware step.
Open the folder that contains the HEX files for updating over USB. See the
CONTENTS.txt
file for information on which file you need.Select the Connectivity bridge firmware file.
Click Open.
Scroll down in the menu on the left to Device and click Write.
The MCUboot DFU window appears.
In the MCUboot DFU window, click Write. When the update is complete, a Completed successfully message appears.
Scroll up in the menu on the left to File and click Clear files.
Update the modem firmware on the nRF9160 System in Package (SiP):
Switch off the Thingy:91.
Press SW3 while switching SW1 to the ON position.
In the menu, select Thingy:91.
In the menu on the left, click Add file in the File section, and select Browse. A file explorer window appears.
Navigate to the folder you downloaded and extracted from the Nordic Semiconductor website in the Download firmware step.
Find the modem firmware zip file with the name similar to
mfw_nrf9160_*.zip
and the number of the latest version.Note
Do not extract the modem firmware zip file.
Select the zip file and click Open.
In the Programmer application, scroll down in the menu on the left to Device and click Write.
The Modem DFU via MCUboot window appears.
In the Modem DFU via MCUboot window, click Write. When the update is complete, a Completed successfully message appears.
Update the nRF9160 SiP application:
Switch off the Thingy:91.
Press SW3 while switching SW1 to the ON position.
In the Programmer navigation bar, click Select device. A drop-down menu appears.
In the menu, select Thingy:91.
In the menu on the left, click Add file in the File section, and select Browse. A file explorer window appears.
Navigate to the folder you downloaded and extracted from the Nordic Semiconductor website in the Download firmware step.
Open the folder that contains the HEX files for updating over USB. See the
CONTENTS.txt
file for information on which file you need.Select the appropriate Asset Tracker v2 firmware file.
Note
If you are connecting over NB-IoT and your operator does not support ePCO, select the file that has legacy Protocol Configuration Options (PCO) mode enabled.
Click Open.
Scroll down in the menu on the left to Device and click Write.
The MCUboot DFU window appears.
In the MCUboot DFU window, click Write. When the update is complete, a Completed successfully message appears.
Scroll up in the menu on the left to File and click Clear files.
You can now disconnect the Thingy:91 from the computer.
Next, you need to create an nRF Cloud account if you do not have one already.
Updating firmware through external debug probe
You can update the Thingy:91 application and modem firmware by using an external debug probe.
Note
The external debug probe must support Arm Cortex-M33, such as the nRF9160 DK. You need a 10-pin 2x5 socket-socket 1.27 mm IDC (Serial Wire Debug (SWD)) JTAG cable to connect to the external debug probe.
To update the firmware, complete the following steps. In these steps, the nRF9160 DK is used as the external debug probe.
Open nRF Connect for Desktop and launch the Programmer application.
Prepare the hardware:
Connect the Thingy:91 to the debug out port on a 10-pin external debug probe using a JTAG cable.
Note
When using nRF9160 DK as the debug probe, make sure that VDD_IO (SW11) is set to 1.8 V on the nRF9160 DK.
Make sure that the Thingy:91 and the external debug probe are powered on.
Note
Do not unplug or power off the devices during this process.
Connect the external debug probe to the computer with a micro-USB cable.
In the Programmer navigation bar, No devices available changes to Select device.
Click Select device and select the appropriate debug probe entry from the drop-down list.
You can identify the nRF9160 DK by the fact that it has three COM ports.
If the three COM ports are not visible, press
Ctrl+R
in Windows orcommand+R
in macOS to restart the Programmer application. The button text changes to the SEGGER ID of the selected device, and the Device Memory Layout section indicates that the device is connected.
Update the nRF52840 System on Chip (SoC) application:
Set the SWD selection switch SW2 to nRF52. See SWD Select for more information on the switch.
In the menu on the left, click Add file in the File section, and select Browse. A file explorer window appears.
Navigate to the folder you downloaded and extracted from the Nordic Semiconductor website in the Download firmware step.
Open the folder that contains the HEX files for updating over USB. See the
CONTENTS.txt
file for information on which file you need.Select the Connectivity bridge firmware file.
Click Open.
Scroll down in the menu on the left to Device and click Erase & write. The update is completed when the animation in Programmer’s Device memory layout window ends.
Scroll up in the menu on the left to File and click Clear files.
Update the modem firmware on the nRF9160 System in Package (SiP):
Set the SWD selection switch SW2 to nRF91.
In the menu on the left, click Add file in the File section, and select Browse. A file explorer window appears.
Navigate to the folder you downloaded and extracted from the Nordic Semiconductor website in the Download firmware step.
Find the modem firmware zip file with the name similar to
mfw_nrf9160_*.zip
and the number of the latest version and click Open.Note
Do not extract the modem firmware zip file.
Select the zip file and click Open.
In the Programmer application, scroll down in the menu on the left to Device and click Write.
The Modem DFU window appears.
In the Modem DFU window, click Write. When the update is complete, a Completed successfully message appears.
Note
If you have issues updating modem firmware, click Erase all before trying to update the modem again. In this case, the contents of the flash memory are deleted and the applications must be reprogrammed.
Update the nRF9160 SiP application:
Make sure the SWD selection switch SW2 is set to nRF91.
In the menu on the left, click Add file in the File section, and select Browse. A file explorer window appears.
Navigate to the folder you downloaded and extracted from the Nordic Semiconductor website in the Download firmware step.
Open the folder that contains the HEX files for updating over USB. See the
CONTENTS.txt
file for information on which file you need.Select the appropriate Asset Tracker v2 firmware file.
Click Open.
Scroll down in the menu on the left to Device and click Erase & write. The update is completed when the animation in Programmer’s Device memory layout window ends.
Scroll up in the menu on the left to File and click Clear files.
Creating an nRF Cloud account
You must sign up with nRF Cloud before you can start using the service.
To create an nRF Cloud account, complete the following steps:
Go to nRF Cloud and click Register.
Enter your email address and choose a password, then click Create Account. nRF Cloud will send you a verification email.
Copy the 6-digit verification code and paste it into the registration dialog box. If you do not see the verification email, check your junk mail for an email from no-reply@verificationemail.com.
If you closed the registration dialog box, you can repeat Step 1 and then click Already have a code?. Then enter your email and the verification code.
You can now sign in on nRF Cloud with your email and the password your chose. After signing in, you are directed to the dashboard view that displays your device count and service usage. Next, you need to activate the SIM card for the Thingy:91.
Activating the iBasis SIM card
If you are using the iBasis Subscriber Identity Module (SIM) card that comes shipped with the Thingy:91, you need to activate it in nRF Cloud.
To activate the SIM card, complete the following steps:
Scratch off the bottom area on the back of the iBasis SIM to reveal the Personal Unblocking Key (PUK) code. The Integrated Circuit Card Identifier (ICCID) code is the first 18 digits printed on the back.
Make a note of the ICCID and PUK codes. You will need them later.
Pop out the nano-SIM card.
Take off the silicone cover on the Thingy:91, and put the card in the nano-SIM card holder.
Sign in to nRF Cloud.
Click the large plus sign in the upper-left corner. The Add New window appears.
In the Add New window, click LTE Device. The Activate SIM Card window appears.
In the SIM ICCID field, enter the ICCID code that you wrote down.
In the PUK field, enter the PUK code that you wrote down.
Read the Terms and Privacy Policy. Then select the checkbox next to them.
Click Activate SIM.
The Activate SIM Card window appears.
Enter your information in the Activate SIM Card window. Then, click Submit .
The SIM Activated successfully message appears.
Connecting to nRF Cloud
To start using nRF Cloud, you need to associate the Thingy:91 to your user account.
To connect the Thingy:91 to nRF Cloud and to associate it with your user account, complete the following steps:
Make sure the Thingy:91 is switched on.
Wait for the Thingy:91 to connect to the LTE network and to nRF Cloud.
After a few moments, the nRF Cloud user association process starts. This is indicated by white double pulse blinking of the Thingy:91’s RGB LED as indicated in Operating states.
To complete the user association, navigate to nRF Cloud.
Click the large plus sign in the upper-left corner. The Add New window appears.
In the Add New window, click LTE Device.
The Activate SIM Card window appears.
Skip the Active SIM Card section by clicking on Skip this step.
The Add LTE Device window appears.
In the Device ID field, enter the text
nrf-
and after it the Thingy:91 International Mobile (Station) Equipment Identity (IMEI) code.The IMEI is the 15 digit code which you can find on a white sticker on the Thingy:91. The Device ID is case sensitive, so make sure all the letters are lower-case.
In the PIN/HWID field, enter the Personal Identification Number (PIN) which is printed on the white sticker on the Thingy:91.
Click Add Device.
The message Device added to account. Waiting for it to connect… appears.
Note
If you see an error message, check the error code and see nRF Cloud REST API (v1) in nRF Cloud to find out what is causing the error.
When the message has disappeared, go to the menu on the left and click Devices.
You can see the Thingy:91 in your device list and all the sensor data being transmitted to the cloud from the Thingy:91. The LED on the Thingy:91 should be blinking green, which indicates that it is transmitting all the data to the cloud.
Note
It might take a while for the sensor data to appear in the nRF Cloud UI, depending on the duration of time GNSS uses to search for a fix.