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 #include "mbed.h"
00020 #include "simple-mbed-cloud-client.h"
00021 #include "SDBlockDevice.h"
00022 #include "FATFileSystem.h"
00023 
00024 // An event queue is a very useful structure to debounce information between contexts (e.g. ISR and normal threads)
00025 // 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
00026 EventQueue eventQueue;
00027 
00028 // Default block device
00029 BlockDevice* bd = BlockDevice::get_default_instance();
00030 FATFileSystem fs("sd", bd);
00031 
00032 // Default network interface object
00033 NetworkInterface *net;
00034 
00035 // Declaring pointers for access to Mbed Cloud Client resources outside of main()
00036 MbedCloudClientResource *button_res;
00037 MbedCloudClientResource *pattern_res;
00038 
00039 // This function gets triggered by the timer. It's easy to replace it by an InterruptIn and fall() mode on a real button
00040 void fake_button_press() {
00041     int v = button_res->get_value_int() + 1;
00042 
00043     button_res->set_value(v);
00044 
00045     printf("Simulated button clicked %d times\n", v);
00046 }
00047 
00048 /**
00049  * PUT handler
00050  * @param resource The resource that triggered the callback
00051  * @param newValue Updated value for the resource
00052  */
00053 void pattern_updated(MbedCloudClientResource *resource, m2m::String newValue) {
00054     printf("PUT received, new value: %s\n", newValue.c_str());
00055 }
00056 
00057 /**
00058  * POST handler
00059  * @param resource The resource that triggered the callback
00060  * @param buffer If a body was passed to the POST function, this contains the data.
00061  *               Note that the buffer is deallocated after leaving this function, so copy it if you need it longer.
00062  * @param size Size of the body
00063  */
00064 void blink_callback(MbedCloudClientResource *resource, const uint8_t *buffer, uint16_t size) {
00065     printf("POST received. Going to blink LED pattern: %s\n", pattern_res->get_value().c_str());
00066 
00067     static DigitalOut augmentedLed(LED1); // LED that is used for blinking the pattern
00068 
00069     // Parse the pattern string, and toggle the LED in that pattern
00070     string s = std::string(pattern_res->get_value().c_str());
00071     size_t i = 0;
00072     size_t pos = s.find(':');
00073     while (pos != string::npos) {
00074         wait_ms(atoi(s.substr(i, pos - i).c_str()));
00075         augmentedLed = !augmentedLed;
00076 
00077         i = ++pos;
00078         pos = s.find(':', pos);
00079 
00080         if (pos == string::npos) {
00081             wait_ms(atoi(s.substr(i, s.length()).c_str()));
00082             augmentedLed = !augmentedLed;
00083         }
00084     }
00085 }
00086 
00087 /**
00088  * Notification callback handler
00089  * @param resource The resource that triggered the callback
00090  * @param status The delivery status of the notification
00091  */
00092 void button_callback(MbedCloudClientResource *resource, const NoticationDeliveryStatus status) {
00093     printf("Button notification, status %s (%d)\n", MbedCloudClientResource::delivery_status_to_string(status), status);
00094 }
00095 
00096 /**
00097  * Registration callback handler
00098  * @param endpoint Information about the registered endpoint such as the name (so you can find it back in portal)
00099  */
00100 void registered(const ConnectorClientEndpointInfo *endpoint) {
00101     printf("Connected to Mbed Cloud. Endpoint Name: %s\n", endpoint->internal_endpoint_name.c_str());
00102 }
00103 
00104 int main(void) {
00105     printf("Starting Simple Mbed Cloud Client example\n");
00106 
00107     // Connect to the internet (DHCP is expected to be on)
00108     printf("Connecting to the network using Cellular, please wait up to 180 seconds for a connection...\n");
00109 
00110     // Connect to the internet (DHCP is expected to be on)
00111     net = NetworkInterface::get_default_instance();
00112 
00113     nsapi_error_t status = net->connect();
00114 
00115     if (status != NSAPI_ERROR_OK) {
00116         printf("Connecting to the network failed (%d)!\n", status);
00117         printf("Make sure that an antenna is connected, the APN is correct for your SIM and\n");
00118         printf("either a rechargeable battery or a 3 Amp USB power supply is plugged in.\n");
00119         printf("For UBLOX_C030_U201 the APN should be left blank and you must have\n");
00120         printf("activated your board [once] at http://www.jtiotsims.com/ubxC030).\n");
00121         return -1;
00122     }
00123 
00124     printf("Connected to the network successfully. IP address: %s\n", net->get_ip_address());
00125 
00126     // SimpleMbedCloudClient handles registering over LwM2M to Mbed Cloud
00127     SimpleMbedCloudClient client(net, bd, &fs);
00128     int client_status = client.init();
00129     if (client_status != 0) {
00130         printf("Initializing Mbed Cloud Client failed (%d)\n", client_status);
00131         return -1;
00132     }
00133 
00134     // Creating resources, which can be written or read from the cloud
00135     button_res = client.create_resource("3200/0/5501", "button_count");
00136     button_res->set_value(0);
00137     button_res->methods(M2MMethod::GET);
00138     button_res->observable(true);
00139     button_res->attach_notification_callback(button_callback);
00140 
00141     pattern_res = client.create_resource("3201/0/5853", "blink_pattern");
00142     pattern_res->set_value("500:500:500:500:500:500:500:500");
00143     pattern_res->methods(M2MMethod::GET | M2MMethod::PUT);
00144     pattern_res->attach_put_callback(pattern_updated);
00145 
00146     MbedCloudClientResource *blink_res = client.create_resource("3201/0/5850", "blink_action");
00147     blink_res->methods(M2MMethod::POST);
00148     blink_res->attach_post_callback(blink_callback);
00149 
00150     printf("Initialized Mbed Cloud Client. Registering...\n");
00151 
00152     // Callback that fires when registering is complete
00153     client.on_registered(&registered);
00154 
00155     // Register with Mbed Cloud
00156     client.register_and_connect();
00157 
00158     // Placeholder for callback to update local resource when GET comes.
00159     // The timer fires on an interrupt context, but debounces it to the eventqueue, so it's safe to do network operations
00160     Ticker timer;
00161     timer.attach(eventQueue.event(&fake_button_press), 5.0);
00162 
00163     // You can easily run the eventQueue in a separate thread if required
00164     eventQueue.dispatch_forever();
00165 }
00166 #endif