main.cpp

00001 // ----------------------------------------------------------------------------
00002 // Copyright 2016-2018 ARM Ltd.
00003 //
00004 // SPDX-License-Identifier: Apache-2.0
00005 //
00006 // Licensed under the Apache License, Version 2.0 (the "License");
00007 // you may not use this file except in compliance with the License.
00008 // You may obtain a copy of the License at
00009 //
00010 //     http://www.apache.org/licenses/LICENSE-2.0
00011 //
00012 // Unless required by applicable law or agreed to in writing, software
00013 // distributed under the License is distributed on an "AS IS" BASIS,
00014 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
00015 // See the License for the specific language governing permissions and
00016 // limitations under the License.
00017 // ----------------------------------------------------------------------------
00018 #ifndef MBED_TEST_MODE
00019 
00020 #include "mbed.h"
00021 #include "simple-mbed-cloud-client.h"
00022 #include "FATFileSystem.h"
00023 #include "LittleFileSystem.h"
00024 
00025 // Default network interface object. Don't forget to change the WiFi SSID/password in mbed_app.json if you're using WiFi.
00026 NetworkInterface *net = NetworkInterface::get_default_instance();
00027 
00028 // Default block device available on the target board
00029 BlockDevice *bd = BlockDevice::get_default_instance();
00030 
00031 #if COMPONENT_SD || COMPONENT_NUSD
00032 // Use FATFileSystem for SD card type blockdevices
00033 //FATFileSystem fs("fs", bd);
00034 #else
00035 // Use LittleFileSystem for non-SD block devices to enable wear leveling and other functions
00036 //LittleFileSystem fs("fs", bd);
00037 #endif
00038 
00039 FileSystem *fs = FileSystem::get_default_instance();
00040 
00041 #if USE_BUTTON == 1
00042 InterruptIn button(BUTTON1);
00043 #endif /* USE_BUTTON */
00044 
00045 // Default LED to use for PUT/POST example
00046 DigitalOut led(LED1);
00047 
00048 // Declaring pointers for access to Pelion Device Management Client resources outside of main()
00049 MbedCloudClientResource *button_res;
00050 MbedCloudClientResource *led_res;
00051 MbedCloudClientResource *post_res;
00052 
00053 // An event queue is a very useful structure to debounce information between contexts (e.g. ISR and normal threads)
00054 // 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
00055 EventQueue eventQueue;
00056 
00057 /**
00058  * PUT handler - sets the value of the built-in LED
00059  * @param resource The resource that triggered the callback
00060  * @param newValue Updated value for the resource
00061  */
00062 void put_callback(MbedCloudClientResource *resource, m2m::String newValue) {
00063     printf("PUT received. New value: %s\n", newValue.c_str());
00064     led = atoi(newValue.c_str());
00065 }
00066 
00067 /**
00068  * POST handler - prints the content of the payload
00069  * @param resource The resource that triggered the callback
00070  * @param buffer If a body was passed to the POST function, this contains the data.
00071  *               Note that the buffer is deallocated after leaving this function, so copy it if you need it longer.
00072  * @param size Size of the body
00073  */
00074 void post_callback(MbedCloudClientResource *resource, const uint8_t *buffer, uint16_t size) {
00075     printf("POST received (length %u). Payload: ", size);
00076     for (size_t ix = 0; ix < size; ix++) {
00077         printf("%02x ", buffer[ix]);
00078     }
00079     printf("\n");
00080 }
00081 
00082 /**
00083  * Button handler
00084  * This function will be triggered either by a physical button press or by a ticker every 5 seconds (see below)
00085  */
00086 void button_press() {
00087     int v = button_res->get_value_int() + 1;
00088     button_res->set_value(v);
00089     printf("Button clicked %d times\n", v);
00090 }
00091 
00092 /**
00093  * Notification callback handler
00094  * @param resource The resource that triggered the callback
00095  * @param status The delivery status of the notification
00096  */
00097 void button_callback(MbedCloudClientResource *resource, const NoticationDeliveryStatus status) {
00098     printf("Button notification, status %s (%d)\n", MbedCloudClientResource::delivery_status_to_string(status), status);
00099 }
00100 
00101 /**
00102  * Registration callback handler
00103  * @param endpoint Information about the registered endpoint such as the name (so you can find it back in portal)
00104  */
00105 void registered(const ConnectorClientEndpointInfo *endpoint) {
00106     printf("Registered to Pelion Device Management. Endpoint Name: %s\n", endpoint->internal_endpoint_name.c_str());
00107 }
00108 
00109 int main(void) {
00110     printf("\nStarting Simple Pelion Device Management Client example\n");
00111 
00112 #if USE_BUTTON == 1
00113     // If the User button is pressed ons start, then format storage.
00114     if (button.read() == MBED_CONF_APP_BUTTON_PRESSED_STATE) {
00115         printf("User button is pushed on start. Formatting the storage...\n");
00116         int storage_status = StorageHelper::format(fs, bd);
00117         if (storage_status != 0) {
00118             printf("ERROR: Failed to reformat the storage (%d).\n", storage_status);
00119         }
00120     } else {
00121         printf("You can hold the user button during boot to format the storage and change the device identity.\n");
00122     }
00123 #endif /* USE_BUTTON */
00124 
00125     // Connect to the Internet (DHCP is expected to be on)
00126     printf("Connecting to the network using the default network interface...\n");
00127     net = NetworkInterface::get_default_instance();
00128 
00129     nsapi_error_t net_status = NSAPI_ERROR_NO_CONNECTION;
00130     while ((net_status = net->connect()) != NSAPI_ERROR_OK) {
00131         printf("Unable to connect to network (%d). Retrying...\n", net_status);
00132     }
00133 
00134     printf("Connected to the network successfully. IP address: %s\n", net->get_ip_address());
00135 
00136     printf("Initializing Pelion Device Management Client...\n");
00137 
00138     // SimpleMbedCloudClient handles registering over LwM2M to Pelion Device Management
00139     SimpleMbedCloudClient client(net, bd, fs);
00140     int client_status = client.init();
00141     if (client_status != 0) {
00142         printf("Pelion Client initialization failed (%d)\n", client_status);
00143         return -1;
00144     }
00145 
00146     // Creating resources, which can be written or read from the cloud
00147     button_res = client.create_resource("3200/0/5501", "button_count");
00148     button_res->set_value(0);
00149     button_res->methods(M2MMethod::GET);
00150     button_res->observable(true);
00151     button_res->attach_notification_callback(button_callback);
00152 
00153     led_res = client.create_resource("3201/0/5853", "led_state");
00154     led_res->set_value(led.read());
00155     led_res->methods(M2MMethod::GET | M2MMethod::PUT);
00156     led_res->attach_put_callback(put_callback);
00157 
00158     post_res = client.create_resource("3300/0/5605", "execute_function");
00159     post_res->methods(M2MMethod::POST);
00160     post_res->attach_post_callback(post_callback);
00161 
00162     printf("Initialized Pelion Device Management Client. Registering...\n");
00163 
00164     // Callback that fires when registering is complete
00165     client.on_registered(&registered);
00166 
00167     // Register with Pelion DM
00168     client.register_and_connect();
00169 
00170 #if USE_BUTTON == 1
00171     // The button fires on an interrupt context, but debounces it to the eventqueue, so it's safe to do network operations
00172     button.fall(eventQueue.event(&button_press));
00173     printf("Press the user button to increment the LwM2M resource value...\n");
00174 #else
00175     // The timer fires on an interrupt context, but debounces it to the eventqueue, so it's safe to do network operations
00176     Ticker timer;
00177     timer.attach(eventQueue.event(&button_press), 5.0);
00178     printf("Simulating button press every 5 seconds...\n");
00179 #endif /* USE_BUTTON */
00180 
00181     // You can easily run the eventQueue in a separate thread if required
00182     eventQueue.dispatch_forever();
00183 }
00184 
00185 #endif /* MBED_TEST_MODE */