Maxim Integrated / Mbed OS MAXREFDES155#

DeepCover Embedded Security in IoT: Public-key Secured Data Paths

Dependencies:   MaximInterface

The MAXREFDES155# is an internet-of-things (IoT) embedded-security reference design, built to authenticate and control a sensing node using elliptic-curve-based public-key cryptography with control and notification from a web server.

The hardware includes an ARM® mbed™ shield and attached sensor endpoint. The shield contains a DS2476 DeepCover® ECDSA/SHA-2 coprocessor, Wifi communication, LCD push-button controls, and status LEDs. The sensor endpoint is attached to the shield using a 300mm cable and contains a DS28C36 DeepCover ECDSA/SHA-2 authenticator, IR-thermal sensor, and aiming laser for the IR sensor. The MAXREFDES155# is equipped with a standard Arduino® form-factor shield connector for immediate testing using an mbed board such as the MAX32600MBED#. The combination of these two devices represent an IoT device. Communication to the web server is accomplished with the shield Wifi circuitry. Communication from the shield to the attached sensor module is accomplished over I2C . The sensor module represents an IoT endpoint that generates small data with a requirement for message authenticity/integrity and secure on/off operational control.

The design is hierarchical with each mbed platform and shield communicating data from the sensor node to a web server that maintains a centralized log and dispatches notifications as necessary. The simplicity of this design enables rapid integration into any star-topology IoT network to provide security with the low overhead and cost provided by the ECDSA-P256 asymmetric-key and SHA-256 symmetric-key algorithms.

More information about the MAXREFDES155# is available on the Maxim Integrated website.

src/main.cpp@18:c2631e985780, 2019-12-03 (annotated)

