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.

xternal/rapidjson/stringbuffer.h@16:a004191a79ab, 2019-10-03 (annotated)

Committer:
IanBenzMaxim
Date:
Thu Oct 03 11:40:13 2019 -0500
Revision:
16:a004191a79ab
Parent:
rapidjson/stringbuffer.h@0:33d4e66780c0 
Updated MaximInterface to version 2.0. Updated mbed-os to version 5.5.7. Cleaned up code styling.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
IanBenzMaxim 0:33d4e66780c0 1 // Tencent is pleased to support the open source community by making RapidJSON available.
IanBenzMaxim 0:33d4e66780c0 2 //
IanBenzMaxim 0:33d4e66780c0 3 // Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved.
IanBenzMaxim 0:33d4e66780c0 4 //
IanBenzMaxim 0:33d4e66780c0 5 // Licensed under the MIT License (the "License"); you may not use this file except
IanBenzMaxim 0:33d4e66780c0 6 // in compliance with the License. You may obtain a copy of the License at
IanBenzMaxim 0:33d4e66780c0 7 //
IanBenzMaxim 0:33d4e66780c0 8 // http://opensource.org/licenses/MIT
IanBenzMaxim 0:33d4e66780c0 9 //
IanBenzMaxim 0:33d4e66780c0 10 // Unless required by applicable law or agreed to in writing, software distributed
IanBenzMaxim 0:33d4e66780c0 11 // under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
IanBenzMaxim 0:33d4e66780c0 12 // CONDITIONS OF ANY KIND, either express or implied. See the License for the
IanBenzMaxim 0:33d4e66780c0 13 // specific language governing permissions and limitations under the License.
IanBenzMaxim 0:33d4e66780c0 14
IanBenzMaxim 0:33d4e66780c0 15 #ifndef RAPIDJSON_STRINGBUFFER_H_
IanBenzMaxim 0:33d4e66780c0 16 #define RAPIDJSON_STRINGBUFFER_H_
IanBenzMaxim 0:33d4e66780c0 17
IanBenzMaxim 0:33d4e66780c0 18 #include "stream.h"
IanBenzMaxim 0:33d4e66780c0 19 #include "internal/stack.h"
IanBenzMaxim 0:33d4e66780c0 20
IanBenzMaxim 0:33d4e66780c0 21 #if RAPIDJSON_HAS_CXX11_RVALUE_REFS
IanBenzMaxim 0:33d4e66780c0 22 #include <utility> // std::move
IanBenzMaxim 0:33d4e66780c0 23 #endif
IanBenzMaxim 0:33d4e66780c0 24
IanBenzMaxim 0:33d4e66780c0 25 #include "internal/stack.h"
IanBenzMaxim 0:33d4e66780c0 26
IanBenzMaxim 0:33d4e66780c0 27 #if defined(__clang__)
IanBenzMaxim 0:33d4e66780c0 28 RAPIDJSON_DIAG_PUSH
IanBenzMaxim 0:33d4e66780c0 29 RAPIDJSON_DIAG_OFF(c++98-compat)
IanBenzMaxim 0:33d4e66780c0 30 #endif
IanBenzMaxim 0:33d4e66780c0 31
IanBenzMaxim 0:33d4e66780c0 32 RAPIDJSON_NAMESPACE_BEGIN
IanBenzMaxim 0:33d4e66780c0 33
IanBenzMaxim 0:33d4e66780c0 34 //! Represents an in-memory output stream.
IanBenzMaxim 0:33d4e66780c0 35 /*!
IanBenzMaxim 0:33d4e66780c0 36 \tparam Encoding Encoding of the stream.
IanBenzMaxim 0:33d4e66780c0 37 \tparam Allocator type for allocating memory buffer.
IanBenzMaxim 0:33d4e66780c0 38 \note implements Stream concept
IanBenzMaxim 0:33d4e66780c0 39 */
IanBenzMaxim 0:33d4e66780c0 40 template <typename Encoding, typename Allocator = CrtAllocator>
IanBenzMaxim 0:33d4e66780c0 41 class GenericStringBuffer {
IanBenzMaxim 0:33d4e66780c0 42 public:
IanBenzMaxim 0:33d4e66780c0 43 typedef typename Encoding::Ch Ch;
IanBenzMaxim 0:33d4e66780c0 44
IanBenzMaxim 0:33d4e66780c0 45 GenericStringBuffer(Allocator* allocator = 0, size_t capacity = kDefaultCapacity) : stack_(allocator, capacity) {}
IanBenzMaxim 0:33d4e66780c0 46
IanBenzMaxim 0:33d4e66780c0 47 #if RAPIDJSON_HAS_CXX11_RVALUE_REFS
IanBenzMaxim 0:33d4e66780c0 48 GenericStringBuffer(GenericStringBuffer&& rhs) : stack_(std::move(rhs.stack_)) {}
IanBenzMaxim 0:33d4e66780c0 49 GenericStringBuffer& operator=(GenericStringBuffer&& rhs) {
IanBenzMaxim 0:33d4e66780c0 50 if (&rhs != this)
IanBenzMaxim 0:33d4e66780c0 51 stack_ = std::move(rhs.stack_);
IanBenzMaxim 0:33d4e66780c0 52 return *this;
IanBenzMaxim 0:33d4e66780c0 53 }
IanBenzMaxim 0:33d4e66780c0 54 #endif
IanBenzMaxim 0:33d4e66780c0 55
IanBenzMaxim 0:33d4e66780c0 56 void Put(Ch c) { *stack_.template Push<Ch>() = c; }
IanBenzMaxim 0:33d4e66780c0 57 void PutUnsafe(Ch c) { *stack_.template PushUnsafe<Ch>() = c; }
IanBenzMaxim 0:33d4e66780c0 58 void Flush() {}
IanBenzMaxim 0:33d4e66780c0 59
IanBenzMaxim 0:33d4e66780c0 60 void Clear() { stack_.Clear(); }
IanBenzMaxim 0:33d4e66780c0 61 void ShrinkToFit() {
IanBenzMaxim 0:33d4e66780c0 62 // Push and pop a null terminator. This is safe.
IanBenzMaxim 0:33d4e66780c0 63 *stack_.template Push<Ch>() = '\0';
IanBenzMaxim 0:33d4e66780c0 64 stack_.ShrinkToFit();
IanBenzMaxim 0:33d4e66780c0 65 stack_.template Pop<Ch>(1);
IanBenzMaxim 0:33d4e66780c0 66 }
IanBenzMaxim 0:33d4e66780c0 67
IanBenzMaxim 0:33d4e66780c0 68 void Reserve(size_t count) { stack_.template Reserve<Ch>(count); }
IanBenzMaxim 0:33d4e66780c0 69 Ch* Push(size_t count) { return stack_.template Push<Ch>(count); }
IanBenzMaxim 0:33d4e66780c0 70 Ch* PushUnsafe(size_t count) { return stack_.template PushUnsafe<Ch>(count); }
IanBenzMaxim 0:33d4e66780c0 71 void Pop(size_t count) { stack_.template Pop<Ch>(count); }
IanBenzMaxim 0:33d4e66780c0 72
IanBenzMaxim 0:33d4e66780c0 73 const Ch* GetString() const {
IanBenzMaxim 0:33d4e66780c0 74 // Push and pop a null terminator. This is safe.
IanBenzMaxim 0:33d4e66780c0 75 *stack_.template Push<Ch>() = '\0';
IanBenzMaxim 0:33d4e66780c0 76 stack_.template Pop<Ch>(1);
IanBenzMaxim 0:33d4e66780c0 77
IanBenzMaxim 0:33d4e66780c0 78 return stack_.template Bottom<Ch>();
IanBenzMaxim 0:33d4e66780c0 79 }
IanBenzMaxim 0:33d4e66780c0 80
IanBenzMaxim 0:33d4e66780c0 81 //! Get the size of string in bytes in the string buffer.
IanBenzMaxim 0:33d4e66780c0 82 size_t GetSize() const { return stack_.GetSize(); }
IanBenzMaxim 0:33d4e66780c0 83
IanBenzMaxim 0:33d4e66780c0 84 //! Get the length of string in Ch in the string buffer.
IanBenzMaxim 0:33d4e66780c0 85 size_t GetLength() const { return stack_.GetSize() / sizeof(Ch); }
IanBenzMaxim 0:33d4e66780c0 86
IanBenzMaxim 0:33d4e66780c0 87 static const size_t kDefaultCapacity = 256;
IanBenzMaxim 0:33d4e66780c0 88 mutable internal::Stack<Allocator> stack_;
IanBenzMaxim 0:33d4e66780c0 89
IanBenzMaxim 0:33d4e66780c0 90 private:
IanBenzMaxim 0:33d4e66780c0 91 // Prohibit copy constructor & assignment operator.
IanBenzMaxim 0:33d4e66780c0 92 GenericStringBuffer(const GenericStringBuffer&);
IanBenzMaxim 0:33d4e66780c0 93 GenericStringBuffer& operator=(const GenericStringBuffer&);
IanBenzMaxim 0:33d4e66780c0 94 };
IanBenzMaxim 0:33d4e66780c0 95
IanBenzMaxim 0:33d4e66780c0 96 //! String buffer with UTF8 encoding
IanBenzMaxim 0:33d4e66780c0 97 typedef GenericStringBuffer<UTF8<> > StringBuffer;
IanBenzMaxim 0:33d4e66780c0 98
IanBenzMaxim 0:33d4e66780c0 99 template<typename Encoding, typename Allocator>
IanBenzMaxim 0:33d4e66780c0 100 inline void PutReserve(GenericStringBuffer<Encoding, Allocator>& stream, size_t count) {
IanBenzMaxim 0:33d4e66780c0 101 stream.Reserve(count);
IanBenzMaxim 0:33d4e66780c0 102 }
IanBenzMaxim 0:33d4e66780c0 103
IanBenzMaxim 0:33d4e66780c0 104 template<typename Encoding, typename Allocator>
IanBenzMaxim 0:33d4e66780c0 105 inline void PutUnsafe(GenericStringBuffer<Encoding, Allocator>& stream, typename Encoding::Ch c) {
IanBenzMaxim 0:33d4e66780c0 106 stream.PutUnsafe(c);
IanBenzMaxim 0:33d4e66780c0 107 }
IanBenzMaxim 0:33d4e66780c0 108
IanBenzMaxim 0:33d4e66780c0 109 //! Implement specialized version of PutN() with memset() for better performance.
IanBenzMaxim 0:33d4e66780c0 110 template<>
IanBenzMaxim 0:33d4e66780c0 111 inline void PutN(GenericStringBuffer<UTF8<> >& stream, char c, size_t n) {
IanBenzMaxim 0:33d4e66780c0 112 std::memset(stream.stack_.Push<char>(n), c, n * sizeof(c));
IanBenzMaxim 0:33d4e66780c0 113 }
IanBenzMaxim 0:33d4e66780c0 114
IanBenzMaxim 0:33d4e66780c0 115 RAPIDJSON_NAMESPACE_END
IanBenzMaxim 0:33d4e66780c0 116
IanBenzMaxim 0:33d4e66780c0 117 #if defined(__clang__)
IanBenzMaxim 0:33d4e66780c0 118 RAPIDJSON_DIAG_POP
IanBenzMaxim 0:33d4e66780c0 119 #endif
IanBenzMaxim 0:33d4e66780c0 120
IanBenzMaxim 0:33d4e66780c0 121 #endif // RAPIDJSON_STRINGBUFFER_H_