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 Jan 19 10:28:27 2018 -0600
Revision:
15:75404fab3615
Parent:
13:6a6225690c2e
Updated MaximInterface revision.

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