Committer:
IanBenzMaxim
Date:
Tue Dec 03 12:56:25 2019 -0600
Revision:
18:c2631e985780
Parent:
17:5926077e5345 
Updated MaximInterface to version 2.1.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
IanBenzMaxim 0:33d4e66780c0 1 /*******************************************************************************
IanBenzMaxim 16:a004191a79ab 2 * Copyright (C) Maxim Integrated Products, Inc., All Rights Reserved.
IanBenzMaxim 0:33d4e66780c0 3 *
IanBenzMaxim 0:33d4e66780c0 4 * Permission is hereby granted, free of charge, to any person obtaining a
IanBenzMaxim 0:33d4e66780c0 5 * copy of this software and associated documentation files (the "Software"),
IanBenzMaxim 0:33d4e66780c0 6 * to deal in the Software without restriction, including without limitation
IanBenzMaxim 0:33d4e66780c0 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
IanBenzMaxim 0:33d4e66780c0 8 * and/or sell copies of the Software, and to permit persons to whom the
IanBenzMaxim 0:33d4e66780c0 9 * Software is furnished to do so, subject to the following conditions:
IanBenzMaxim 0:33d4e66780c0 10 *
IanBenzMaxim 0:33d4e66780c0 11 * The above copyright notice and this permission notice shall be included
IanBenzMaxim 0:33d4e66780c0 12 * in all copies or substantial portions of the Software.
IanBenzMaxim 0:33d4e66780c0 13 *
IanBenzMaxim 0:33d4e66780c0 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
IanBenzMaxim 0:33d4e66780c0 15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
IanBenzMaxim 0:33d4e66780c0 16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IanBenzMaxim 0:33d4e66780c0 17 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
IanBenzMaxim 0:33d4e66780c0 18 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
IanBenzMaxim 0:33d4e66780c0 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
IanBenzMaxim 0:33d4e66780c0 20 * OTHER DEALINGS IN THE SOFTWARE.
IanBenzMaxim 0:33d4e66780c0 21 *
IanBenzMaxim 0:33d4e66780c0 22 * Except as contained in this notice, the name of Maxim Integrated
IanBenzMaxim 0:33d4e66780c0 23 * Products, Inc. shall not be used except as stated in the Maxim Integrated
IanBenzMaxim 0:33d4e66780c0 24 * Products, Inc. Branding Policy.
IanBenzMaxim 0:33d4e66780c0 25 *
IanBenzMaxim 0:33d4e66780c0 26 * The mere transfer of this software does not imply any licenses
IanBenzMaxim 0:33d4e66780c0 27 * of trade secrets, proprietary technology, copyrights, patents,
IanBenzMaxim 0:33d4e66780c0 28 * trademarks, maskwork rights, or any other form of intellectual
IanBenzMaxim 0:33d4e66780c0 29 * property whatsoever. Maxim Integrated Products, Inc. retains all
IanBenzMaxim 0:33d4e66780c0 30 * ownership rights.
IanBenzMaxim 0:33d4e66780c0 31 *******************************************************************************/
IanBenzMaxim 0:33d4e66780c0 32
IanBenzMaxim 0:33d4e66780c0 33 #include <string>
IanBenzMaxim 16:a004191a79ab 34 #include <MaximInterfaceDevices/DS28C36_DS2476.hpp>
IanBenzMaxim 16:a004191a79ab 35 #include <MaximInterfaceMbed/I2CMaster.hpp>
IanBenzMaxim 16:a004191a79ab 36 #include <MaximInterfaceMbed/Sleep.hpp>
IanBenzMaxim 16:a004191a79ab 37 #include <mbed-os/drivers/DigitalIn.h>
IanBenzMaxim 16:a004191a79ab 38 #include <mbed-os/drivers/I2C.h>
IanBenzMaxim 0:33d4e66780c0 39 #include "CC3100.hpp"
IanBenzMaxim 0:33d4e66780c0 40 #include "Display.hpp"
IanBenzMaxim 13:6a6225690c2e 41 #include "InitWindow.hpp"
IanBenzMaxim 0:33d4e66780c0 42 #include "Keys.hpp"
IanBenzMaxim 13:6a6225690c2e 43 #include "SensorNode.hpp"
IanBenzMaxim 0:33d4e66780c0 44 #include "WindowManager.hpp"
IanBenzMaxim 0:33d4e66780c0 45
IanBenzMaxim 17:5926077e5345 46 static mbed::DigitalIn upButton(MBED_CONF_APP_UP_BUTTON_PIN);
IanBenzMaxim 17:5926077e5345 47 static mbed::DigitalIn downButton(MBED_CONF_APP_DOWN_BUTTON_PIN);
IanBenzMaxim 17:5926077e5345 48 static mbed::DigitalIn leftButton(MBED_CONF_APP_LEFT_BUTTON_PIN);
IanBenzMaxim 17:5926077e5345 49 static mbed::DigitalIn rightButton(MBED_CONF_APP_RIGHT_BUTTON_PIN);
IanBenzMaxim 17:5926077e5345 50 static mbed::DigitalIn leftClickButton(MBED_CONF_APP_LEFT_CLICK_BUTTON_PIN);
IanBenzMaxim 17:5926077e5345 51 static mbed::DigitalIn rightClickButton(MBED_CONF_APP_RIGHT_CLICK_BUTTON_PIN);
IanBenzMaxim 0:33d4e66780c0 52
IanBenzMaxim 17:5926077e5345 53 static Display display(MBED_CONF_APP_DISPLAY_MOSI_PIN,
IanBenzMaxim 17:5926077e5345 54 MBED_CONF_APP_DISPLAY_MISO_PIN,
IanBenzMaxim 17:5926077e5345 55 MBED_CONF_APP_DISPLAY_SCLK_PIN,
IanBenzMaxim 17:5926077e5345 56 MBED_CONF_APP_DISPLAY_SSEL_PIN,
IanBenzMaxim 17:5926077e5345 57 MBED_CONF_APP_DISPLAY_A0_PIN);
IanBenzMaxim 10:71359af61af8 58 static WindowManager windowManager(display.canvas());
IanBenzMaxim 0:33d4e66780c0 59
IanBenzMaxim 17:5926077e5345 60 static mbed::I2C mbedI2C(MBED_CONF_APP_SDA_PIN, MBED_CONF_APP_SCL_PIN);
IanBenzMaxim 16:a004191a79ab 61 static MaximInterfaceMbed::I2CMaster i2c(mbedI2C);
IanBenzMaxim 16:a004191a79ab 62 static MaximInterfaceMbed::Sleep sleep;
IanBenzMaxim 16:a004191a79ab 63 MaximInterfaceDevices::DS2476 coproc(sleep, i2c);
IanBenzMaxim 16:a004191a79ab 64 SensorNode sensorNode(sleep, i2c, coproc);
IanBenzMaxim 0:33d4e66780c0 65
IanBenzMaxim 0:33d4e66780c0 66 std::string webId;
IanBenzMaxim 0:33d4e66780c0 67
IanBenzMaxim 0:33d4e66780c0 68 static bool buttonPressed(mbed::DigitalIn & button);
IanBenzMaxim 0:33d4e66780c0 69
IanBenzMaxim 13:6a6225690c2e 70 int main() {
IanBenzMaxim 13:6a6225690c2e 71 mbedI2C.frequency(100000);
IanBenzMaxim 13:6a6225690c2e 72 display.initialize();
IanBenzMaxim 13:6a6225690c2e 73 // Set initial window.
IanBenzMaxim 13:6a6225690c2e 74 {
IanBenzMaxim 16:a004191a79ab 75 std::auto_ptr<Window> window(new InitWindow(InitWindow::InitMode));
IanBenzMaxim 13:6a6225690c2e 76 windowManager.push(window);
IanBenzMaxim 13:6a6225690c2e 77 }
IanBenzMaxim 13:6a6225690c2e 78 while (true) {
IanBenzMaxim 13:6a6225690c2e 79 // Update window manager and redraw screen if necessary.
IanBenzMaxim 13:6a6225690c2e 80 if (windowManager.update()) {
IanBenzMaxim 13:6a6225690c2e 81 display.update();
IanBenzMaxim 7:66c5dedc750b 82 }
IanBenzMaxim 13:6a6225690c2e 83 // Update CC3100 Wi-Fi interface.
IanBenzMaxim 13:6a6225690c2e 84 CC3100::instance().update();
IanBenzMaxim 13:6a6225690c2e 85 // Check if any buttons are pressed.
IanBenzMaxim 13:6a6225690c2e 86 if (buttonPressed(leftClickButton)) {
IanBenzMaxim 13:6a6225690c2e 87 windowManager.processKey(LeftClickKey);
IanBenzMaxim 13:6a6225690c2e 88 } else if (buttonPressed(rightClickButton)) {
IanBenzMaxim 13:6a6225690c2e 89 windowManager.processKey(RightClickKey);
IanBenzMaxim 13:6a6225690c2e 90 } else if (buttonPressed(upButton)) {
IanBenzMaxim 13:6a6225690c2e 91 windowManager.processKey(UpKey);
IanBenzMaxim 13:6a6225690c2e 92 } else if (buttonPressed(downButton)) {
IanBenzMaxim 13:6a6225690c2e 93 windowManager.processKey(DownKey);
IanBenzMaxim 13:6a6225690c2e 94 } else if (buttonPressed(leftButton)) {
IanBenzMaxim 13:6a6225690c2e 95 windowManager.processKey(LeftKey);
IanBenzMaxim 13:6a6225690c2e 96 } else if (buttonPressed(rightButton)) {
IanBenzMaxim 13:6a6225690c2e 97 windowManager.processKey(RightKey);
IanBenzMaxim 0:33d4e66780c0 98 }
IanBenzMaxim 13:6a6225690c2e 99 }
IanBenzMaxim 0:33d4e66780c0 100 }
IanBenzMaxim 0:33d4e66780c0 101
IanBenzMaxim 16:a004191a79ab 102 /// @brief Checks if button is pressed and waits for release.
IanBenzMaxim 0:33d4e66780c0 103 /// @param button Active low button to check.
IanBenzMaxim 0:33d4e66780c0 104 /// @returns True if pressed.
IanBenzMaxim 13:6a6225690c2e 105 static bool buttonPressed(mbed::DigitalIn & button) {
IanBenzMaxim 13:6a6225690c2e 106 const int buttonPressed = 0; // Active low
IanBenzMaxim 13:6a6225690c2e 107 if (button == buttonPressed) {
IanBenzMaxim 17:5926077e5345 108 while (button == buttonPressed)
IanBenzMaxim 17:5926077e5345 109 ;
IanBenzMaxim 13:6a6225690c2e 110 return true;
IanBenzMaxim 13:6a6225690c2e 111 }
IanBenzMaxim 13:6a6225690c2e 112 // else
IanBenzMaxim 13:6a6225690c2e 113 return false;
IanBenzMaxim 0:33d4e66780c0 114 }