Overview

This application, besides its main functionality described here, can be built with Software Update over the Air (SUOTA) support. Attached scripts require Python 3.

Features:

Advertising starts automatically once the application starts, advertising contains:
- Proximity Reporter Profile information.
- SUOTA service information.
- DIS information
Standard applications for Proximity Reporter profile can be used to connect to device.
The Renesas dedicated applications for Android and iOS Renesas SUOTA can connect to device to perform software update. Those applications can be found in Play Store or Apple App Store.

Installation procedure

To install the project follow the General Installation and Debugging Procedure.

Import the project pxp_reporter from /projects/dk_apps/demos/pxp_reporter and build it in the QSPI_SUOTA or eFLASH_SUOTA configuration.

Prepare SUOTA image

SUOTA image is a binary file with a proper header that can be sent to a target device from Android or iOS device.

Image is created automatically when the corresponding build target is selected.

To create an image manually, open command prompt, navigate to a projects/dk_apps/demos/pxp_reporter folder and run script to create the image file (note: make sure to run scripts with Python 3). In case an eFLASH_SUOTA build configuration is selected, the image that will be generated can be secure.

For secure image run the command:

python mkimage.py <build_configuration> --prod_id <product_id> -s <security_config_file> --prod_keys <keys_file>

else:

python mkimage.py <build_configuration> --prod_id <product_id>

Where:

build_configuration may be DA1459x-00-Release_QSPI_SUOTA, DA1459x-00-Release_eFLASH_SUOTA etc.
product_id DA1459x-00. In case of secure image (applicable only on eFLASH_SUOTA build configurations):
security_config_file is the path of the secure_cfg.xml file (contains the configuration of the secure image)
keys_file is the path of the product_keys.xml file (contains the product keys)

The generated image file is the pxp_reporter.raw.1.0.0.1.img which contains a version number taken from a sw_version.h.

Copy Image to Android or iOS device

The image file should be copied to Android phone or tablet or to iOS device inside the SUOTA folder of the device. For iOS devices use iTunes. For Android a USB cable can be used to connect the Android device with PC in order to copy the img file or the following command can be used to send the image:

adb push <build_configuration>/pxp_reporter.raw.1.0.0.1.img /sdcard/suota

Upload image via mobile app

Run SUOTA Application and find your device. The name of the device should be Renesas PX Reporter. Select the desired device and press 'Update device' button. Choose the image to be uploaded. If settings on next screen are correct proceed with 'Send to device' button. When programming is finished device will reboot and start new program.

Manual testing

Build pxp_reporter (Release_QSPI_SUOTA) or (Release_eFLASH_SUOTA).
Program flash with the suota image using the program_qspi.py or program_eflash.py scripts or using the launchers program_qspi_jtag, program_qspi_serial, program_eflash_jtag or program_eflash_serial.
Change version number in the sw_version.h file and rebuild the pxp_reporter project.
Run mkimage.py script to create a new image.
Transfer the image to Android or iOS device.
Find the device using SUOTA Application. The name of device shall be Renesas PX Reporter.
Proceed with a software update in SUOTA Application.
When programming is finished, the device reboots automatically and advertising starts again.
The device should be visible as Renesas PX Reporter with the new version number.
When the application is running verify that Proximity Reporter profile is available and working.
When there are other active connections, SUOTA should fail.