Maxim Integrated / MaximInterface

Device interface library for multiple platforms including Mbed.

Dependents:   DeepCover Embedded Security in IoT MaximInterface MAXREFDES155#

Maxim Interface is a library framework focused on providing flexible and expressive hardware interfaces. Both communication interfaces such as I2C and 1-Wire and device interfaces such as DS18B20 are supported. Modern C++ concepts are used extensively while keeping compatibility with C++98/C++03 and requiring no external dependencies. The embedded-friendly design does not depend on exceptions or RTTI.

The full version of the project is hosted on GitLab: https://gitlab.com/iabenz/MaximInterface

MaximInterfaceDevices/DS28C39.cpp@8:5ea891c7d1a1, 2019-09-16 (annotated)

Committer:
IanBenzMaxim
Date:
Mon Sep 16 11:13:37 2019 -0500
Revision:
8:5ea891c7d1a1
Parent:
7:9cd16581b578
Child:
11:3f3bf6bf5e6c
Updated to version 2.0.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
IanBenzMaxim 7:9cd16581b578 1 /*******************************************************************************
IanBenzMaxim 8:5ea891c7d1a1 2 * Copyright (C) Maxim Integrated Products, Inc., All Rights Reserved.
IanBenzMaxim 7:9cd16581b578 3 *
IanBenzMaxim 7:9cd16581b578 4 * Permission is hereby granted, free of charge, to any person obtaining a
IanBenzMaxim 7:9cd16581b578 5 * copy of this software and associated documentation files (the "Software"),
IanBenzMaxim 7:9cd16581b578 6 * to deal in the Software without restriction, including without limitation
IanBenzMaxim 7:9cd16581b578 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
IanBenzMaxim 7:9cd16581b578 8 * and/or sell copies of the Software, and to permit persons to whom the
IanBenzMaxim 7:9cd16581b578 9 * Software is furnished to do so, subject to the following conditions:
IanBenzMaxim 7:9cd16581b578 10 *
IanBenzMaxim 7:9cd16581b578 11 * The above copyright notice and this permission notice shall be included
IanBenzMaxim 7:9cd16581b578 12 * in all copies or substantial portions of the Software.
IanBenzMaxim 7:9cd16581b578 13 *
IanBenzMaxim 7:9cd16581b578 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
IanBenzMaxim 7:9cd16581b578 15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
IanBenzMaxim 7:9cd16581b578 16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IanBenzMaxim 7:9cd16581b578 17 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
IanBenzMaxim 7:9cd16581b578 18 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
IanBenzMaxim 7:9cd16581b578 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
IanBenzMaxim 7:9cd16581b578 20 * OTHER DEALINGS IN THE SOFTWARE.
IanBenzMaxim 7:9cd16581b578 21 *
IanBenzMaxim 7:9cd16581b578 22 * Except as contained in this notice, the name of Maxim Integrated
IanBenzMaxim 7:9cd16581b578 23 * Products, Inc. shall not be used except as stated in the Maxim Integrated
IanBenzMaxim 7:9cd16581b578 24 * Products, Inc. Branding Policy.
IanBenzMaxim 7:9cd16581b578 25 *
IanBenzMaxim 7:9cd16581b578 26 * The mere transfer of this software does not imply any licenses
IanBenzMaxim 7:9cd16581b578 27 * of trade secrets, proprietary technology, copyrights, patents,
IanBenzMaxim 7:9cd16581b578 28 * trademarks, maskwork rights, or any other form of intellectual
IanBenzMaxim 7:9cd16581b578 29 * property whatsoever. Maxim Integrated Products, Inc. retains all
IanBenzMaxim 7:9cd16581b578 30 * ownership rights.
IanBenzMaxim 7:9cd16581b578 31 *******************************************************************************/
IanBenzMaxim 7:9cd16581b578 32
IanBenzMaxim 7:9cd16581b578 33 #include <stddef.h>
IanBenzMaxim 7:9cd16581b578 34 #include <algorithm>
IanBenzMaxim 7:9cd16581b578 35 #include <MaximInterfaceCore/Error.hpp>
IanBenzMaxim 7:9cd16581b578 36 #include "DS28C39.hpp"
IanBenzMaxim 7:9cd16581b578 37
IanBenzMaxim 7:9cd16581b578 38 namespace MaximInterfaceDevices {
IanBenzMaxim 7:9cd16581b578 39
IanBenzMaxim 7:9cd16581b578 40 using namespace Core;
IanBenzMaxim 7:9cd16581b578 41 using std::copy;
IanBenzMaxim 7:9cd16581b578 42
IanBenzMaxim 7:9cd16581b578 43 static const int readMemoryTimeMs = 30;
IanBenzMaxim 7:9cd16581b578 44 static const int writeMemoryTimeMs = 65;
IanBenzMaxim 7:9cd16581b578 45 static const int writeStateTimeMs = 15;
IanBenzMaxim 7:9cd16581b578 46 static const int generateEccKeyPairTimeMs = 200;
IanBenzMaxim 7:9cd16581b578 47 static const int generateEcdsaSignatureTimeMs = 130;
IanBenzMaxim 7:9cd16581b578 48 static const int trngOnDemandCheckTimeMs = 20;
IanBenzMaxim 7:9cd16581b578 49 static const int trngGenerationTimeMs = 10;
IanBenzMaxim 7:9cd16581b578 50 static const int verifyEcdsaSignatureTimeMs = 180;
IanBenzMaxim 7:9cd16581b578 51
IanBenzMaxim 7:9cd16581b578 52 const int DS28C39::authorityPublicKeyXPage;
IanBenzMaxim 7:9cd16581b578 53 const int DS28C39::authorityPublicKeyYPage;
IanBenzMaxim 7:9cd16581b578 54 const int DS28C39::writePublicKeyXPage;
IanBenzMaxim 7:9cd16581b578 55 const int DS28C39::writePublicKeyYPage;
IanBenzMaxim 7:9cd16581b578 56 const int DS28C39::memoryPages;
IanBenzMaxim 7:9cd16581b578 57
IanBenzMaxim 8:5ea891c7d1a1 58 Result<void> DS28C39::writeMemory(int pageNum, Page::const_span page) {
IanBenzMaxim 7:9cd16581b578 59 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 60 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 61 }
IanBenzMaxim 7:9cd16581b578 62
IanBenzMaxim 7:9cd16581b578 63 uint_least8_t request[2 + Page::size];
IanBenzMaxim 7:9cd16581b578 64 request[0] = 0x96;
IanBenzMaxim 7:9cd16581b578 65 request[1] = pageNum;
IanBenzMaxim 7:9cd16581b578 66 copy(page.begin(), page.end(), request + 2);
IanBenzMaxim 7:9cd16581b578 67 return runCommand(request, writeMemoryTimeMs);
IanBenzMaxim 7:9cd16581b578 68 }
IanBenzMaxim 7:9cd16581b578 69
IanBenzMaxim 8:5ea891c7d1a1 70 Result<DS28C39::Page::array> DS28C39::readMemory(int pageNum) const {
IanBenzMaxim 7:9cd16581b578 71 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 72 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 73 }
IanBenzMaxim 7:9cd16581b578 74
IanBenzMaxim 7:9cd16581b578 75 uint_least8_t buffer[1 + Page::size];
IanBenzMaxim 7:9cd16581b578 76 buffer[0] = 0x44;
IanBenzMaxim 7:9cd16581b578 77 buffer[1] = pageNum;
IanBenzMaxim 8:5ea891c7d1a1 78 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 79 runCommand(make_span(buffer, 2), readMemoryTimeMs, buffer);
IanBenzMaxim 8:5ea891c7d1a1 80 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 81 return response.error();
IanBenzMaxim 7:9cd16581b578 82 }
IanBenzMaxim 8:5ea891c7d1a1 83 Page::array page;
IanBenzMaxim 8:5ea891c7d1a1 84 copy(response.value().begin(), response.value().end(), page.begin());
IanBenzMaxim 8:5ea891c7d1a1 85 return page;
IanBenzMaxim 7:9cd16581b578 86 }
IanBenzMaxim 7:9cd16581b578 87
IanBenzMaxim 8:5ea891c7d1a1 88 Result<DS28C39::Status> DS28C39::readStatus(bool entropyHealthTest) const {
IanBenzMaxim 7:9cd16581b578 89 int delay = readMemoryTimeMs;
IanBenzMaxim 7:9cd16581b578 90 if (entropyHealthTest) {
IanBenzMaxim 7:9cd16581b578 91 delay += trngOnDemandCheckTimeMs;
IanBenzMaxim 7:9cd16581b578 92 }
IanBenzMaxim 8:5ea891c7d1a1 93 uint_least8_t buffer[Status::PageProtectionList::size + RomId::size +
IanBenzMaxim 8:5ea891c7d1a1 94 ManId::size + Status::RomVersion::size + 2];
IanBenzMaxim 7:9cd16581b578 95 buffer[0] = 0xAA;
IanBenzMaxim 7:9cd16581b578 96 buffer[1] = entropyHealthTest ? 0x01 : 0x00;
IanBenzMaxim 8:5ea891c7d1a1 97 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 98 runCommand(make_span(buffer, 2), delay, buffer);
IanBenzMaxim 8:5ea891c7d1a1 99 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 100 return response.error();
IanBenzMaxim 8:5ea891c7d1a1 101 }
IanBenzMaxim 8:5ea891c7d1a1 102 Status status;
IanBenzMaxim 8:5ea891c7d1a1 103 span<uint_least8_t>::const_iterator responseIt = response.value().begin();
IanBenzMaxim 8:5ea891c7d1a1 104 for (Status::PageProtectionList::array::iterator it =
IanBenzMaxim 8:5ea891c7d1a1 105 status.pageProtection.begin();
IanBenzMaxim 8:5ea891c7d1a1 106 it != status.pageProtection.end(); ++it) {
IanBenzMaxim 8:5ea891c7d1a1 107 *it = *responseIt;
IanBenzMaxim 8:5ea891c7d1a1 108 ++responseIt;
IanBenzMaxim 8:5ea891c7d1a1 109 }
IanBenzMaxim 8:5ea891c7d1a1 110 span<uint_least8_t>::const_iterator responseItEnd =
IanBenzMaxim 8:5ea891c7d1a1 111 responseIt + status.romId.size();
IanBenzMaxim 8:5ea891c7d1a1 112 copy(responseIt, responseItEnd, status.romId.begin());
IanBenzMaxim 8:5ea891c7d1a1 113 responseIt = responseItEnd;
IanBenzMaxim 8:5ea891c7d1a1 114 responseItEnd = responseIt + status.manId.size();
IanBenzMaxim 8:5ea891c7d1a1 115 copy(responseIt, responseItEnd, status.manId.begin());
IanBenzMaxim 8:5ea891c7d1a1 116 responseIt = responseItEnd;
IanBenzMaxim 8:5ea891c7d1a1 117 responseItEnd = responseIt + status.romVersion.size();
IanBenzMaxim 8:5ea891c7d1a1 118 copy(responseIt, responseItEnd, status.romVersion.begin());
IanBenzMaxim 8:5ea891c7d1a1 119 responseIt = responseItEnd;
IanBenzMaxim 8:5ea891c7d1a1 120 switch (*responseIt) {
IanBenzMaxim 8:5ea891c7d1a1 121 case Status::TestNotPerformed:
IanBenzMaxim 8:5ea891c7d1a1 122 case Status::EntropyHealthy:
IanBenzMaxim 8:5ea891c7d1a1 123 case Status::EntropyNotHealthy:
IanBenzMaxim 8:5ea891c7d1a1 124 status.entropyHealthTestStatus =
IanBenzMaxim 8:5ea891c7d1a1 125 static_cast<Status::EntropyHealthTestStatus>(*responseIt);
IanBenzMaxim 8:5ea891c7d1a1 126 break;
IanBenzMaxim 7:9cd16581b578 127
IanBenzMaxim 8:5ea891c7d1a1 128 default:
IanBenzMaxim 8:5ea891c7d1a1 129 return InvalidResponseError;
IanBenzMaxim 7:9cd16581b578 130 }
IanBenzMaxim 8:5ea891c7d1a1 131 return status;
IanBenzMaxim 7:9cd16581b578 132 }
IanBenzMaxim 7:9cd16581b578 133
IanBenzMaxim 8:5ea891c7d1a1 134 Result<void> DS28C39::setPageProtection(int pageNum,
IanBenzMaxim 8:5ea891c7d1a1 135 const PageProtection & protection) {
IanBenzMaxim 7:9cd16581b578 136 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 137 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 138 }
IanBenzMaxim 7:9cd16581b578 139
IanBenzMaxim 7:9cd16581b578 140 const uint_least8_t request[] = {
IanBenzMaxim 7:9cd16581b578 141 0xC3, static_cast<uint_least8_t>(pageNum),
IanBenzMaxim 7:9cd16581b578 142 static_cast<uint_least8_t>(protection.to_ulong())};
IanBenzMaxim 7:9cd16581b578 143 return runCommand(request, writeStateTimeMs);
IanBenzMaxim 7:9cd16581b578 144 }
IanBenzMaxim 7:9cd16581b578 145
IanBenzMaxim 8:5ea891c7d1a1 146 Result<Ecc256::Signature::array>
IanBenzMaxim 7:9cd16581b578 147 DS28C39::computeAndReadPageAuthentication(int pageNum, bool anonymous,
IanBenzMaxim 8:5ea891c7d1a1 148 Page::const_span challenge) const {
IanBenzMaxim 7:9cd16581b578 149 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 150 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 151 }
IanBenzMaxim 7:9cd16581b578 152
IanBenzMaxim 7:9cd16581b578 153 const size_t requestSize = 2 + Page::size;
IanBenzMaxim 7:9cd16581b578 154 const size_t responseSize = 1 + 2 * Ecc256::Scalar::size;
IanBenzMaxim 7:9cd16581b578 155 uint_least8_t buffer[MaximInterfaceCore_MAX(requestSize, responseSize)];
IanBenzMaxim 7:9cd16581b578 156 buffer[0] = 0xA5;
IanBenzMaxim 7:9cd16581b578 157 buffer[1] = pageNum | (anonymous ? 0xE0 : 0x00);
IanBenzMaxim 7:9cd16581b578 158 copy(challenge.begin(), challenge.end(), buffer + 2);
IanBenzMaxim 8:5ea891c7d1a1 159 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 160 runCommand(make_span(buffer, requestSize), generateEcdsaSignatureTimeMs,
IanBenzMaxim 8:5ea891c7d1a1 161 make_span(buffer, responseSize));
IanBenzMaxim 8:5ea891c7d1a1 162 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 163 return response.error();
IanBenzMaxim 7:9cd16581b578 164 }
IanBenzMaxim 8:5ea891c7d1a1 165 Ecc256::Signature::array signature;
IanBenzMaxim 8:5ea891c7d1a1 166 span<uint_least8_t>::const_iterator begin = response.value().begin();
IanBenzMaxim 8:5ea891c7d1a1 167 span<uint_least8_t>::const_iterator end = begin + signature.s.size();
IanBenzMaxim 8:5ea891c7d1a1 168 copy(begin, end, signature.s.begin());
IanBenzMaxim 8:5ea891c7d1a1 169 begin = end;
IanBenzMaxim 8:5ea891c7d1a1 170 end = begin + signature.r.size();
IanBenzMaxim 8:5ea891c7d1a1 171 copy(begin, end, signature.r.begin());
IanBenzMaxim 8:5ea891c7d1a1 172 return signature;
IanBenzMaxim 7:9cd16581b578 173 }
IanBenzMaxim 7:9cd16581b578 174
IanBenzMaxim 8:5ea891c7d1a1 175 Result<void> DS28C39::disableDevice() {
IanBenzMaxim 7:9cd16581b578 176 const uint_least8_t request[] = {0x33, 0x9E, 0xA7, 0x49, 0xFB,
IanBenzMaxim 7:9cd16581b578 177 0x10, 0x62, 0x0A, 0x26};
IanBenzMaxim 7:9cd16581b578 178 return runCommand(request, writeStateTimeMs);
IanBenzMaxim 7:9cd16581b578 179 }
IanBenzMaxim 7:9cd16581b578 180
IanBenzMaxim 8:5ea891c7d1a1 181 Result<Ecc256::PublicKey::array> DS28C39::readDevicePublicKey() const {
IanBenzMaxim 7:9cd16581b578 182 uint_least8_t buffer[1 + 2 * Ecc256::Scalar::size];
IanBenzMaxim 7:9cd16581b578 183 buffer[0] = 0xCB;
IanBenzMaxim 8:5ea891c7d1a1 184 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 185 runCommand(make_span(buffer, 1), generateEccKeyPairTimeMs, buffer);
IanBenzMaxim 8:5ea891c7d1a1 186 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 187 return response.error();
IanBenzMaxim 7:9cd16581b578 188 }
IanBenzMaxim 8:5ea891c7d1a1 189 Ecc256::PublicKey::array devicePublicKey;
IanBenzMaxim 8:5ea891c7d1a1 190 span<uint_least8_t>::const_iterator begin = response.value().begin();
IanBenzMaxim 8:5ea891c7d1a1 191 span<uint_least8_t>::const_iterator end = begin + devicePublicKey.x.size();
IanBenzMaxim 8:5ea891c7d1a1 192 copy(begin, end, devicePublicKey.x.begin());
IanBenzMaxim 8:5ea891c7d1a1 193 begin = end;
IanBenzMaxim 8:5ea891c7d1a1 194 end = begin + devicePublicKey.y.size();
IanBenzMaxim 8:5ea891c7d1a1 195 copy(begin, end, devicePublicKey.y.begin());
IanBenzMaxim 8:5ea891c7d1a1 196 return devicePublicKey;
IanBenzMaxim 7:9cd16581b578 197 }
IanBenzMaxim 7:9cd16581b578 198
IanBenzMaxim 8:5ea891c7d1a1 199 Result<void> DS28C39::readRng(span<uint_least8_t> data) const {
IanBenzMaxim 7:9cd16581b578 200 const span<uint_least8_t>::index_type maxDataSize = 64;
IanBenzMaxim 7:9cd16581b578 201 if ((data.size() < 1) || (data.size() > maxDataSize)) {
IanBenzMaxim 8:5ea891c7d1a1 202 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 203 }
IanBenzMaxim 7:9cd16581b578 204
IanBenzMaxim 7:9cd16581b578 205 uint_least8_t buffer[1 + maxDataSize];
IanBenzMaxim 7:9cd16581b578 206 buffer[0] = 0xD2;
IanBenzMaxim 7:9cd16581b578 207 buffer[1] = static_cast<uint_least8_t>(data.size() - 1);
IanBenzMaxim 8:5ea891c7d1a1 208 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 209 runCommand(make_span(buffer, 2), trngGenerationTimeMs,
IanBenzMaxim 8:5ea891c7d1a1 210 make_span(buffer, 1 + data.size()));
IanBenzMaxim 8:5ea891c7d1a1 211 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 212 return response.error();
IanBenzMaxim 7:9cd16581b578 213 }
IanBenzMaxim 8:5ea891c7d1a1 214 copy(response.value().begin(), response.value().end(), data.begin());
IanBenzMaxim 8:5ea891c7d1a1 215 return none;
IanBenzMaxim 7:9cd16581b578 216 }
IanBenzMaxim 7:9cd16581b578 217
IanBenzMaxim 8:5ea891c7d1a1 218 Result<void>
IanBenzMaxim 7:9cd16581b578 219 DS28C39::authenticatePublicKey(Ecc256::Signature::const_span certificate,
IanBenzMaxim 7:9cd16581b578 220 span<const uint_least8_t> customization) {
IanBenzMaxim 7:9cd16581b578 221 static const span<const uint_least8_t>::index_type maxCustomizationSize = 32;
IanBenzMaxim 7:9cd16581b578 222 static const span<const uint_least8_t>::index_type signatureSize =
IanBenzMaxim 7:9cd16581b578 223 2 * Ecc256::Scalar::size;
IanBenzMaxim 7:9cd16581b578 224
IanBenzMaxim 7:9cd16581b578 225 if (customization.size() < 1 || customization.size() > maxCustomizationSize) {
IanBenzMaxim 8:5ea891c7d1a1 226 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 227 }
IanBenzMaxim 7:9cd16581b578 228
IanBenzMaxim 7:9cd16581b578 229 uint_least8_t request[1 + signatureSize + maxCustomizationSize];
IanBenzMaxim 7:9cd16581b578 230 uint_least8_t * requestIt = request;
IanBenzMaxim 7:9cd16581b578 231 *requestIt++ = 0x59;
IanBenzMaxim 7:9cd16581b578 232 requestIt = copy(certificate.r.begin(), certificate.r.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 233 requestIt = copy(certificate.s.begin(), certificate.s.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 234 requestIt = copy(customization.begin(), customization.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 235 return runCommand(make_span(request, requestIt), verifyEcdsaSignatureTimeMs);
IanBenzMaxim 7:9cd16581b578 236 }
IanBenzMaxim 7:9cd16581b578 237
IanBenzMaxim 8:5ea891c7d1a1 238 Result<void>
IanBenzMaxim 7:9cd16581b578 239 DS28C39::authenticatedWriteMemory(int pageNum, Page::const_span page,
IanBenzMaxim 7:9cd16581b578 240 Ecc256::Signature::const_span signature) {
IanBenzMaxim 7:9cd16581b578 241 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 242 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 243 }
IanBenzMaxim 7:9cd16581b578 244
IanBenzMaxim 7:9cd16581b578 245 uint_least8_t request[2 + Page::size + 2 * Ecc256::Scalar::size];
IanBenzMaxim 7:9cd16581b578 246 uint_least8_t * requestIt = request;
IanBenzMaxim 7:9cd16581b578 247 *requestIt++ = 0x89;
IanBenzMaxim 7:9cd16581b578 248 *requestIt++ = pageNum;
IanBenzMaxim 7:9cd16581b578 249 requestIt = copy(page.begin(), page.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 250 requestIt = copy(signature.r.begin(), signature.r.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 251 copy(signature.s.begin(), signature.s.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 252 return runCommand(request, verifyEcdsaSignatureTimeMs + writeMemoryTimeMs);
IanBenzMaxim 7:9cd16581b578 253 }
IanBenzMaxim 7:9cd16581b578 254
IanBenzMaxim 8:5ea891c7d1a1 255 Result<span<uint_least8_t> >
IanBenzMaxim 8:5ea891c7d1a1 256 DS28C39::runCommand(span<const uint_least8_t> request, int delayTime,
IanBenzMaxim 8:5ea891c7d1a1 257 span<uint_least8_t> response) const {
IanBenzMaxim 8:5ea891c7d1a1 258 const Result<span<uint_least8_t> > responseOutput =
IanBenzMaxim 8:5ea891c7d1a1 259 doRunCommand(request, delayTime, response);
IanBenzMaxim 8:5ea891c7d1a1 260 if (!responseOutput) {
IanBenzMaxim 8:5ea891c7d1a1 261 return responseOutput;
IanBenzMaxim 7:9cd16581b578 262 }
IanBenzMaxim 8:5ea891c7d1a1 263 if (responseOutput.value().empty()) {
IanBenzMaxim 8:5ea891c7d1a1 264 return InvalidResponseError;
IanBenzMaxim 7:9cd16581b578 265 }
IanBenzMaxim 7:9cd16581b578 266 // Parse command result byte.
IanBenzMaxim 8:5ea891c7d1a1 267 switch (responseOutput.value().front()) {
IanBenzMaxim 7:9cd16581b578 268 case 0xAA:
IanBenzMaxim 7:9cd16581b578 269 // Success response.
IanBenzMaxim 7:9cd16581b578 270 break;
IanBenzMaxim 7:9cd16581b578 271
IanBenzMaxim 7:9cd16581b578 272 case 0x00:
IanBenzMaxim 8:5ea891c7d1a1 273 return AuthenticationError;
IanBenzMaxim 7:9cd16581b578 274
IanBenzMaxim 7:9cd16581b578 275 default:
IanBenzMaxim 8:5ea891c7d1a1 276 return error_code(responseOutput.value().front(), errorCategory());
IanBenzMaxim 7:9cd16581b578 277 }
IanBenzMaxim 8:5ea891c7d1a1 278 if (responseOutput.value().size() != response.size()) {
IanBenzMaxim 8:5ea891c7d1a1 279 return InvalidResponseError;
IanBenzMaxim 8:5ea891c7d1a1 280 }
IanBenzMaxim 8:5ea891c7d1a1 281 return responseOutput.value().subspan(1);
IanBenzMaxim 7:9cd16581b578 282 }
IanBenzMaxim 7:9cd16581b578 283
IanBenzMaxim 8:5ea891c7d1a1 284 Result<void> DS28C39::runCommand(span<const uint_least8_t> request,
IanBenzMaxim 8:5ea891c7d1a1 285 int delayTime) {
IanBenzMaxim 7:9cd16581b578 286 uint_least8_t buffer;
IanBenzMaxim 8:5ea891c7d1a1 287 MaximInterfaceCore_TRY(runCommand(request, delayTime, make_span(&buffer, 1)));
IanBenzMaxim 8:5ea891c7d1a1 288 return none;
IanBenzMaxim 7:9cd16581b578 289 }
IanBenzMaxim 7:9cd16581b578 290
IanBenzMaxim 7:9cd16581b578 291 const error_category & DS28C39::errorCategory() {
IanBenzMaxim 7:9cd16581b578 292 static class : public error_category {
IanBenzMaxim 7:9cd16581b578 293 public:
IanBenzMaxim 7:9cd16581b578 294 virtual const char * name() const { return "DS28C39"; }
IanBenzMaxim 7:9cd16581b578 295
IanBenzMaxim 7:9cd16581b578 296 virtual std::string message(int condition) const {
IanBenzMaxim 7:9cd16581b578 297 switch (condition) {
IanBenzMaxim 7:9cd16581b578 298 case InvalidOperationError:
IanBenzMaxim 7:9cd16581b578 299 return "Invalid Operation Error";
IanBenzMaxim 7:9cd16581b578 300
IanBenzMaxim 7:9cd16581b578 301 case InvalidParameterError:
IanBenzMaxim 7:9cd16581b578 302 return "Invalid Parameter Error";
IanBenzMaxim 7:9cd16581b578 303
IanBenzMaxim 7:9cd16581b578 304 case InvalidSequenceError:
IanBenzMaxim 7:9cd16581b578 305 return "Invalid Sequence Error";
IanBenzMaxim 7:9cd16581b578 306
IanBenzMaxim 7:9cd16581b578 307 case InternalError:
IanBenzMaxim 7:9cd16581b578 308 return "Internal Error";
IanBenzMaxim 7:9cd16581b578 309
IanBenzMaxim 7:9cd16581b578 310 case DeviceDisabledError:
IanBenzMaxim 7:9cd16581b578 311 return "Device Disabled Error";
IanBenzMaxim 7:9cd16581b578 312
IanBenzMaxim 7:9cd16581b578 313 case AuthenticationError:
IanBenzMaxim 7:9cd16581b578 314 return "Authentication Error";
IanBenzMaxim 7:9cd16581b578 315
IanBenzMaxim 7:9cd16581b578 316 case InvalidResponseError:
IanBenzMaxim 7:9cd16581b578 317 return "Invalid Response Error";
IanBenzMaxim 7:9cd16581b578 318 }
IanBenzMaxim 7:9cd16581b578 319 return defaultErrorMessage(condition);
IanBenzMaxim 7:9cd16581b578 320 }
IanBenzMaxim 7:9cd16581b578 321 } instance;
IanBenzMaxim 7:9cd16581b578 322 return instance;
IanBenzMaxim 7:9cd16581b578 323 }
IanBenzMaxim 7:9cd16581b578 324
IanBenzMaxim 7:9cd16581b578 325 DS28C39::PageAuthenticationData &
IanBenzMaxim 7:9cd16581b578 326 DS28C39::PageAuthenticationData::setAnonymousRomId() {
IanBenzMaxim 7:9cd16581b578 327 std::fill(romId().begin(), romId().end(), 0xFF);
IanBenzMaxim 7:9cd16581b578 328 return *this;
IanBenzMaxim 7:9cd16581b578 329 }
IanBenzMaxim 7:9cd16581b578 330
IanBenzMaxim 7:9cd16581b578 331 } // namespace MaximInterfaceDevices