system/application_nvm/main.c
/*******************************************************************************
* # License
* Copyright 2019 Silicon Laboratories Inc. www.silabs.com
*******************************************************************************
*
* The licensor of this software is Silicon Laboratories Inc. Your use of this
* software is governed by the terms of Silicon Labs Master Software License
* Agreement (MSLA) available at
* www.silabs.com/about-us/legal/master-software-license-agreement. This
* software is distributed to you in Source Code format and is governed by the
* sections of the MSLA applicable to Source Code.
*
******************************************************************************/
/* Documentation for this app is available online.
* See https://docs.silabs.com/gecko-os/4/standard/latest/sdk/examples/system/application-nvm
*/
/*
* This demonstrates how to load and save settings to the application NVM.
*/
#include "gos.h"
#include "nvm_settings.h"
#define CLOUD_URL "https://my-other-cloud.com"
#define SETUP_WEB_SSID "example-ssid"
#define APPLICATION_START_LINE "\r\nNVM example starting ..."
/*************************************************************************************************/
{
gos_result_t result;
char *cloud_url;
GOS_LOG(APPLICATION_START_LINE);
// Obtain a reference to the cloud URL setting in cached NVM
{
GOS_LOG("Failed to retrieve CLOUD.URL from NVM, err:%d", result);
return;
}
modify_gecko_os_settings();
// Print the current cloud URL
GOS_LOG("\r\nApp setting: cloud-url = %s", cloud_url);
// Check if cloud URL has been modified
if (strcmp(cloud_url, CLOUD_URL) == 0)
{
GOS_LOG("Up-to-date");
}
else
{
// Update the cloud URL
strcpy(cloud_url, CLOUD_URL);
GOS_LOG("updated to: %s", cloud_url);
GOS_LOG("Saving updated value to application NVM");
{
GOS_LOG("Failed to save application settings to NVM, err:%d", result);
}
else
{
GOS_LOG("NVM settings updated");
}
}
GOS_LOG("\r\nIssue a 'reboot' command to verify the updated settings persist");
GOS_LOG("Issue command: 'nvm_reset' to reset application NVM to default values\r\n");
}
/*************************************************************************************************/
{
gos_result_t result;
GOS_LOG("Invoking application NVM reset ...");
GOS_LOG("NOTE: Plugin and Kernel settings should persist after this operation");
// This will factory reset the application NVM ONLY
// Plugins and Kernel settings will not be effected.
// If this API is successful it will reboot the device
{
GOS_LOG("Failed to reset, err:%d", result);
}
else
{
// NOTE: This must be unreachable as the above API should reboot the device
}
}
/*************************************************************************************************
* This demonstrates how to modify Gecko OS Plugins and Kernel settings.
* These settings reside in a different part of NVM than the application NVM.
*/
static void modify_gecko_os_settings(void)
{
gos_result_t result;
char ssid_buffer[128];
// Retrieve the setting from the Plugins' NVM cache
{
GOS_LOG("Failed to retrieve Gecko OS setting 'setup.web.ssid, err:%d", result);
}
else
{
GOS_LOG("Gecko OS Plugin setting: setup.web.ssid = %s", ssid_buffer);
if (strcmp(ssid_buffer, SETUP_WEB_SSID) != 0)
{
GOS_LOG("Updating to: %s", SETUP_WEB_SSID);
// Update the setting in the Plugins' NVM cache
{
GOS_LOG("Failed to update Gecko OS setting 'setup.web.ssid, err:%d", result);
}
// Save ALL cached NVM settings (Application, Plugins, Kernel) to NVM
{
GOS_LOG("Failed to save Gecko OS settings, err:%d", result);
}
else
{
GOS_LOG("Successfully updated");
}
}
else
{
GOS_LOG("Up-to-date");
}
}
}