Maxim Integrated MAX5715 12-bit 4-channel voltage-output DAC
Dependents: MAX5715BOB_Tester MAX5715BOB_12bit_4ch_SPI_DAC MAX5715BOB_Serial_Tester
MAX5715.h@0:777851395940, 2019-05-23 (annotated)
- Committer:
- whismanoid
- Date:
- Thu May 23 22:18:03 2019 +0000
- Revision:
- 0:777851395940
- Child:
- 1:7a5d38577aa1
equivalent to unpublished lib MAX5715 8:ae93fe5
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
whismanoid | 0:777851395940 | 1 | // /******************************************************************************* |
whismanoid | 0:777851395940 | 2 | // * Copyright (C) 2019 Maxim Integrated Products, Inc., All Rights Reserved. |
whismanoid | 0:777851395940 | 3 | // * |
whismanoid | 0:777851395940 | 4 | // * Permission is hereby granted, free of charge, to any person obtaining a |
whismanoid | 0:777851395940 | 5 | // * copy of this software and associated documentation files (the "Software"), |
whismanoid | 0:777851395940 | 6 | // * to deal in the Software without restriction, including without limitation |
whismanoid | 0:777851395940 | 7 | // * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
whismanoid | 0:777851395940 | 8 | // * and/or sell copies of the Software, and to permit persons to whom the |
whismanoid | 0:777851395940 | 9 | // * Software is furnished to do so, subject to the following conditions: |
whismanoid | 0:777851395940 | 10 | // * |
whismanoid | 0:777851395940 | 11 | // * The above copyright notice and this permission notice shall be included |
whismanoid | 0:777851395940 | 12 | // * in all copies or substantial portions of the Software. |
whismanoid | 0:777851395940 | 13 | // * |
whismanoid | 0:777851395940 | 14 | // * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
whismanoid | 0:777851395940 | 15 | // * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
whismanoid | 0:777851395940 | 16 | // * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
whismanoid | 0:777851395940 | 17 | // * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES |
whismanoid | 0:777851395940 | 18 | // * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
whismanoid | 0:777851395940 | 19 | // * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
whismanoid | 0:777851395940 | 20 | // * OTHER DEALINGS IN THE SOFTWARE. |
whismanoid | 0:777851395940 | 21 | // * |
whismanoid | 0:777851395940 | 22 | // * Except as contained in this notice, the name of Maxim Integrated |
whismanoid | 0:777851395940 | 23 | // * Products, Inc. shall not be used except as stated in the Maxim Integrated |
whismanoid | 0:777851395940 | 24 | // * Products, Inc. Branding Policy. |
whismanoid | 0:777851395940 | 25 | // * |
whismanoid | 0:777851395940 | 26 | // * The mere transfer of this software does not imply any licenses |
whismanoid | 0:777851395940 | 27 | // * of trade secrets, proprietary technology, copyrights, patents, |
whismanoid | 0:777851395940 | 28 | // * trademarks, maskwork rights, or any other form of intellectual |
whismanoid | 0:777851395940 | 29 | // * property whatsoever. Maxim Integrated Products, Inc. retains all |
whismanoid | 0:777851395940 | 30 | // * ownership rights. |
whismanoid | 0:777851395940 | 31 | // ******************************************************************************* |
whismanoid | 0:777851395940 | 32 | // */ |
whismanoid | 0:777851395940 | 33 | // ********************************************************************* |
whismanoid | 0:777851395940 | 34 | // @file MAX5715.h |
whismanoid | 0:777851395940 | 35 | // ********************************************************************* |
whismanoid | 0:777851395940 | 36 | // Header file |
whismanoid | 0:777851395940 | 37 | // DO NOT EDIT; except areas designated "CUSTOMIZE". Automatically generated file. |
whismanoid | 0:777851395940 | 38 | // generated by XMLSystemOfDevicesToMBED.py |
whismanoid | 0:777851395940 | 39 | // System Name = ExampleSystem |
whismanoid | 0:777851395940 | 40 | // System Description = Device driver example |
whismanoid | 0:777851395940 | 41 | // Device Name = MAX5715 |
whismanoid | 0:777851395940 | 42 | // Device Description = Ultra-Small, 12-Bit, 4-Channel, Buffered Output Voltage DAC with Internal Reference and SPI Interface |
whismanoid | 0:777851395940 | 43 | // Device Manufacturer = Maxim Integrated |
whismanoid | 0:777851395940 | 44 | // Device PartNumber = MAX5715AAUD+ |
whismanoid | 0:777851395940 | 45 | // Device RegValue_Width = DataWidth16bit_HL |
whismanoid | 0:777851395940 | 46 | // |
whismanoid | 0:777851395940 | 47 | // DAC NumChannels = 4 |
whismanoid | 0:777851395940 | 48 | // DAC ResolutionBits = 12 |
whismanoid | 0:777851395940 | 49 | // |
whismanoid | 0:777851395940 | 50 | // SPI CS = ActiveLow |
whismanoid | 0:777851395940 | 51 | // SPI FrameStart = CS |
whismanoid | 0:777851395940 | 52 | // SPI CPOL = 1 |
whismanoid | 0:777851395940 | 53 | // SPI CPHA = 0 |
whismanoid | 0:777851395940 | 54 | // SPI MOSI and MISO Data are both stable on Falling edge of SCLK |
whismanoid | 0:777851395940 | 55 | // SPI SCLK Idle High |
whismanoid | 0:777851395940 | 56 | // SPI SCLKMaxMHz = 50 |
whismanoid | 0:777851395940 | 57 | // SPI SCLKMinMHz = 0 |
whismanoid | 0:777851395940 | 58 | // |
whismanoid | 0:777851395940 | 59 | |
whismanoid | 0:777851395940 | 60 | |
whismanoid | 0:777851395940 | 61 | // Prevent multiple declaration |
whismanoid | 0:777851395940 | 62 | #ifndef __MAX5715_H__ |
whismanoid | 0:777851395940 | 63 | #define __MAX5715_H__ |
whismanoid | 0:777851395940 | 64 | |
whismanoid | 0:777851395940 | 65 | #include "mbed.h" |
whismanoid | 0:777851395940 | 66 | |
whismanoid | 0:777851395940 | 67 | // CODE GENERATOR: conditional defines |
whismanoid | 0:777851395940 | 68 | // CODE GENERATOR: class declaration and docstrings |
whismanoid | 0:777851395940 | 69 | /** |
whismanoid | 0:777851395940 | 70 | * @brief MAX5715 Ultra-Small, 12-Bit, 4-Channel, Buffered Output Voltage DAC with Internal Reference and SPI Interface |
whismanoid | 0:777851395940 | 71 | * |
whismanoid | 0:777851395940 | 72 | * //---------- CODE GENERATOR: testMainCppCodeList |
whismanoid | 0:777851395940 | 73 | * @code |
whismanoid | 0:777851395940 | 74 | * // CODE GENERATOR: example code includes |
whismanoid | 0:777851395940 | 75 | * // example code includes |
whismanoid | 0:777851395940 | 76 | * #include "mbed.h" |
whismanoid | 0:777851395940 | 77 | * //#include "max32625.h" |
whismanoid | 0:777851395940 | 78 | * #include "MAX5715.h" |
whismanoid | 0:777851395940 | 79 | * |
whismanoid | 0:777851395940 | 80 | * // optional: serial port |
whismanoid | 0:777851395940 | 81 | * // note: some platforms such as Nucleo-F446RE do not support the USBSerial library. |
whismanoid | 0:777851395940 | 82 | * // In those cases, remove the USBDevice lib from the project and rebuild. |
whismanoid | 0:777851395940 | 83 | * #if defined(TARGET_MAX32625MBED) |
whismanoid | 0:777851395940 | 84 | * #include "USBSerial.h" |
whismanoid | 0:777851395940 | 85 | * USBSerial serial; // virtual serial port over USB (DEV connector) |
whismanoid | 0:777851395940 | 86 | * #elif defined(TARGET_MAX32630MBED) |
whismanoid | 0:777851395940 | 87 | * #include "USBSerial.h" |
whismanoid | 0:777851395940 | 88 | * USBSerial serial; // virtual serial port over USB (DEV connector) |
whismanoid | 0:777851395940 | 89 | * #else |
whismanoid | 0:777851395940 | 90 | * //#include "USBSerial.h" |
whismanoid | 0:777851395940 | 91 | * Serial serial(USBTX, USBRX); // tx, rx |
whismanoid | 0:777851395940 | 92 | * #endif |
whismanoid | 0:777851395940 | 93 | * |
whismanoid | 0:777851395940 | 94 | * // example code board support |
whismanoid | 0:777851395940 | 95 | * //MAX32630FTHR pegasus(MAX32630FTHR::VIO_3V3); |
whismanoid | 0:777851395940 | 96 | * //DigitalOut rLED(LED1); |
whismanoid | 0:777851395940 | 97 | * //DigitalOut gLED(LED2); |
whismanoid | 0:777851395940 | 98 | * //DigitalOut bLED(LED3); |
whismanoid | 0:777851395940 | 99 | * // |
whismanoid | 0:777851395940 | 100 | * // Arduino "shield" connector port definitions (MAX32625MBED shown) |
whismanoid | 0:777851395940 | 101 | * #if defined(TARGET_MAX32625MBED) |
whismanoid | 0:777851395940 | 102 | * #define A0 AIN_0 |
whismanoid | 0:777851395940 | 103 | * #define A1 AIN_1 |
whismanoid | 0:777851395940 | 104 | * #define A2 AIN_2 |
whismanoid | 0:777851395940 | 105 | * #define A3 AIN_3 |
whismanoid | 0:777851395940 | 106 | * #define D0 P0_0 |
whismanoid | 0:777851395940 | 107 | * #define D1 P0_1 |
whismanoid | 0:777851395940 | 108 | * #define D2 P0_2 |
whismanoid | 0:777851395940 | 109 | * #define D3 P0_3 |
whismanoid | 0:777851395940 | 110 | * #define D4 P0_4 |
whismanoid | 0:777851395940 | 111 | * #define D5 P0_5 |
whismanoid | 0:777851395940 | 112 | * #define D6 P0_6 |
whismanoid | 0:777851395940 | 113 | * #define D7 P0_7 |
whismanoid | 0:777851395940 | 114 | * #define D8 P1_4 |
whismanoid | 0:777851395940 | 115 | * #define D9 P1_5 |
whismanoid | 0:777851395940 | 116 | * #define D10 P1_3 |
whismanoid | 0:777851395940 | 117 | * #define D11 P1_1 |
whismanoid | 0:777851395940 | 118 | * #define D12 P1_2 |
whismanoid | 0:777851395940 | 119 | * #define D13 P1_0 |
whismanoid | 0:777851395940 | 120 | * #endif |
whismanoid | 0:777851395940 | 121 | * |
whismanoid | 0:777851395940 | 122 | * // example code declare SPI interface |
whismanoid | 0:777851395940 | 123 | * #if defined(TARGET_MAX32625MBED) |
whismanoid | 0:777851395940 | 124 | * SPI spi(SPI1_MOSI, SPI1_MISO, SPI1_SCK); // mosi, miso, sclk spi1 TARGET_MAX32625MBED: P1_1 P1_2 P1_0 Arduino 10-pin header D11 D12 D13 |
whismanoid | 0:777851395940 | 125 | * DigitalOut spi_cs(SPI1_SS); // TARGET_MAX32625MBED: P1_3 Arduino 10-pin header D10 |
whismanoid | 0:777851395940 | 126 | * #elif defined(TARGET_MAX32600MBED) |
whismanoid | 0:777851395940 | 127 | * SPI spi(SPI2_MOSI, SPI2_MISO, SPI2_SCK); // mosi, miso, sclk spi1 TARGET_MAX32600MBED: Arduino 10-pin header D11 D12 D13 |
whismanoid | 0:777851395940 | 128 | * DigitalOut spi_cs(SPI2_SS); // Generic: Arduino 10-pin header D10 |
whismanoid | 0:777851395940 | 129 | * #else |
whismanoid | 0:777851395940 | 130 | * SPI spi(D11, D12, D13); // mosi, miso, sclk spi1 TARGET_MAX32600MBED: Arduino 10-pin header D11 D12 D13 |
whismanoid | 0:777851395940 | 131 | * DigitalOut spi_cs(D10); // Generic: Arduino 10-pin header D10 |
whismanoid | 0:777851395940 | 132 | * #endif |
whismanoid | 0:777851395940 | 133 | * |
whismanoid | 0:777851395940 | 134 | * // example code declare GPIO interface pins |
whismanoid | 0:777851395940 | 135 | * DigitalOut LDACb_pin(D9); // Digital Trigger Input to MAX5715 device |
whismanoid | 0:777851395940 | 136 | * DigitalOut CLRb_pin(D8); // Digital Trigger Input to MAX5715 device |
whismanoid | 0:777851395940 | 137 | * // AnalogOut REF_pin(Px_x_PortName_To_Be_Determined); // Reference Input to MAX5715 device |
whismanoid | 0:777851395940 | 138 | * // AnalogIn OUTA_pin(A0); // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 139 | * // AnalogIn OUTB_pin(A1); // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 140 | * // AnalogIn OUTC_pin(A2); // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 141 | * // AnalogIn OUTD_pin(A3); // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 142 | * // DigitalIn RDYb_pin(Px_x_PortName_To_Be_Determined); // Digital MAX5715 Output from MAX5715 device |
whismanoid | 0:777851395940 | 143 | * // example code declare device instance |
whismanoid | 0:777851395940 | 144 | * MAX5715 g_MAX5715_device(spi, spi_cs, LDACb_pin, CLRb_pin, MAX5715::MAX5715_IC); |
whismanoid | 0:777851395940 | 145 | * |
whismanoid | 0:777851395940 | 146 | * // example code main function |
whismanoid | 0:777851395940 | 147 | * int main() |
whismanoid | 0:777851395940 | 148 | * { |
whismanoid | 0:777851395940 | 149 | * while (1) |
whismanoid | 0:777851395940 | 150 | * { |
whismanoid | 0:777851395940 | 151 | * // example code: serial port banner message |
whismanoid | 0:777851395940 | 152 | * #if defined(TARGET_MAX32625MBED) |
whismanoid | 0:777851395940 | 153 | * serial.printf("MAX32625MBED "); |
whismanoid | 0:777851395940 | 154 | * #elif defined(TARGET_MAX32600MBED) |
whismanoid | 0:777851395940 | 155 | * serial.printf("MAX32600MBED "); |
whismanoid | 0:777851395940 | 156 | * #elif defined(TARGET_NUCLEO_F446RE) |
whismanoid | 0:777851395940 | 157 | * serial.printf("NUCLEO_F446RE "); |
whismanoid | 0:777851395940 | 158 | * #endif |
whismanoid | 0:777851395940 | 159 | * serial.printf("MAX5715BOB\r\n"); |
whismanoid | 0:777851395940 | 160 | * |
whismanoid | 0:777851395940 | 161 | * //MAX5715 dac(spi, spi_cs, MAX5715::MAX5715_IC); |
whismanoid | 0:777851395940 | 162 | * //dac.Init(); |
whismanoid | 0:777851395940 | 163 | * |
whismanoid | 0:777851395940 | 164 | * // CODE GENERATOR: example code: member function Init |
whismanoid | 0:777851395940 | 165 | * g_MAX5715_device.Init(); |
whismanoid | 0:777851395940 | 166 | * |
whismanoid | 0:777851395940 | 167 | * // CODE GENERATOR: example code: member function REF |
whismanoid | 0:777851395940 | 168 | * // CODE GENERATOR: example code: device has enumType 'MAX5715_REF_enum_t' |
whismanoid | 0:777851395940 | 169 | * // CODE GENERATOR: TypedefEnum_MAXxxxxx_REF_enum_t_NamesList: REF_EXT, REF_2V500, REF_2V048, REF_4V096, REF_AlwaysOn_EXT, REF_AlwaysOn_2V500, REF_AlwaysOn_2V048, REF_AlwaysOn_4V096 |
whismanoid | 0:777851395940 | 170 | * g_MAX5715_device.REF(MAX5715::REF_AlwaysOn_2V500); |
whismanoid | 0:777851395940 | 171 | * |
whismanoid | 0:777851395940 | 172 | * // CODE GENERATOR: example code: has no member function CODE_LOAD |
whismanoid | 0:777851395940 | 173 | * // CODE GENERATOR: example code: member function CODEallLOADall |
whismanoid | 0:777851395940 | 174 | * //uint16_t code = 4095; |
whismanoid | 0:777851395940 | 175 | * //g_MAX5715_device.CODEallLOADall(code); |
whismanoid | 0:777851395940 | 176 | * |
whismanoid | 0:777851395940 | 177 | * // CODE GENERATOR: example code: member function CODEnLOADn |
whismanoid | 0:777851395940 | 178 | * // |
whismanoid | 0:777851395940 | 179 | * uint16_t ch = 0; |
whismanoid | 0:777851395940 | 180 | * uint16_t code = 0xccc; |
whismanoid | 0:777851395940 | 181 | * g_MAX5715_device.CODEnLOADn(ch, code); |
whismanoid | 0:777851395940 | 182 | * // |
whismanoid | 0:777851395940 | 183 | * ch = 1; |
whismanoid | 0:777851395940 | 184 | * code = 0x800; |
whismanoid | 0:777851395940 | 185 | * g_MAX5715_device.CODEnLOADn(ch, code); |
whismanoid | 0:777851395940 | 186 | * // |
whismanoid | 0:777851395940 | 187 | * ch = 2; |
whismanoid | 0:777851395940 | 188 | * code = 0x666; |
whismanoid | 0:777851395940 | 189 | * g_MAX5715_device.CODEnLOADn(ch, code); |
whismanoid | 0:777851395940 | 190 | * // |
whismanoid | 0:777851395940 | 191 | * ch = 3; |
whismanoid | 0:777851395940 | 192 | * code = 0xFFF; |
whismanoid | 0:777851395940 | 193 | * g_MAX5715_device.CODEnLOADn(ch, code); |
whismanoid | 0:777851395940 | 194 | * |
whismanoid | 0:777851395940 | 195 | * // CODE GENERATOR: example code: has no member function ScanManual |
whismanoid | 0:777851395940 | 196 | * // CODE GENERATOR: example code: has no member function ReadAINcode |
whismanoid | 0:777851395940 | 197 | * wait(3.0); |
whismanoid | 0:777851395940 | 198 | * } |
whismanoid | 0:777851395940 | 199 | * } |
whismanoid | 0:777851395940 | 200 | * @endcode |
whismanoid | 0:777851395940 | 201 | * //---------- CODE GENERATOR: end testMainCppCodeList |
whismanoid | 0:777851395940 | 202 | */ |
whismanoid | 0:777851395940 | 203 | class MAX5715 { |
whismanoid | 0:777851395940 | 204 | public: |
whismanoid | 0:777851395940 | 205 | // CODE GENERATOR: TypedefEnum EnumItem declarations |
whismanoid | 0:777851395940 | 206 | // CODE GENERATOR: TypedefEnum MAX5715_CMD_enum_t |
whismanoid | 0:777851395940 | 207 | //---------------------------------------- |
whismanoid | 0:777851395940 | 208 | /// Command Codes (first byte) |
whismanoid | 0:777851395940 | 209 | /// |
whismanoid | 0:777851395940 | 210 | /// Naming convention is CMD_bitstream_FUNCTION_NAME |
whismanoid | 0:777851395940 | 211 | /// - nnnn = channel selection |
whismanoid | 0:777851395940 | 212 | /// - dcba = channel bitmask |
whismanoid | 0:777851395940 | 213 | /// - dddd_dddd_dddd = data field |
whismanoid | 0:777851395940 | 214 | /// - xxxx = don't care |
whismanoid | 0:777851395940 | 215 | typedef enum MAX5715_CMD_enum_t { |
whismanoid | 0:777851395940 | 216 | CMD_0000_nnnn_dddd_dddd_dddd_0000_CODEn = 0x00, //!< 8'b00000000 |
whismanoid | 0:777851395940 | 217 | CMD_0001_nnnn_0000_0000_0000_0000_LOADn = 0x10, //!< 8'b00010000 |
whismanoid | 0:777851395940 | 218 | CMD_0010_nnnn_dddd_dddd_dddd_0000_CODEnLOADall = 0x20, //!< 8'b00100000 |
whismanoid | 0:777851395940 | 219 | CMD_0011_nnnn_dddd_dddd_dddd_0000_CODEnLOADn = 0x30, //!< 8'b00110000 |
whismanoid | 0:777851395940 | 220 | CMD_0100_0000_0000_dcba_0000_0000_POWERn_Normal = 0x40, //!< 8'b01000000 |
whismanoid | 0:777851395940 | 221 | CMD_0100_0001_0000_dcba_0000_0000_POWERn_PD1k = 0x41, //!< 8'b01000001 |
whismanoid | 0:777851395940 | 222 | CMD_0100_0010_0000_dcba_0000_0000_POWERn_PD100k = 0x42, //!< 8'b01000010 |
whismanoid | 0:777851395940 | 223 | CMD_0100_0011_0000_dcba_0000_0000_POWERn_PDHiZ = 0x43, //!< 8'b01000011 |
whismanoid | 0:777851395940 | 224 | CMD_0101_0000_0000_0000_0000_0000_SW_CLEAR = 0x50, //!< 8'b01010000 |
whismanoid | 0:777851395940 | 225 | CMD_0101_0001_0000_0000_0000_0000_SW_RESET = 0x51, //!< 8'b01010001 |
whismanoid | 0:777851395940 | 226 | CMD_0110_0000_0000_dcba_0000_0000_CONFIGn_LATCHED = 0x60, //!< 8'b01100000 |
whismanoid | 0:777851395940 | 227 | CMD_0110_0001_0000_dcba_0000_0000_CONFIGn_TRANSPARENT = 0x61, //!< 8'b01100001 |
whismanoid | 0:777851395940 | 228 | CMD_0110_1000_0000_0000_0000_0000_CONFIGall_LATCHED = 0x68, //!< 8'b01101000 |
whismanoid | 0:777851395940 | 229 | CMD_0110_1001_0000_0000_0000_0000_CONFIGall_TRANSPARENT = 0x69, //!< 8'b01101001 |
whismanoid | 0:777851395940 | 230 | CMD_0111_0000_0000_0000_0000_0000_REF_EXT = 0x70, //!< 8'b01110000 |
whismanoid | 0:777851395940 | 231 | CMD_0111_0001_0000_0000_0000_0000_REF_2V500 = 0x71, //!< 8'b01110001 |
whismanoid | 0:777851395940 | 232 | CMD_0111_0010_0000_0000_0000_0000_REF_2V048 = 0x72, //!< 8'b01110010 |
whismanoid | 0:777851395940 | 233 | CMD_0111_0011_0000_0000_0000_0000_REF_4V096 = 0x73, //!< 8'b01110011 |
whismanoid | 0:777851395940 | 234 | CMD_0111_0100_0000_0000_0000_0000_REF_AlwaysOn_EXT = 0x74, //!< 8'b01110100 |
whismanoid | 0:777851395940 | 235 | CMD_0111_0101_0000_0000_0000_0000_REF_AlwaysOn_2V500 = 0x75, //!< 8'b01110101 |
whismanoid | 0:777851395940 | 236 | CMD_0111_0110_0000_0000_0000_0000_REF_AlwaysOn_2V048 = 0x76, //!< 8'b01110110 |
whismanoid | 0:777851395940 | 237 | CMD_0111_0111_0000_0000_0000_0000_REF_AlwaysOn_4V096 = 0x77, //!< 8'b01110111 |
whismanoid | 0:777851395940 | 238 | CMD_1000_0000_dddd_dddd_dddd_0000_CODEall = 0x80, //!< 8'b10000000 |
whismanoid | 0:777851395940 | 239 | CMD_1000_0001_0000_0000_0000_0000_LOADall = 0x81, //!< 8'b10000001 |
whismanoid | 0:777851395940 | 240 | CMD_1000_0010_dddd_dddd_dddd_0000_CODEallLOADall = 0x82, //!< 8'b10000010 |
whismanoid | 0:777851395940 | 241 | CMD_1000_0011_dddd_dddd_dddd_0000_CODEallLOADall = 0x83, //!< 8'b10000011 |
whismanoid | 0:777851395940 | 242 | CMD_1001_xxxx_NOP = 0x90, //!< 8'b10010000 |
whismanoid | 0:777851395940 | 243 | CMD_1010_xxxx_NOP = 0xa0, //!< 8'b10100000 |
whismanoid | 0:777851395940 | 244 | CMD_1011_xxxx_NOP = 0xb0, //!< 8'b10110000 |
whismanoid | 0:777851395940 | 245 | CMD_1100_xxxx_NOP = 0xc0, //!< 8'b11000000 |
whismanoid | 0:777851395940 | 246 | CMD_1101_xxxx_NOP = 0xd0, //!< 8'b11010000 |
whismanoid | 0:777851395940 | 247 | CMD_1110_xxxx_NOP = 0xe0, //!< 8'b11100000 |
whismanoid | 0:777851395940 | 248 | CMD_1111_xxxx_NOP = 0xf0, //!< 8'b11110000 |
whismanoid | 0:777851395940 | 249 | } MAX5715_CMD_enum_t; |
whismanoid | 0:777851395940 | 250 | |
whismanoid | 0:777851395940 | 251 | // CODE GENERATOR: TypedefEnum MAX5715_POWER_enum_t |
whismanoid | 0:777851395940 | 252 | //---------------------------------------- |
whismanoid | 0:777851395940 | 253 | /// Argument to POWER function |
whismanoid | 0:777851395940 | 254 | typedef enum MAX5715_POWER_enum_t { |
whismanoid | 0:777851395940 | 255 | POWERn_Normal = 0x00, //!< 8'b00000000 |
whismanoid | 0:777851395940 | 256 | POWERn_PD1k = 0x01, //!< 8'b00000001 |
whismanoid | 0:777851395940 | 257 | POWERn_PD100k = 0x02, //!< 8'b00000010 |
whismanoid | 0:777851395940 | 258 | POWERn_PDHiZ = 0x03, //!< 8'b00000011 |
whismanoid | 0:777851395940 | 259 | } MAX5715_POWER_enum_t; |
whismanoid | 0:777851395940 | 260 | |
whismanoid | 0:777851395940 | 261 | // CODE GENERATOR: TypedefEnum MAX5715_REF_enum_t |
whismanoid | 0:777851395940 | 262 | //---------------------------------------- |
whismanoid | 0:777851395940 | 263 | /// Argument to REF function ( external? voltage? always on? ) |
whismanoid | 0:777851395940 | 264 | typedef enum MAX5715_REF_enum_t { |
whismanoid | 0:777851395940 | 265 | REF_EXT = 0x00, //!< 8'b00000000 |
whismanoid | 0:777851395940 | 266 | REF_2V500 = 0x01, //!< 8'b00000001 |
whismanoid | 0:777851395940 | 267 | REF_2V048 = 0x02, //!< 8'b00000010 |
whismanoid | 0:777851395940 | 268 | REF_4V096 = 0x03, //!< 8'b00000011 |
whismanoid | 0:777851395940 | 269 | REF_AlwaysOn_EXT = 0x04, //!< 8'b00000100 |
whismanoid | 0:777851395940 | 270 | REF_AlwaysOn_2V500 = 0x05, //!< 8'b00000101 |
whismanoid | 0:777851395940 | 271 | REF_AlwaysOn_2V048 = 0x06, //!< 8'b00000110 |
whismanoid | 0:777851395940 | 272 | REF_AlwaysOn_4V096 = 0x07, //!< 8'b00000111 |
whismanoid | 0:777851395940 | 273 | } MAX5715_REF_enum_t; |
whismanoid | 0:777851395940 | 274 | |
whismanoid | 0:777851395940 | 275 | // TODO1: CODE GENERATOR: ic_variant -- IC's supported with this driver |
whismanoid | 0:777851395940 | 276 | /** |
whismanoid | 0:777851395940 | 277 | * @brief IC's supported with this driver |
whismanoid | 0:777851395940 | 278 | * @details MAX5715 |
whismanoid | 0:777851395940 | 279 | */ |
whismanoid | 0:777851395940 | 280 | typedef enum |
whismanoid | 0:777851395940 | 281 | { |
whismanoid | 0:777851395940 | 282 | MAX5715_IC = 0, |
whismanoid | 0:777851395940 | 283 | //MAX5715_IC = 1 |
whismanoid | 0:777851395940 | 284 | } MAX5715_ic_t; |
whismanoid | 0:777851395940 | 285 | |
whismanoid | 0:777851395940 | 286 | // TODO1: CODE GENERATOR: class constructor declaration |
whismanoid | 0:777851395940 | 287 | /**********************************************************//** |
whismanoid | 0:777851395940 | 288 | * @brief Constructor for MAX5715 Class. |
whismanoid | 0:777851395940 | 289 | * |
whismanoid | 0:777851395940 | 290 | * @details Requires an existing SPI object as well as a DigitalOut object. |
whismanoid | 0:777851395940 | 291 | * The DigitalOut object is used for a chip enable signal |
whismanoid | 0:777851395940 | 292 | * |
whismanoid | 0:777851395940 | 293 | * On Entry: |
whismanoid | 0:777851395940 | 294 | * @param[in] spi - pointer to existing SPI object |
whismanoid | 0:777851395940 | 295 | * @param[in] cs_pin - pointer to a DigitalOut pin object |
whismanoid | 0:777851395940 | 296 | * CODE GENERATOR: class constructor docstrings gpio InputPin pins |
whismanoid | 0:777851395940 | 297 | * @param[in] LDACb_pin - pointer to a DigitalOut pin object |
whismanoid | 0:777851395940 | 298 | * @param[in] CLRb_pin - pointer to a DigitalOut pin object |
whismanoid | 0:777851395940 | 299 | * CODE GENERATOR: class constructor docstrings gpio OutputPin pins |
whismanoid | 0:777851395940 | 300 | * @param[in] ic_variant - which type of MAX5715 is used |
whismanoid | 0:777851395940 | 301 | * |
whismanoid | 0:777851395940 | 302 | * On Exit: |
whismanoid | 0:777851395940 | 303 | * |
whismanoid | 0:777851395940 | 304 | * @return None |
whismanoid | 0:777851395940 | 305 | **************************************************************/ |
whismanoid | 0:777851395940 | 306 | MAX5715(SPI &spi, DigitalOut &cs_pin, // SPI interface |
whismanoid | 0:777851395940 | 307 | // CODE GENERATOR: class constructor declaration gpio InputPin pins |
whismanoid | 0:777851395940 | 308 | DigitalOut &LDACb_pin, // Digital Trigger Input to MAX5715 device |
whismanoid | 0:777851395940 | 309 | DigitalOut &CLRb_pin, // Digital Trigger Input to MAX5715 device |
whismanoid | 0:777851395940 | 310 | // AnalogOut &REF_pin, // Reference Input to MAX5715 device |
whismanoid | 0:777851395940 | 311 | // CODE GENERATOR: class constructor declaration gpio OutputPin pins |
whismanoid | 0:777851395940 | 312 | // AnalogIn &OUTA_pin, // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 313 | // AnalogIn &OUTB_pin, // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 314 | // AnalogIn &OUTC_pin, // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 315 | // AnalogIn &OUTD_pin, // Analog Output from MAX5715 device |
whismanoid | 0:777851395940 | 316 | // DigitalIn &RDYb_pin, // Digital MAX5715 Output from MAX5715 device |
whismanoid | 0:777851395940 | 317 | MAX5715_ic_t ic_variant); |
whismanoid | 0:777851395940 | 318 | |
whismanoid | 0:777851395940 | 319 | // CODE GENERATOR: class destructor declaration |
whismanoid | 0:777851395940 | 320 | /************************************************************ |
whismanoid | 0:777851395940 | 321 | * @brief Default destructor for MAX5715 Class. |
whismanoid | 0:777851395940 | 322 | * |
whismanoid | 0:777851395940 | 323 | * @details Destroys SPI object if owner |
whismanoid | 0:777851395940 | 324 | * |
whismanoid | 0:777851395940 | 325 | * On Entry: |
whismanoid | 0:777851395940 | 326 | * |
whismanoid | 0:777851395940 | 327 | * On Exit: |
whismanoid | 0:777851395940 | 328 | * |
whismanoid | 0:777851395940 | 329 | * @return None |
whismanoid | 0:777851395940 | 330 | **************************************************************/ |
whismanoid | 0:777851395940 | 331 | ~MAX5715(); |
whismanoid | 0:777851395940 | 332 | |
whismanoid | 0:777851395940 | 333 | // CODE GENERATOR: spi_frequency setter declaration |
whismanoid | 0:777851395940 | 334 | // set SPI SCLK frequency |
whismanoid | 0:777851395940 | 335 | void spi_frequency(int spi_sclk_Hz); |
whismanoid | 0:777851395940 | 336 | |
whismanoid | 0:777851395940 | 337 | //---------------------------------------- |
whismanoid | 0:777851395940 | 338 | // CODE GENERATOR: omit typedef enum MAX5715_device_t, class members instead of global device object |
whismanoid | 0:777851395940 | 339 | public: |
whismanoid | 0:777851395940 | 340 | |
whismanoid | 0:777851395940 | 341 | /// reference voltage, in Volts |
whismanoid | 0:777851395940 | 342 | double VRef; |
whismanoid | 0:777851395940 | 343 | |
whismanoid | 0:777851395940 | 344 | /// DAC Selection: 0=OUTA, 1=OUTB, 2=OUTC, 3=OUTD, 4..15=ALL OUTA,OUTB,OUTC,OUTD |
whismanoid | 0:777851395940 | 345 | uint8_t channelNumber_0_3; |
whismanoid | 0:777851395940 | 346 | |
whismanoid | 0:777851395940 | 347 | /// channel bitmask channel_dcba: 1=OUTA, 2=OUTB, 4=OUTC, 8=OUTD |
whismanoid | 0:777851395940 | 348 | uint8_t channels_bitmask_DCBA; |
whismanoid | 0:777851395940 | 349 | |
whismanoid | 0:777851395940 | 350 | /// shadow of write-only register CODE[channel_0_3] CMD_0010_nnnn |
whismanoid | 0:777851395940 | 351 | int16_t Shadow_0010_nnnn_CODE[4]; |
whismanoid | 0:777851395940 | 352 | |
whismanoid | 0:777851395940 | 353 | /// shadow of write-only register POWER[channel_0_3] CMD_0100_00pp |
whismanoid | 0:777851395940 | 354 | int16_t Shadow_0100_00pp_POWER[4]; |
whismanoid | 0:777851395940 | 355 | |
whismanoid | 0:777851395940 | 356 | /// shadow of write-only register CONFIG[channel_0_3] CMD_0110_a00t |
whismanoid | 0:777851395940 | 357 | int16_t Shadow_0110_a00t_CONFIG[4]; |
whismanoid | 0:777851395940 | 358 | |
whismanoid | 0:777851395940 | 359 | /// shadow of write-only register REF CMD_0111_0rrr |
whismanoid | 0:777851395940 | 360 | int16_t Shadow_0111_0rrr_REF; |
whismanoid | 0:777851395940 | 361 | |
whismanoid | 0:777851395940 | 362 | /// shadow of CODE field of write-only register CODE[channel_0_3] CMD_0010_nnnn |
whismanoid | 0:777851395940 | 363 | int16_t CODE[4]; |
whismanoid | 0:777851395940 | 364 | |
whismanoid | 0:777851395940 | 365 | // CODE GENERATOR: omit global g_MAX5715_device |
whismanoid | 0:777851395940 | 366 | |
whismanoid | 0:777851395940 | 367 | // CODE GENERATOR: extern function declarations |
whismanoid | 0:777851395940 | 368 | // CODE GENERATOR: extern function declaration SPIoutputCS |
whismanoid | 0:777851395940 | 369 | //---------------------------------------- |
whismanoid | 0:777851395940 | 370 | // Assert SPI Chip Select |
whismanoid | 0:777851395940 | 371 | // SPI chip-select for MAX5715 |
whismanoid | 0:777851395940 | 372 | // |
whismanoid | 0:777851395940 | 373 | void SPIoutputCS(int isLogicHigh); |
whismanoid | 0:777851395940 | 374 | |
whismanoid | 0:777851395940 | 375 | // CODE GENERATOR: extern function declaration SPIwrite24bits |
whismanoid | 0:777851395940 | 376 | //---------------------------------------- |
whismanoid | 0:777851395940 | 377 | // SPI write 24 bits |
whismanoid | 0:777851395940 | 378 | // SPI interface to MAX5715 shift 24 bits mosiData into MAX5715 DIN |
whismanoid | 0:777851395940 | 379 | // |
whismanoid | 0:777851395940 | 380 | void SPIwrite24bits(int8_t mosiData8_FF0000, int16_t mosiData16_00FFFF); |
whismanoid | 0:777851395940 | 381 | |
whismanoid | 0:777851395940 | 382 | // CODE GENERATOR: extern function declaration LDACboutputValue |
whismanoid | 0:777851395940 | 383 | //---------------------------------------- |
whismanoid | 0:777851395940 | 384 | // Assert MAX5715 LDAC pin : High = inactive, Low = load DAC. |
whismanoid | 0:777851395940 | 385 | // |
whismanoid | 0:777851395940 | 386 | void LDACboutputValue(int isLogicHigh); |
whismanoid | 0:777851395940 | 387 | |
whismanoid | 0:777851395940 | 388 | // CODE GENERATOR: extern function declaration CLRboutputValue |
whismanoid | 0:777851395940 | 389 | //---------------------------------------- |
whismanoid | 0:777851395940 | 390 | // Assert MAX5715 CLR pin : High = inactive, Low = clear DAC. |
whismanoid | 0:777851395940 | 391 | // |
whismanoid | 0:777851395940 | 392 | void CLRboutputValue(int isLogicHigh); |
whismanoid | 0:777851395940 | 393 | |
whismanoid | 0:777851395940 | 394 | // CODE GENERATOR: class member data |
whismanoid | 0:777851395940 | 395 | private: |
whismanoid | 0:777851395940 | 396 | // CODE GENERATOR: class member data for SPI interface |
whismanoid | 0:777851395940 | 397 | // SPI object |
whismanoid | 0:777851395940 | 398 | SPI &m_spi; |
whismanoid | 0:777851395940 | 399 | int m_SPI_SCLK_Hz; |
whismanoid | 0:777851395940 | 400 | int m_SPI_dataMode; |
whismanoid | 0:777851395940 | 401 | int m_SPI_cs_state; |
whismanoid | 0:777851395940 | 402 | |
whismanoid | 0:777851395940 | 403 | // Selector pin object |
whismanoid | 0:777851395940 | 404 | DigitalOut &m_cs_pin; |
whismanoid | 0:777851395940 | 405 | |
whismanoid | 0:777851395940 | 406 | // CODE GENERATOR: class member data for gpio InputPin pins |
whismanoid | 0:777851395940 | 407 | // InputPin Name = LDAC# |
whismanoid | 0:777851395940 | 408 | // InputPin Description = Dedicated Active-Low Asynchronous Load DAC. |
whismanoid | 0:777851395940 | 409 | // InputPin Function = Trigger |
whismanoid | 0:777851395940 | 410 | DigitalOut &m_LDACb_pin; |
whismanoid | 0:777851395940 | 411 | // |
whismanoid | 0:777851395940 | 412 | // InputPin Name = CLR# |
whismanoid | 0:777851395940 | 413 | // InputPin Description = Active-Low Clear Input. |
whismanoid | 0:777851395940 | 414 | // InputPin Function = Trigger |
whismanoid | 0:777851395940 | 415 | DigitalOut &m_CLRb_pin; |
whismanoid | 0:777851395940 | 416 | // |
whismanoid | 0:777851395940 | 417 | // InputPin Name = REF |
whismanoid | 0:777851395940 | 418 | // InputPin Description = Reference Voltage Input/Output. |
whismanoid | 0:777851395940 | 419 | // Software selectable to be external reference or internal 2.048V, 2.500V, or 4.096V reference. |
whismanoid | 0:777851395940 | 420 | // Default is external reference mode. |
whismanoid | 0:777851395940 | 421 | // InputPin Function = Reference |
whismanoid | 0:777851395940 | 422 | // AnalogOut &m_REF_pin; |
whismanoid | 0:777851395940 | 423 | // |
whismanoid | 0:777851395940 | 424 | // CODE GENERATOR: class member data for gpio OutputPin pins |
whismanoid | 0:777851395940 | 425 | // OutputPin Name = OUTA |
whismanoid | 0:777851395940 | 426 | // OutputPin Description = Buffered Channel A DAC Output |
whismanoid | 0:777851395940 | 427 | // OutputPin Function = Analog |
whismanoid | 0:777851395940 | 428 | // AnalogIn &m_OUTA_pin; |
whismanoid | 0:777851395940 | 429 | // |
whismanoid | 0:777851395940 | 430 | // OutputPin Name = OUTB |
whismanoid | 0:777851395940 | 431 | // OutputPin Description = Buffered Channel B DAC Output |
whismanoid | 0:777851395940 | 432 | // OutputPin Function = Analog |
whismanoid | 0:777851395940 | 433 | // AnalogIn &m_OUTB_pin; |
whismanoid | 0:777851395940 | 434 | // |
whismanoid | 0:777851395940 | 435 | // OutputPin Name = OUTC |
whismanoid | 0:777851395940 | 436 | // OutputPin Description = Buffered Channel C DAC Output |
whismanoid | 0:777851395940 | 437 | // OutputPin Function = Analog |
whismanoid | 0:777851395940 | 438 | // AnalogIn &m_OUTC_pin; |
whismanoid | 0:777851395940 | 439 | // |
whismanoid | 0:777851395940 | 440 | // OutputPin Name = OUTD |
whismanoid | 0:777851395940 | 441 | // OutputPin Description = Buffered Channel D DAC Output |
whismanoid | 0:777851395940 | 442 | // OutputPin Function = Analog |
whismanoid | 0:777851395940 | 443 | // AnalogIn &m_OUTD_pin; |
whismanoid | 0:777851395940 | 444 | // |
whismanoid | 0:777851395940 | 445 | // OutputPin Name = RDY# |
whismanoid | 0:777851395940 | 446 | // OutputPin Description = SPI RDY Output. In daisy-chained applications connect RDY to the CSB of the next device in the chain. |
whismanoid | 0:777851395940 | 447 | // OutputPin Function = DaisyChain |
whismanoid | 0:777851395940 | 448 | // DigitalIn &m_RDYb_pin; |
whismanoid | 0:777851395940 | 449 | // |
whismanoid | 0:777851395940 | 450 | |
whismanoid | 0:777851395940 | 451 | // Identifies which IC variant is being used |
whismanoid | 0:777851395940 | 452 | MAX5715_ic_t m_ic_variant; |
whismanoid | 0:777851395940 | 453 | |
whismanoid | 0:777851395940 | 454 | public: |
whismanoid | 0:777851395940 | 455 | |
whismanoid | 0:777851395940 | 456 | // CODE GENERATOR: class member function declarations |
whismanoid | 0:777851395940 | 457 | //---------------------------------------- |
whismanoid | 0:777851395940 | 458 | /// Initialize device |
whismanoid | 0:777851395940 | 459 | /// @return 1 on success; 0 on failure |
whismanoid | 0:777851395940 | 460 | uint8_t Init(void); |
whismanoid | 0:777851395940 | 461 | |
whismanoid | 0:777851395940 | 462 | //---------------------------------------- |
whismanoid | 0:777851395940 | 463 | /// Return the DAC register value corresponding to physical voltage. |
whismanoid | 0:777851395940 | 464 | /// Does not perform any offset or gain correction. |
whismanoid | 0:777851395940 | 465 | /// |
whismanoid | 0:777851395940 | 466 | /// @pre g_MAX5715_device.VRef = Voltage of REF input, in Volts |
whismanoid | 0:777851395940 | 467 | /// @param[in] voltage = physical voltage in Volts |
whismanoid | 0:777851395940 | 468 | /// @return raw 12-bit MAX5715 code (right justified). |
whismanoid | 0:777851395940 | 469 | uint16_t DACCodeOfVoltage(double voltageV); |
whismanoid | 0:777851395940 | 470 | |
whismanoid | 0:777851395940 | 471 | //---------------------------------------- |
whismanoid | 0:777851395940 | 472 | /// Return the physical voltage corresponding to DAC register. |
whismanoid | 0:777851395940 | 473 | /// Does not perform any offset or gain correction. |
whismanoid | 0:777851395940 | 474 | /// |
whismanoid | 0:777851395940 | 475 | /// @pre g_MAX5715_device.VRef = Voltage of REF input, in Volts |
whismanoid | 0:777851395940 | 476 | /// @param[in] value_u12: raw 12-bit MAX5715 code (right justified). |
whismanoid | 0:777851395940 | 477 | /// @return physical voltage corresponding to MAX5715 code. |
whismanoid | 0:777851395940 | 478 | double VoltageOfCode(uint16_t value_u12); |
whismanoid | 0:777851395940 | 479 | |
whismanoid | 0:777851395940 | 480 | //---------------------------------------- |
whismanoid | 0:777851395940 | 481 | /// CMD_1000_0000_dddd_dddd_dddd_0000_CODEall |
whismanoid | 0:777851395940 | 482 | /// |
whismanoid | 0:777851395940 | 483 | /// Writes data to all CODE registers |
whismanoid | 0:777851395940 | 484 | /// @post updates g_MAX5815_device.Shadow_0010_nnnn_CODE[0..3] |
whismanoid | 0:777851395940 | 485 | /// @post updates g_MAX5815_device.CODE[0..3] |
whismanoid | 0:777851395940 | 486 | void CODEall(uint16_t dacCodeLsbs); |
whismanoid | 0:777851395940 | 487 | |
whismanoid | 0:777851395940 | 488 | //---------------------------------------- |
whismanoid | 0:777851395940 | 489 | /// CMD_0000_nnnn_dddd_dddd_dddd_0000_CODEn |
whismanoid | 0:777851395940 | 490 | /// |
whismanoid | 0:777851395940 | 491 | /// Writes data to the selected CODE register(s) |
whismanoid | 0:777851395940 | 492 | /// |
whismanoid | 0:777851395940 | 493 | /// @param[in] channel_0_3 = DAC Selection: 0=OUTA, 1=OUTB, 2=OUTC, 3=OUTD, 4..15=ALL OUTA,OUTB,OUTC,OUTD |
whismanoid | 0:777851395940 | 494 | /// @post updates g_MAX5815_device.Shadow_0010_nnnn_CODE[0..3] |
whismanoid | 0:777851395940 | 495 | /// @post updates g_MAX5815_device.CODE[0..3] |
whismanoid | 0:777851395940 | 496 | void CODEn(uint8_t channel_0_3, uint16_t dacCodeLsbs); |
whismanoid | 0:777851395940 | 497 | |
whismanoid | 0:777851395940 | 498 | //---------------------------------------- |
whismanoid | 0:777851395940 | 499 | /// CMD_1000_0010_dddd_dddd_dddd_0000_CODEallLOADall |
whismanoid | 0:777851395940 | 500 | /// |
whismanoid | 0:777851395940 | 501 | /// Simultaneously writes data to all CODE registers while updating all DAC registers |
whismanoid | 0:777851395940 | 502 | /// @post updates g_MAX5815_device.Shadow_0010_nnnn_CODE[0..3] |
whismanoid | 0:777851395940 | 503 | /// @post updates g_MAX5815_device.CODE[0..3] |
whismanoid | 0:777851395940 | 504 | void CODEallLOADall(uint16_t dacCodeLsbs); |
whismanoid | 0:777851395940 | 505 | |
whismanoid | 0:777851395940 | 506 | //---------------------------------------- |
whismanoid | 0:777851395940 | 507 | /// CMD_0010_nnnn_dddd_dddd_dddd_0000_CODEnLOADall |
whismanoid | 0:777851395940 | 508 | /// |
whismanoid | 0:777851395940 | 509 | /// Simultaneously writes data to the selected CODE register(s) while updating all DAC registers. |
whismanoid | 0:777851395940 | 510 | /// |
whismanoid | 0:777851395940 | 511 | /// @param[in] channel_0_3 = DAC Selection: 0=OUTA, 1=OUTB, 2=OUTC, 3=OUTD, 4..15=ALL OUTA,OUTB,OUTC,OUTD |
whismanoid | 0:777851395940 | 512 | /// @post updates g_MAX5815_device.Shadow_0010_nnnn_CODE[0..3] |
whismanoid | 0:777851395940 | 513 | /// @post updates g_MAX5815_device.CODE[0..3] |
whismanoid | 0:777851395940 | 514 | void CODEnLOADall(uint8_t channel_0_3, uint16_t dacCodeLsbs); |
whismanoid | 0:777851395940 | 515 | |
whismanoid | 0:777851395940 | 516 | //---------------------------------------- |
whismanoid | 0:777851395940 | 517 | /// CMD_0011_nnnn_dddd_dddd_dddd_0000_CODEnLOADn |
whismanoid | 0:777851395940 | 518 | /// |
whismanoid | 0:777851395940 | 519 | /// Simultaneously writes data to the selected CODE register(s) while updating selected DAC register(s) |
whismanoid | 0:777851395940 | 520 | /// |
whismanoid | 0:777851395940 | 521 | /// @param[in] channel_0_3 = DAC Selection: 0=OUTA, 1=OUTB, 2=OUTC, 3=OUTD, 4..15=ALL OUTA,OUTB,OUTC,OUTD |
whismanoid | 0:777851395940 | 522 | /// @post updates g_MAX5815_device.Shadow_0010_nnnn_CODE[0..3] |
whismanoid | 0:777851395940 | 523 | /// @post updates g_MAX5815_device.CODE[0..3] |
whismanoid | 0:777851395940 | 524 | void CODEnLOADn(uint8_t channel_0_3, uint16_t dacCodeLsbs); |
whismanoid | 0:777851395940 | 525 | |
whismanoid | 0:777851395940 | 526 | //---------------------------------------- |
whismanoid | 0:777851395940 | 527 | /// CMD_0110_0000_0000_dcba_0000_0000_CONFIGn_LATCHED |
whismanoid | 0:777851395940 | 528 | /// |
whismanoid | 0:777851395940 | 529 | /// Sets the DAC Latch Mode of the selected DACs. |
whismanoid | 0:777851395940 | 530 | /// Only DACS with a 1 in the selection bit are updated by the command. |
whismanoid | 0:777851395940 | 531 | /// LD_EN = 0: DAC latch is operational (LOAD and LDAC controlled) |
whismanoid | 0:777851395940 | 532 | /// |
whismanoid | 0:777851395940 | 533 | /// @param[in] channels_bitmask_DCBA = channel select bitmap |
whismanoid | 0:777851395940 | 534 | /// bit 1000 = channel D |
whismanoid | 0:777851395940 | 535 | /// bit 0100 = channel C |
whismanoid | 0:777851395940 | 536 | /// bit 0010 = channel B |
whismanoid | 0:777851395940 | 537 | /// bit 0001 = channel A |
whismanoid | 0:777851395940 | 538 | void CONFIGn_LATCHED(uint8_t channels_bitmask_DCBA); |
whismanoid | 0:777851395940 | 539 | |
whismanoid | 0:777851395940 | 540 | //---------------------------------------- |
whismanoid | 0:777851395940 | 541 | /// CMD_0110_0001_0000_dcba_0000_0000_CONFIGn_TRANSPARENT |
whismanoid | 0:777851395940 | 542 | /// |
whismanoid | 0:777851395940 | 543 | /// Sets the DAC Latch Mode of the selected DACs. |
whismanoid | 0:777851395940 | 544 | /// Only DACS with a 1 in the selection bit are updated by the command. |
whismanoid | 0:777851395940 | 545 | /// LD_EN = 1: DAC latch is transparent |
whismanoid | 0:777851395940 | 546 | /// |
whismanoid | 0:777851395940 | 547 | /// @param[in] channels_bitmask_DCBA = channel select bitmap |
whismanoid | 0:777851395940 | 548 | /// bit 1000 = channel D |
whismanoid | 0:777851395940 | 549 | /// bit 0100 = channel C |
whismanoid | 0:777851395940 | 550 | /// bit 0010 = channel B |
whismanoid | 0:777851395940 | 551 | /// bit 0001 = channel A |
whismanoid | 0:777851395940 | 552 | void CONFIGn_TRANSPARENT(uint8_t channels_bitmask_DCBA); |
whismanoid | 0:777851395940 | 553 | |
whismanoid | 0:777851395940 | 554 | //---------------------------------------- |
whismanoid | 0:777851395940 | 555 | /// CMD_0110_1000_0000_0000_0000_0000_CONFIGall_LATCHED |
whismanoid | 0:777851395940 | 556 | /// |
whismanoid | 0:777851395940 | 557 | /// Sets the DAC Latch Mode of all DACs. |
whismanoid | 0:777851395940 | 558 | /// LD_EN = 0: DAC latch is operational (LOAD and LDAC controlled) |
whismanoid | 0:777851395940 | 559 | void CONFIGall_LATCHED(void); |
whismanoid | 0:777851395940 | 560 | |
whismanoid | 0:777851395940 | 561 | //---------------------------------------- |
whismanoid | 0:777851395940 | 562 | /// CMD_0110_1001_0000_0000_0000_0000_CONFIGall_TRANSPARENT |
whismanoid | 0:777851395940 | 563 | /// |
whismanoid | 0:777851395940 | 564 | /// Sets the DAC Latch Mode of all DACs. |
whismanoid | 0:777851395940 | 565 | /// LD_EN = 1: DAC latch is transparent |
whismanoid | 0:777851395940 | 566 | void CONFIGall_TRANSPARENT(void); |
whismanoid | 0:777851395940 | 567 | |
whismanoid | 0:777851395940 | 568 | //---------------------------------------- |
whismanoid | 0:777851395940 | 569 | /// CMD_1000_0001_0000_0000_0000_0000_LOADall |
whismanoid | 0:777851395940 | 570 | /// |
whismanoid | 0:777851395940 | 571 | /// Updates all DAC latches with current CODE register data |
whismanoid | 0:777851395940 | 572 | void LOADall(void); |
whismanoid | 0:777851395940 | 573 | |
whismanoid | 0:777851395940 | 574 | //---------------------------------------- |
whismanoid | 0:777851395940 | 575 | /// CMD_0001_nnnn_0000_0000_0000_0000_LOADn |
whismanoid | 0:777851395940 | 576 | /// |
whismanoid | 0:777851395940 | 577 | /// Transfers data from the selected CODE register(s) to the selected DAC register(s). |
whismanoid | 0:777851395940 | 578 | /// |
whismanoid | 0:777851395940 | 579 | /// @param[in] channel_0_3 = DAC Selection: 0=OUTA, 1=OUTB, 2=OUTC, 3=OUTD, 4..15=ALL OUTA,OUTB,OUTC,OUTD |
whismanoid | 0:777851395940 | 580 | void LOADn(uint8_t channel_0_3); |
whismanoid | 0:777851395940 | 581 | |
whismanoid | 0:777851395940 | 582 | //---------------------------------------- |
whismanoid | 0:777851395940 | 583 | /// CMD_0100_0000_0000_dcba_0000_0000_POWERn_Normal |
whismanoid | 0:777851395940 | 584 | /// |
whismanoid | 0:777851395940 | 585 | /// Sets the power mode of the selected DACs |
whismanoid | 0:777851395940 | 586 | /// (DACs selected with a 1 in the corresponding DACn bit are updated, |
whismanoid | 0:777851395940 | 587 | /// DACs with a 0 in the corresponding DACn bit are not impacted) |
whismanoid | 0:777851395940 | 588 | /// |
whismanoid | 0:777851395940 | 589 | /// @param[in] channels_bitmask_DCBA = channel select bitmap |
whismanoid | 0:777851395940 | 590 | /// bit 1000 = channel D |
whismanoid | 0:777851395940 | 591 | /// bit 0100 = channel C |
whismanoid | 0:777851395940 | 592 | /// bit 0010 = channel B |
whismanoid | 0:777851395940 | 593 | /// bit 0001 = channel A |
whismanoid | 0:777851395940 | 594 | /// @param[in] powerValue = power configuration for selected channel |
whismanoid | 0:777851395940 | 595 | void POWER(uint8_t channels_bitmask_DCBA, MAX5715_POWER_enum_t powerValue); |
whismanoid | 0:777851395940 | 596 | |
whismanoid | 0:777851395940 | 597 | //---------------------------------------- |
whismanoid | 0:777851395940 | 598 | /// CMD_0111_0000_0000_0000_0000_0000_REF_EXT |
whismanoid | 0:777851395940 | 599 | /// CMD_0111_0001_0000_0000_0000_0000_REF_2V500 |
whismanoid | 0:777851395940 | 600 | /// CMD_0111_0010_0000_0000_0000_0000_REF_2V048 |
whismanoid | 0:777851395940 | 601 | /// CMD_0111_0011_0000_0000_0000_0000_REF_4V096 |
whismanoid | 0:777851395940 | 602 | /// CMD_0111_0100_0000_0000_0000_0000_REF_AlwaysOn_EXT |
whismanoid | 0:777851395940 | 603 | /// CMD_0111_0101_0000_0000_0000_0000_REF_AlwaysOn_2V500 |
whismanoid | 0:777851395940 | 604 | /// CMD_0111_0110_0000_0000_0000_0000_REF_AlwaysOn_2V048 |
whismanoid | 0:777851395940 | 605 | /// CMD_0111_0111_0000_0000_0000_0000_REF_AlwaysOn_4V096 |
whismanoid | 0:777851395940 | 606 | /// |
whismanoid | 0:777851395940 | 607 | /// Sets the reference operating mode. |
whismanoid | 0:777851395940 | 608 | /// REF Power (B18): 0 = Internal reference is only powered if at least one DAC is powered |
whismanoid | 0:777851395940 | 609 | /// 1 = Internal reference is always powered |
whismanoid | 0:777851395940 | 610 | void REF(MAX5715_REF_enum_t value); |
whismanoid | 0:777851395940 | 611 | |
whismanoid | 0:777851395940 | 612 | //---------------------------------------- |
whismanoid | 0:777851395940 | 613 | /// CMD_0101_0000_0000_0000_0000_0000_SW_CLEAR |
whismanoid | 0:777851395940 | 614 | /// |
whismanoid | 0:777851395940 | 615 | /// Software Clear |
whismanoid | 0:777851395940 | 616 | /// All CODE and DAC registers cleared to their default values. |
whismanoid | 0:777851395940 | 617 | /// |
whismanoid | 0:777851395940 | 618 | /// @return 1 on success; 0 on failure |
whismanoid | 0:777851395940 | 619 | uint8_t SW_CLEAR(void); |
whismanoid | 0:777851395940 | 620 | |
whismanoid | 0:777851395940 | 621 | //---------------------------------------- |
whismanoid | 0:777851395940 | 622 | /// CMD_0101_0001_0000_0000_0000_0000_SW_RESET |
whismanoid | 0:777851395940 | 623 | /// |
whismanoid | 0:777851395940 | 624 | /// Software Reset |
whismanoid | 0:777851395940 | 625 | /// All CODE, DAC, and control registers returned to their default values, |
whismanoid | 0:777851395940 | 626 | /// simulating a power cycle reset. |
whismanoid | 0:777851395940 | 627 | /// |
whismanoid | 0:777851395940 | 628 | /// @return 1 on success; 0 on failure |
whismanoid | 0:777851395940 | 629 | uint8_t SW_RESET(void); |
whismanoid | 0:777851395940 | 630 | |
whismanoid | 0:777851395940 | 631 | }; // end of class MAX5715 |
whismanoid | 0:777851395940 | 632 | |
whismanoid | 0:777851395940 | 633 | #endif // __MAX5715_H__ |
whismanoid | 0:777851395940 | 634 | |
whismanoid | 0:777851395940 | 635 | // End of file |