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/DS28E39.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 "DS28E39.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 DS28E39::decrementCounterPage;
IanBenzMaxim 7:9cd16581b578 53 const int DS28E39::authorityPublicKeyXPage;
IanBenzMaxim 7:9cd16581b578 54 const int DS28E39::authorityPublicKeyYPage;
IanBenzMaxim 7:9cd16581b578 55 const int DS28E39::writePublicKeyXPage;
IanBenzMaxim 7:9cd16581b578 56 const int DS28E39::writePublicKeyYPage;
IanBenzMaxim 7:9cd16581b578 57 const int DS28E39::memoryPages;
IanBenzMaxim 7:9cd16581b578 58
IanBenzMaxim 8:5ea891c7d1a1 59 Result<void> DS28E39::writeMemory(int pageNum, Page::const_span page) {
IanBenzMaxim 7:9cd16581b578 60 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 61 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 62 }
IanBenzMaxim 7:9cd16581b578 63
IanBenzMaxim 7:9cd16581b578 64 uint_least8_t request[2 + Page::size];
IanBenzMaxim 7:9cd16581b578 65 request[0] = 0x96;
IanBenzMaxim 7:9cd16581b578 66 request[1] = pageNum;
IanBenzMaxim 7:9cd16581b578 67 copy(page.begin(), page.end(), request + 2);
IanBenzMaxim 7:9cd16581b578 68 return runCommand(request, writeMemoryTimeMs);
IanBenzMaxim 7:9cd16581b578 69 }
IanBenzMaxim 7:9cd16581b578 70
IanBenzMaxim 8:5ea891c7d1a1 71 Result<DS28E39::Page::array> DS28E39::readMemory(int pageNum) const {
IanBenzMaxim 7:9cd16581b578 72 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 73 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 74 }
IanBenzMaxim 7:9cd16581b578 75
IanBenzMaxim 7:9cd16581b578 76 uint_least8_t buffer[1 + Page::size];
IanBenzMaxim 7:9cd16581b578 77 buffer[0] = 0x44;
IanBenzMaxim 7:9cd16581b578 78 buffer[1] = pageNum;
IanBenzMaxim 8:5ea891c7d1a1 79 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 80 runCommand(make_span(buffer, 2), readMemoryTimeMs, buffer);
IanBenzMaxim 8:5ea891c7d1a1 81 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 82 return response.error();
IanBenzMaxim 7:9cd16581b578 83 }
IanBenzMaxim 8:5ea891c7d1a1 84 Page::array page;
IanBenzMaxim 8:5ea891c7d1a1 85 copy(response.value().begin(), response.value().end(), page.begin());
IanBenzMaxim 8:5ea891c7d1a1 86 return page;
IanBenzMaxim 7:9cd16581b578 87 }
IanBenzMaxim 7:9cd16581b578 88
IanBenzMaxim 8:5ea891c7d1a1 89 Result<DS28E39::Status> DS28E39::readStatus(bool entropyHealthTest) const {
IanBenzMaxim 7:9cd16581b578 90 int delay = readMemoryTimeMs;
IanBenzMaxim 7:9cd16581b578 91 if (entropyHealthTest) {
IanBenzMaxim 7:9cd16581b578 92 delay += trngOnDemandCheckTimeMs;
IanBenzMaxim 7:9cd16581b578 93 }
IanBenzMaxim 8:5ea891c7d1a1 94 uint_least8_t buffer[Status::PageProtectionList::size + ManId::size +
IanBenzMaxim 8:5ea891c7d1a1 95 Status::RomVersion::size + 2];
IanBenzMaxim 7:9cd16581b578 96 buffer[0] = 0xAA;
IanBenzMaxim 7:9cd16581b578 97 buffer[1] = entropyHealthTest ? 0x01 : 0x00;
IanBenzMaxim 8:5ea891c7d1a1 98 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 99 runCommand(make_span(buffer, 2), delay, buffer);
IanBenzMaxim 8:5ea891c7d1a1 100 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 101 return response.error();
IanBenzMaxim 8:5ea891c7d1a1 102 }
IanBenzMaxim 8:5ea891c7d1a1 103 Status status;
IanBenzMaxim 8:5ea891c7d1a1 104 span<uint_least8_t>::const_iterator responseIt = response.value().begin();
IanBenzMaxim 8:5ea891c7d1a1 105 for (Status::PageProtectionList::array::iterator it =
IanBenzMaxim 8:5ea891c7d1a1 106 status.pageProtection.begin();
IanBenzMaxim 8:5ea891c7d1a1 107 it != status.pageProtection.end(); ++it) {
IanBenzMaxim 8:5ea891c7d1a1 108 *it = *responseIt;
IanBenzMaxim 8:5ea891c7d1a1 109 ++responseIt;
IanBenzMaxim 8:5ea891c7d1a1 110 }
IanBenzMaxim 8:5ea891c7d1a1 111 span<uint_least8_t>::const_iterator responseItEnd =
IanBenzMaxim 8:5ea891c7d1a1 112 responseIt + status.manId.size();
IanBenzMaxim 8:5ea891c7d1a1 113 copy(responseIt, responseItEnd, status.manId.begin());
IanBenzMaxim 8:5ea891c7d1a1 114 responseIt = responseItEnd;
IanBenzMaxim 8:5ea891c7d1a1 115 responseItEnd = responseIt + status.romVersion.size();
IanBenzMaxim 8:5ea891c7d1a1 116 copy(responseIt, responseItEnd, status.romVersion.begin());
IanBenzMaxim 8:5ea891c7d1a1 117 responseIt = responseItEnd;
IanBenzMaxim 8:5ea891c7d1a1 118 switch (*responseIt) {
IanBenzMaxim 8:5ea891c7d1a1 119 case Status::TestNotPerformed:
IanBenzMaxim 8:5ea891c7d1a1 120 case Status::EntropyHealthy:
IanBenzMaxim 8:5ea891c7d1a1 121 case Status::EntropyNotHealthy:
IanBenzMaxim 8:5ea891c7d1a1 122 status.entropyHealthTestStatus =
IanBenzMaxim 8:5ea891c7d1a1 123 static_cast<Status::EntropyHealthTestStatus>(*responseIt);
IanBenzMaxim 8:5ea891c7d1a1 124 break;
IanBenzMaxim 7:9cd16581b578 125
IanBenzMaxim 8:5ea891c7d1a1 126 default:
IanBenzMaxim 8:5ea891c7d1a1 127 return InvalidResponseError;
IanBenzMaxim 7:9cd16581b578 128 }
IanBenzMaxim 8:5ea891c7d1a1 129 return status;
IanBenzMaxim 7:9cd16581b578 130 }
IanBenzMaxim 7:9cd16581b578 131
IanBenzMaxim 8:5ea891c7d1a1 132 Result<void> DS28E39::setPageProtection(int pageNum,
IanBenzMaxim 8:5ea891c7d1a1 133 const PageProtection & protection) {
IanBenzMaxim 7:9cd16581b578 134 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 135 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 136 }
IanBenzMaxim 7:9cd16581b578 137
IanBenzMaxim 7:9cd16581b578 138 int delay = writeStateTimeMs;
IanBenzMaxim 7:9cd16581b578 139 if (pageNum == decrementCounterPage) {
IanBenzMaxim 7:9cd16581b578 140 delay += writeMemoryTimeMs;
IanBenzMaxim 7:9cd16581b578 141 }
IanBenzMaxim 7:9cd16581b578 142 const uint_least8_t request[] = {
IanBenzMaxim 7:9cd16581b578 143 0xC3, static_cast<uint_least8_t>(pageNum),
IanBenzMaxim 7:9cd16581b578 144 static_cast<uint_least8_t>(protection.to_ulong())};
IanBenzMaxim 7:9cd16581b578 145 return runCommand(request, delay);
IanBenzMaxim 7:9cd16581b578 146 }
IanBenzMaxim 7:9cd16581b578 147
IanBenzMaxim 8:5ea891c7d1a1 148 Result<Ecc256::Signature::array>
IanBenzMaxim 7:9cd16581b578 149 DS28E39::computeAndReadPageAuthentication(int pageNum, bool anonymous,
IanBenzMaxim 8:5ea891c7d1a1 150 Page::const_span challenge) const {
IanBenzMaxim 7:9cd16581b578 151 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 152 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 153 }
IanBenzMaxim 7:9cd16581b578 154
IanBenzMaxim 7:9cd16581b578 155 const size_t requestSize = 2 + Page::size;
IanBenzMaxim 7:9cd16581b578 156 const size_t responseSize = 1 + 2 * Ecc256::Scalar::size;
IanBenzMaxim 7:9cd16581b578 157 uint_least8_t buffer[MaximInterfaceCore_MAX(requestSize, responseSize)];
IanBenzMaxim 7:9cd16581b578 158 buffer[0] = 0xA5;
IanBenzMaxim 7:9cd16581b578 159 buffer[1] = pageNum | (anonymous ? 0xE0 : 0x00);
IanBenzMaxim 7:9cd16581b578 160 copy(challenge.begin(), challenge.end(), buffer + 2);
IanBenzMaxim 8:5ea891c7d1a1 161 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 162 runCommand(make_span(buffer, requestSize), generateEcdsaSignatureTimeMs,
IanBenzMaxim 8:5ea891c7d1a1 163 make_span(buffer, responseSize));
IanBenzMaxim 8:5ea891c7d1a1 164 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 165 return response.error();
IanBenzMaxim 7:9cd16581b578 166 }
IanBenzMaxim 8:5ea891c7d1a1 167 Ecc256::Signature::array signature;
IanBenzMaxim 8:5ea891c7d1a1 168 span<uint_least8_t>::const_iterator begin = response.value().begin();
IanBenzMaxim 8:5ea891c7d1a1 169 span<uint_least8_t>::const_iterator end = begin + signature.s.size();
IanBenzMaxim 8:5ea891c7d1a1 170 copy(begin, end, signature.s.begin());
IanBenzMaxim 8:5ea891c7d1a1 171 begin = end;
IanBenzMaxim 8:5ea891c7d1a1 172 end = begin + signature.r.size();
IanBenzMaxim 8:5ea891c7d1a1 173 copy(begin, end, signature.r.begin());
IanBenzMaxim 8:5ea891c7d1a1 174 return signature;
IanBenzMaxim 7:9cd16581b578 175 }
IanBenzMaxim 7:9cd16581b578 176
IanBenzMaxim 8:5ea891c7d1a1 177 Result<void> DS28E39::decrementCounter() {
IanBenzMaxim 7:9cd16581b578 178 const uint_least8_t request = 0xC9;
IanBenzMaxim 7:9cd16581b578 179 return runCommand(make_span(&request, 1), writeMemoryTimeMs);
IanBenzMaxim 7:9cd16581b578 180 }
IanBenzMaxim 7:9cd16581b578 181
IanBenzMaxim 8:5ea891c7d1a1 182 Result<void> DS28E39::disableDevice() {
IanBenzMaxim 7:9cd16581b578 183 const uint_least8_t request[] = {0x33, 0x9E, 0xA7, 0x49, 0xFB,
IanBenzMaxim 7:9cd16581b578 184 0x10, 0x62, 0x0A, 0x26};
IanBenzMaxim 7:9cd16581b578 185 return runCommand(request, writeStateTimeMs);
IanBenzMaxim 7:9cd16581b578 186 }
IanBenzMaxim 7:9cd16581b578 187
IanBenzMaxim 8:5ea891c7d1a1 188 Result<Ecc256::PublicKey::array> DS28E39::readDevicePublicKey() const {
IanBenzMaxim 7:9cd16581b578 189 uint_least8_t buffer[1 + 2 * Ecc256::Scalar::size];
IanBenzMaxim 7:9cd16581b578 190 buffer[0] = 0xCB;
IanBenzMaxim 8:5ea891c7d1a1 191 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 192 runCommand(make_span(buffer, 1), generateEccKeyPairTimeMs, buffer);
IanBenzMaxim 8:5ea891c7d1a1 193 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 194 return response.error();
IanBenzMaxim 7:9cd16581b578 195 }
IanBenzMaxim 8:5ea891c7d1a1 196 Ecc256::PublicKey::array devicePublicKey;
IanBenzMaxim 8:5ea891c7d1a1 197 span<uint_least8_t>::const_iterator begin = response.value().begin();
IanBenzMaxim 8:5ea891c7d1a1 198 span<uint_least8_t>::const_iterator end = begin + devicePublicKey.x.size();
IanBenzMaxim 8:5ea891c7d1a1 199 copy(begin, end, devicePublicKey.x.begin());
IanBenzMaxim 8:5ea891c7d1a1 200 begin = end;
IanBenzMaxim 8:5ea891c7d1a1 201 end = begin + devicePublicKey.y.size();
IanBenzMaxim 8:5ea891c7d1a1 202 copy(begin, end, devicePublicKey.y.begin());
IanBenzMaxim 8:5ea891c7d1a1 203 return devicePublicKey;
IanBenzMaxim 7:9cd16581b578 204 }
IanBenzMaxim 7:9cd16581b578 205
IanBenzMaxim 8:5ea891c7d1a1 206 Result<void> DS28E39::readRng(span<uint_least8_t> data) const {
IanBenzMaxim 7:9cd16581b578 207 const span<uint_least8_t>::index_type maxDataSize = 64;
IanBenzMaxim 7:9cd16581b578 208 if ((data.size() < 1) || (data.size() > maxDataSize)) {
IanBenzMaxim 8:5ea891c7d1a1 209 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 210 }
IanBenzMaxim 7:9cd16581b578 211
IanBenzMaxim 7:9cd16581b578 212 uint_least8_t buffer[1 + maxDataSize];
IanBenzMaxim 7:9cd16581b578 213 buffer[0] = 0xD2;
IanBenzMaxim 7:9cd16581b578 214 buffer[1] = static_cast<uint_least8_t>(data.size() - 1);
IanBenzMaxim 8:5ea891c7d1a1 215 const Result<span<uint_least8_t> > response =
IanBenzMaxim 8:5ea891c7d1a1 216 runCommand(make_span(buffer, 2), trngGenerationTimeMs,
IanBenzMaxim 8:5ea891c7d1a1 217 make_span(buffer, 1 + data.size()));
IanBenzMaxim 8:5ea891c7d1a1 218 if (!response) {
IanBenzMaxim 8:5ea891c7d1a1 219 return response.error();
IanBenzMaxim 7:9cd16581b578 220 }
IanBenzMaxim 8:5ea891c7d1a1 221 copy(response.value().begin(), response.value().end(), data.begin());
IanBenzMaxim 8:5ea891c7d1a1 222 return none;
IanBenzMaxim 7:9cd16581b578 223 }
IanBenzMaxim 7:9cd16581b578 224
IanBenzMaxim 8:5ea891c7d1a1 225 Result<void>
IanBenzMaxim 7:9cd16581b578 226 DS28E39::authenticatePublicKey(Ecc256::Signature::const_span certificate,
IanBenzMaxim 7:9cd16581b578 227 span<const uint_least8_t> customization) {
IanBenzMaxim 7:9cd16581b578 228 static const span<const uint_least8_t>::index_type maxCustomizationSize = 32;
IanBenzMaxim 7:9cd16581b578 229 static const span<const uint_least8_t>::index_type signatureSize =
IanBenzMaxim 7:9cd16581b578 230 2 * Ecc256::Scalar::size;
IanBenzMaxim 7:9cd16581b578 231
IanBenzMaxim 7:9cd16581b578 232 if (customization.size() < 1 || customization.size() > maxCustomizationSize) {
IanBenzMaxim 8:5ea891c7d1a1 233 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 234 }
IanBenzMaxim 7:9cd16581b578 235
IanBenzMaxim 7:9cd16581b578 236 uint_least8_t request[1 + signatureSize + maxCustomizationSize];
IanBenzMaxim 7:9cd16581b578 237 uint_least8_t * requestIt = request;
IanBenzMaxim 7:9cd16581b578 238 *requestIt++ = 0x59;
IanBenzMaxim 7:9cd16581b578 239 requestIt = copy(certificate.r.begin(), certificate.r.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 240 requestIt = copy(certificate.s.begin(), certificate.s.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 241 requestIt = copy(customization.begin(), customization.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 242 return runCommand(make_span(request, requestIt), verifyEcdsaSignatureTimeMs);
IanBenzMaxim 7:9cd16581b578 243 }
IanBenzMaxim 7:9cd16581b578 244
IanBenzMaxim 8:5ea891c7d1a1 245 Result<void>
IanBenzMaxim 7:9cd16581b578 246 DS28E39::authenticatedWriteMemory(int pageNum, Page::const_span page,
IanBenzMaxim 7:9cd16581b578 247 Ecc256::Signature::const_span signature) {
IanBenzMaxim 7:9cd16581b578 248 if (pageNum < 0 || pageNum >= memoryPages) {
IanBenzMaxim 8:5ea891c7d1a1 249 return InvalidParameterError;
IanBenzMaxim 7:9cd16581b578 250 }
IanBenzMaxim 7:9cd16581b578 251
IanBenzMaxim 7:9cd16581b578 252 uint_least8_t request[2 + Page::size + 2 * Ecc256::Scalar::size];
IanBenzMaxim 7:9cd16581b578 253 uint_least8_t * requestIt = request;
IanBenzMaxim 7:9cd16581b578 254 *requestIt++ = 0x89;
IanBenzMaxim 7:9cd16581b578 255 *requestIt++ = pageNum;
IanBenzMaxim 7:9cd16581b578 256 requestIt = copy(page.begin(), page.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 257 requestIt = copy(signature.r.begin(), signature.r.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 258 copy(signature.s.begin(), signature.s.end(), requestIt);
IanBenzMaxim 7:9cd16581b578 259 return runCommand(request, verifyEcdsaSignatureTimeMs + writeMemoryTimeMs);
IanBenzMaxim 7:9cd16581b578 260 }
IanBenzMaxim 7:9cd16581b578 261
IanBenzMaxim 8:5ea891c7d1a1 262 Result<span<uint_least8_t> >
IanBenzMaxim 8:5ea891c7d1a1 263 DS28E39::runCommand(span<const uint_least8_t> request, int delayTime,
IanBenzMaxim 8:5ea891c7d1a1 264 span<uint_least8_t> response) const {
IanBenzMaxim 8:5ea891c7d1a1 265 const Result<span<uint_least8_t> > responseOutput =
IanBenzMaxim 8:5ea891c7d1a1 266 doRunCommand(request, delayTime, response);
IanBenzMaxim 8:5ea891c7d1a1 267 if (!responseOutput) {
IanBenzMaxim 8:5ea891c7d1a1 268 return responseOutput;
IanBenzMaxim 7:9cd16581b578 269 }
IanBenzMaxim 8:5ea891c7d1a1 270 if (responseOutput.value().empty()) {
IanBenzMaxim 8:5ea891c7d1a1 271 return InvalidResponseError;
IanBenzMaxim 7:9cd16581b578 272 }
IanBenzMaxim 7:9cd16581b578 273 // Parse command result byte.
IanBenzMaxim 8:5ea891c7d1a1 274 switch (responseOutput.value().front()) {
IanBenzMaxim 7:9cd16581b578 275 case 0xAA:
IanBenzMaxim 7:9cd16581b578 276 // Success response.
IanBenzMaxim 7:9cd16581b578 277 break;
IanBenzMaxim 7:9cd16581b578 278
IanBenzMaxim 7:9cd16581b578 279 case 0x00:
IanBenzMaxim 8:5ea891c7d1a1 280 return AuthenticationError;
IanBenzMaxim 7:9cd16581b578 281
IanBenzMaxim 7:9cd16581b578 282 default:
IanBenzMaxim 8:5ea891c7d1a1 283 return error_code(responseOutput.value().front(), errorCategory());
IanBenzMaxim 7:9cd16581b578 284 }
IanBenzMaxim 8:5ea891c7d1a1 285 if (responseOutput.value().size() != response.size()) {
IanBenzMaxim 8:5ea891c7d1a1 286 return InvalidResponseError;
IanBenzMaxim 8:5ea891c7d1a1 287 }
IanBenzMaxim 8:5ea891c7d1a1 288 return responseOutput.value().subspan(1);
IanBenzMaxim 7:9cd16581b578 289 }
IanBenzMaxim 7:9cd16581b578 290
IanBenzMaxim 8:5ea891c7d1a1 291 Result<void> DS28E39::runCommand(span<const uint_least8_t> request,
IanBenzMaxim 8:5ea891c7d1a1 292 int delayTime) {
IanBenzMaxim 7:9cd16581b578 293 uint_least8_t buffer;
IanBenzMaxim 8:5ea891c7d1a1 294 MaximInterfaceCore_TRY(runCommand(request, delayTime, make_span(&buffer, 1)));
IanBenzMaxim 8:5ea891c7d1a1 295 return none;
IanBenzMaxim 7:9cd16581b578 296 }
IanBenzMaxim 7:9cd16581b578 297
IanBenzMaxim 7:9cd16581b578 298 const error_category & DS28E39::errorCategory() {
IanBenzMaxim 7:9cd16581b578 299 static class : public error_category {
IanBenzMaxim 7:9cd16581b578 300 public:
IanBenzMaxim 7:9cd16581b578 301 virtual const char * name() const { return "DS28E39"; }
IanBenzMaxim 7:9cd16581b578 302
IanBenzMaxim 7:9cd16581b578 303 virtual std::string message(int condition) const {
IanBenzMaxim 7:9cd16581b578 304 switch (condition) {
IanBenzMaxim 7:9cd16581b578 305 case InvalidOperationError:
IanBenzMaxim 7:9cd16581b578 306 return "Invalid Operation Error";
IanBenzMaxim 7:9cd16581b578 307
IanBenzMaxim 7:9cd16581b578 308 case InvalidParameterError:
IanBenzMaxim 7:9cd16581b578 309 return "Invalid Parameter Error";
IanBenzMaxim 7:9cd16581b578 310
IanBenzMaxim 7:9cd16581b578 311 case InvalidSequenceError:
IanBenzMaxim 7:9cd16581b578 312 return "Invalid Sequence Error";
IanBenzMaxim 7:9cd16581b578 313
IanBenzMaxim 7:9cd16581b578 314 case InternalError:
IanBenzMaxim 7:9cd16581b578 315 return "Internal Error";
IanBenzMaxim 7:9cd16581b578 316
IanBenzMaxim 7:9cd16581b578 317 case DeviceDisabledError:
IanBenzMaxim 7:9cd16581b578 318 return "Device Disabled Error";
IanBenzMaxim 7:9cd16581b578 319
IanBenzMaxim 7:9cd16581b578 320 case AuthenticationError:
IanBenzMaxim 7:9cd16581b578 321 return "Authentication Error";
IanBenzMaxim 7:9cd16581b578 322
IanBenzMaxim 7:9cd16581b578 323 case InvalidResponseError:
IanBenzMaxim 7:9cd16581b578 324 return "Invalid Response Error";
IanBenzMaxim 7:9cd16581b578 325 }
IanBenzMaxim 7:9cd16581b578 326 return defaultErrorMessage(condition);
IanBenzMaxim 7:9cd16581b578 327 }
IanBenzMaxim 7:9cd16581b578 328 } instance;
IanBenzMaxim 7:9cd16581b578 329 return instance;
IanBenzMaxim 7:9cd16581b578 330 }
IanBenzMaxim 7:9cd16581b578 331
IanBenzMaxim 7:9cd16581b578 332 DS28E39::PageAuthenticationData &
IanBenzMaxim 7:9cd16581b578 333 DS28E39::PageAuthenticationData::setAnonymousRomId() {
IanBenzMaxim 7:9cd16581b578 334 std::fill(romId().begin(), romId().end(), 0xFF);
IanBenzMaxim 7:9cd16581b578 335 return *this;
IanBenzMaxim 7:9cd16581b578 336 }
IanBenzMaxim 7:9cd16581b578 337
IanBenzMaxim 7:9cd16581b578 338 } // namespace MaximInterfaceDevices