Mark Underwood / Mbed OS MAX11043_Serial_Tester

Test program running on MAX32625MBED. Control through USB Serial commands using a terminal emulator such as teraterm or putty.

Dependencies:   MaximTinyTester CmdLine MAX541 USBDevice

MAX11043/MAX11043.cpp@76:0397493d7baf, 2020-02-24 (annotated)

Committer:
whismanoid
Date:
Mon Feb 24 08:11:55 2020 +0000
Revision:
76:0397493d7baf
Parent:
75:0900a57f2e5d
Child:
77:3a6e2a5cd7d9
SPI is not interrupt-safe, so use EventQueue to defer execution to user context

Who changed what in which revision?

UserRevisionLine numberNew contents of line
whismanoid 53:3d5a3d241a5e 1 // /*******************************************************************************
whismanoid 53:3d5a3d241a5e 2 // * Copyright (C) 2020 Maxim Integrated Products, Inc., All Rights Reserved.
whismanoid 53:3d5a3d241a5e 3 // *
whismanoid 53:3d5a3d241a5e 4 // * Permission is hereby granted, free of charge, to any person obtaining a
whismanoid 53:3d5a3d241a5e 5 // * copy of this software and associated documentation files (the "Software"),
whismanoid 53:3d5a3d241a5e 6 // * to deal in the Software without restriction, including without limitation
whismanoid 53:3d5a3d241a5e 7 // * the rights to use, copy, modify, merge, publish, distribute, sublicense,
whismanoid 53:3d5a3d241a5e 8 // * and/or sell copies of the Software, and to permit persons to whom the
whismanoid 53:3d5a3d241a5e 9 // * Software is furnished to do so, subject to the following conditions:
whismanoid 53:3d5a3d241a5e 10 // *
whismanoid 53:3d5a3d241a5e 11 // * The above copyright notice and this permission notice shall be included
whismanoid 53:3d5a3d241a5e 12 // * in all copies or substantial portions of the Software.
whismanoid 53:3d5a3d241a5e 13 // *
whismanoid 53:3d5a3d241a5e 14 // * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
whismanoid 53:3d5a3d241a5e 15 // * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
whismanoid 53:3d5a3d241a5e 16 // * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
whismanoid 53:3d5a3d241a5e 17 // * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
whismanoid 53:3d5a3d241a5e 18 // * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
whismanoid 53:3d5a3d241a5e 19 // * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
whismanoid 53:3d5a3d241a5e 20 // * OTHER DEALINGS IN THE SOFTWARE.
whismanoid 53:3d5a3d241a5e 21 // *
whismanoid 53:3d5a3d241a5e 22 // * Except as contained in this notice, the name of Maxim Integrated
whismanoid 53:3d5a3d241a5e 23 // * Products, Inc. shall not be used except as stated in the Maxim Integrated
whismanoid 53:3d5a3d241a5e 24 // * Products, Inc. Branding Policy.
whismanoid 53:3d5a3d241a5e 25 // *
whismanoid 53:3d5a3d241a5e 26 // * The mere transfer of this software does not imply any licenses
whismanoid 53:3d5a3d241a5e 27 // * of trade secrets, proprietary technology, copyrights, patents,
whismanoid 53:3d5a3d241a5e 28 // * trademarks, maskwork rights, or any other form of intellectual
whismanoid 53:3d5a3d241a5e 29 // * property whatsoever. Maxim Integrated Products, Inc. retains all
whismanoid 53:3d5a3d241a5e 30 // * ownership rights.
whismanoid 53:3d5a3d241a5e 31 // *******************************************************************************
whismanoid 53:3d5a3d241a5e 32 // */
whismanoid 53:3d5a3d241a5e 33 // *********************************************************************
whismanoid 53:3d5a3d241a5e 34 // @file MAX11043.cpp
whismanoid 53:3d5a3d241a5e 35 // *********************************************************************
whismanoid 53:3d5a3d241a5e 36 // Device Driver file
whismanoid 53:3d5a3d241a5e 37 // DO NOT EDIT; except areas designated "CUSTOMIZE". Automatically generated file.
whismanoid 53:3d5a3d241a5e 38 // generated by XMLSystemOfDevicesToMBED.py
whismanoid 53:3d5a3d241a5e 39 // System Name = ExampleSystem
whismanoid 53:3d5a3d241a5e 40 // System Description = Device driver example
whismanoid 53:3d5a3d241a5e 41
whismanoid 53:3d5a3d241a5e 42 #include "MAX11043.h"
whismanoid 69:989e392cf635 43 //--------------------------------------------------
whismanoid 69:989e392cf635 44 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 45 // EOC# asserts low when new data is available.
whismanoid 69:989e392cf635 46 // Initiate a data read prior to the next rising edge of EOC# or the result is overwritten.
whismanoid 69:989e392cf635 47 #ifndef MAX11043_EOC_INTERRUPT_POLLING
whismanoid 71:62bcd01ea87f 48 #define MAX11043_EOC_INTERRUPT_POLLING 0
whismanoid 69:989e392cf635 49 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 73:879578472009 50 //--------------------------------------------------
whismanoid 76:0397493d7baf 51 // SPI is not interrupt-safe, so use EventQueue to defer execution to user context.
whismanoid 76:0397493d7baf 52 #ifndef MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 53 #define MAX11043_EOC_INTERRUPT_EVENTQUEUE 1
whismanoid 76:0397493d7baf 54 #endif // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 55 #if MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 56 #else // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 57 #endif // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 58 #if MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 59 // SPI is not interrupt-safe, so use EventQueue to defer execution to user context.
whismanoid 76:0397493d7baf 60 #include "mbed_events.h"
whismanoid 76:0397493d7baf 61 #define MYONEOCTHREADEVENTFLAG_ENABLE_SPI (1UL << 0)
whismanoid 76:0397493d7baf 62 EventFlags myOnEOCThread_event_flags;
whismanoid 76:0397493d7baf 63 Thread myOnEOCThread;
whismanoid 76:0397493d7baf 64 extern void myOnEOCThread_handler();
whismanoid 76:0397493d7baf 65 #else // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 66 #endif // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 67 //--------------------------------------------------
whismanoid 73:879578472009 68 // Diagnostic: Use MAX32625MBED pin D5 as DigitalOut EOC#-detected
whismanoid 73:879578472009 69 #ifndef MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 73:879578472009 70 #define MAX11043_ScopeTrigger_MAX32625MBED_D5 1
whismanoid 73:879578472009 71 #endif // MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 73:879578472009 72 #if MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 73:879578472009 73 // Diagnostic: Use MAX32625MBED pin D5 as DigitalOut EOC#-detected
whismanoid 73:879578472009 74 // WIP MAX11043 interrupt EOC echo - moving DigitalOut ScopeTrigger to global scope, it compiles but there is no activity on scope
whismanoid 74:f4f969c9a7a9 75 extern DigitalInOut digitalInOut5; // declared in Test_Main_MAX11043.cpp (D5, PIN_INPUT, PullUp, 1)
whismanoid 75:0900a57f2e5d 76 const size_t byteCount_onEOCFallingEdge = 1 + (2 * 4);
whismanoid 75:0900a57f2e5d 77 const uint8_t mosiData_onEOCFallingEdge[9] = {
whismanoid 75:0900a57f2e5d 78 MAX11043::CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd,
whismanoid 75:0900a57f2e5d 79 0, 0, 0, 0, 0, 0, 0, 0
whismanoid 75:0900a57f2e5d 80 };
whismanoid 75:0900a57f2e5d 81 uint8_t misoData_onEOCFallingEdge[9];
whismanoid 73:879578472009 82 #endif // MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 53:3d5a3d241a5e 83
whismanoid 53:3d5a3d241a5e 84 // Device Name = MAX11043
whismanoid 53:3d5a3d241a5e 85 // Device Description = 200ksps, Low-Power, Serial SPI 24-Bit, 4-Channel, Differential/Single-Ended Input, Simultaneous-Sampling SD ADC
whismanoid 53:3d5a3d241a5e 86 // Device DeviceBriefDescription = 24-bit 200ksps Delta-Sigma ADC
whismanoid 53:3d5a3d241a5e 87 // Device Manufacturer = Maxim Integrated
whismanoid 53:3d5a3d241a5e 88 // Device PartNumber = MAX11043ATL+
whismanoid 53:3d5a3d241a5e 89 // Device RegValue_Width = DataWidth16bit_HL
whismanoid 53:3d5a3d241a5e 90 //
whismanoid 53:3d5a3d241a5e 91 // ADC MaxOutputDataRate = 200ksps
whismanoid 53:3d5a3d241a5e 92 // ADC NumChannels = 4
whismanoid 53:3d5a3d241a5e 93 // ADC ResolutionBits = 24
whismanoid 53:3d5a3d241a5e 94 //
whismanoid 53:3d5a3d241a5e 95 // SPI CS = ActiveLow
whismanoid 53:3d5a3d241a5e 96 // SPI FrameStart = CS
whismanoid 53:3d5a3d241a5e 97 // SPI CPOL = 0
whismanoid 53:3d5a3d241a5e 98 // SPI CPHA = 0
whismanoid 53:3d5a3d241a5e 99 // SPI MOSI and MISO Data are both stable on Rising edge of SCLK
whismanoid 53:3d5a3d241a5e 100 // SPI SCLK Idle Low
whismanoid 53:3d5a3d241a5e 101 // SPI SCLKMaxMHz = 40
whismanoid 53:3d5a3d241a5e 102 // SPI SCLKMinMHz = 0
whismanoid 53:3d5a3d241a5e 103 //
whismanoid 53:3d5a3d241a5e 104 // InputPin Name = CONVRUN
whismanoid 53:3d5a3d241a5e 105 // InputPin Description = CONVRUN (digital input). Convert Run. Drive high to start continuous conversions on all 4 channels. The device is idle when
whismanoid 53:3d5a3d241a5e 106 // CONVRUN is low.
whismanoid 53:3d5a3d241a5e 107 // InputPin Function = Configuration
whismanoid 53:3d5a3d241a5e 108 //
whismanoid 53:3d5a3d241a5e 109 // InputPin Name = SHDN
whismanoid 53:3d5a3d241a5e 110 // InputPin Description = Shutdown (digital input). Active-High Shutdown Input. Drive high to shut down the MAX11043.
whismanoid 53:3d5a3d241a5e 111 // InputPin Function = Configuration
whismanoid 53:3d5a3d241a5e 112 //
whismanoid 53:3d5a3d241a5e 113 // InputPin Name = DACSTEP
whismanoid 53:3d5a3d241a5e 114 // InputPin Description = DACSTEP (digital input). DAC Step Input. Drive high to move the DAC output in the direction of UP/DWN on the next rising
whismanoid 53:3d5a3d241a5e 115 // edge of the system clock.
whismanoid 53:3d5a3d241a5e 116 // InputPin Function = Configuration
whismanoid 53:3d5a3d241a5e 117 //
whismanoid 53:3d5a3d241a5e 118 // InputPin Name = UP/DWN#
whismanoid 53:3d5a3d241a5e 119 // InputPin Description = UP/DWN# (digital input). DAC Step Direction Select. Drive high to step up, drive low to step down when DACSTEP is toggled.
whismanoid 53:3d5a3d241a5e 120 // InputPin Function = Configuration
whismanoid 53:3d5a3d241a5e 121 //
whismanoid 53:3d5a3d241a5e 122 // OutputPin Name = EOC
whismanoid 53:3d5a3d241a5e 123 // OutputPin Description = End of Conversion Output. Active-Low End-of-Conversion Indicator. EOC asserts low to indicate that new data is ready.
whismanoid 53:3d5a3d241a5e 124 // OutputPin Function = Event
whismanoid 53:3d5a3d241a5e 125 //
whismanoid 58:2fea32db466b 126 // SupplyPin Name = AVDD
whismanoid 58:2fea32db466b 127 // SupplyPin Description = Analog Power-Supply Input. Bypass each AVDD with a nominal 1uF capacitor to AGND.
whismanoid 58:2fea32db466b 128 // SupplyPin VinMax = 3.60
whismanoid 58:2fea32db466b 129 // SupplyPin VinMin = 3.00
whismanoid 58:2fea32db466b 130 // SupplyPin Function = Analog
whismanoid 58:2fea32db466b 131 //
whismanoid 58:2fea32db466b 132 // SupplyPin Name = AGND
whismanoid 58:2fea32db466b 133 // SupplyPin Description = Analog Ground. Connect all AGND inputs together.
whismanoid 58:2fea32db466b 134 // SupplyPin VinMax = 0
whismanoid 58:2fea32db466b 135 // SupplyPin VinMin = 0
whismanoid 58:2fea32db466b 136 // SupplyPin Function = Analog
whismanoid 58:2fea32db466b 137 //
whismanoid 58:2fea32db466b 138 // SupplyPin Name = DGND
whismanoid 58:2fea32db466b 139 // SupplyPin Description = Digital Ground. Connect all DGND inputs together.
whismanoid 58:2fea32db466b 140 // SupplyPin VinMax = 0
whismanoid 58:2fea32db466b 141 // SupplyPin VinMin = 0
whismanoid 58:2fea32db466b 142 // SupplyPin Function = Digital
whismanoid 58:2fea32db466b 143 //
whismanoid 58:2fea32db466b 144 // SupplyPin Name = DVDD
whismanoid 58:2fea32db466b 145 // SupplyPin Description = Digital Power-Supply Input. Bypass each DVDD with a nominal 1uF capacitor to DGND.
whismanoid 58:2fea32db466b 146 // SupplyPin VinMax = 3.60 (*TODO PENDING VERIFICATION*)
whismanoid 58:2fea32db466b 147 // SupplyPin VinMin = 3.00 (*TODO PENDING VERIFICATION*)
whismanoid 58:2fea32db466b 148 // SupplyPin Function = Digital
whismanoid 58:2fea32db466b 149 //
whismanoid 58:2fea32db466b 150 // SupplyPin Name = DVREG
whismanoid 58:2fea32db466b 151 // SupplyPin Description = Regulated Digital Core Supply (from internal +2.5V regulator). Bypass DVREG to DGND with a 10uF capacitor.
whismanoid 58:2fea32db466b 152 // SupplyPin VinMax = 2.50
whismanoid 58:2fea32db466b 153 // SupplyPin VinMin = 2.50
whismanoid 58:2fea32db466b 154 // SupplyPin Function = Digital
whismanoid 58:2fea32db466b 155 //
whismanoid 53:3d5a3d241a5e 156
whismanoid 53:3d5a3d241a5e 157 // CODE GENERATOR: class constructor definition
whismanoid 53:3d5a3d241a5e 158 MAX11043::MAX11043(SPI &spi, DigitalOut &cs_pin, // SPI interface
whismanoid 53:3d5a3d241a5e 159 // CODE GENERATOR: class constructor definition gpio InputPin pins
whismanoid 53:3d5a3d241a5e 160 DigitalOut &CONVRUN_pin, // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 161 DigitalOut &SHDN_pin, // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 162 DigitalOut &DACSTEP_pin, // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 163 DigitalOut &UP_slash_DWNb_pin, // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 164 // CODE GENERATOR: class constructor definition gpio OutputPin pins
whismanoid 69:989e392cf635 165 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 166 #if MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 167 // MAX11043 EOC End Of Conversion input should be InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 168 // Workaround using DigitalIn(PinName:EOC_pin) polled to sync with EOC falling edge for ADC reads
whismanoid 69:989e392cf635 169 // TODO: onEOCFallingEdge: replace DigitalIn &EOC_pin with PinName EOC_pin, so that I can create an InterruptIn(PinName:EOC_pin)
whismanoid 53:3d5a3d241a5e 170 DigitalIn &EOC_pin, // Digital Event Output from MAX11043 device
whismanoid 69:989e392cf635 171 #else // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 172 // MAX11043 EOC End Of Conversion input is InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 173 // TODO: onEOCFallingEdge: replace DigitalIn &EOC_pin with PinName EOC_pin, so that I can create an InterruptIn(PinName:EOC_pin)
whismanoid 69:989e392cf635 174 InterruptIn &EOC_pin, // Digital Event Output from MAX11043 device
whismanoid 69:989e392cf635 175 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 53:3d5a3d241a5e 176 // CODE GENERATOR: class constructor definition ic_variant
whismanoid 53:3d5a3d241a5e 177 MAX11043_ic_t ic_variant)
whismanoid 53:3d5a3d241a5e 178 // CODE GENERATOR: class constructor initializer list
whismanoid 53:3d5a3d241a5e 179 : m_spi(spi), m_cs_pin(cs_pin), // SPI interface
whismanoid 53:3d5a3d241a5e 180 // CODE GENERATOR: class constructor initializer list gpio InputPin pins
whismanoid 53:3d5a3d241a5e 181 m_CONVRUN_pin(CONVRUN_pin), // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 182 m_SHDN_pin(SHDN_pin), // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 183 m_DACSTEP_pin(DACSTEP_pin), // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 184 m_UP_slash_DWNb_pin(UP_slash_DWNb_pin), // Digital Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 185 // CODE GENERATOR: class constructor initializer list gpio OutputPin pins
whismanoid 69:989e392cf635 186 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 187 #if MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 188 // MAX11043 EOC End Of Conversion input should be InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 189 // Workaround using DigitalIn(PinName:EOC_pin) polled to sync with EOC falling edge for ADC reads
whismanoid 53:3d5a3d241a5e 190 m_EOC_pin(EOC_pin), // Digital Event Output from MAX11043 device
whismanoid 69:989e392cf635 191 #else // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 192 // MAX11043 EOC End Of Conversion input is InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 70:f44a577c9e59 193 m_EOC_pin(EOC_pin), // Digital Event Output from MAX11043 device
whismanoid 69:989e392cf635 194 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 53:3d5a3d241a5e 195 // CODE GENERATOR: class constructor initializer list ic_variant
whismanoid 53:3d5a3d241a5e 196 m_ic_variant(ic_variant)
whismanoid 53:3d5a3d241a5e 197 {
whismanoid 53:3d5a3d241a5e 198 // CODE GENERATOR: class constructor definition SPI interface initialization
whismanoid 53:3d5a3d241a5e 199 //
whismanoid 53:3d5a3d241a5e 200 // SPI CS = ActiveLow
whismanoid 53:3d5a3d241a5e 201 // SPI FrameStart = CS
whismanoid 53:3d5a3d241a5e 202 m_SPI_cs_state = 1;
whismanoid 67:5b8a495dda1c 203 if (m_cs_pin.is_connected()) { // avoid mbed runtime error if pin is NC not connected
whismanoid 67:5b8a495dda1c 204 m_cs_pin = m_SPI_cs_state;
whismanoid 67:5b8a495dda1c 205 }
whismanoid 53:3d5a3d241a5e 206
whismanoid 53:3d5a3d241a5e 207 // SPI CPOL = 0
whismanoid 53:3d5a3d241a5e 208 // SPI CPHA = 0
whismanoid 53:3d5a3d241a5e 209 // SPI MOSI and MISO Data are both stable on Rising edge of SCLK
whismanoid 53:3d5a3d241a5e 210 // SPI SCLK Idle Low
whismanoid 53:3d5a3d241a5e 211 m_SPI_dataMode = 0; //SPI_MODE0; // CPOL=0,CPHA=0: Rising Edge stable; SCLK idle Low
whismanoid 53:3d5a3d241a5e 212 m_spi.format(8,m_SPI_dataMode); // int bits_must_be_8, int mode=0_3 CPOL=0,CPHA=0
whismanoid 53:3d5a3d241a5e 213
whismanoid 53:3d5a3d241a5e 214 // SPI SCLKMaxMHz = 40
whismanoid 53:3d5a3d241a5e 215 // SPI SCLKMinMHz = 0
whismanoid 53:3d5a3d241a5e 216 //#define SPI_SCLK_Hz 48000000 // 48MHz
whismanoid 53:3d5a3d241a5e 217 //#define SPI_SCLK_Hz 24000000 // 24MHz
whismanoid 53:3d5a3d241a5e 218 //#define SPI_SCLK_Hz 12000000 // 12MHz
whismanoid 53:3d5a3d241a5e 219 //#define SPI_SCLK_Hz 6000000 // 6MHz
whismanoid 53:3d5a3d241a5e 220 //#define SPI_SCLK_Hz 4000000 // 4MHz
whismanoid 53:3d5a3d241a5e 221 //#define SPI_SCLK_Hz 2000000 // 2MHz
whismanoid 53:3d5a3d241a5e 222 //#define SPI_SCLK_Hz 1000000 // 1MHz
whismanoid 61:b4f3051578ef 223 m_SPI_SCLK_Hz = 24000000; // platform limit 24MHz; MAX11043 limit is 40MHz
whismanoid 53:3d5a3d241a5e 224 m_spi.frequency(m_SPI_SCLK_Hz);
whismanoid 53:3d5a3d241a5e 225
whismanoid 53:3d5a3d241a5e 226 //
whismanoid 53:3d5a3d241a5e 227 // CODE GENERATOR: class constructor definition gpio InputPin (Input to device) initialization
whismanoid 53:3d5a3d241a5e 228 //
whismanoid 53:3d5a3d241a5e 229 // CONVRUN Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 230 m_CONVRUN_pin = 1; // output logic high -- initial value in constructor
whismanoid 53:3d5a3d241a5e 231 //
whismanoid 53:3d5a3d241a5e 232 // SHDN Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 233 m_SHDN_pin = 1; // output logic high -- initial value in constructor
whismanoid 53:3d5a3d241a5e 234 //
whismanoid 53:3d5a3d241a5e 235 // DACSTEP Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 236 m_DACSTEP_pin = 1; // output logic high -- initial value in constructor
whismanoid 53:3d5a3d241a5e 237 //
whismanoid 53:3d5a3d241a5e 238 // UP_slash_DWNb Configuration Input to MAX11043 device
whismanoid 53:3d5a3d241a5e 239 m_UP_slash_DWNb_pin = 1; // output logic high -- initial value in constructor
whismanoid 53:3d5a3d241a5e 240 //
whismanoid 53:3d5a3d241a5e 241 // CODE GENERATOR: class constructor definition gpio OutputPin (Output from MAX11043 device) initialization
whismanoid 53:3d5a3d241a5e 242 //
whismanoid 53:3d5a3d241a5e 243 // EOC Event Output from device
whismanoid 69:989e392cf635 244 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 76:0397493d7baf 245 #if MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 246 // SPI is not interrupt-safe, so use EventQueue to defer execution to user context.
whismanoid 76:0397493d7baf 247 myOnEOCThread.start(myOnEOCThread_handler);
whismanoid 76:0397493d7baf 248 #else // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 249 #endif // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 250 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 251 #if MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 252 // MAX11043 EOC End Of Conversion input should be InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 253 // Workaround using DigitalIn(PinName:EOC_pin) polled to sync with EOC falling edge for ADC reads
whismanoid 69:989e392cf635 254 #else // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 255 // MAX11043 EOC End Of Conversion input is InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 256 // TODO: onEOCFallingEdge: interrupt handler requires global object extern MAX11043 g_MAX11043_device
whismanoid 71:62bcd01ea87f 257 // InterruptIn interruptEOC(EOC_pin); // InterruptIn constructor requires PinName, not DigitalIn -- Error: No instance of constructor "mbed::InterruptIn::InterruptIn" matches the argument list in "MAX11043/MAX11043.cpp", Line: 187, Col: 31
whismanoid 69:989e392cf635 258 // TODO: onEOCFallingEdge: replace DigitalIn &EOC_pin with PinName EOC_pin, so that I can create an InterruptIn(PinName:EOC_pin)
whismanoid 74:f4f969c9a7a9 259 digitalInOut5.output(); // ScopeTrigger
whismanoid 70:f44a577c9e59 260 extern void onEOCFallingEdge(void);
whismanoid 71:62bcd01ea87f 261 // interruptEOC.fall(&onEOCFallingEdge);
whismanoid 71:62bcd01ea87f 262 EOC_pin.fall(&onEOCFallingEdge);
whismanoid 69:989e392cf635 263 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 76:0397493d7baf 264 }
whismanoid 69:989e392cf635 265
whismanoid 76:0397493d7baf 266 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 76:0397493d7baf 267 // SPI is not interrupt-safe, so use EventQueue to defer execution to user context.
whismanoid 76:0397493d7baf 268 #if MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 269 void myOnEOCThread_handler()
whismanoid 76:0397493d7baf 270 {
whismanoid 76:0397493d7baf 271 while (true) {
whismanoid 76:0397493d7baf 272 //signal_wait(int32_t signals, uint32_t millisec=osWaitForever)
whismanoid 76:0397493d7baf 273 //flags_read = myOnEOCThread_event_flags.wait_any(MYONEOCTHREADEVENTFLAG_ENABLE_SPI);
whismanoid 76:0397493d7baf 274 // myOnEOCThread_event_flags.wait_any(MYONEOCTHREADEVENTFLAG_ENABLE_SPI, osWaitForever, false); // clear=false: don't auto clear the flag
whismanoid 76:0397493d7baf 275 myOnEOCThread_event_flags.wait_any(MYONEOCTHREADEVENTFLAG_ENABLE_SPI, osWaitForever, true); // clear=true: auto clear the flag
whismanoid 76:0397493d7baf 276 //
whismanoid 76:0397493d7baf 277 extern MAX11043 g_MAX11043_device;
whismanoid 76:0397493d7baf 278 #if MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 76:0397493d7baf 279 // Diagnostic: Use MAX32625MBED pin D5 as DigitalOut EOC#-detected
whismanoid 76:0397493d7baf 280 digitalInOut5.write(0); // ScopeTrigger
whismanoid 76:0397493d7baf 281 digitalInOut5.write(1); // ScopeTrigger
whismanoid 76:0397493d7baf 282 digitalInOut5.write(0); // ScopeTrigger
whismanoid 76:0397493d7baf 283 digitalInOut5.write(1); // ScopeTrigger
whismanoid 76:0397493d7baf 284 #endif // MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 76:0397493d7baf 285 extern SPI spi; // declared in Test_Main_MAX11043.cpp
whismanoid 76:0397493d7baf 286 spi.write((char*)mosiData_onEOCFallingEdge, byteCount_onEOCFallingEdge, (char*)misoData_onEOCFallingEdge, byteCount_onEOCFallingEdge);
whismanoid 76:0397493d7baf 287 // TODO1: update adca
whismanoid 76:0397493d7baf 288 //g_MAX11043_device.adca = (misoData_onEOCFallingEdge[1] << 8) | misoData_onEOCFallingEdge[2];
whismanoid 76:0397493d7baf 289 // TODO1: update adcb
whismanoid 76:0397493d7baf 290 //g_MAX11043_device.adcb = (misoData_onEOCFallingEdge[3] << 8) | misoData_onEOCFallingEdge[4];
whismanoid 76:0397493d7baf 291 // TODO1: update adcc
whismanoid 76:0397493d7baf 292 //g_MAX11043_device.adcc = (misoData_onEOCFallingEdge[5] << 8) | misoData_onEOCFallingEdge[6];
whismanoid 76:0397493d7baf 293 // TODO1: update adcd
whismanoid 76:0397493d7baf 294 //g_MAX11043_device.adcd = (misoData_onEOCFallingEdge[7] << 8) | misoData_onEOCFallingEdge[8];
whismanoid 76:0397493d7baf 295 }
whismanoid 53:3d5a3d241a5e 296 }
whismanoid 76:0397493d7baf 297 #else // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 298 #endif // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 53:3d5a3d241a5e 299
whismanoid 69:989e392cf635 300 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 301 #if MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 302 // MAX11043 EOC End Of Conversion input should be InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 303 // Workaround using DigitalIn(PinName:EOC_pin) polled to sync with EOC falling edge for ADC reads
whismanoid 69:989e392cf635 304 #else // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 305 // MAX11043 EOC End Of Conversion input is InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 306 // Interrupt Handler: EOC Event Output from device
whismanoid 69:989e392cf635 307 void onEOCFallingEdge(void)
whismanoid 69:989e392cf635 308 {
whismanoid 72:40feab5fd579 309 // VERIFIED: if DO NOTHING inside interrupt service routine, no crash
whismanoid 72:40feab5fd579 310 #if 1
whismanoid 72:40feab5fd579 311 // VERIFIED: GPIO PIN pulse in response to EOC# falling edge, no crash on HH, no missed pulses
whismanoid 73:879578472009 312 #if MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 73:879578472009 313 // Diagnostic: Use MAX32625MBED pin D5 as DigitalOut EOC#-detected
whismanoid 74:f4f969c9a7a9 314 digitalInOut5.write(0); // ScopeTrigger 1.8us after EOC# falling edge
whismanoid 74:f4f969c9a7a9 315 digitalInOut5.write(1); // ScopeTrigger
whismanoid 74:f4f969c9a7a9 316 digitalInOut5.write(0); // ScopeTrigger
whismanoid 74:f4f969c9a7a9 317 digitalInOut5.write(1); // ScopeTrigger
whismanoid 73:879578472009 318 #endif // MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 72:40feab5fd579 319 #endif
whismanoid 76:0397493d7baf 320 #if MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 321 // SPI is not interrupt-safe, so use EventQueue to defer execution to user context.
whismanoid 76:0397493d7baf 322 myOnEOCThread_event_flags.set(MYONEOCTHREADEVENTFLAG_ENABLE_SPI);
whismanoid 76:0397493d7baf 323 #else // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 324 #endif // MAX11043_EOC_INTERRUPT_EVENTQUEUE
whismanoid 76:0397493d7baf 325 #if 0
whismanoid 72:40feab5fd579 326 // TODO: read 4 channels in response to EOC# falling edge
whismanoid 72:40feab5fd579 327 // WIP MAX11043 interrupt CRASH on Menu item HH CONVRUN High
whismanoid 72:40feab5fd579 328 //
whismanoid 72:40feab5fd579 329 // ++ MbedOS Error Info ++
whismanoid 72:40feab5fd579 330 // Error Status: 0x80020115 Code: 277 Module: 2
whismanoid 72:40feab5fd579 331 // Error Message: Mutex lock failed
whismanoid 72:40feab5fd579 332 // Location: 0xBA33
whismanoid 72:40feab5fd579 333 // Error Value: 0xFFFFFFFA
whismanoid 72:40feab5fd579 334 // Current Thread: main Id: 0x20002CD0 Entry: 0xBD17 StackSize: 0x1000 StackMem: 0x20001CD0 SP: 0x20027ED0
whismanoid 72:40feab5fd579 335 // For more info, visit: https://armmbed.github.io/mbedos-error/?error=0x80020115
whismanoid 72:40feab5fd579 336 // -- MbedOS Error Info --
whismanoid 69:989e392cf635 337 extern MAX11043 g_MAX11043_device;
whismanoid 75:0900a57f2e5d 338 //~ g_MAX11043_device.Read_ADCabcd();
whismanoid 74:f4f969c9a7a9 339 // read register ADCabcd -> &adca, &adcb, &adcc, &adcd
whismanoid 74:f4f969c9a7a9 340 // g_MAX11043_device.RegRead(CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd, 0);
whismanoid 75:0900a57f2e5d 341 // SPI 8+64 = 72-bit transfer
whismanoid 75:0900a57f2e5d 342 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32 ___[4]_40 ___[5]_48 ___[6]_56 ___[7]_64 ___[8]_72
whismanoid 75:0900a57f2e5d 343 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000 ... _0000
whismanoid 75:0900a57f2e5d 344 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 75:0900a57f2e5d 345 // global const size_t byteCount_onEOCFallingEdge = 1 + (2 * 4);
whismanoid 75:0900a57f2e5d 346 // global const uint8_t mosiData_onEOCFallingEdge[9] = {
whismanoid 75:0900a57f2e5d 347 // global CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd,
whismanoid 75:0900a57f2e5d 348 // global 0, 0, 0, 0, 0, 0, 0, 0
whismanoid 75:0900a57f2e5d 349 // global };
whismanoid 75:0900a57f2e5d 350 // global uint8_t misoData_onEOCFallingEdge[9];
whismanoid 75:0900a57f2e5d 351 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 75:0900a57f2e5d 352 // SPIreadWriteWithLowCS(byteCount_onEOCFallingEdge, mosiData_onEOCFallingEdge, misoData_onEOCFallingEdge);
whismanoid 75:0900a57f2e5d 353 // onSPIprint() is not interrupt-safe
whismanoid 75:0900a57f2e5d 354 // unsigned int numBytesTransferred = m_spi.write((char*)mosiData, byteCount, (char*)misoData, byteCount);
whismanoid 75:0900a57f2e5d 355 // g_MAX11043_device.m_spi is inaccessible
whismanoid 75:0900a57f2e5d 356 extern SPI spi; // declared in Test_Main_MAX11043.cpp
whismanoid 75:0900a57f2e5d 357 spi.write((char*)mosiData_onEOCFallingEdge, byteCount_onEOCFallingEdge, (char*)misoData_onEOCFallingEdge, byteCount_onEOCFallingEdge);
whismanoid 75:0900a57f2e5d 358 //
whismanoid 75:0900a57f2e5d 359 // ++ MbedOS Error Info ++
whismanoid 75:0900a57f2e5d 360 // Error Status: 0x80020115 Code: 277 Module: 2
whismanoid 75:0900a57f2e5d 361 // Error Message: Mutex lock failed
whismanoid 75:0900a57f2e5d 362 // Location: 0xBABB
whismanoid 75:0900a57f2e5d 363 // Error Value: 0xFFFFFFFA
whismanoid 75:0900a57f2e5d 364 // Current Thread: main Id: 0x20002CD0 Entry: 0xBD9F StackSize: 0x1000 StackMem: 0x20001CD0 SP: 0x20027F10
whismanoid 75:0900a57f2e5d 365 // For more info, visit: https://armmbed.github.io/mbedos-error/?error=0x80020115
whismanoid 75:0900a57f2e5d 366 // -- MbedOS Error Info --
whismanoid 75:0900a57f2e5d 367 //
whismanoid 75:0900a57f2e5d 368 //if (ptrRegData) { (*ptrRegData) = (misoData[1] << 8) | misoData[2]; }
whismanoid 75:0900a57f2e5d 369 //if (commandByte == CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd) {
whismanoid 75:0900a57f2e5d 370 // TODO1: update adca
whismanoid 75:0900a57f2e5d 371 //g_MAX11043_device.adca = (misoData_onEOCFallingEdge[1] << 8) | misoData_onEOCFallingEdge[2];
whismanoid 75:0900a57f2e5d 372 // TODO1: update adcb
whismanoid 75:0900a57f2e5d 373 //g_MAX11043_device.adcb = (misoData_onEOCFallingEdge[3] << 8) | misoData_onEOCFallingEdge[4];
whismanoid 75:0900a57f2e5d 374 // TODO1: update adcc
whismanoid 75:0900a57f2e5d 375 //g_MAX11043_device.adcc = (misoData_onEOCFallingEdge[5] << 8) | misoData_onEOCFallingEdge[6];
whismanoid 75:0900a57f2e5d 376 // TODO1: update adcd
whismanoid 75:0900a57f2e5d 377 //g_MAX11043_device.adcd = (misoData_onEOCFallingEdge[7] << 8) | misoData_onEOCFallingEdge[8];
whismanoid 75:0900a57f2e5d 378 //}
whismanoid 72:40feab5fd579 379 #endif
whismanoid 76:0397493d7baf 380 #if 0 // MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 75:0900a57f2e5d 381 // Diagnostic: Use MAX32625MBED pin D5 as DigitalOut EOC#-detected
whismanoid 75:0900a57f2e5d 382 digitalInOut5.write(0); // ScopeTrigger
whismanoid 75:0900a57f2e5d 383 digitalInOut5.write(1); // ScopeTrigger
whismanoid 75:0900a57f2e5d 384 #endif // MAX11043_ScopeTrigger_MAX32625MBED_D5
whismanoid 69:989e392cf635 385 }
whismanoid 69:989e392cf635 386 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 387
whismanoid 53:3d5a3d241a5e 388 // CODE GENERATOR: class destructor definition
whismanoid 53:3d5a3d241a5e 389 MAX11043::~MAX11043()
whismanoid 53:3d5a3d241a5e 390 {
whismanoid 53:3d5a3d241a5e 391 // do nothing
whismanoid 53:3d5a3d241a5e 392 }
whismanoid 53:3d5a3d241a5e 393
whismanoid 53:3d5a3d241a5e 394 // CODE GENERATOR: spi_frequency setter definition
whismanoid 53:3d5a3d241a5e 395 /// set SPI SCLK frequency
whismanoid 53:3d5a3d241a5e 396 void MAX11043::spi_frequency(int spi_sclk_Hz)
whismanoid 53:3d5a3d241a5e 397 {
whismanoid 53:3d5a3d241a5e 398 m_SPI_SCLK_Hz = spi_sclk_Hz;
whismanoid 53:3d5a3d241a5e 399 m_spi.frequency(m_SPI_SCLK_Hz);
whismanoid 53:3d5a3d241a5e 400 }
whismanoid 53:3d5a3d241a5e 401
whismanoid 53:3d5a3d241a5e 402 // CODE GENERATOR: omit global g_MAX11043_device
whismanoid 53:3d5a3d241a5e 403 // CODE GENERATOR: extern function declarations
whismanoid 53:3d5a3d241a5e 404 // CODE GENERATOR: extern function requirement MAX11043::SPIoutputCS
whismanoid 53:3d5a3d241a5e 405 // Assert SPI Chip Select
whismanoid 53:3d5a3d241a5e 406 // SPI chip-select for MAX11043
whismanoid 53:3d5a3d241a5e 407 //
whismanoid 62:8223a7253c90 408 inline void MAX11043::SPIoutputCS(int isLogicHigh)
whismanoid 53:3d5a3d241a5e 409 {
whismanoid 53:3d5a3d241a5e 410 // CODE GENERATOR: extern function definition for function SPIoutputCS
whismanoid 53:3d5a3d241a5e 411 // CODE GENERATOR: extern function definition for standard SPI interface function SPIoutputCS(int isLogicHigh)
whismanoid 53:3d5a3d241a5e 412 m_SPI_cs_state = isLogicHigh;
whismanoid 67:5b8a495dda1c 413 if (m_cs_pin.is_connected()) { // avoid mbed runtime error if pin is NC not connected
whismanoid 67:5b8a495dda1c 414 m_cs_pin = m_SPI_cs_state;
whismanoid 67:5b8a495dda1c 415 }
whismanoid 53:3d5a3d241a5e 416 }
whismanoid 53:3d5a3d241a5e 417
whismanoid 62:8223a7253c90 418 // CODE GENERATOR: extern function requirement MAX11043::SPIreadWriteWithLowCS
whismanoid 62:8223a7253c90 419 // SPI read and write arbitrary number of 8-bit bytes
whismanoid 62:8223a7253c90 420 // SPI interface to MAX11043 shift mosiData into MAX11043 DIN
whismanoid 62:8223a7253c90 421 // while simultaneously capturing miso data from MAX11043 DOUT
whismanoid 62:8223a7253c90 422 //
whismanoid 62:8223a7253c90 423 int MAX11043::SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[])
whismanoid 62:8223a7253c90 424 {
whismanoid 62:8223a7253c90 425 // CODE GENERATOR: extern function definition for function SPIreadWriteWithLowCS
whismanoid 63:8f39d21d6157 426 // TODO1: CODE GENERATOR: extern function definition for standard SPI interface function SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[])
whismanoid 62:8223a7253c90 427 //size_t byteCount = 4;
whismanoid 62:8223a7253c90 428 //static char mosiData[4];
whismanoid 62:8223a7253c90 429 //static char misoData[4];
whismanoid 62:8223a7253c90 430 //
whismanoid 62:8223a7253c90 431 // Arduino: begin critical section: noInterrupts() masks all interrupt sources; end critical section with interrupts()
whismanoid 62:8223a7253c90 432 //~ noInterrupts();
whismanoid 62:8223a7253c90 433 //
whismanoid 62:8223a7253c90 434 //~ digitalWrite(Scope_Trigger_Pin, LOW); // diagnostic Scope_Trigger_Pin
whismanoid 62:8223a7253c90 435 //
whismanoid 67:5b8a495dda1c 436 if (m_cs_pin.is_connected()) { // avoid mbed runtime error if pin is NC not connected
whismanoid 67:5b8a495dda1c 437 m_cs_pin = 0;
whismanoid 67:5b8a495dda1c 438 }
whismanoid 62:8223a7253c90 439 unsigned int numBytesTransferred = m_spi.write((char*)mosiData, byteCount, (char*)misoData, byteCount);
whismanoid 67:5b8a495dda1c 440 if (m_cs_pin.is_connected()) { // avoid mbed runtime error if pin is NC not connected
whismanoid 67:5b8a495dda1c 441 m_cs_pin = m_SPI_cs_state;
whismanoid 67:5b8a495dda1c 442 }
whismanoid 62:8223a7253c90 443 //
whismanoid 62:8223a7253c90 444 //~ digitalWrite(Scope_Trigger_Pin, HIGH); // diagnostic Scope_Trigger_Pin
whismanoid 62:8223a7253c90 445 //
whismanoid 62:8223a7253c90 446 // Arduino: begin critical section: noInterrupts() masks all interrupt sources; end critical section with interrupts()
whismanoid 62:8223a7253c90 447 //~ interrupts();
whismanoid 62:8223a7253c90 448 // Optional Diagnostic function to print SPI transactions
whismanoid 62:8223a7253c90 449 if (onSPIprint)
whismanoid 62:8223a7253c90 450 {
whismanoid 62:8223a7253c90 451 onSPIprint(byteCount, (uint8_t*)mosiData, (uint8_t*)misoData);
whismanoid 62:8223a7253c90 452 }
whismanoid 62:8223a7253c90 453 return numBytesTransferred;
whismanoid 62:8223a7253c90 454 }
whismanoid 62:8223a7253c90 455
whismanoid 53:3d5a3d241a5e 456 // TODO1: CODE GENERATOR: extern function GPIOoutputSHDN alias SHDNoutputValue
whismanoid 53:3d5a3d241a5e 457 // CODE GENERATOR: extern function requirement MAX11043::SHDNoutputValue
whismanoid 58:2fea32db466b 458 // Assert MAX11043 SHDN pin : High = Shut Down, Low = Normal Operation.
whismanoid 53:3d5a3d241a5e 459 //
whismanoid 53:3d5a3d241a5e 460 void MAX11043::SHDNoutputValue(int isLogicHigh)
whismanoid 53:3d5a3d241a5e 461 {
whismanoid 53:3d5a3d241a5e 462 // CODE GENERATOR: extern function definition for function SHDNoutputValue
whismanoid 53:3d5a3d241a5e 463 // TODO1: CODE GENERATOR: extern function definition for gpio interface function SHDNoutputValue
whismanoid 53:3d5a3d241a5e 464 // TODO1: CODE GENERATOR: gpio pin SHDN assuming member function m_SHDN_pin
whismanoid 53:3d5a3d241a5e 465 // TODO1: CODE GENERATOR: gpio direction output
whismanoid 53:3d5a3d241a5e 466 // m_SHDN_pin.output(); // only applicable to DigitalInOut
whismanoid 53:3d5a3d241a5e 467 // TODO1: CODE GENERATOR: gpio function Value
whismanoid 53:3d5a3d241a5e 468 m_SHDN_pin = isLogicHigh;
whismanoid 53:3d5a3d241a5e 469 }
whismanoid 52:607010f0c54e 470
whismanoid 53:3d5a3d241a5e 471 // TODO1: CODE GENERATOR: extern function GPIOoutputCONVRUN alias CONVRUNoutputValue
whismanoid 53:3d5a3d241a5e 472 // CODE GENERATOR: extern function requirement MAX11043::CONVRUNoutputValue
whismanoid 58:2fea32db466b 473 // Assert MAX11043 CONVRUN pin : High = start continuous conversions on all 4 channels, Low = Idle.
whismanoid 53:3d5a3d241a5e 474 //
whismanoid 53:3d5a3d241a5e 475 void MAX11043::CONVRUNoutputValue(int isLogicHigh)
whismanoid 53:3d5a3d241a5e 476 {
whismanoid 53:3d5a3d241a5e 477 // CODE GENERATOR: extern function definition for function CONVRUNoutputValue
whismanoid 53:3d5a3d241a5e 478 // TODO1: CODE GENERATOR: extern function definition for gpio interface function CONVRUNoutputValue
whismanoid 53:3d5a3d241a5e 479 // TODO1: CODE GENERATOR: gpio pin CONVRUN assuming member function m_CONVRUN_pin
whismanoid 53:3d5a3d241a5e 480 // TODO1: CODE GENERATOR: gpio direction output
whismanoid 53:3d5a3d241a5e 481 // m_CONVRUN_pin.output(); // only applicable to DigitalInOut
whismanoid 53:3d5a3d241a5e 482 // TODO1: CODE GENERATOR: gpio function Value
whismanoid 53:3d5a3d241a5e 483 m_CONVRUN_pin = isLogicHigh;
whismanoid 69:989e392cf635 484 //--------------------------------------------------
whismanoid 69:989e392cf635 485 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 486 // EOC# asserts low when new data is available.
whismanoid 69:989e392cf635 487 // Initiate a data read prior to the next rising edge of EOC# or the result is overwritten.
whismanoid 69:989e392cf635 488 #if MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 489 // MAX11043 EOC End Of Conversion input should be InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 490 // Workaround using DigitalIn(PinName:EOC_pin) polled to sync with EOC falling edge for ADC reads
whismanoid 69:989e392cf635 491 if (m_CONVRUN_pin)
whismanoid 69:989e392cf635 492 {
whismanoid 69:989e392cf635 493 // CONVRUN was switched high, EOC# will now begin toggling
whismanoid 69:989e392cf635 494 }
whismanoid 69:989e392cf635 495 else
whismanoid 69:989e392cf635 496 {
whismanoid 69:989e392cf635 497 // CONVRUN was switched low, so wait until EOC# returns high
whismanoid 69:989e392cf635 498 #warning "MAX11043::Read_ADCabcd() Potential infinite loop if EOC pin not connected"
whismanoid 69:989e392cf635 499 // possible infinite loop; need a timeout or futility countdown to escape
whismanoid 69:989e392cf635 500 for (int futility_countdown = 100;
whismanoid 69:989e392cf635 501 ((futility_countdown > 0) &&
whismanoid 69:989e392cf635 502 (m_EOC_pin != 1));
whismanoid 69:989e392cf635 503 futility_countdown--)
whismanoid 69:989e392cf635 504 {
whismanoid 69:989e392cf635 505 // spinlock waiting for logic high pin state (start of new conversion)
whismanoid 69:989e392cf635 506 }
whismanoid 69:989e392cf635 507 }
whismanoid 69:989e392cf635 508 #else // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 509 // MAX11043 EOC End Of Conversion input is InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 510 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 511 //--------------------------------------------------
whismanoid 53:3d5a3d241a5e 512 }
whismanoid 53:3d5a3d241a5e 513
whismanoid 53:3d5a3d241a5e 514 // TODO1: CODE GENERATOR: extern function GPIOoutputDACSTEP alias DACSTEPoutputValue
whismanoid 53:3d5a3d241a5e 515 // CODE GENERATOR: extern function requirement MAX11043::DACSTEPoutputValue
whismanoid 58:2fea32db466b 516 // Assert MAX11043 DACSTEP pin : High = Active, Low = Idle.
whismanoid 53:3d5a3d241a5e 517 //
whismanoid 53:3d5a3d241a5e 518 void MAX11043::DACSTEPoutputValue(int isLogicHigh)
whismanoid 53:3d5a3d241a5e 519 {
whismanoid 53:3d5a3d241a5e 520 // CODE GENERATOR: extern function definition for function DACSTEPoutputValue
whismanoid 53:3d5a3d241a5e 521 // TODO1: CODE GENERATOR: extern function definition for gpio interface function DACSTEPoutputValue
whismanoid 53:3d5a3d241a5e 522 // TODO1: CODE GENERATOR: gpio pin DACSTEP assuming member function m_DACSTEP_pin
whismanoid 53:3d5a3d241a5e 523 // TODO1: CODE GENERATOR: gpio direction output
whismanoid 53:3d5a3d241a5e 524 // m_DACSTEP_pin.output(); // only applicable to DigitalInOut
whismanoid 53:3d5a3d241a5e 525 // TODO1: CODE GENERATOR: gpio function Value
whismanoid 53:3d5a3d241a5e 526 m_DACSTEP_pin = isLogicHigh;
whismanoid 53:3d5a3d241a5e 527 }
whismanoid 53:3d5a3d241a5e 528
whismanoid 53:3d5a3d241a5e 529 // TODO1: CODE GENERATOR: extern function GPIOoutputUP_slash_DWNb alias UP_slash_DWNboutputValue
whismanoid 53:3d5a3d241a5e 530 // CODE GENERATOR: extern function requirement MAX11043::UP_slash_DWNboutputValue
whismanoid 58:2fea32db466b 531 // Assert MAX11043 UP_slash_DWNb pin : High = Up, Low = Down.
whismanoid 53:3d5a3d241a5e 532 //
whismanoid 53:3d5a3d241a5e 533 void MAX11043::UP_slash_DWNboutputValue(int isLogicHigh)
whismanoid 53:3d5a3d241a5e 534 {
whismanoid 53:3d5a3d241a5e 535 // CODE GENERATOR: extern function definition for function UP_slash_DWNboutputValue
whismanoid 53:3d5a3d241a5e 536 // TODO1: CODE GENERATOR: extern function definition for gpio interface function UP_slash_DWNboutputValue
whismanoid 53:3d5a3d241a5e 537 // TODO1: CODE GENERATOR: gpio pin UP_slash_DWNb assuming member function m_UP_slash_DWNb_pin
whismanoid 53:3d5a3d241a5e 538 // TODO1: CODE GENERATOR: gpio direction output
whismanoid 53:3d5a3d241a5e 539 // m_UP_slash_DWNb_pin.output(); // only applicable to DigitalInOut
whismanoid 53:3d5a3d241a5e 540 // TODO1: CODE GENERATOR: gpio function Value
whismanoid 53:3d5a3d241a5e 541 m_UP_slash_DWNb_pin = isLogicHigh;
whismanoid 53:3d5a3d241a5e 542 }
whismanoid 53:3d5a3d241a5e 543
whismanoid 53:3d5a3d241a5e 544 // CODE GENERATOR: extern function requirement MAX11043::EOCinputWaitUntilLow
whismanoid 53:3d5a3d241a5e 545 // Wait for MAX11043 EOC pin low, indicating end of conversion.
whismanoid 53:3d5a3d241a5e 546 // Required when using any of the InternalClock modes.
whismanoid 53:3d5a3d241a5e 547 //
whismanoid 53:3d5a3d241a5e 548 void MAX11043::EOCinputWaitUntilLow()
whismanoid 53:3d5a3d241a5e 549 {
whismanoid 53:3d5a3d241a5e 550 // CODE GENERATOR: extern function definition for function EOCinputWaitUntilLow
whismanoid 53:3d5a3d241a5e 551 // TODO1: CODE GENERATOR: extern function definition for gpio interface function EOCinputWaitUntilLow
whismanoid 53:3d5a3d241a5e 552 // TODO1: CODE GENERATOR: gpio pin EOC assuming member function m_EOC_pin
whismanoid 53:3d5a3d241a5e 553 // TODO1: CODE GENERATOR: gpio direction input
whismanoid 53:3d5a3d241a5e 554 // m_EOC_pin.input(); // only applicable to DigitalInOut
whismanoid 53:3d5a3d241a5e 555 // TODO1: CODE GENERATOR: gpio function WaitUntilLow
whismanoid 53:3d5a3d241a5e 556 while (m_EOC_pin != 0)
whismanoid 53:3d5a3d241a5e 557 {
whismanoid 53:3d5a3d241a5e 558 // spinlock waiting for logic low pin state
whismanoid 53:3d5a3d241a5e 559 }
whismanoid 53:3d5a3d241a5e 560 }
whismanoid 53:3d5a3d241a5e 561
whismanoid 53:3d5a3d241a5e 562 // CODE GENERATOR: extern function requirement MAX11043::EOCinputValue
whismanoid 53:3d5a3d241a5e 563 // Return the status of the MAX11043 EOC pin.
whismanoid 53:3d5a3d241a5e 564 //
whismanoid 53:3d5a3d241a5e 565 int MAX11043::EOCinputValue()
whismanoid 53:3d5a3d241a5e 566 {
whismanoid 53:3d5a3d241a5e 567 // CODE GENERATOR: extern function definition for function EOCinputValue
whismanoid 53:3d5a3d241a5e 568 // TODO1: CODE GENERATOR: extern function definition for gpio interface function EOCinputValue
whismanoid 53:3d5a3d241a5e 569 // TODO1: CODE GENERATOR: gpio pin EOC assuming member function m_EOC_pin
whismanoid 53:3d5a3d241a5e 570 // TODO1: CODE GENERATOR: gpio direction input
whismanoid 53:3d5a3d241a5e 571 // m_EOC_pin.input(); // only applicable to DigitalInOut
whismanoid 53:3d5a3d241a5e 572 // TODO1: CODE GENERATOR: gpio function Value
whismanoid 53:3d5a3d241a5e 573 return m_EOC_pin.read();
whismanoid 53:3d5a3d241a5e 574 }
whismanoid 53:3d5a3d241a5e 575
whismanoid 53:3d5a3d241a5e 576 // CODE GENERATOR: class member function definitions
whismanoid 53:3d5a3d241a5e 577 //----------------------------------------
whismanoid 53:3d5a3d241a5e 578 // Menu item '!'
whismanoid 53:3d5a3d241a5e 579 // Initialize device
whismanoid 53:3d5a3d241a5e 580 // @return 1 on success; 0 on failure
whismanoid 53:3d5a3d241a5e 581 uint8_t MAX11043::Init(void)
whismanoid 53:3d5a3d241a5e 582 {
whismanoid 53:3d5a3d241a5e 583
whismanoid 53:3d5a3d241a5e 584 //----------------------------------------
whismanoid 59:47538bcf6cda 585 // reference voltage, in Volts
whismanoid 59:47538bcf6cda 586 VRef = 2.500;
whismanoid 59:47538bcf6cda 587
whismanoid 59:47538bcf6cda 588 //----------------------------------------
whismanoid 59:47538bcf6cda 589 // shadow of register config CMD_0010_0010_d16_Rd08_Configuration
whismanoid 59:47538bcf6cda 590 config = 0x6000;
whismanoid 59:47538bcf6cda 591
whismanoid 59:47538bcf6cda 592 //----------------------------------------
whismanoid 59:47538bcf6cda 593 // shadow of register status CMD_0001_1110_d8_Rd07_Status
whismanoid 59:47538bcf6cda 594 status = 0x00;
whismanoid 53:3d5a3d241a5e 595
whismanoid 53:3d5a3d241a5e 596 //----------------------------------------
whismanoid 59:47538bcf6cda 597 // shadow of register ADCa CMD_0000_0010_d16o8_Rd00_ADCa
whismanoid 59:47538bcf6cda 598 adca = 0x0000;
whismanoid 53:3d5a3d241a5e 599
whismanoid 53:3d5a3d241a5e 600 //----------------------------------------
whismanoid 59:47538bcf6cda 601 // shadow of register ADCb CMD_0000_0110_d16o8_Rd01_ADCb
whismanoid 59:47538bcf6cda 602 adcb = 0x0000;
whismanoid 59:47538bcf6cda 603
whismanoid 59:47538bcf6cda 604 //----------------------------------------
whismanoid 59:47538bcf6cda 605 // shadow of register ADCc CMD_0000_1010_d16o8_Rd02_ADCc
whismanoid 59:47538bcf6cda 606 adcc = 0x0000;
whismanoid 59:47538bcf6cda 607
whismanoid 59:47538bcf6cda 608 //----------------------------------------
whismanoid 59:47538bcf6cda 609 // shadow of register ADCd CMD_0000_1110_d16o8_Rd03_ADCd
whismanoid 59:47538bcf6cda 610 adcd = 0x0000;
whismanoid 53:3d5a3d241a5e 611
whismanoid 53:3d5a3d241a5e 612 //----------------------------------------
whismanoid 53:3d5a3d241a5e 613 // init (based on old EV kit GUI)
whismanoid 53:3d5a3d241a5e 614 #warning "Not Implemented Yet: MAX11043::Init init..."
whismanoid 53:3d5a3d241a5e 615 // bool bOpResult = false;
whismanoid 53:3d5a3d241a5e 616 // String FWVersionString = "00";
whismanoid 53:3d5a3d241a5e 617 // bool bDemoMode = true;
whismanoid 53:3d5a3d241a5e 618 // int scan_resolution = 0;
whismanoid 53:3d5a3d241a5e 619 // int scan_channels = 0;
whismanoid 53:3d5a3d241a5e 620 // int scan_bits = 0;
whismanoid 53:3d5a3d241a5e 621 // int sampleRateFactore = 0;
whismanoid 53:3d5a3d241a5e 622 // double sampleRate = 0;
whismanoid 53:3d5a3d241a5e 623 // unsigned long banks_requested = 0;
whismanoid 53:3d5a3d241a5e 624 // bool bScanMode = 0;
whismanoid 53:3d5a3d241a5e 625
whismanoid 53:3d5a3d241a5e 626 //----------------------------------------
whismanoid 59:47538bcf6cda 627 // Device ID Validation -- not used, no device ID register
whismanoid 53:3d5a3d241a5e 628 #warning "Not Implemented Yet: MAX11043::Init Device ID Validation..."
whismanoid 53:3d5a3d241a5e 629 // const uint32_t part_id_expect = 0x000F02;
whismanoid 53:3d5a3d241a5e 630 // uint32_t part_id_readback;
whismanoid 53:3d5a3d241a5e 631 // RegRead(xxxxxxxxxxxxCMD_r001_0001_xxxx_xxxx_xxxx_xxxx_xxxx_xddd_PART_ID, &part_id_readback);
whismanoid 53:3d5a3d241a5e 632 // if (part_id_readback != part_id_expect) return 0;
whismanoid 53:3d5a3d241a5e 633
whismanoid 53:3d5a3d241a5e 634 //----------------------------------------
whismanoid 58:2fea32db466b 635 // Active-High Shutdown Input. Drive high to shut down the MAX11043.
whismanoid 58:2fea32db466b 636 SHDNoutputValue(0); // SHDN Inactive
whismanoid 58:2fea32db466b 637
whismanoid 58:2fea32db466b 638 //----------------------------------------
whismanoid 58:2fea32db466b 639 // Convert Run. Drive high to start continuous conversions on all 4 channels. The device is idle when
whismanoid 58:2fea32db466b 640 // CONVRUN is low.
whismanoid 58:2fea32db466b 641 CONVRUNoutputValue(0); // CONVRUN Idle
whismanoid 58:2fea32db466b 642
whismanoid 58:2fea32db466b 643 //----------------------------------------
whismanoid 58:2fea32db466b 644 // DAC Step Input. Drive high to move the DAC output in the direction of UP/DWN on the next rising
whismanoid 58:2fea32db466b 645 // edge of the system clock.
whismanoid 58:2fea32db466b 646 DACSTEPoutputValue(0); // DACSTEP Idle
whismanoid 58:2fea32db466b 647
whismanoid 58:2fea32db466b 648 //----------------------------------------
whismanoid 58:2fea32db466b 649 // DAC Step Direction Select. Drive high to step up, drive low to step down when DACSTEP is toggled.
whismanoid 58:2fea32db466b 650 UP_slash_DWNboutputValue(0); // UP/DWN# Down
whismanoid 58:2fea32db466b 651
whismanoid 58:2fea32db466b 652 //----------------------------------------
whismanoid 53:3d5a3d241a5e 653 // success
whismanoid 53:3d5a3d241a5e 654 return 1;
whismanoid 53:3d5a3d241a5e 655 }
whismanoid 53:3d5a3d241a5e 656
whismanoid 53:3d5a3d241a5e 657 //----------------------------------------
whismanoid 53:3d5a3d241a5e 658 // Write a MAX11043 register.
whismanoid 53:3d5a3d241a5e 659 //
whismanoid 57:1c9da8e90737 660 // CMDOP_1aaa_aaaa_ReadRegister bit is cleared 0 indicating a write operation.
whismanoid 53:3d5a3d241a5e 661 //
whismanoid 53:3d5a3d241a5e 662 // MAX11043 register length can be determined by function RegSize.
whismanoid 53:3d5a3d241a5e 663 //
whismanoid 53:3d5a3d241a5e 664 // For 8-bit register size:
whismanoid 53:3d5a3d241a5e 665 //
whismanoid 53:3d5a3d241a5e 666 // SPI 16-bit transfer
whismanoid 53:3d5a3d241a5e 667 //
whismanoid 53:3d5a3d241a5e 668 // SPI MOSI = 0aaa_aaaa_dddd_dddd
whismanoid 53:3d5a3d241a5e 669 //
whismanoid 53:3d5a3d241a5e 670 // SPI MISO = xxxx_xxxx_xxxx_xxxx
whismanoid 53:3d5a3d241a5e 671 //
whismanoid 53:3d5a3d241a5e 672 // For 16-bit register size:
whismanoid 53:3d5a3d241a5e 673 //
whismanoid 53:3d5a3d241a5e 674 // SPI 24-bit or 32-bit transfer
whismanoid 53:3d5a3d241a5e 675 //
whismanoid 53:3d5a3d241a5e 676 // SPI MOSI = 0aaa_aaaa_dddd_dddd_dddd_dddd
whismanoid 53:3d5a3d241a5e 677 //
whismanoid 53:3d5a3d241a5e 678 // SPI MISO = xxxx_xxxx_xxxx_xxxx_xxxx_xxxx
whismanoid 53:3d5a3d241a5e 679 //
whismanoid 53:3d5a3d241a5e 680 // For 24-bit register size:
whismanoid 53:3d5a3d241a5e 681 //
whismanoid 53:3d5a3d241a5e 682 // SPI 32-bit transfer
whismanoid 53:3d5a3d241a5e 683 //
whismanoid 53:3d5a3d241a5e 684 // SPI MOSI = 0aaa_aaaa_dddd_dddd_dddd_dddd_dddd_dddd
whismanoid 53:3d5a3d241a5e 685 //
whismanoid 53:3d5a3d241a5e 686 // SPI MISO = xxxx_xxxx_xxxx_xxxx_xxxx_xxxx_xxxx_xxxx
whismanoid 53:3d5a3d241a5e 687 //
whismanoid 53:3d5a3d241a5e 688 // @return 1 on success; 0 on failure
whismanoid 53:3d5a3d241a5e 689 uint8_t MAX11043::RegWrite(MAX11043_CMD_enum_t commandByte, uint32_t regData)
whismanoid 53:3d5a3d241a5e 690 {
whismanoid 53:3d5a3d241a5e 691
whismanoid 53:3d5a3d241a5e 692 //----------------------------------------
whismanoid 53:3d5a3d241a5e 693 // switch based on register address szie RegSize(commandByte)
whismanoid 57:1c9da8e90737 694 //commandByte = (MAX11043_CMD_enum_t)((commandByte &~ CMDOP_0aaa_aa10_ReadRegister) & 0xFF);
whismanoid 53:3d5a3d241a5e 695 switch(RegSize(commandByte))
whismanoid 53:3d5a3d241a5e 696 {
whismanoid 53:3d5a3d241a5e 697 case 8: // 8-bit register size
whismanoid 53:3d5a3d241a5e 698 {
whismanoid 63:8f39d21d6157 699 // SPI 8+8 = 16-bit transfer
whismanoid 63:8f39d21d6157 700 // 1234 5678 ___[1]_16
whismanoid 63:8f39d21d6157 701 // SPI MOSI = 0aaa_aaaa_dddd_dddd ... _0000
whismanoid 63:8f39d21d6157 702 // SPI MISO = xxxx_xxxx_xxxx_xxxx ... _xxxx
whismanoid 63:8f39d21d6157 703 size_t byteCount = 1 + 1;
whismanoid 63:8f39d21d6157 704 uint8_t mosiData[2];
whismanoid 63:8f39d21d6157 705 uint8_t misoData[2];
whismanoid 63:8f39d21d6157 706 mosiData[0] = commandByte;
whismanoid 63:8f39d21d6157 707 mosiData[1] = regData;
whismanoid 63:8f39d21d6157 708 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 63:8f39d21d6157 709 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 63:8f39d21d6157 710 // TODO: cache CMD_0101_0100_d8_Wr15_FilterCAddress
whismanoid 63:8f39d21d6157 711 // if (commandByte == CMD_0101_0100_d8_Wr15_FilterCAddress) {
whismanoid 63:8f39d21d6157 712 // FilterCAddress = regData;
whismanoid 63:8f39d21d6157 713 // }
whismanoid 63:8f39d21d6157 714 // TODO: cache CMD_0110_0000_d8_Wr18_FlashMode
whismanoid 63:8f39d21d6157 715 // if (commandByte == CMD_0110_0000_d8_Wr18_FlashMode) {
whismanoid 63:8f39d21d6157 716 // FlashMode = regData;
whismanoid 63:8f39d21d6157 717 // }
whismanoid 53:3d5a3d241a5e 718 }
whismanoid 53:3d5a3d241a5e 719 break;
whismanoid 53:3d5a3d241a5e 720 case 16: // 16-bit register size
whismanoid 63:8f39d21d6157 721 #warning "Not Verified Yet: MAX11043::RegWrite 16-bit"
whismanoid 53:3d5a3d241a5e 722 {
whismanoid 63:8f39d21d6157 723 // SPI 8+16 = 24-bit transfer
whismanoid 63:8f39d21d6157 724 // 1234 5678 ___[1]_16 ___[2]_24
whismanoid 63:8f39d21d6157 725 // SPI MOSI = 0aaa_aaaa_dddd_dddd_dddd_dddd ... _0000
whismanoid 63:8f39d21d6157 726 // SPI MISO = xxxx_xxxx_xxxx_xxxx_xxxx_xxxx ... _xxxx
whismanoid 63:8f39d21d6157 727 size_t byteCount = 1 + 2;
whismanoid 63:8f39d21d6157 728 uint8_t mosiData[3];
whismanoid 63:8f39d21d6157 729 uint8_t misoData[3];
whismanoid 63:8f39d21d6157 730 mosiData[0] = commandByte;
whismanoid 63:8f39d21d6157 731 mosiData[1] = (uint8_t)((regData >> 8) & 0xFF);
whismanoid 63:8f39d21d6157 732 mosiData[2] = (uint8_t)((regData >> 0) & 0xFF);
whismanoid 63:8f39d21d6157 733 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 63:8f39d21d6157 734 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 63:8f39d21d6157 735 // cache CMD_0010_0000_d16_Wr08_Configuration
whismanoid 63:8f39d21d6157 736 if (commandByte == CMD_0010_0000_d16_Wr08_Configuration) {
whismanoid 63:8f39d21d6157 737 config = regData;
whismanoid 63:8f39d21d6157 738 }
whismanoid 63:8f39d21d6157 739 // TODO: cache CMD_0010_0100_d16_Wr09_DAC
whismanoid 63:8f39d21d6157 740 // TODO: cache CMD_0010_1000_d16_Wr0A_DACStep
whismanoid 63:8f39d21d6157 741 // TODO: cache CMD_0010_1100_d16_Wr0B_DACHDACL
whismanoid 63:8f39d21d6157 742 // TODO: cache CMD_0011_0000_d16_Wr0C_ConfigA
whismanoid 63:8f39d21d6157 743 // TODO: cache CMD_0011_0100_d16_Wr0D_ConfigB
whismanoid 63:8f39d21d6157 744 // TODO: cache CMD_0011_1000_d16_Wr0E_ConfigC
whismanoid 63:8f39d21d6157 745 // TODO: cache CMD_0011_1100_d16_Wr0F_ConfigD
whismanoid 63:8f39d21d6157 746 // TODO: cache CMD_0100_0000_d16_Wr10_Reference
whismanoid 63:8f39d21d6157 747 // TODO: cache CMD_0100_0100_d16_Wr11_AGain
whismanoid 63:8f39d21d6157 748 // TODO: cache CMD_0100_1000_d16_Wr12_BGain
whismanoid 63:8f39d21d6157 749 // TODO: cache CMD_0100_1100_d16_Wr13_CGain
whismanoid 63:8f39d21d6157 750 // TODO: cache CMD_0101_0000_d16_Wr14_DGain
whismanoid 63:8f39d21d6157 751 // TODO: cache CMD_0110_0100_d16_Wr19_FlashAddr
whismanoid 63:8f39d21d6157 752 // TODO: cache CMD_0110_1000_d16_Wr1A_FlashDataIn
whismanoid 53:3d5a3d241a5e 753 }
whismanoid 53:3d5a3d241a5e 754 break;
whismanoid 63:8f39d21d6157 755 case 32: // 32-bit register size
whismanoid 63:8f39d21d6157 756 #warning "Not Verified Yet: MAX11043::RegWrite 32-bit"
whismanoid 53:3d5a3d241a5e 757 {
whismanoid 63:8f39d21d6157 758 // SPI 8+32 = 40-bit transfer
whismanoid 63:8f39d21d6157 759 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32 ___[4]_40
whismanoid 63:8f39d21d6157 760 // SPI MOSI = 1aaa_aaaa_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd ... _0000
whismanoid 63:8f39d21d6157 761 // SPI MISO = xxxx_xxxx_xxxx_xxxx_xxxx_xxxx_xxxx_xxxx_xxxx_xxxx ... _xxxx
whismanoid 63:8f39d21d6157 762 //
whismanoid 63:8f39d21d6157 763 size_t byteCount = 1 + (2 * 2);
whismanoid 63:8f39d21d6157 764 uint8_t mosiData[5];
whismanoid 63:8f39d21d6157 765 uint8_t misoData[5];
whismanoid 63:8f39d21d6157 766 mosiData[0] = commandByte;
whismanoid 63:8f39d21d6157 767 mosiData[1] = (uint8_t)((regData >> 24) & 0xFF);
whismanoid 63:8f39d21d6157 768 mosiData[2] = (uint8_t)((regData >> 16) & 0xFF);
whismanoid 63:8f39d21d6157 769 mosiData[3] = (uint8_t)((regData >> 8) & 0xFF);
whismanoid 63:8f39d21d6157 770 mosiData[4] = (uint8_t)((regData >> 0) & 0xFF);
whismanoid 63:8f39d21d6157 771 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 63:8f39d21d6157 772 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 63:8f39d21d6157 773 // TODO: cache CMD_0101_1000_d32_Wr16_FilterCDataOut
whismanoid 63:8f39d21d6157 774 // if (commandByte == CMD_0101_1000_d32_Wr16_FilterCDataOut) {
whismanoid 63:8f39d21d6157 775 // FilterCDataOut = regData;
whismanoid 63:8f39d21d6157 776 // }
whismanoid 63:8f39d21d6157 777 // TODO: cache CMD_0101_1100_d32_Wr17_FilterCDataIn
whismanoid 63:8f39d21d6157 778 // if (commandByte == CMD_0101_1000_d32_Wr16_FilterCDataOut) {
whismanoid 63:8f39d21d6157 779 // FilterCDataOut = regData;
whismanoid 63:8f39d21d6157 780 // }
whismanoid 53:3d5a3d241a5e 781 }
whismanoid 53:3d5a3d241a5e 782 break;
whismanoid 53:3d5a3d241a5e 783 }
whismanoid 53:3d5a3d241a5e 784
whismanoid 53:3d5a3d241a5e 785 //----------------------------------------
whismanoid 53:3d5a3d241a5e 786 // success
whismanoid 53:3d5a3d241a5e 787 return 1;
whismanoid 53:3d5a3d241a5e 788 }
whismanoid 53:3d5a3d241a5e 789
whismanoid 53:3d5a3d241a5e 790 //----------------------------------------
whismanoid 53:3d5a3d241a5e 791 // Read an 8-bit MAX11043 register
whismanoid 53:3d5a3d241a5e 792 //
whismanoid 57:1c9da8e90737 793 // CMDOP_1aaa_aaaa_ReadRegister bit is set 1 indicating a read operation.
whismanoid 53:3d5a3d241a5e 794 //
whismanoid 53:3d5a3d241a5e 795 // MAX11043 register length can be determined by function RegSize.
whismanoid 53:3d5a3d241a5e 796 //
whismanoid 53:3d5a3d241a5e 797 // For 8-bit register size:
whismanoid 53:3d5a3d241a5e 798 //
whismanoid 53:3d5a3d241a5e 799 // SPI 16-bit transfer
whismanoid 53:3d5a3d241a5e 800 //
whismanoid 53:3d5a3d241a5e 801 // SPI MOSI = 1aaa_aaaa_0000_0000
whismanoid 53:3d5a3d241a5e 802 //
whismanoid 53:3d5a3d241a5e 803 // SPI MISO = xxxx_xxxx_dddd_dddd
whismanoid 53:3d5a3d241a5e 804 //
whismanoid 53:3d5a3d241a5e 805 // For 16-bit register size:
whismanoid 53:3d5a3d241a5e 806 //
whismanoid 53:3d5a3d241a5e 807 // SPI 24-bit or 32-bit transfer
whismanoid 53:3d5a3d241a5e 808 //
whismanoid 53:3d5a3d241a5e 809 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000
whismanoid 53:3d5a3d241a5e 810 //
whismanoid 53:3d5a3d241a5e 811 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd
whismanoid 53:3d5a3d241a5e 812 //
whismanoid 53:3d5a3d241a5e 813 // For 24-bit register size:
whismanoid 53:3d5a3d241a5e 814 //
whismanoid 53:3d5a3d241a5e 815 // SPI 32-bit transfer
whismanoid 53:3d5a3d241a5e 816 //
whismanoid 53:3d5a3d241a5e 817 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000
whismanoid 53:3d5a3d241a5e 818 //
whismanoid 53:3d5a3d241a5e 819 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd
whismanoid 53:3d5a3d241a5e 820 //
whismanoid 53:3d5a3d241a5e 821 //
whismanoid 53:3d5a3d241a5e 822 // @return 1 on success; 0 on failure
whismanoid 53:3d5a3d241a5e 823 uint8_t MAX11043::RegRead(MAX11043_CMD_enum_t commandByte, uint32_t* ptrRegData)
whismanoid 53:3d5a3d241a5e 824 {
whismanoid 53:3d5a3d241a5e 825
whismanoid 53:3d5a3d241a5e 826 //----------------------------------------
whismanoid 53:3d5a3d241a5e 827 // switch based on register address szie RegSize(regAddress)
whismanoid 57:1c9da8e90737 828 //commandByte = (MAX11043_CMD_enum_t)((commandByte &~ CMDOP_0aaa_aa10_ReadRegister) & 0xFF);
whismanoid 53:3d5a3d241a5e 829 switch(RegSize(commandByte))
whismanoid 53:3d5a3d241a5e 830 {
whismanoid 53:3d5a3d241a5e 831 case 8: // 8-bit register size
whismanoid 53:3d5a3d241a5e 832 {
whismanoid 60:d1d1eaa90fb7 833 // SPI 8+8 = 16-bit transfer
whismanoid 62:8223a7253c90 834 // 1234 5678 ___[1]_16
whismanoid 63:8f39d21d6157 835 // SPI MOSI = 1aaa_aaaa_0000_0000 ... _0000
whismanoid 63:8f39d21d6157 836 // SPI MISO = xxxx_xxxx_dddd_dddd ... _xxxx
whismanoid 63:8f39d21d6157 837 size_t byteCount = 1 + 1;
whismanoid 63:8f39d21d6157 838 uint8_t mosiData[2];
whismanoid 63:8f39d21d6157 839 uint8_t misoData[2];
whismanoid 63:8f39d21d6157 840 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 63:8f39d21d6157 841 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 63:8f39d21d6157 842 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 63:8f39d21d6157 843 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 63:8f39d21d6157 844 if (ptrRegData) { (*ptrRegData) = misoData[1]; }
whismanoid 59:47538bcf6cda 845 if (commandByte == CMD_0001_1110_d8_Rd07_Status) {
whismanoid 59:47538bcf6cda 846 // TODO1: update status
whismanoid 63:8f39d21d6157 847 status = misoData[1];
whismanoid 59:47538bcf6cda 848 }
whismanoid 53:3d5a3d241a5e 849 }
whismanoid 53:3d5a3d241a5e 850 break;
whismanoid 53:3d5a3d241a5e 851 case 16: // 16-bit register size
whismanoid 63:8f39d21d6157 852 #warning "Not Verified Yet: MAX11043::RegRead 16-bit"
whismanoid 53:3d5a3d241a5e 853 {
whismanoid 60:d1d1eaa90fb7 854 // SPI 8+16 = 24-bit transfer
whismanoid 62:8223a7253c90 855 // 1234 5678 ___[1]_16 ___[2]_24
whismanoid 60:d1d1eaa90fb7 856 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000 ... _0000
whismanoid 60:d1d1eaa90fb7 857 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 63:8f39d21d6157 858 size_t byteCount = 1 + 2;
whismanoid 63:8f39d21d6157 859 uint8_t mosiData[3];
whismanoid 63:8f39d21d6157 860 uint8_t misoData[3];
whismanoid 63:8f39d21d6157 861 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 63:8f39d21d6157 862 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 63:8f39d21d6157 863 mosiData[2] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 63:8f39d21d6157 864 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 63:8f39d21d6157 865 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 63:8f39d21d6157 866 if (ptrRegData) { (*ptrRegData) = (misoData[1] << 8) | misoData[2]; }
whismanoid 59:47538bcf6cda 867 if (commandByte == CMD_0010_0010_d16_Rd08_Configuration) {
whismanoid 59:47538bcf6cda 868 // TODO1: update config
whismanoid 63:8f39d21d6157 869 config = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 870 }
whismanoid 59:47538bcf6cda 871 if (commandByte == CMD_0000_0010_d16o8_Rd00_ADCa) {
whismanoid 59:47538bcf6cda 872 // TODO1: update adca
whismanoid 63:8f39d21d6157 873 adca = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 874 }
whismanoid 59:47538bcf6cda 875 if (commandByte == CMD_0000_0110_d16o8_Rd01_ADCb) {
whismanoid 59:47538bcf6cda 876 // TODO1: update adcb
whismanoid 63:8f39d21d6157 877 adcb = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 878 }
whismanoid 59:47538bcf6cda 879 if (commandByte == CMD_0000_1010_d16o8_Rd02_ADCc) {
whismanoid 59:47538bcf6cda 880 // TODO1: update adcc
whismanoid 63:8f39d21d6157 881 adcc = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 882 }
whismanoid 59:47538bcf6cda 883 if (commandByte == CMD_0000_1110_d16o8_Rd03_ADCd) {
whismanoid 59:47538bcf6cda 884 // TODO1: update adcd
whismanoid 63:8f39d21d6157 885 adcd = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 886 }
whismanoid 53:3d5a3d241a5e 887 }
whismanoid 53:3d5a3d241a5e 888 break;
whismanoid 53:3d5a3d241a5e 889 case 24: // 24-bit register size
whismanoid 53:3d5a3d241a5e 890 {
whismanoid 60:d1d1eaa90fb7 891 // SPI 8+24 = 32-bit transfer
whismanoid 62:8223a7253c90 892 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32
whismanoid 63:8f39d21d6157 893 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000 ... _0000
whismanoid 63:8f39d21d6157 894 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 63:8f39d21d6157 895 size_t byteCount = 1 + 3;
whismanoid 63:8f39d21d6157 896 uint8_t mosiData[4];
whismanoid 63:8f39d21d6157 897 uint8_t misoData[4];
whismanoid 63:8f39d21d6157 898 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 63:8f39d21d6157 899 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 63:8f39d21d6157 900 mosiData[2] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 63:8f39d21d6157 901 mosiData[3] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 63:8f39d21d6157 902 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 63:8f39d21d6157 903 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 63:8f39d21d6157 904 if (ptrRegData) { (*ptrRegData) = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3]; }
whismanoid 59:47538bcf6cda 905 if (commandByte == CMD_0000_0010_d16o8_Rd00_ADCa) {
whismanoid 59:47538bcf6cda 906 // TODO1: update adca
whismanoid 63:8f39d21d6157 907 adca = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 908 }
whismanoid 59:47538bcf6cda 909 if (commandByte == CMD_0000_0110_d16o8_Rd01_ADCb) {
whismanoid 59:47538bcf6cda 910 // TODO1: update adcb
whismanoid 63:8f39d21d6157 911 adcb = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 912 }
whismanoid 59:47538bcf6cda 913 if (commandByte == CMD_0000_1010_d16o8_Rd02_ADCc) {
whismanoid 59:47538bcf6cda 914 // TODO1: update adcc
whismanoid 63:8f39d21d6157 915 adcc = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 916 }
whismanoid 59:47538bcf6cda 917 if (commandByte == CMD_0000_1110_d16o8_Rd03_ADCd) {
whismanoid 59:47538bcf6cda 918 // TODO1: update adcd
whismanoid 63:8f39d21d6157 919 adcd = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 920 }
whismanoid 59:47538bcf6cda 921 }
whismanoid 59:47538bcf6cda 922 break;
whismanoid 63:8f39d21d6157 923 case 32: // 32-bit register size CMD_0001_0010_d16o8_d16o8_Rd04_ADCab, CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd
whismanoid 59:47538bcf6cda 924 //
whismanoid 63:8f39d21d6157 925 #warning "Not Implemented Yet: MAX11043::RegRead 32-bit CMD_0001_0010_d16o8_d16o8_Rd04_ADCab"
whismanoid 63:8f39d21d6157 926 // TODO: support long SPI read CMD_0001_0010_d16o8_d16o8_Rd04_ADCab
whismanoid 59:47538bcf6cda 927 // %SW 0x12 (0 0) (0 0) -- for 16-bit read A,B
whismanoid 59:47538bcf6cda 928 // update adca, adcb
whismanoid 59:47538bcf6cda 929 //
whismanoid 63:8f39d21d6157 930 // TODO: support long SPI read CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd
whismanoid 59:47538bcf6cda 931 // %SW 0x16 (0 0) (0 0) -- for 16-bit read C,D
whismanoid 59:47538bcf6cda 932 // update adcc, adcd
whismanoid 59:47538bcf6cda 933 //
whismanoid 59:47538bcf6cda 934 {
whismanoid 60:d1d1eaa90fb7 935 // SPI 8+32 = 40-bit transfer
whismanoid 62:8223a7253c90 936 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32 ___[4]_40
whismanoid 60:d1d1eaa90fb7 937 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000_0000_0000 ... _0000
whismanoid 60:d1d1eaa90fb7 938 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 62:8223a7253c90 939 size_t byteCount = 1 + (2 * 2);
whismanoid 62:8223a7253c90 940 uint8_t mosiData[5];
whismanoid 62:8223a7253c90 941 uint8_t misoData[5];
whismanoid 62:8223a7253c90 942 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 62:8223a7253c90 943 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 944 mosiData[2] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 945 mosiData[3] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 946 mosiData[4] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 947 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 62:8223a7253c90 948 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 62:8223a7253c90 949 if (ptrRegData) { (*ptrRegData) = (misoData[1] << 8) | misoData[2]; }
whismanoid 63:8f39d21d6157 950 if (commandByte == CMD_0001_0010_d16o8_d16o8_Rd04_ADCab) {
whismanoid 59:47538bcf6cda 951 // TODO1: update adca
whismanoid 62:8223a7253c90 952 adca = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 953 // TODO1: update adcb
whismanoid 62:8223a7253c90 954 adcb = (misoData[3] << 8) | misoData[4];
whismanoid 59:47538bcf6cda 955 }
whismanoid 63:8f39d21d6157 956 if (commandByte == CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd) {
whismanoid 59:47538bcf6cda 957 // TODO1: update adcc
whismanoid 62:8223a7253c90 958 adcc = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 959 // TODO1: update adcd
whismanoid 62:8223a7253c90 960 adcd = (misoData[3] << 8) | misoData[4];
whismanoid 59:47538bcf6cda 961 }
whismanoid 59:47538bcf6cda 962 }
whismanoid 59:47538bcf6cda 963 break;
whismanoid 63:8f39d21d6157 964 case 48: // 48-bit register size CMD_0001_0010_d16o8_d16o8_Rd04_ADCab, CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd
whismanoid 59:47538bcf6cda 965 //
whismanoid 63:8f39d21d6157 966 #warning "Not Verified Yet: MAX11043::RegRead 48-bit CMD_0001_0010_d16o8_d16o8_Rd04_ADCab"
whismanoid 63:8f39d21d6157 967 // TODO: support long SPI read CMD_0001_0010_d16o8_d16o8_Rd04_ADCab
whismanoid 59:47538bcf6cda 968 // %SW 0x12 (0 0 0) (0 0 0) -- for 24-bit read A,B
whismanoid 59:47538bcf6cda 969 // update adca, adcb
whismanoid 59:47538bcf6cda 970 //
whismanoid 63:8f39d21d6157 971 // TODO: support long SPI read CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd
whismanoid 59:47538bcf6cda 972 // %SW 0x16 (0 0 0) (0 0 0) -- for 24-bit read C,D
whismanoid 59:47538bcf6cda 973 // update adcc, adcd
whismanoid 59:47538bcf6cda 974 //
whismanoid 59:47538bcf6cda 975 {
whismanoid 60:d1d1eaa90fb7 976 // SPI 8+48 = 56-bit transfer
whismanoid 62:8223a7253c90 977 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32 ___[4]_40 ___[5]_48 ___[6]_56
whismanoid 60:d1d1eaa90fb7 978 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000 ... _0000
whismanoid 60:d1d1eaa90fb7 979 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 62:8223a7253c90 980 size_t byteCount = 1 + (3 * 2);
whismanoid 62:8223a7253c90 981 uint8_t mosiData[7];
whismanoid 62:8223a7253c90 982 uint8_t misoData[7];
whismanoid 62:8223a7253c90 983 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 62:8223a7253c90 984 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 985 mosiData[2] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 986 mosiData[3] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 987 mosiData[4] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 988 mosiData[5] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 989 mosiData[6] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 990 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 62:8223a7253c90 991 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 62:8223a7253c90 992 if (ptrRegData) { (*ptrRegData) = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3]; }
whismanoid 63:8f39d21d6157 993 if (commandByte == CMD_0001_0010_d16o8_d16o8_Rd04_ADCab) {
whismanoid 59:47538bcf6cda 994 // TODO1: update adca
whismanoid 62:8223a7253c90 995 adca = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 996 // TODO1: update adcb
whismanoid 62:8223a7253c90 997 adcb = (misoData[4] << 16) | (misoData[5] << 8) | misoData[6];
whismanoid 59:47538bcf6cda 998 }
whismanoid 63:8f39d21d6157 999 if (commandByte == CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd) {
whismanoid 59:47538bcf6cda 1000 // TODO1: update adcc
whismanoid 62:8223a7253c90 1001 adcc = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 1002 // TODO1: update adcd
whismanoid 62:8223a7253c90 1003 adcd = (misoData[4] << 16) | (misoData[5] << 8) | misoData[6];
whismanoid 59:47538bcf6cda 1004 }
whismanoid 59:47538bcf6cda 1005 }
whismanoid 59:47538bcf6cda 1006 break;
whismanoid 63:8f39d21d6157 1007 case 64: // 64-bit register size CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd
whismanoid 59:47538bcf6cda 1008 //
whismanoid 63:8f39d21d6157 1009 #warning "Not Verified Yet: MAX11043::RegRead 64-bit CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd"
whismanoid 63:8f39d21d6157 1010 // TODO: support long SPI read CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd
whismanoid 59:47538bcf6cda 1011 // %SW 0x1A (0 0) (0 0) (0 0) (0 0) -- for 16-bit read A,B,C,D
whismanoid 59:47538bcf6cda 1012 // update adca, adcb, adcc, adcd
whismanoid 59:47538bcf6cda 1013 //
whismanoid 59:47538bcf6cda 1014 {
whismanoid 60:d1d1eaa90fb7 1015 // SPI 8+64 = 72-bit transfer
whismanoid 62:8223a7253c90 1016 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32 ___[4]_40 ___[5]_48 ___[6]_56 ___[7]_64 ___[8]_72
whismanoid 60:d1d1eaa90fb7 1017 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000 ... _0000
whismanoid 60:d1d1eaa90fb7 1018 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 62:8223a7253c90 1019 size_t byteCount = 1 + (2 * 4);
whismanoid 62:8223a7253c90 1020 uint8_t mosiData[9];
whismanoid 62:8223a7253c90 1021 uint8_t misoData[9];
whismanoid 62:8223a7253c90 1022 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 62:8223a7253c90 1023 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1024 mosiData[2] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1025 mosiData[3] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1026 mosiData[4] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1027 mosiData[5] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1028 mosiData[6] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1029 mosiData[7] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1030 mosiData[8] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1031 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 62:8223a7253c90 1032 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 62:8223a7253c90 1033 if (ptrRegData) { (*ptrRegData) = (misoData[1] << 8) | misoData[2]; }
whismanoid 63:8f39d21d6157 1034 if (commandByte == CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd) {
whismanoid 59:47538bcf6cda 1035 // TODO1: update adca
whismanoid 62:8223a7253c90 1036 adca = (misoData[1] << 8) | misoData[2];
whismanoid 59:47538bcf6cda 1037 // TODO1: update adcb
whismanoid 62:8223a7253c90 1038 adcb = (misoData[3] << 8) | misoData[4];
whismanoid 59:47538bcf6cda 1039 // TODO1: update adcc
whismanoid 62:8223a7253c90 1040 adcc = (misoData[5] << 8) | misoData[6];
whismanoid 59:47538bcf6cda 1041 // TODO1: update adcd
whismanoid 62:8223a7253c90 1042 adcd = (misoData[7] << 8) | misoData[8];
whismanoid 59:47538bcf6cda 1043 }
whismanoid 59:47538bcf6cda 1044 }
whismanoid 59:47538bcf6cda 1045 break;
whismanoid 63:8f39d21d6157 1046 case 96: // 96-bit register size CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd
whismanoid 59:47538bcf6cda 1047 //
whismanoid 63:8f39d21d6157 1048 #warning "Not Verified Yet: MAX11043::RegRead 96-bit CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd"
whismanoid 63:8f39d21d6157 1049 // TODO: support long SPI read CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd
whismanoid 59:47538bcf6cda 1050 // %SW 0x1A (0 0 0) (0 0 0) (0 0 0) (0 0 0) -- for 24-bit read A,B,C,D
whismanoid 59:47538bcf6cda 1051 // update adca, adcb, adcc, adcd
whismanoid 59:47538bcf6cda 1052 //
whismanoid 59:47538bcf6cda 1053 {
whismanoid 60:d1d1eaa90fb7 1054 // SPI 8+96 = 104-bit transfer
whismanoid 62:8223a7253c90 1055 // 1234 5678 ___[1]_16 ___[2]_24 ___[3]_32 ___[4]_40 ___[5]_48 ___[6]_56 ___[7]_64 ___[8]_72 ___[9]_80 __[10]_88 __[11]_96 __[12]104
whismanoid 60:d1d1eaa90fb7 1056 // SPI MOSI = 1aaa_aaaa_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000_0000 ... _0000
whismanoid 60:d1d1eaa90fb7 1057 // SPI MISO = xxxx_xxxx_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd_dddd ... _xxxx
whismanoid 62:8223a7253c90 1058 size_t byteCount = 1 + (3 * 4);
whismanoid 62:8223a7253c90 1059 uint8_t mosiData[13];
whismanoid 62:8223a7253c90 1060 uint8_t misoData[13];
whismanoid 62:8223a7253c90 1061 mosiData[0] = CMDOP_0aaa_aa10_ReadRegister | commandByte;
whismanoid 62:8223a7253c90 1062 mosiData[1] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1063 mosiData[2] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1064 mosiData[3] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1065 mosiData[4] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1066 mosiData[5] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1067 mosiData[6] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1068 mosiData[7] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1069 mosiData[8] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1070 mosiData[9] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1071 mosiData[10] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1072 mosiData[11] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1073 mosiData[12] = 0; // CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 62:8223a7253c90 1074 // SPIreadWriteWithLowCS(size_t byteCount, uint8_t mosiData[], uint8_t misoData[]);
whismanoid 62:8223a7253c90 1075 SPIreadWriteWithLowCS(byteCount, mosiData, misoData);
whismanoid 62:8223a7253c90 1076 if (ptrRegData) { (*ptrRegData) = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3]; }
whismanoid 63:8f39d21d6157 1077 if (commandByte == CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd) {
whismanoid 59:47538bcf6cda 1078 // TODO1: update adca
whismanoid 62:8223a7253c90 1079 adca = (misoData[1] << 16) | (misoData[2] << 8) | misoData[3];
whismanoid 59:47538bcf6cda 1080 // TODO1: update adcb
whismanoid 62:8223a7253c90 1081 adcb = (misoData[4] << 16) | (misoData[5] << 8) | misoData[6];
whismanoid 59:47538bcf6cda 1082 // TODO1: update adcc
whismanoid 62:8223a7253c90 1083 adcc = (misoData[7] << 16) | (misoData[8] << 8) | misoData[9];
whismanoid 59:47538bcf6cda 1084 // TODO1: update adcd
whismanoid 62:8223a7253c90 1085 adcd = (misoData[10] << 16) | (misoData[11] << 8) | misoData[12];
whismanoid 59:47538bcf6cda 1086 }
whismanoid 53:3d5a3d241a5e 1087 }
whismanoid 53:3d5a3d241a5e 1088 break;
whismanoid 53:3d5a3d241a5e 1089 }
whismanoid 53:3d5a3d241a5e 1090
whismanoid 53:3d5a3d241a5e 1091 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1092 // success
whismanoid 53:3d5a3d241a5e 1093 return 1;
whismanoid 53:3d5a3d241a5e 1094 }
whismanoid 53:3d5a3d241a5e 1095
whismanoid 53:3d5a3d241a5e 1096 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1097 // Return the size of a MAX11043 register
whismanoid 53:3d5a3d241a5e 1098 //
whismanoid 53:3d5a3d241a5e 1099 // @return 8 for 8-bit, 16 for 16-bit, 24 for 24-bit, else 0 for undefined register size
whismanoid 53:3d5a3d241a5e 1100 uint8_t MAX11043::RegSize(MAX11043_CMD_enum_t commandByte)
whismanoid 53:3d5a3d241a5e 1101 {
whismanoid 53:3d5a3d241a5e 1102
whismanoid 53:3d5a3d241a5e 1103 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1104 // switch based on register address value regAddress
whismanoid 57:1c9da8e90737 1105 // commandByte = (MAX11043_CMD_enum_t)((commandByte &~ CMDOP_0aaa_aa10_ReadRegister) & 0xFF);
whismanoid 53:3d5a3d241a5e 1106 switch(commandByte)
whismanoid 53:3d5a3d241a5e 1107 {
whismanoid 53:3d5a3d241a5e 1108 default:
whismanoid 57:1c9da8e90737 1109 // case CMDOP_0aaa_aa00_WriteRegister:
whismanoid 57:1c9da8e90737 1110 // case CMDOP_0aaa_aa10_ReadRegister:
whismanoid 57:1c9da8e90737 1111 // case CMDOP_1111_1111_NoOperationMOSIidleHigh:
whismanoid 53:3d5a3d241a5e 1112 return 0; // undefined register size
whismanoid 53:3d5a3d241a5e 1113 case CMD_0001_1110_d8_Rd07_Status:
whismanoid 53:3d5a3d241a5e 1114 case CMD_0101_0100_d8_Wr15_FilterCAddress:
whismanoid 53:3d5a3d241a5e 1115 case CMD_0101_0110_d8_Rd15_FilterCAddress:
whismanoid 53:3d5a3d241a5e 1116 case CMD_0110_0000_d8_Wr18_FlashMode:
whismanoid 53:3d5a3d241a5e 1117 case CMD_0110_0010_d8_Rd18_FlashMode:
whismanoid 53:3d5a3d241a5e 1118 return 8; // 8-bit register size
whismanoid 53:3d5a3d241a5e 1119 case CMD_0010_0000_d16_Wr08_Configuration:
whismanoid 53:3d5a3d241a5e 1120 case CMD_0010_0010_d16_Rd08_Configuration:
whismanoid 53:3d5a3d241a5e 1121 case CMD_0010_0100_d16_Wr09_DAC:
whismanoid 53:3d5a3d241a5e 1122 case CMD_0010_0110_d16_Rd09_DAC:
whismanoid 53:3d5a3d241a5e 1123 case CMD_0010_1000_d16_Wr0A_DACStep:
whismanoid 53:3d5a3d241a5e 1124 case CMD_0010_1010_d16_Rd0A_DACStep:
whismanoid 53:3d5a3d241a5e 1125 case CMD_0010_1100_d16_Wr0B_DACHDACL:
whismanoid 53:3d5a3d241a5e 1126 case CMD_0010_1110_d16_Rd0B_DACHDACL:
whismanoid 53:3d5a3d241a5e 1127 case CMD_0011_0000_d16_Wr0C_ConfigA:
whismanoid 53:3d5a3d241a5e 1128 case CMD_0011_0010_d16_Rd0C_ConfigA:
whismanoid 53:3d5a3d241a5e 1129 case CMD_0011_0100_d16_Wr0D_ConfigB:
whismanoid 53:3d5a3d241a5e 1130 case CMD_0011_0110_d16_Rd0D_ConfigB:
whismanoid 53:3d5a3d241a5e 1131 case CMD_0011_1000_d16_Wr0E_ConfigC:
whismanoid 53:3d5a3d241a5e 1132 case CMD_0011_1010_d16_Rd0E_ConfigC:
whismanoid 53:3d5a3d241a5e 1133 case CMD_0011_1100_d16_Wr0F_ConfigD:
whismanoid 53:3d5a3d241a5e 1134 case CMD_0011_1110_d16_Rd0F_ConfigD:
whismanoid 53:3d5a3d241a5e 1135 case CMD_0100_0000_d16_Wr10_Reference:
whismanoid 53:3d5a3d241a5e 1136 case CMD_0100_0010_d16_Rd10_Reference:
whismanoid 53:3d5a3d241a5e 1137 case CMD_0100_0100_d16_Wr11_AGain:
whismanoid 53:3d5a3d241a5e 1138 case CMD_0100_0110_d16_Rd11_AGain:
whismanoid 53:3d5a3d241a5e 1139 case CMD_0100_1000_d16_Wr12_BGain:
whismanoid 53:3d5a3d241a5e 1140 case CMD_0100_1010_d16_Rd12_BGain:
whismanoid 53:3d5a3d241a5e 1141 case CMD_0100_1100_d16_Wr13_CGain:
whismanoid 53:3d5a3d241a5e 1142 case CMD_0100_1110_d16_Rd13_CGain:
whismanoid 53:3d5a3d241a5e 1143 case CMD_0101_0000_d16_Wr14_DGain:
whismanoid 53:3d5a3d241a5e 1144 case CMD_0101_0010_d16_Rd14_DGain:
whismanoid 53:3d5a3d241a5e 1145 case CMD_0110_0100_d16_Wr19_FlashAddr:
whismanoid 53:3d5a3d241a5e 1146 case CMD_0110_0110_d16_Rd19_FlashAddr:
whismanoid 53:3d5a3d241a5e 1147 case CMD_0110_1000_d16_Wr1A_FlashDataIn:
whismanoid 53:3d5a3d241a5e 1148 case CMD_0110_1010_d16_Rd1A_FlashDataIn:
whismanoid 53:3d5a3d241a5e 1149 case CMD_0110_1110_d16_Rd1B_FlashDataOut:
whismanoid 53:3d5a3d241a5e 1150 return 16; // 16-bit register size
whismanoid 59:47538bcf6cda 1151 case CMD_0000_0010_d16o8_Rd00_ADCa:
whismanoid 59:47538bcf6cda 1152 case CMD_0000_0110_d16o8_Rd01_ADCb:
whismanoid 59:47538bcf6cda 1153 case CMD_0000_1010_d16o8_Rd02_ADCc:
whismanoid 59:47538bcf6cda 1154 case CMD_0000_1110_d16o8_Rd03_ADCd:
whismanoid 59:47538bcf6cda 1155 if (config & CONFIG_xxxx_xxxx_xx1x_xxxx_24BIT)
whismanoid 59:47538bcf6cda 1156 {
whismanoid 59:47538bcf6cda 1157 // %SW 0x02 (0 0 0) -- for 24-bit read
whismanoid 59:47538bcf6cda 1158 return 24; // 24-bit register size
whismanoid 59:47538bcf6cda 1159 }
whismanoid 59:47538bcf6cda 1160 // %SW 0x02 (0 0) -- for 16-bit read
whismanoid 59:47538bcf6cda 1161 //
whismanoid 59:47538bcf6cda 1162 return 16; // 16-bit register size
whismanoid 63:8f39d21d6157 1163 case CMD_0001_0010_d16o8_d16o8_Rd04_ADCab:
whismanoid 63:8f39d21d6157 1164 case CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd:
whismanoid 59:47538bcf6cda 1165 //
whismanoid 59:47538bcf6cda 1166 // TODO: support long SPI read
whismanoid 59:47538bcf6cda 1167 if (config & CONFIG_xxxx_xxxx_xx1x_xxxx_24BIT)
whismanoid 59:47538bcf6cda 1168 {
whismanoid 59:47538bcf6cda 1169 // %SW 0x12 (0 0 0) (0 0 0) -- for 24-bit read A,B
whismanoid 59:47538bcf6cda 1170 // %SW 0x16 (0 0 0) (0 0 0) -- for 24-bit read C,D
whismanoid 59:47538bcf6cda 1171 return 48; // 48-bit register size: 2*(24)
whismanoid 59:47538bcf6cda 1172 }
whismanoid 59:47538bcf6cda 1173 // %SW 0x12 (0 0) (0 0) -- for 16-bit read A,B
whismanoid 59:47538bcf6cda 1174 // %SW 0x16 (0 0) (0 0) -- for 16-bit read C,D
whismanoid 59:47538bcf6cda 1175 //
whismanoid 59:47538bcf6cda 1176 return 32; // 32-bit register size: 2*(16)
whismanoid 63:8f39d21d6157 1177 case CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd:
whismanoid 59:47538bcf6cda 1178 //
whismanoid 59:47538bcf6cda 1179 // TODO: support long SPI read
whismanoid 59:47538bcf6cda 1180 if (config & CONFIG_xxxx_xxxx_xx1x_xxxx_24BIT)
whismanoid 59:47538bcf6cda 1181 {
whismanoid 59:47538bcf6cda 1182 // %SW 0x1A (0 0 0) (0 0 0) (0 0 0) (0 0 0) -- for 24-bit read A,B,C,D
whismanoid 59:47538bcf6cda 1183 return 96; // 96-bit register size: 4*(24)
whismanoid 59:47538bcf6cda 1184 }
whismanoid 59:47538bcf6cda 1185 // %SW 0x1A (0 0) (0 0) (0 0) (0 0) -- for 16-bit read A,B,C,D
whismanoid 59:47538bcf6cda 1186 //
whismanoid 59:47538bcf6cda 1187 return 64; // 64-bit register size: 4*(16)
whismanoid 53:3d5a3d241a5e 1188 case CMD_0101_1000_d32_Wr16_FilterCDataOut:
whismanoid 53:3d5a3d241a5e 1189 case CMD_0101_1010_d32_Rd16_FilterCDataOut:
whismanoid 53:3d5a3d241a5e 1190 case CMD_0101_1100_d32_Wr17_FilterCDataIn:
whismanoid 53:3d5a3d241a5e 1191 case CMD_0101_1110_d32_Rd17_FilterCDataIn:
whismanoid 53:3d5a3d241a5e 1192 return 32; // 32-bit register size
whismanoid 53:3d5a3d241a5e 1193 }
whismanoid 53:3d5a3d241a5e 1194 }
whismanoid 53:3d5a3d241a5e 1195
whismanoid 53:3d5a3d241a5e 1196 //----------------------------------------
whismanoid 57:1c9da8e90737 1197 // Decode operation from commandByte
whismanoid 57:1c9da8e90737 1198 //
whismanoid 57:1c9da8e90737 1199 // @return operation such as idle, read register, write register, etc.
whismanoid 57:1c9da8e90737 1200 MAX11043::MAX11043_CMDOP_enum_t MAX11043::DecodeCommand(MAX11043_CMD_enum_t commandByte)
whismanoid 57:1c9da8e90737 1201 {
whismanoid 57:1c9da8e90737 1202
whismanoid 57:1c9da8e90737 1203 //----------------------------------------
whismanoid 57:1c9da8e90737 1204 // decode operation from command byte
whismanoid 57:1c9da8e90737 1205 switch (commandByte & 0x83)
whismanoid 57:1c9da8e90737 1206 {
whismanoid 57:1c9da8e90737 1207 case CMDOP_0aaa_aa10_ReadRegister:
whismanoid 57:1c9da8e90737 1208 return CMDOP_0aaa_aa10_ReadRegister;
whismanoid 57:1c9da8e90737 1209 case CMDOP_0aaa_aa00_WriteRegister:
whismanoid 57:1c9da8e90737 1210 return CMDOP_0aaa_aa00_WriteRegister;
whismanoid 57:1c9da8e90737 1211 default:
whismanoid 57:1c9da8e90737 1212 return CMDOP_1111_1111_NoOperationMOSIidleHigh;
whismanoid 57:1c9da8e90737 1213 }
whismanoid 57:1c9da8e90737 1214 }
whismanoid 57:1c9da8e90737 1215
whismanoid 57:1c9da8e90737 1216 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1217 // Return the address field of a MAX11043 register
whismanoid 53:3d5a3d241a5e 1218 //
whismanoid 53:3d5a3d241a5e 1219 // @return register address field as given in datasheet
whismanoid 53:3d5a3d241a5e 1220 uint8_t MAX11043::RegAddrOfCommand(MAX11043_CMD_enum_t commandByte)
whismanoid 53:3d5a3d241a5e 1221 {
whismanoid 53:3d5a3d241a5e 1222
whismanoid 53:3d5a3d241a5e 1223 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1224 // extract register address value from command byte
whismanoid 57:1c9da8e90737 1225 return (uint8_t)((commandByte &~ 0x83) >> 2); // CMDOP_0aaa_aa10_ReadRegister
whismanoid 53:3d5a3d241a5e 1226 }
whismanoid 53:3d5a3d241a5e 1227
whismanoid 53:3d5a3d241a5e 1228 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1229 // Test whether a command byte is a register read command
whismanoid 53:3d5a3d241a5e 1230 //
whismanoid 53:3d5a3d241a5e 1231 // @return true if command byte is a register read command
whismanoid 53:3d5a3d241a5e 1232 uint8_t MAX11043::IsRegReadCommand(MAX11043_CMD_enum_t commandByte)
whismanoid 53:3d5a3d241a5e 1233 {
whismanoid 53:3d5a3d241a5e 1234
whismanoid 53:3d5a3d241a5e 1235 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1236 // Test whether a command byte is a register read command
whismanoid 57:1c9da8e90737 1237 return (commandByte &~ 0x02) ? 1 : 0; // CMDOP_0aaa_aa10_ReadRegister
whismanoid 53:3d5a3d241a5e 1238 }
whismanoid 53:3d5a3d241a5e 1239
whismanoid 53:3d5a3d241a5e 1240 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1241 // Return the name of a MAX11043 register
whismanoid 53:3d5a3d241a5e 1242 //
whismanoid 53:3d5a3d241a5e 1243 // @return null-terminated constant C string containing register name or empty string
whismanoid 53:3d5a3d241a5e 1244 const char* MAX11043::RegName(MAX11043_CMD_enum_t commandByte)
whismanoid 53:3d5a3d241a5e 1245 {
whismanoid 53:3d5a3d241a5e 1246
whismanoid 53:3d5a3d241a5e 1247 //----------------------------------------
whismanoid 53:3d5a3d241a5e 1248 // switch based on register address value regAddress
whismanoid 57:1c9da8e90737 1249 // commandByte = (MAX11043_CMD_enum_t)((commandByte &~ CMDOP_0aaa_aa10_ReadRegister) & 0xFF);
whismanoid 53:3d5a3d241a5e 1250 switch(commandByte)
whismanoid 53:3d5a3d241a5e 1251 {
whismanoid 53:3d5a3d241a5e 1252 default:
whismanoid 53:3d5a3d241a5e 1253 return ""; // undefined register
whismanoid 57:1c9da8e90737 1254 // case CMDOP_0aaa_aa00_WriteRegister: return "_______";
whismanoid 57:1c9da8e90737 1255 // case CMDOP_0aaa_aa10_ReadRegister: return "_______";
whismanoid 57:1c9da8e90737 1256 // case CMDOP_1111_1111_NoOperationMOSIidleHigh: return "_______";
whismanoid 59:47538bcf6cda 1257 case CMD_0000_0010_d16o8_Rd00_ADCa: return "ADCa";
whismanoid 59:47538bcf6cda 1258 case CMD_0000_0110_d16o8_Rd01_ADCb: return "ADCb";
whismanoid 59:47538bcf6cda 1259 case CMD_0000_1010_d16o8_Rd02_ADCc: return "ADCc";
whismanoid 59:47538bcf6cda 1260 case CMD_0000_1110_d16o8_Rd03_ADCd: return "ADCd";
whismanoid 63:8f39d21d6157 1261 case CMD_0001_0010_d16o8_d16o8_Rd04_ADCab: return "ADCab";
whismanoid 63:8f39d21d6157 1262 case CMD_0001_0110_d16o8_d16o8_Rd05_ADCcd: return "ADCcd";
whismanoid 63:8f39d21d6157 1263 case CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd: return "ADCabcd";
whismanoid 53:3d5a3d241a5e 1264 case CMD_0001_1110_d8_Rd07_Status: return "Status";
whismanoid 53:3d5a3d241a5e 1265 case CMD_0010_0000_d16_Wr08_Configuration: return "Configuration";
whismanoid 53:3d5a3d241a5e 1266 case CMD_0010_0010_d16_Rd08_Configuration: return "Configuration";
whismanoid 53:3d5a3d241a5e 1267 case CMD_0010_0100_d16_Wr09_DAC: return "DAC";
whismanoid 53:3d5a3d241a5e 1268 case CMD_0010_0110_d16_Rd09_DAC: return "DAC";
whismanoid 53:3d5a3d241a5e 1269 case CMD_0010_1000_d16_Wr0A_DACStep: return "DACStep";
whismanoid 53:3d5a3d241a5e 1270 case CMD_0010_1010_d16_Rd0A_DACStep: return "DACStep";
whismanoid 53:3d5a3d241a5e 1271 case CMD_0010_1100_d16_Wr0B_DACHDACL: return "DACHDACL";
whismanoid 53:3d5a3d241a5e 1272 case CMD_0010_1110_d16_Rd0B_DACHDACL: return "DACHDACL";
whismanoid 53:3d5a3d241a5e 1273 case CMD_0011_0000_d16_Wr0C_ConfigA: return "ConfigA";
whismanoid 53:3d5a3d241a5e 1274 case CMD_0011_0010_d16_Rd0C_ConfigA: return "ConfigA";
whismanoid 53:3d5a3d241a5e 1275 case CMD_0011_0100_d16_Wr0D_ConfigB: return "ConfigB";
whismanoid 53:3d5a3d241a5e 1276 case CMD_0011_0110_d16_Rd0D_ConfigB: return "ConfigB";
whismanoid 53:3d5a3d241a5e 1277 case CMD_0011_1000_d16_Wr0E_ConfigC: return "ConfigC";
whismanoid 53:3d5a3d241a5e 1278 case CMD_0011_1010_d16_Rd0E_ConfigC: return "ConfigC";
whismanoid 53:3d5a3d241a5e 1279 case CMD_0011_1100_d16_Wr0F_ConfigD: return "ConfigD";
whismanoid 53:3d5a3d241a5e 1280 case CMD_0011_1110_d16_Rd0F_ConfigD: return "ConfigD";
whismanoid 53:3d5a3d241a5e 1281 case CMD_0100_0000_d16_Wr10_Reference: return "Reference";
whismanoid 53:3d5a3d241a5e 1282 case CMD_0100_0010_d16_Rd10_Reference: return "Reference";
whismanoid 53:3d5a3d241a5e 1283 case CMD_0100_0100_d16_Wr11_AGain: return "AGain";
whismanoid 53:3d5a3d241a5e 1284 case CMD_0100_0110_d16_Rd11_AGain: return "AGain";
whismanoid 53:3d5a3d241a5e 1285 case CMD_0100_1000_d16_Wr12_BGain: return "BGain";
whismanoid 53:3d5a3d241a5e 1286 case CMD_0100_1010_d16_Rd12_BGain: return "BGain";
whismanoid 53:3d5a3d241a5e 1287 case CMD_0100_1100_d16_Wr13_CGain: return "CGain";
whismanoid 53:3d5a3d241a5e 1288 case CMD_0100_1110_d16_Rd13_CGain: return "CGain";
whismanoid 53:3d5a3d241a5e 1289 case CMD_0101_0000_d16_Wr14_DGain: return "DGain";
whismanoid 53:3d5a3d241a5e 1290 case CMD_0101_0010_d16_Rd14_DGain: return "DGain";
whismanoid 53:3d5a3d241a5e 1291 case CMD_0101_0100_d8_Wr15_FilterCAddress: return "FilterCAddress";
whismanoid 53:3d5a3d241a5e 1292 case CMD_0101_0110_d8_Rd15_FilterCAddress: return "FilterCAddress";
whismanoid 53:3d5a3d241a5e 1293 case CMD_0101_1000_d32_Wr16_FilterCDataOut: return "FilterCDataOut";
whismanoid 53:3d5a3d241a5e 1294 case CMD_0101_1010_d32_Rd16_FilterCDataOut: return "FilterCDataOut";
whismanoid 53:3d5a3d241a5e 1295 case CMD_0101_1100_d32_Wr17_FilterCDataIn: return "FilterCDataIn";
whismanoid 53:3d5a3d241a5e 1296 case CMD_0101_1110_d32_Rd17_FilterCDataIn: return "FilterCDataIn";
whismanoid 53:3d5a3d241a5e 1297 case CMD_0110_0000_d8_Wr18_FlashMode: return "FlashMode";
whismanoid 53:3d5a3d241a5e 1298 case CMD_0110_0010_d8_Rd18_FlashMode: return "FlashMode";
whismanoid 53:3d5a3d241a5e 1299 case CMD_0110_0100_d16_Wr19_FlashAddr: return "FlashAddr";
whismanoid 53:3d5a3d241a5e 1300 case CMD_0110_0110_d16_Rd19_FlashAddr: return "FlashAddr";
whismanoid 53:3d5a3d241a5e 1301 case CMD_0110_1000_d16_Wr1A_FlashDataIn: return "FlashDataIn";
whismanoid 53:3d5a3d241a5e 1302 case CMD_0110_1010_d16_Rd1A_FlashDataIn: return "FlashDataIn";
whismanoid 53:3d5a3d241a5e 1303 case CMD_0110_1110_d16_Rd1B_FlashDataOut: return "FlashDataOut";
whismanoid 53:3d5a3d241a5e 1304 }
whismanoid 53:3d5a3d241a5e 1305 }
whismanoid 53:3d5a3d241a5e 1306
whismanoid 59:47538bcf6cda 1307 //----------------------------------------
whismanoid 64:a667cfd83492 1308 // Menu item '$' -> adca, adcb, adcc, adcd
whismanoid 64:a667cfd83492 1309 // Read ADCabcd
whismanoid 64:a667cfd83492 1310 //
whismanoid 64:a667cfd83492 1311 // @return 1 on success; 0 on failure
whismanoid 64:a667cfd83492 1312 uint8_t MAX11043::Read_ADCabcd(void)
whismanoid 64:a667cfd83492 1313 {
whismanoid 64:a667cfd83492 1314
whismanoid 64:a667cfd83492 1315 //----------------------------------------
whismanoid 64:a667cfd83492 1316 // warning -- WIP work in progress
whismanoid 64:a667cfd83492 1317 #warning "Not Tested Yet: MAX11043::Read_ADCabcd..."
whismanoid 64:a667cfd83492 1318
whismanoid 69:989e392cf635 1319 //--------------------------------------------------
whismanoid 69:989e392cf635 1320 // MAX11043 ADC Read operations must be synchronized to EOC End Of Conversion
whismanoid 69:989e392cf635 1321 // EOC# asserts low when new data is available.
whismanoid 69:989e392cf635 1322 // Initiate a data read prior to the next rising edge of EOC# or the result is overwritten.
whismanoid 69:989e392cf635 1323 #if MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 1324 // MAX11043 EOC End Of Conversion input should be InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 1325 // Workaround using DigitalIn(PinName:EOC_pin) polled to sync with EOC falling edge for ADC reads
whismanoid 69:989e392cf635 1326 // 2020-02-20 MAX11043_EOC_INTERRUPT_POLLING works on MAX32625MBED at 9us conversion rate, with 1us timing margin
whismanoid 69:989e392cf635 1327 // TODO: poll m_EOC_pin if CONVRUN is high
whismanoid 69:989e392cf635 1328 if (m_CONVRUN_pin)
whismanoid 69:989e392cf635 1329 {
whismanoid 69:989e392cf635 1330 #warning "MAX11043::Read_ADCabcd() Potential infinite loop if EOC pin not connected"
whismanoid 69:989e392cf635 1331 // possible infinite loop; need a timeout or futility countdown to escape
whismanoid 69:989e392cf635 1332 for (int futility_countdown = 100;
whismanoid 69:989e392cf635 1333 ((futility_countdown > 0) &&
whismanoid 69:989e392cf635 1334 (m_EOC_pin != 1));
whismanoid 69:989e392cf635 1335 futility_countdown--)
whismanoid 69:989e392cf635 1336 {
whismanoid 69:989e392cf635 1337 // spinlock waiting for logic high pin state (start of new conversion)
whismanoid 69:989e392cf635 1338 }
whismanoid 69:989e392cf635 1339 for (int futility_countdown = 100;
whismanoid 69:989e392cf635 1340 ((futility_countdown > 0) &&
whismanoid 69:989e392cf635 1341 (m_EOC_pin != 0));
whismanoid 69:989e392cf635 1342 futility_countdown--)
whismanoid 69:989e392cf635 1343 {
whismanoid 69:989e392cf635 1344 // spinlock waiting for logic low pin state (new data is available)
whismanoid 69:989e392cf635 1345 }
whismanoid 69:989e392cf635 1346 }
whismanoid 69:989e392cf635 1347 else
whismanoid 69:989e392cf635 1348 {
whismanoid 69:989e392cf635 1349 // CONVRUN pin is being driven low, so conversion result will not change, EOC# remains high
whismanoid 69:989e392cf635 1350 }
whismanoid 69:989e392cf635 1351 #else // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 1352 // MAX11043 EOC End Of Conversion input is InterruptIn(PinName:EOC_pin).fall(onEOCFallingEdge);
whismanoid 69:989e392cf635 1353 #endif // MAX11043_EOC_INTERRUPT_POLLING
whismanoid 69:989e392cf635 1354 //--------------------------------------------------
whismanoid 69:989e392cf635 1355
whismanoid 64:a667cfd83492 1356 //----------------------------------------
whismanoid 64:a667cfd83492 1357 // read register ADCabcd -> &adca, &adcb, &adcc, &adcd
whismanoid 64:a667cfd83492 1358 RegRead(CMD_0001_1010_d16o8_d16o8_d16o8_d16o8_Rd06_ADCabcd, 0);
whismanoid 64:a667cfd83492 1359
whismanoid 64:a667cfd83492 1360 //----------------------------------------
whismanoid 64:a667cfd83492 1361 // success
whismanoid 64:a667cfd83492 1362 return 1;
whismanoid 64:a667cfd83492 1363 }
whismanoid 64:a667cfd83492 1364
whismanoid 64:a667cfd83492 1365 //----------------------------------------
whismanoid 66:3fe92f6f1cfa 1366 // Menu item 'GA'
whismanoid 64:a667cfd83492 1367 // Write AGain register
whismanoid 64:a667cfd83492 1368 //
whismanoid 64:a667cfd83492 1369 // @param[in] gain 2's complement, 0x800=0.25V/V, 0x1000=0.5V/V, 0x2000=1VV/V, 0x4000=2V/V, default=0x2000
whismanoid 64:a667cfd83492 1370 //
whismanoid 64:a667cfd83492 1371 // @return 1 on success; 0 on failure
whismanoid 64:a667cfd83492 1372 uint8_t MAX11043::Write_AGain(uint32_t gain)
whismanoid 64:a667cfd83492 1373 {
whismanoid 64:a667cfd83492 1374
whismanoid 64:a667cfd83492 1375 //----------------------------------------
whismanoid 64:a667cfd83492 1376 // warning -- WIP work in progress
whismanoid 64:a667cfd83492 1377 #warning "Not Tested Yet: MAX11043::Write_AGain..."
whismanoid 64:a667cfd83492 1378
whismanoid 64:a667cfd83492 1379 //----------------------------------------
whismanoid 64:a667cfd83492 1380 // write register
whismanoid 64:a667cfd83492 1381 RegWrite(CMD_0100_0100_d16_Wr11_AGain, gain);
whismanoid 64:a667cfd83492 1382
whismanoid 64:a667cfd83492 1383 //----------------------------------------
whismanoid 64:a667cfd83492 1384 // success
whismanoid 64:a667cfd83492 1385 return 1;
whismanoid 64:a667cfd83492 1386 }
whismanoid 64:a667cfd83492 1387
whismanoid 64:a667cfd83492 1388 //----------------------------------------
whismanoid 59:47538bcf6cda 1389 // Menu item 'XX'
whismanoid 59:47538bcf6cda 1390 //
whismanoid 59:47538bcf6cda 1391 // @return 1 on success; 0 on failure
whismanoid 59:47538bcf6cda 1392 uint8_t MAX11043::Configure_XXXXX(uint8_t linef, uint8_t rate)
whismanoid 59:47538bcf6cda 1393 {
whismanoid 59:47538bcf6cda 1394
whismanoid 59:47538bcf6cda 1395 //----------------------------------------
whismanoid 59:47538bcf6cda 1396 // warning -- WIP work in progress
whismanoid 59:47538bcf6cda 1397 #warning "Not Tested Yet: MAX11043::Configure_XXXXX..."
whismanoid 59:47538bcf6cda 1398
whismanoid 59:47538bcf6cda 1399 //----------------------------------------
whismanoid 59:47538bcf6cda 1400 // read register
whismanoid 59:47538bcf6cda 1401 RegRead(CMD_0000_0010_d16o8_Rd00_ADCa, &adca);
whismanoid 59:47538bcf6cda 1402
whismanoid 59:47538bcf6cda 1403 //----------------------------------------
whismanoid 59:47538bcf6cda 1404 // success
whismanoid 59:47538bcf6cda 1405 return 1;
whismanoid 59:47538bcf6cda 1406 }
whismanoid 59:47538bcf6cda 1407
whismanoid 59:47538bcf6cda 1408 //----------------------------------------
whismanoid 59:47538bcf6cda 1409 // Menu item 'XY'
whismanoid 59:47538bcf6cda 1410 //
whismanoid 59:47538bcf6cda 1411 // @return 1 on success; 0 on failure
whismanoid 59:47538bcf6cda 1412 uint8_t MAX11043::Configure_XXXXY(uint8_t linef, uint8_t rate)
whismanoid 59:47538bcf6cda 1413 {
whismanoid 59:47538bcf6cda 1414
whismanoid 59:47538bcf6cda 1415 //----------------------------------------
whismanoid 59:47538bcf6cda 1416 // warning -- WIP work in progress
whismanoid 59:47538bcf6cda 1417 #warning "Not Tested Yet: MAX11043::Configure_XXXXY..."
whismanoid 59:47538bcf6cda 1418
whismanoid 59:47538bcf6cda 1419 //----------------------------------------
whismanoid 59:47538bcf6cda 1420 // read register
whismanoid 59:47538bcf6cda 1421 RegRead(CMD_0001_1110_d8_Rd07_Status, &status);
whismanoid 59:47538bcf6cda 1422
whismanoid 59:47538bcf6cda 1423 //----------------------------------------
whismanoid 59:47538bcf6cda 1424 // success
whismanoid 59:47538bcf6cda 1425 return 1;
whismanoid 59:47538bcf6cda 1426 }
whismanoid 59:47538bcf6cda 1427
whismanoid 53:3d5a3d241a5e 1428
whismanoid 53:3d5a3d241a5e 1429 // End of file