8. Smart configuration

The SmartConfig Android application can discover and connect to SPS devices. It serves to discover, read and modify the configuration of the device. The iOS application is available in the Apple ‘App Store’ and is easily installed from there just like any other iOS application. Search for ‘SmartConsole’ or ‘Renesas SmartConsole’ to find the application.

../_images/SmartConfig.svg

Figure 21 SmartConfig Icon – Android – iOS

8.1. Installation

The Android application is available in the Google Play Store or Apple store and is easily installed from there just like any other application. To find the application, search for Renesas SmartConfig. After installation process you need to turn on your Bluetooth and allow SmartConfig to access this device`s location.

../_images/install1.svg

Figure 22 installation SmartConfig

The user must tap the SmartConfig icon to start the application. When the application is started the scan screen is displayed and the SPS devices that are within range appear. The device name, BD Address, RSSI and the advertised services are displayed in the list of discovered devices. The user can connect to any of them by tapping on that item in the list. To do a rescan, simply tap the SCAN button on the top of the screen or swipe down the list.

../_images/scan1.svg

Figure 23 Scan Screen

8.2. Functionality

When the SmartConfig application connects to a SPS device, the discovery of the configuration parameters (elements) is automatically started, followed by successive reads of the current configuration values of the parameters. The elements and the corresponding values are displayed on the screen as shown in Figure 24. To change the value of any parameter, simply tap on the parameter. Next, a list of all valid options or an edit textbox to enter a new value is displayed. The new value will be applied locally but all changed values will be sent to the remote configuration service and applied in the SPS device when the APPLY button is tapped. The user can undo the changes before they are applied to the SPS device or refresh the values with the device’s values by tapping any of the corresponding buttons on the top of the parameters list. After a successful update of the parameters, the Apply and Undo buttons are disabled. In case an Apply fails, a “Write failed” message is shown on screen and the parameter change is NOT stored in the device’s flash.

../_images/Read.svg

Figure 24 Read and Edit Configuration Parameters

The SmartConfig application uses a built-in XML file that describes all the supported configuration elements, their parameters (Group ID, Elemt ID, Name, Type, Units, Maximum size, Minimum and maximum values) and the definitions of enumerations and custom types used. If the application finds an XML file with the name config-spec.xml, it uses this to replace the built-in XML file. Since the Configurator application also uses the same XML file (see Section 6.2), this is a way to keep both applications synchronized. The Android SmartConfig application looks in the folder “Renesas Semiconductor/SmartConfig”, while the iOS one looks into the application’s Documents. Moreover, if SmartConfig finds another XML file named user-config-spec.xml, it merges this with the XML file that it finally uses (either the built-in or the config-spec.xml). This way, the user can add extra elements or different element properties, without having to alter the common config-spec.xml file.

8.3. Information and Disclaimer Screens

The ‘Information’ screen displays contact information and the version of the application. See Figure 20. The Disclaimer screen contains the disclaimer notes.

../_images/Disclaimer1.svg

Figure 25 Information & Disclaimer Screens in smartconfig