Christos Vasilakis / Mbed OS pelion-example-common-DISCO_F413ZH

pelion-example-common-DISCO_F413ZH

main.cpp@7:24d524c2bdcc, 2018-12-16 (annotated)

Committer:
screamer
Date:
Sun Dec 16 12:02:30 2018 +0000
Revision:
7:24d524c2bdcc
Parent:
5:766c011942b4
Child:
8:579904ba4ba1
Improve main application documentation. Also make use of FAT FS for SD card block device

Who changed what in which revision?

UserRevisionLine numberNew contents of line
screamer 0:ea30ba97a865 1 // ----------------------------------------------------------------------------
screamer 0:ea30ba97a865 2 // Copyright 2016-2018 ARM Ltd.
screamer 0:ea30ba97a865 3 //
screamer 0:ea30ba97a865 4 // SPDX-License-Identifier: Apache-2.0
screamer 0:ea30ba97a865 5 //
screamer 0:ea30ba97a865 6 // Licensed under the Apache License, Version 2.0 (the "License");
screamer 0:ea30ba97a865 7 // you may not use this file except in compliance with the License.
screamer 0:ea30ba97a865 8 // You may obtain a copy of the License at
screamer 0:ea30ba97a865 9 //
screamer 0:ea30ba97a865 10 // http://www.apache.org/licenses/LICENSE-2.0
screamer 0:ea30ba97a865 11 //
screamer 0:ea30ba97a865 12 // Unless required by applicable law or agreed to in writing, software
screamer 0:ea30ba97a865 13 // distributed under the License is distributed on an "AS IS" BASIS,
screamer 0:ea30ba97a865 14 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
screamer 0:ea30ba97a865 15 // See the License for the specific language governing permissions and
screamer 0:ea30ba97a865 16 // limitations under the License.
screamer 0:ea30ba97a865 17 // ----------------------------------------------------------------------------
screamer 0:ea30ba97a865 18 #ifndef MBED_TEST_MODE
screamer 0:ea30ba97a865 19
screamer 0:ea30ba97a865 20 #include "mbed.h"
screamer 0:ea30ba97a865 21 #include "simple-mbed-cloud-client.h"
screamer 0:ea30ba97a865 22 #include "FATFileSystem.h"
screamer 1:37392c1b4cf8 23 #include "LittleFileSystem.h"
screamer 0:ea30ba97a865 24
screamer 0:ea30ba97a865 25 // An event queue is a very useful structure to debounce information between contexts (e.g. ISR and normal threads)
screamer 0:ea30ba97a865 26 // This is great because things such as network operations are illegal in ISR, so updating a resource in a button's fall() function is not allowed
screamer 0:ea30ba97a865 27 EventQueue eventQueue;
screamer 0:ea30ba97a865 28
screamer 0:ea30ba97a865 29 // Default network interface object
screamer 0:ea30ba97a865 30 NetworkInterface *net = NetworkInterface::get_default_instance();
screamer 0:ea30ba97a865 31
screamer 7:24d524c2bdcc 32 // Default block device available on the target board
screamer 1:37392c1b4cf8 33 BlockDevice *bd = BlockDevice::get_default_instance();
screamer 7:24d524c2bdcc 34
screamer 7:24d524c2bdcc 35 #if COMPONENT_SD || COMPONENT_NUSD
screamer 7:24d524c2bdcc 36 // Use FATFileSystem for SD card type blockdevices
screamer 7:24d524c2bdcc 37 FATFileSystem fs("fs", bd);
screamer 7:24d524c2bdcc 38 #else
screamer 7:24d524c2bdcc 39 // Use LittleFileSystem for non-SD block devices to enable wear leveling and other functions
screamer 7:24d524c2bdcc 40 LittleFileSystem fs("fs", bd);
screamer 7:24d524c2bdcc 41 #endif
screamer 0:ea30ba97a865 42
screamer 1:37392c1b4cf8 43 // Default User button for GET example
screamer 4:05845431da95 44 InterruptIn button(BUTTON1);
screamer 1:37392c1b4cf8 45 // Default LED to use for PUT/POST example
screamer 1:37392c1b4cf8 46 DigitalOut led(LED1);
screamer 7:24d524c2bdcc 47 // Temperature reading from microcontroller
screamer 1:37392c1b4cf8 48 AnalogIn adc_temp(ADC_TEMP);
screamer 7:24d524c2bdcc 49 // Voltage reference reading from microcontroller
screamer 1:37392c1b4cf8 50 AnalogIn adc_vref(ADC_VREF);
screamer 0:ea30ba97a865 51
screamer 1:37392c1b4cf8 52 #define SENSORS_POLL_INTERVAL 1.0
screamer 0:ea30ba97a865 53
screamer 1:37392c1b4cf8 54 // Declaring pointers for access to Pelion Client resources outside of main()
screamer 1:37392c1b4cf8 55 MbedCloudClientResource *res_button;
screamer 1:37392c1b4cf8 56 MbedCloudClientResource *res_led;
screamer 1:37392c1b4cf8 57 MbedCloudClientResource *res_temperature;
screamer 1:37392c1b4cf8 58 MbedCloudClientResource *res_voltage;
screamer 1:37392c1b4cf8 59
screamer 1:37392c1b4cf8 60 // When the device is registered, this variable will be used to access various useful information, like device ID etc.
screamer 1:37392c1b4cf8 61 static const ConnectorClientEndpointInfo* endpointInfo;
screamer 0:ea30ba97a865 62
screamer 0:ea30ba97a865 63 /**
screamer 0:ea30ba97a865 64 * PUT handler
screamer 0:ea30ba97a865 65 * @param resource The resource that triggered the callback
screamer 0:ea30ba97a865 66 * @param newValue Updated value for the resource
screamer 0:ea30ba97a865 67 */
screamer 1:37392c1b4cf8 68 void led_put_callback(MbedCloudClientResource *resource, m2m::String newValue) {
screamer 0:ea30ba97a865 69 printf("PUT received, new value: %s\n", newValue.c_str());
screamer 1:37392c1b4cf8 70 led = atoi(newValue.c_str());
screamer 0:ea30ba97a865 71 }
screamer 0:ea30ba97a865 72
screamer 0:ea30ba97a865 73 /**
screamer 0:ea30ba97a865 74 * POST handler
screamer 0:ea30ba97a865 75 * @param resource The resource that triggered the callback
screamer 0:ea30ba97a865 76 * @param buffer If a body was passed to the POST function, this contains the data.
screamer 0:ea30ba97a865 77 * Note that the buffer is deallocated after leaving this function, so copy it if you need it longer.
screamer 0:ea30ba97a865 78 * @param size Size of the body
screamer 0:ea30ba97a865 79 */
screamer 1:37392c1b4cf8 80 void led_post_callback(MbedCloudClientResource *resource, const uint8_t *buffer, uint16_t size) {
screamer 1:37392c1b4cf8 81 printf("POST received. Going to blink LED pattern: %s\n", res_led->get_value().c_str());
screamer 1:37392c1b4cf8 82 led = atoi(res_led->get_value().c_str());
screamer 1:37392c1b4cf8 83 }
screamer 0:ea30ba97a865 84
screamer 1:37392c1b4cf8 85 /**
screamer 1:37392c1b4cf8 86 * Button function triggered by the physical button press.
screamer 1:37392c1b4cf8 87 */
screamer 1:37392c1b4cf8 88 void button_press() {
screamer 1:37392c1b4cf8 89 int v = res_button->get_value_int() + 1;
screamer 1:37392c1b4cf8 90 res_button->set_value(v);
screamer 1:37392c1b4cf8 91 printf("Button clicked %d times\n", v);
screamer 0:ea30ba97a865 92 }
screamer 0:ea30ba97a865 93
screamer 0:ea30ba97a865 94 /**
screamer 0:ea30ba97a865 95 * Notification callback handler
screamer 0:ea30ba97a865 96 * @param resource The resource that triggered the callback
screamer 0:ea30ba97a865 97 * @param status The delivery status of the notification
screamer 0:ea30ba97a865 98 */
screamer 0:ea30ba97a865 99 void button_callback(MbedCloudClientResource *resource, const NoticationDeliveryStatus status) {
screamer 0:ea30ba97a865 100 printf("Button notification, status %s (%d)\n", MbedCloudClientResource::delivery_status_to_string(status), status);
screamer 0:ea30ba97a865 101 }
screamer 0:ea30ba97a865 102
screamer 0:ea30ba97a865 103 /**
screamer 0:ea30ba97a865 104 * Registration callback handler
screamer 0:ea30ba97a865 105 * @param endpoint Information about the registered endpoint such as the name (so you can find it back in portal)
screamer 0:ea30ba97a865 106 */
screamer 0:ea30ba97a865 107 void registered(const ConnectorClientEndpointInfo *endpoint) {
screamer 7:24d524c2bdcc 108 printf("Registered to Pelion Device Management. Endpoint Name: %s\n", endpoint->internal_endpoint_name.c_str());
screamer 1:37392c1b4cf8 109 endpointInfo = endpoint;
screamer 0:ea30ba97a865 110 }
screamer 0:ea30ba97a865 111
screamer 1:37392c1b4cf8 112 /**
screamer 1:37392c1b4cf8 113 * Update sensors and report their values.
screamer 1:37392c1b4cf8 114 * This function is called periodically.
screamer 1:37392c1b4cf8 115 */
screamer 1:37392c1b4cf8 116 void sensors_update() {
screamer 1:37392c1b4cf8 117 float temp = adc_temp.read()*100;
screamer 1:37392c1b4cf8 118 float vref = adc_vref.read();
screamer 1:37392c1b4cf8 119 printf("ADC temp: %6.4f C, vref: %6.4f %%\r\n", temp, vref);
screamer 1:37392c1b4cf8 120 if (endpointInfo) {
screamer 1:37392c1b4cf8 121 res_temperature->set_value(temp);
screamer 1:37392c1b4cf8 122 res_voltage->set_value(vref);
screamer 1:37392c1b4cf8 123 }
screamer 1:37392c1b4cf8 124 }
screamer 1:37392c1b4cf8 125
screamer 1:37392c1b4cf8 126
screamer 0:ea30ba97a865 127 int main(void) {
screamer 0:ea30ba97a865 128 printf("Starting Simple Pelion Device Management Client example\n");
screamer 1:37392c1b4cf8 129
screamer 1:37392c1b4cf8 130 // If the User button is pressed ons start, then format storage.
screamer 7:24d524c2bdcc 131 DigitalIn *user_button = new DigitalIn(BUTTON1);
screamer 7:24d524c2bdcc 132 #if TARGET_DISCO_L475VG_IOT01A
screamer 7:24d524c2bdcc 133 // The user button on DISCO_L475VG_IOT01A works the other way around
screamer 7:24d524c2bdcc 134 const int PRESSED = 0;
screamer 7:24d524c2bdcc 135 #else
screamer 1:37392c1b4cf8 136 const int PRESSED = 1;
screamer 7:24d524c2bdcc 137 #endif
screamer 1:37392c1b4cf8 138 if (user_button->read() == PRESSED) {
screamer 1:37392c1b4cf8 139 printf("User button is pushed on start. Formatting the storage...\n");
screamer 7:24d524c2bdcc 140 int storage_status = fs.reformat(bd);
screamer 1:37392c1b4cf8 141 if (storage_status != 0) {
screamer 7:24d524c2bdcc 142 if (bd->erase(0, bd->size()) == 0) {
screamer 7:24d524c2bdcc 143 if (fs.format(bd) == 0) {
screamer 1:37392c1b4cf8 144 storage_status = 0;
screamer 1:37392c1b4cf8 145 printf("The storage reformatted successfully.\n");
screamer 1:37392c1b4cf8 146 }
screamer 1:37392c1b4cf8 147 }
screamer 1:37392c1b4cf8 148 }
screamer 1:37392c1b4cf8 149 if (storage_status != 0) {
screamer 1:37392c1b4cf8 150 printf("ERROR: Failed to reformat the storage (%d).\n", storage_status);
screamer 1:37392c1b4cf8 151 }
screamer 1:37392c1b4cf8 152 }
screamer 0:ea30ba97a865 153
screamer 0:ea30ba97a865 154 // Connect to the internet (DHCP is expected to be on)
screamer 1:37392c1b4cf8 155 printf("Connecting to the network using Wifi...\n");
screamer 1:37392c1b4cf8 156 net = NetworkInterface::get_default_instance();
screamer 0:ea30ba97a865 157
screamer 1:37392c1b4cf8 158 nsapi_error_t net_status = -1;
screamer 1:37392c1b4cf8 159 for (int tries = 0; tries < 3; tries++) {
screamer 1:37392c1b4cf8 160 net_status = net->connect();
screamer 1:37392c1b4cf8 161 if (net_status == NSAPI_ERROR_OK) {
screamer 1:37392c1b4cf8 162 break;
screamer 1:37392c1b4cf8 163 } else {
screamer 1:37392c1b4cf8 164 printf("Unable to connect to network. Retrying...\n");
screamer 1:37392c1b4cf8 165 }
screamer 1:37392c1b4cf8 166 }
screamer 1:37392c1b4cf8 167
screamer 1:37392c1b4cf8 168 if (net_status != NSAPI_ERROR_OK) {
screamer 1:37392c1b4cf8 169 printf("ERROR: Connecting to the network failed (%d)!\n", net_status);
screamer 0:ea30ba97a865 170 return -1;
screamer 0:ea30ba97a865 171 }
screamer 0:ea30ba97a865 172
screamer 0:ea30ba97a865 173 printf("Connected to the network successfully. IP address: %s\n", net->get_ip_address());
screamer 0:ea30ba97a865 174
screamer 7:24d524c2bdcc 175 printf("Initializing Pelion Device Management Client...");
screamer 7:24d524c2bdcc 176
screamer 1:37392c1b4cf8 177 // SimpleMbedCloudClient handles registering over LwM2M to Pelion DM
screamer 0:ea30ba97a865 178 SimpleMbedCloudClient client(net, bd, &fs);
screamer 0:ea30ba97a865 179 int client_status = client.init();
screamer 0:ea30ba97a865 180 if (client_status != 0) {
screamer 1:37392c1b4cf8 181 printf("ERROR: Pelion Client initialization failed (%d)\n", client_status);
screamer 0:ea30ba97a865 182 return -1;
screamer 0:ea30ba97a865 183 }
screamer 0:ea30ba97a865 184
screamer 0:ea30ba97a865 185 // Creating resources, which can be written or read from the cloud
screamer 1:37392c1b4cf8 186 res_button = client.create_resource("3200/0/5501", "button_count");
screamer 1:37392c1b4cf8 187 res_button->set_value(0);
screamer 1:37392c1b4cf8 188 res_button->methods(M2MMethod::GET);
screamer 1:37392c1b4cf8 189 res_button->observable(true);
screamer 1:37392c1b4cf8 190 res_button->attach_notification_callback(button_callback);
screamer 1:37392c1b4cf8 191
screamer 1:37392c1b4cf8 192 res_led = client.create_resource("3201/0/5853", "led_state");
screamer 1:37392c1b4cf8 193 res_led->set_value(1);
screamer 1:37392c1b4cf8 194 res_led->methods(M2MMethod::GET | M2MMethod::PUT);
screamer 1:37392c1b4cf8 195 res_led->attach_put_callback(led_put_callback);
screamer 0:ea30ba97a865 196
screamer 1:37392c1b4cf8 197 // Sensor resources
screamer 1:37392c1b4cf8 198 res_temperature = client.create_resource("3303/0/5700", "temperature");
screamer 1:37392c1b4cf8 199 res_temperature->set_value(0);
screamer 1:37392c1b4cf8 200 res_temperature->methods(M2MMethod::GET);
screamer 1:37392c1b4cf8 201 res_temperature->observable(true);
screamer 0:ea30ba97a865 202
screamer 1:37392c1b4cf8 203 res_voltage = client.create_resource("3316/0/5700", "voltage");
screamer 1:37392c1b4cf8 204 res_voltage->set_value(0);
screamer 1:37392c1b4cf8 205 res_voltage->methods(M2MMethod::GET);
screamer 1:37392c1b4cf8 206 res_voltage->observable(true);
screamer 0:ea30ba97a865 207
screamer 0:ea30ba97a865 208 printf("Initialized Pelion Client. Registering...\n");
screamer 0:ea30ba97a865 209
screamer 0:ea30ba97a865 210 // Callback that fires when registering is complete
screamer 0:ea30ba97a865 211 client.on_registered(&registered);
screamer 0:ea30ba97a865 212
screamer 1:37392c1b4cf8 213 // Register with Pelion DM
screamer 0:ea30ba97a865 214 client.register_and_connect();
screamer 0:ea30ba97a865 215
screamer 7:24d524c2bdcc 216 int i = 600; // wait up 60 seconds before attaching sensors and button events
screamer 1:37392c1b4cf8 217 while (i-- > 0 && !client.is_client_registered()) {
screamer 1:37392c1b4cf8 218 wait_ms(100);
screamer 1:37392c1b4cf8 219 }
screamer 1:37392c1b4cf8 220
screamer 1:37392c1b4cf8 221 button.fall(eventQueue.event(&button_press));
screamer 1:37392c1b4cf8 222
screamer 0:ea30ba97a865 223 // The timer fires on an interrupt context, but debounces it to the eventqueue, so it's safe to do network operations
screamer 0:ea30ba97a865 224 Ticker timer;
screamer 1:37392c1b4cf8 225 timer.attach(eventQueue.event(&sensors_update), SENSORS_POLL_INTERVAL);
screamer 0:ea30ba97a865 226
screamer 0:ea30ba97a865 227 // You can easily run the eventQueue in a separate thread if required
screamer 0:ea30ba97a865 228 eventQueue.dispatch_forever();
screamer 0:ea30ba97a865 229 }
screamer 0:ea30ba97a865 230 #endif