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.

Committer:
IanBenzMaxim
Date:
Fri Feb 24 11:23:12 2017 -0600
Revision:
0:33d4e66780c0
Child:
3:d2799d8497c0
Initial commit.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
IanBenzMaxim 0:33d4e66780c0 1 /*******************************************************************************
IanBenzMaxim 0:33d4e66780c0 2 * Copyright (C) 2017 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 <memory>
IanBenzMaxim 0:33d4e66780c0 34 #include <wait_api.h>
IanBenzMaxim 0:33d4e66780c0 35 #include <TCPSocket.h>
IanBenzMaxim 0:33d4e66780c0 36 #include "CC3100.hpp"
IanBenzMaxim 0:33d4e66780c0 37 #include "WindowManager.hpp"
IanBenzMaxim 0:33d4e66780c0 38 #include "DisplayIdWindow.hpp"
IanBenzMaxim 0:33d4e66780c0 39 #include "NormalOperationWindow.hpp"
IanBenzMaxim 0:33d4e66780c0 40 #include "ErrorWindow.hpp"
IanBenzMaxim 0:33d4e66780c0 41 #include "WifiConnectWindow.hpp"
IanBenzMaxim 0:33d4e66780c0 42
IanBenzMaxim 0:33d4e66780c0 43 static const char wifiSsid[] = "MXIM_SECURITY_GRP";
IanBenzMaxim 0:33d4e66780c0 44 static const char wifiPassword[] = "DEEPCOVER";
IanBenzMaxim 0:33d4e66780c0 45 static const char serverAddress[] = "www.maxim-security.com";
IanBenzMaxim 0:33d4e66780c0 46 static const uint16_t serverPort = 3900;
IanBenzMaxim 0:33d4e66780c0 47
IanBenzMaxim 0:33d4e66780c0 48 WifiConnectWindow::WifiConnectWindow(Graphic * parent) : Window(parent), m_state(NotStarted),
IanBenzMaxim 0:33d4e66780c0 49 m_description("WiFi SSID: " + std::string(wifiSsid) + "\nWiFi Pass: " + std::string(wifiPassword), this),
IanBenzMaxim 0:33d4e66780c0 50 m_backButton("Back", this), m_continueButton("Connect to WiFi", this)
IanBenzMaxim 0:33d4e66780c0 51 {
IanBenzMaxim 0:33d4e66780c0 52 m_description.setWordWrap(true);
IanBenzMaxim 0:33d4e66780c0 53 m_backButton.setClickedHandler(Button::EventHandler(this, &WifiConnectWindow::backButtonClicked));
IanBenzMaxim 0:33d4e66780c0 54 m_continueButton.setClickedHandler(Button::EventHandler(this, &WifiConnectWindow::continueButtonClicked));
IanBenzMaxim 0:33d4e66780c0 55 m_continueButton.setFocused();
IanBenzMaxim 0:33d4e66780c0 56 }
IanBenzMaxim 0:33d4e66780c0 57
IanBenzMaxim 0:33d4e66780c0 58 void WifiConnectWindow::doPostLayout()
IanBenzMaxim 0:33d4e66780c0 59 {
IanBenzMaxim 0:33d4e66780c0 60 switch (m_state)
IanBenzMaxim 0:33d4e66780c0 61 {
IanBenzMaxim 0:33d4e66780c0 62 case PreConnect:
IanBenzMaxim 0:33d4e66780c0 63 m_backButton.setParent(NULL);
IanBenzMaxim 0:33d4e66780c0 64 m_continueButton.setParent(NULL);
IanBenzMaxim 0:33d4e66780c0 65 m_description.setText("Connecting to WiFi network...");
IanBenzMaxim 0:33d4e66780c0 66 m_state = WiFiConnect;
IanBenzMaxim 0:33d4e66780c0 67 break;
IanBenzMaxim 0:33d4e66780c0 68
IanBenzMaxim 0:33d4e66780c0 69 case WiFiConnect:
IanBenzMaxim 0:33d4e66780c0 70 {
IanBenzMaxim 0:33d4e66780c0 71 // Connect to AP.
IanBenzMaxim 0:33d4e66780c0 72 int result = CC3100::instance().connect(wifiSsid, wifiPassword, NSAPI_SECURITY_WPA2);
IanBenzMaxim 0:33d4e66780c0 73 if (result != 0)
IanBenzMaxim 0:33d4e66780c0 74 {
IanBenzMaxim 0:33d4e66780c0 75 if (windowManager() != NULL)
IanBenzMaxim 0:33d4e66780c0 76 {
IanBenzMaxim 0:33d4e66780c0 77 windowManager()->pop();
IanBenzMaxim 0:33d4e66780c0 78 windowManager()->push(new ErrorWindow("WiFi connect failed"));
IanBenzMaxim 0:33d4e66780c0 79 }
IanBenzMaxim 0:33d4e66780c0 80 break;
IanBenzMaxim 0:33d4e66780c0 81 }
IanBenzMaxim 0:33d4e66780c0 82
IanBenzMaxim 0:33d4e66780c0 83 m_description.setText("Connecting to server...");
IanBenzMaxim 0:33d4e66780c0 84 m_state = ServerConnect;
IanBenzMaxim 0:33d4e66780c0 85 }
IanBenzMaxim 0:33d4e66780c0 86 break;
IanBenzMaxim 0:33d4e66780c0 87
IanBenzMaxim 0:33d4e66780c0 88 case ServerConnect:
IanBenzMaxim 0:33d4e66780c0 89 {
IanBenzMaxim 0:33d4e66780c0 90 // Get IP address from DNS lookup.
IanBenzMaxim 0:33d4e66780c0 91 SocketAddress socketAddress;
IanBenzMaxim 0:33d4e66780c0 92 int result = CC3100::instance().gethostbyname(serverAddress, &socketAddress);
IanBenzMaxim 0:33d4e66780c0 93 if (result != 0)
IanBenzMaxim 0:33d4e66780c0 94 {
IanBenzMaxim 0:33d4e66780c0 95 if (windowManager() != NULL)
IanBenzMaxim 0:33d4e66780c0 96 {
IanBenzMaxim 0:33d4e66780c0 97 windowManager()->pop();
IanBenzMaxim 0:33d4e66780c0 98 windowManager()->push(new ErrorWindow("Hostname lookup failed"));
IanBenzMaxim 0:33d4e66780c0 99 }
IanBenzMaxim 0:33d4e66780c0 100 break;
IanBenzMaxim 0:33d4e66780c0 101 }
IanBenzMaxim 0:33d4e66780c0 102
IanBenzMaxim 0:33d4e66780c0 103 // Open socket connection.
IanBenzMaxim 0:33d4e66780c0 104 std::auto_ptr<TCPSocket> socket(new TCPSocket(&CC3100::instance()));
IanBenzMaxim 0:33d4e66780c0 105 socket->set_blocking(false);
IanBenzMaxim 0:33d4e66780c0 106 socketAddress.set_port(serverPort);
IanBenzMaxim 0:33d4e66780c0 107 result = socket->connect(socketAddress);
IanBenzMaxim 0:33d4e66780c0 108 if (result != 0)
IanBenzMaxim 0:33d4e66780c0 109 {
IanBenzMaxim 0:33d4e66780c0 110 if (windowManager() != NULL)
IanBenzMaxim 0:33d4e66780c0 111 {
IanBenzMaxim 0:33d4e66780c0 112 windowManager()->pop();
IanBenzMaxim 0:33d4e66780c0 113 windowManager()->push(new ErrorWindow("Socket connect failed"));
IanBenzMaxim 0:33d4e66780c0 114 }
IanBenzMaxim 0:33d4e66780c0 115 break;
IanBenzMaxim 0:33d4e66780c0 116 }
IanBenzMaxim 0:33d4e66780c0 117
IanBenzMaxim 0:33d4e66780c0 118 if (windowManager() != NULL)
IanBenzMaxim 0:33d4e66780c0 119 {
IanBenzMaxim 0:33d4e66780c0 120 windowManager()->pop();
IanBenzMaxim 0:33d4e66780c0 121 windowManager()->push(new NormalOperationWindow(socket.release()));
IanBenzMaxim 0:33d4e66780c0 122 }
IanBenzMaxim 0:33d4e66780c0 123 }
IanBenzMaxim 0:33d4e66780c0 124 break;
IanBenzMaxim 0:33d4e66780c0 125 }
IanBenzMaxim 0:33d4e66780c0 126 }
IanBenzMaxim 0:33d4e66780c0 127
IanBenzMaxim 0:33d4e66780c0 128 void WifiConnectWindow::doLayout()
IanBenzMaxim 0:33d4e66780c0 129 {
IanBenzMaxim 0:33d4e66780c0 130 m_backButton.setX(0);
IanBenzMaxim 0:33d4e66780c0 131 m_backButton.setY(height() - m_backButton.height());
IanBenzMaxim 0:33d4e66780c0 132 m_continueButton.setX(width() - m_continueButton.width());
IanBenzMaxim 0:33d4e66780c0 133 m_continueButton.setY(height() - m_continueButton.height());
IanBenzMaxim 0:33d4e66780c0 134 m_description.setWidth(width());
IanBenzMaxim 0:33d4e66780c0 135 m_description.setHeight(std::min(m_backButton.y(), m_continueButton.y()));
IanBenzMaxim 0:33d4e66780c0 136 }
IanBenzMaxim 0:33d4e66780c0 137
IanBenzMaxim 0:33d4e66780c0 138 bool WifiConnectWindow::doProcessKey(Key key)
IanBenzMaxim 0:33d4e66780c0 139 {
IanBenzMaxim 0:33d4e66780c0 140 bool handled;
IanBenzMaxim 0:33d4e66780c0 141 switch (key)
IanBenzMaxim 0:33d4e66780c0 142 {
IanBenzMaxim 0:33d4e66780c0 143 case LeftKey:
IanBenzMaxim 0:33d4e66780c0 144 m_backButton.setFocused();
IanBenzMaxim 0:33d4e66780c0 145 handled = true;
IanBenzMaxim 0:33d4e66780c0 146 break;
IanBenzMaxim 0:33d4e66780c0 147
IanBenzMaxim 0:33d4e66780c0 148 case RightKey:
IanBenzMaxim 0:33d4e66780c0 149 m_continueButton.setFocused();
IanBenzMaxim 0:33d4e66780c0 150 handled = true;
IanBenzMaxim 0:33d4e66780c0 151 break;
IanBenzMaxim 0:33d4e66780c0 152
IanBenzMaxim 0:33d4e66780c0 153 default:
IanBenzMaxim 0:33d4e66780c0 154 handled = false;
IanBenzMaxim 0:33d4e66780c0 155 break;
IanBenzMaxim 0:33d4e66780c0 156 }
IanBenzMaxim 0:33d4e66780c0 157 return handled;
IanBenzMaxim 0:33d4e66780c0 158 }
IanBenzMaxim 0:33d4e66780c0 159
IanBenzMaxim 0:33d4e66780c0 160 void WifiConnectWindow::continueButtonClicked()
IanBenzMaxim 0:33d4e66780c0 161 {
IanBenzMaxim 0:33d4e66780c0 162 if (m_state == NotStarted)
IanBenzMaxim 0:33d4e66780c0 163 {
IanBenzMaxim 0:33d4e66780c0 164 m_state = PreConnect;
IanBenzMaxim 0:33d4e66780c0 165 }
IanBenzMaxim 0:33d4e66780c0 166 }
IanBenzMaxim 0:33d4e66780c0 167
IanBenzMaxim 0:33d4e66780c0 168 void WifiConnectWindow::backButtonClicked()
IanBenzMaxim 0:33d4e66780c0 169 {
IanBenzMaxim 0:33d4e66780c0 170 if (windowManager() != NULL)
IanBenzMaxim 0:33d4e66780c0 171 {
IanBenzMaxim 0:33d4e66780c0 172 windowManager()->pop();
IanBenzMaxim 0:33d4e66780c0 173 windowManager()->push(new DisplayIdWindow(DisplayIdWindow::PreConnectMode));
IanBenzMaxim 0:33d4e66780c0 174 }
IanBenzMaxim 0:33d4e66780c0 175 }