SoftBank FOTA sample

The Softbank FOTA sample demonstrates how to run the Softbank FOTA add-on for the nRF Connect SDK library in an application in order to periodically check / download modem firmware updates.

Requirements 

The sample supports the following development kits:

Hardware platforms	PCA	Board name	Board target
nRF9160 DK	PCA10090	nrf9160dk	nrf9160dk/nrf9160/ns
nRF9151 DK	PCA10171	nrf9151dk	nrf9151dk/nrf9151/ns

Overview 

Before running this sample, make sure you have provisioned your device to nRF Cloud Provisioning.

The sample connects to LTE network, and will handle dfu events triggered by the Softbank FOTA library. Using the modem time, the Softbank FOTA library will calculate when the next check for modem firmware update will happen.

Configuration 

See Configuring and building in the nRF Connect SDK documentation for information about how to permanently or temporarily change the configuration.

Configuration options 

During development, it is recommended to see when the next update is scheduled, you can use the verbose version of the library. (CONFIG_SB_FOTA_LOG=y) For production, it is recommended to use use the non-verbose version of the library (CONFIG_SB_FOTA_LOG=n) in order to save memory

Configuration files 

The sample provides predefined configuration files for typical use cases.

The following files are available:

prj.conf - Standard default configuration file.

To configure modem trace output, see Sending traces over UART on an nRF91 Series DK.

Building and running 

This sample can be found under samples in the Softbank FOTA add-on structure.

You can build this sample as firmware image for a board target with the */ns variant (see the Requirements section above). In such cases, the sample has Cortex-M Security Extensions (CMSE) enabled and separates the firmware between Non-Secure Processing Environment (NSPE) and Secure Processing Environment (SPE). Because of this, it automatically includes the Trusted Firmware-M (TF-M).

To build the sample, follow the instructions in Building an application for your preferred building environment. See also Programming an application for programming steps and Testing and optimization for general information about testing and debugging in the nRF Connect SDK.

Testing 

After programming the sample and all prerequisites to the development kit, test it by performing the following steps:

Connect the USB cable and power on or reset your nRF91 Series DK.
Use a terminal emulator, like the Serial Terminal app, to connect to the serial port. See Testing and optimization for the required settings and steps.
Observe that the kit prints the following information:
```
SoftBank FOTA client started
```
Deploy an nRF Cloud FOTA.

In the shell observe the next fota check. For example:

<inf> sb_fota: Next update check in 14 days, 09:20:10

Use sb_fota_clock_set() to set the modem time to trick the update to happen. (Or wait simply wait ~14 days).

For example, if AT+CCLK returns 25/03/04,01:30:40+4, then use app clock shell command to set the clock:
```
uart:~$ app clock 25/03/18,10:50:40+4
```
Verify that download starts:
```
SB_FOTA_EVENT_DOWNLOADING
```

Troubleshooting 

Q: I don’t see any output log such as “… Next update check in…”. I only see “SoftBank FOTA client started”.

A: By default, the library does not use LOG. Check that you have linked the alternative verbose library CONFIG_SB_FOTA_LOG=y

Dependencies 

This sample uses the following nRF Connect SDK libraries:

nRF Cloud
(AT) Shell

It uses the following sdk-nrfxlib library:

nrfxlib_nrf_modem

It uses the following Softbank FOTA add-on.

Softbank FOTA library