Maxim Integrated MAX5171 14-bit Force/Sense DAC
Dependents: MAX5171BOB_Tester MAX5171BOB_14bit_Remote_Sense_SPI_DAC MAX5171BOB_Serial_Tester
MAX5171.h@2:d1340b334b0d, 2019-06-17 (annotated)
- Committer:
- whismanoid
- Date:
- Mon Jun 17 05:30:16 2019 +0000
- Revision:
- 2:d1340b334b0d
- Parent:
- 1:e73245718b2a
- Child:
- 4:1984eef51fe3
remove serial port dependency from mbed hello
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
whismanoid | 1:e73245718b2a | 1 | // /******************************************************************************* |
whismanoid | 1:e73245718b2a | 2 | // * Copyright (C) 2019 Maxim Integrated Products, Inc., All Rights Reserved. |
whismanoid | 1:e73245718b2a | 3 | // * |
whismanoid | 1:e73245718b2a | 4 | // * Permission is hereby granted, free of charge, to any person obtaining a |
whismanoid | 1:e73245718b2a | 5 | // * copy of this software and associated documentation files (the "Software"), |
whismanoid | 1:e73245718b2a | 6 | // * to deal in the Software without restriction, including without limitation |
whismanoid | 1:e73245718b2a | 7 | // * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
whismanoid | 1:e73245718b2a | 8 | // * and/or sell copies of the Software, and to permit persons to whom the |
whismanoid | 1:e73245718b2a | 9 | // * Software is furnished to do so, subject to the following conditions: |
whismanoid | 1:e73245718b2a | 10 | // * |
whismanoid | 1:e73245718b2a | 11 | // * The above copyright notice and this permission notice shall be included |
whismanoid | 1:e73245718b2a | 12 | // * in all copies or substantial portions of the Software. |
whismanoid | 1:e73245718b2a | 13 | // * |
whismanoid | 1:e73245718b2a | 14 | // * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
whismanoid | 1:e73245718b2a | 15 | // * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
whismanoid | 1:e73245718b2a | 16 | // * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
whismanoid | 1:e73245718b2a | 17 | // * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES |
whismanoid | 1:e73245718b2a | 18 | // * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
whismanoid | 1:e73245718b2a | 19 | // * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
whismanoid | 1:e73245718b2a | 20 | // * OTHER DEALINGS IN THE SOFTWARE. |
whismanoid | 1:e73245718b2a | 21 | // * |
whismanoid | 1:e73245718b2a | 22 | // * Except as contained in this notice, the name of Maxim Integrated |
whismanoid | 1:e73245718b2a | 23 | // * Products, Inc. shall not be used except as stated in the Maxim Integrated |
whismanoid | 1:e73245718b2a | 24 | // * Products, Inc. Branding Policy. |
whismanoid | 1:e73245718b2a | 25 | // * |
whismanoid | 1:e73245718b2a | 26 | // * The mere transfer of this software does not imply any licenses |
whismanoid | 1:e73245718b2a | 27 | // * of trade secrets, proprietary technology, copyrights, patents, |
whismanoid | 1:e73245718b2a | 28 | // * trademarks, maskwork rights, or any other form of intellectual |
whismanoid | 1:e73245718b2a | 29 | // * property whatsoever. Maxim Integrated Products, Inc. retains all |
whismanoid | 1:e73245718b2a | 30 | // * ownership rights. |
whismanoid | 1:e73245718b2a | 31 | // ******************************************************************************* |
whismanoid | 1:e73245718b2a | 32 | // */ |
whismanoid | 1:e73245718b2a | 33 | // ********************************************************************* |
whismanoid | 1:e73245718b2a | 34 | // @file MAX5171.h |
whismanoid | 1:e73245718b2a | 35 | // ********************************************************************* |
whismanoid | 1:e73245718b2a | 36 | // Header file |
whismanoid | 1:e73245718b2a | 37 | // DO NOT EDIT; except areas designated "CUSTOMIZE". Automatically generated file. |
whismanoid | 1:e73245718b2a | 38 | // generated by XMLSystemOfDevicesToMBED.py |
whismanoid | 1:e73245718b2a | 39 | // System Name = ExampleSystem |
whismanoid | 1:e73245718b2a | 40 | // System Description = Device driver example |
whismanoid | 1:e73245718b2a | 41 | // Device Name = MAX5171 |
whismanoid | 1:e73245718b2a | 42 | // Device Description = Low-Power, Serial, 14-Bit, 1-Channel DACs with Force/Sense Voltage Output and SPI Interface |
whismanoid | 1:e73245718b2a | 43 | // Device Manufacturer = Maxim Integrated |
whismanoid | 1:e73245718b2a | 44 | // Device PartNumber = MAX5171AEEE+ |
whismanoid | 1:e73245718b2a | 45 | // Device RegValue_Width = DataWidth16bit_HL |
whismanoid | 1:e73245718b2a | 46 | // |
whismanoid | 1:e73245718b2a | 47 | // DAC NumChannels = 1 |
whismanoid | 1:e73245718b2a | 48 | // DAC ResolutionBits = 14 |
whismanoid | 1:e73245718b2a | 49 | // |
whismanoid | 1:e73245718b2a | 50 | // SPI CS = ActiveLow |
whismanoid | 1:e73245718b2a | 51 | // SPI FrameStart = CS |
whismanoid | 1:e73245718b2a | 52 | // SPI CPOL = 0 |
whismanoid | 1:e73245718b2a | 53 | // SPI CPHA = 0 |
whismanoid | 1:e73245718b2a | 54 | // SPI MOSI and MISO Data are both stable on Rising edge of SCLK |
whismanoid | 1:e73245718b2a | 55 | // SPI SCLK Idle Low |
whismanoid | 1:e73245718b2a | 56 | // SPI SCLKMaxMHz = 10 |
whismanoid | 1:e73245718b2a | 57 | // SPI SCLKMinMHz = 0 |
whismanoid | 1:e73245718b2a | 58 | // |
whismanoid | 1:e73245718b2a | 59 | |
whismanoid | 1:e73245718b2a | 60 | |
whismanoid | 1:e73245718b2a | 61 | // Prevent multiple declaration |
whismanoid | 1:e73245718b2a | 62 | #ifndef __MAX5171_H__ |
whismanoid | 1:e73245718b2a | 63 | #define __MAX5171_H__ |
whismanoid | 1:e73245718b2a | 64 | |
whismanoid | 1:e73245718b2a | 65 | #include "mbed.h" |
whismanoid | 1:e73245718b2a | 66 | |
whismanoid | 1:e73245718b2a | 67 | // CODE GENERATOR: conditional defines |
whismanoid | 1:e73245718b2a | 68 | // CODE GENERATOR: class declaration and docstrings |
whismanoid | 1:e73245718b2a | 69 | /** |
whismanoid | 1:e73245718b2a | 70 | * @brief MAX5171 Low-Power, Serial, 14-Bit, 1-Channel DACs with Force/Sense Voltage Output and SPI Interface |
whismanoid | 1:e73245718b2a | 71 | * |
whismanoid | 1:e73245718b2a | 72 | * |
whismanoid | 1:e73245718b2a | 73 | * |
whismanoid | 1:e73245718b2a | 74 | * Datasheet: https://www.maximintegrated.com/MAX5171 |
whismanoid | 1:e73245718b2a | 75 | * |
whismanoid | 1:e73245718b2a | 76 | * |
whismanoid | 1:e73245718b2a | 77 | * |
whismanoid | 2:d1340b334b0d | 78 | * //---------- CODE GENERATOR: helloCppCodeList |
whismanoid | 1:e73245718b2a | 79 | * @code |
whismanoid | 1:e73245718b2a | 80 | * // CODE GENERATOR: example code includes |
whismanoid | 1:e73245718b2a | 81 | * // example code includes |
whismanoid | 1:e73245718b2a | 82 | * #include "mbed.h" |
whismanoid | 1:e73245718b2a | 83 | * //#include "max32625.h" |
whismanoid | 1:e73245718b2a | 84 | * #include "MAX5171.h" |
whismanoid | 1:e73245718b2a | 85 | * |
whismanoid | 1:e73245718b2a | 86 | * // example code board support |
whismanoid | 1:e73245718b2a | 87 | * //MAX32630FTHR pegasus(MAX32630FTHR::VIO_3V3); |
whismanoid | 1:e73245718b2a | 88 | * //DigitalOut rLED(LED1); |
whismanoid | 1:e73245718b2a | 89 | * //DigitalOut gLED(LED2); |
whismanoid | 1:e73245718b2a | 90 | * //DigitalOut bLED(LED3); |
whismanoid | 1:e73245718b2a | 91 | * // |
whismanoid | 1:e73245718b2a | 92 | * // Arduino "shield" connector port definitions (MAX32625MBED shown) |
whismanoid | 1:e73245718b2a | 93 | * #if defined(TARGET_MAX32625MBED) |
whismanoid | 1:e73245718b2a | 94 | * #define A0 AIN_0 |
whismanoid | 1:e73245718b2a | 95 | * #define A1 AIN_1 |
whismanoid | 1:e73245718b2a | 96 | * #define A2 AIN_2 |
whismanoid | 1:e73245718b2a | 97 | * #define A3 AIN_3 |
whismanoid | 1:e73245718b2a | 98 | * #define D0 P0_0 |
whismanoid | 1:e73245718b2a | 99 | * #define D1 P0_1 |
whismanoid | 1:e73245718b2a | 100 | * #define D2 P0_2 |
whismanoid | 1:e73245718b2a | 101 | * #define D3 P0_3 |
whismanoid | 1:e73245718b2a | 102 | * #define D4 P0_4 |
whismanoid | 1:e73245718b2a | 103 | * #define D5 P0_5 |
whismanoid | 1:e73245718b2a | 104 | * #define D6 P0_6 |
whismanoid | 1:e73245718b2a | 105 | * #define D7 P0_7 |
whismanoid | 1:e73245718b2a | 106 | * #define D8 P1_4 |
whismanoid | 1:e73245718b2a | 107 | * #define D9 P1_5 |
whismanoid | 1:e73245718b2a | 108 | * #define D10 P1_3 |
whismanoid | 1:e73245718b2a | 109 | * #define D11 P1_1 |
whismanoid | 1:e73245718b2a | 110 | * #define D12 P1_2 |
whismanoid | 1:e73245718b2a | 111 | * #define D13 P1_0 |
whismanoid | 1:e73245718b2a | 112 | * #endif |
whismanoid | 1:e73245718b2a | 113 | * |
whismanoid | 1:e73245718b2a | 114 | * // example code declare SPI interface |
whismanoid | 1:e73245718b2a | 115 | * #if defined(TARGET_MAX32625MBED) |
whismanoid | 1:e73245718b2a | 116 | * 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 | 1:e73245718b2a | 117 | * DigitalOut spi_cs(SPI1_SS); // TARGET_MAX32625MBED: P1_3 Arduino 10-pin header D10 |
whismanoid | 1:e73245718b2a | 118 | * #elif defined(TARGET_MAX32600MBED) |
whismanoid | 1:e73245718b2a | 119 | * SPI spi(SPI2_MOSI, SPI2_MISO, SPI2_SCK); // mosi, miso, sclk spi1 TARGET_MAX32600MBED: Arduino 10-pin header D11 D12 D13 |
whismanoid | 1:e73245718b2a | 120 | * DigitalOut spi_cs(SPI2_SS); // Generic: Arduino 10-pin header D10 |
whismanoid | 1:e73245718b2a | 121 | * #else |
whismanoid | 1:e73245718b2a | 122 | * SPI spi(D11, D12, D13); // mosi, miso, sclk spi1 TARGET_MAX32600MBED: Arduino 10-pin header D11 D12 D13 |
whismanoid | 1:e73245718b2a | 123 | * DigitalOut spi_cs(D10); // Generic: Arduino 10-pin header D10 |
whismanoid | 1:e73245718b2a | 124 | * #endif |
whismanoid | 1:e73245718b2a | 125 | * |
whismanoid | 1:e73245718b2a | 126 | * // example code declare GPIO interface pins |
whismanoid | 1:e73245718b2a | 127 | * // AnalogOut FB_pin(Px_x_PortName_To_Be_Determined); // Analog Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 128 | * DigitalOut RS_pin(D9); // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 129 | * DigitalOut PDLb_pin(D8); // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 130 | * DigitalOut CLRb_pin(D7); // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 131 | * DigitalOut SHDN_pin(D6); // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 132 | * // AnalogIn OUT_pin(A0); // Analog Output from MAX5171 device |
whismanoid | 1:e73245718b2a | 133 | * DigitalIn UPO_pin(D5); // Digital General-Purpose Output from MAX5171 device |
whismanoid | 1:e73245718b2a | 134 | * // example code declare device instance |
whismanoid | 1:e73245718b2a | 135 | * MAX5171 g_MAX5171_device(spi, spi_cs, RS_pin, PDLb_pin, CLRb_pin, SHDN_pin, UPO_pin, MAX5171::MAX5171_IC); |
whismanoid | 1:e73245718b2a | 136 | * |
whismanoid | 1:e73245718b2a | 137 | * // example code main function |
whismanoid | 1:e73245718b2a | 138 | * int main() |
whismanoid | 1:e73245718b2a | 139 | * { |
whismanoid | 1:e73245718b2a | 140 | * while (1) |
whismanoid | 1:e73245718b2a | 141 | * { |
whismanoid | 1:e73245718b2a | 142 | * // CODE GENERATOR: example code: member function Init |
whismanoid | 1:e73245718b2a | 143 | * g_MAX5171_device.Init(); |
whismanoid | 1:e73245718b2a | 144 | * |
whismanoid | 1:e73245718b2a | 145 | * // CODE GENERATOR: example code: has no member function REF |
whismanoid | 1:e73245718b2a | 146 | * // CODE GENERATOR: example code: member function CODE_LOAD |
whismanoid | 1:e73245718b2a | 147 | * // |
whismanoid | 1:e73245718b2a | 148 | * uint16_t code = 0xccc; |
whismanoid | 1:e73245718b2a | 149 | * g_MAX5171_device.CODE_LOAD(code); |
whismanoid | 1:e73245718b2a | 150 | * // |
whismanoid | 1:e73245718b2a | 151 | * code = 0x800; |
whismanoid | 1:e73245718b2a | 152 | * g_MAX5171_device.CODE_LOAD(code); |
whismanoid | 1:e73245718b2a | 153 | * // |
whismanoid | 1:e73245718b2a | 154 | * code = 0x666; |
whismanoid | 1:e73245718b2a | 155 | * g_MAX5171_device.CODE_LOAD(code); |
whismanoid | 1:e73245718b2a | 156 | * // |
whismanoid | 1:e73245718b2a | 157 | * code = 0xFFF; |
whismanoid | 1:e73245718b2a | 158 | * g_MAX5171_device.CODE_LOAD(code); |
whismanoid | 1:e73245718b2a | 159 | * |
whismanoid | 1:e73245718b2a | 160 | * // CODE GENERATOR: example code: has no member function CODEallLOADall |
whismanoid | 1:e73245718b2a | 161 | * // CODE GENERATOR: example code: has no member function CODEnLOADn |
whismanoid | 1:e73245718b2a | 162 | * // CODE GENERATOR: example code: has no member function ScanManual |
whismanoid | 1:e73245718b2a | 163 | * // CODE GENERATOR: example code: has no member function ReadAINcode |
whismanoid | 1:e73245718b2a | 164 | * wait(3.0); |
whismanoid | 1:e73245718b2a | 165 | * } |
whismanoid | 1:e73245718b2a | 166 | * } |
whismanoid | 1:e73245718b2a | 167 | * @endcode |
whismanoid | 2:d1340b334b0d | 168 | * //---------- CODE GENERATOR: end helloCppCodeList |
whismanoid | 1:e73245718b2a | 169 | */ |
whismanoid | 2:d1340b334b0d | 170 | class MAX5171 { |
whismanoid | 1:e73245718b2a | 171 | public: |
whismanoid | 1:e73245718b2a | 172 | // CODE GENERATOR: TypedefEnum EnumItem declarations |
whismanoid | 1:e73245718b2a | 173 | // CODE GENERATOR: TypedefEnum MAX5171_CMD_enum_t |
whismanoid | 1:e73245718b2a | 174 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 175 | /// Command Codes (first byte) |
whismanoid | 1:e73245718b2a | 176 | /// |
whismanoid | 1:e73245718b2a | 177 | /// Naming convention is CMD_bitstream_FUNCTION_NAME |
whismanoid | 1:e73245718b2a | 178 | /// - dd_dddd_dddd_dddd = data field |
whismanoid | 1:e73245718b2a | 179 | /// - xxxx = don't care |
whismanoid | 1:e73245718b2a | 180 | typedef enum MAX5171_CMD_enum_t { |
whismanoid | 1:e73245718b2a | 181 | CMD_00dd_dddd_dddd_dddd_CODE = 0x0000, //!< 16'b0000000000000000 |
whismanoid | 1:e73245718b2a | 182 | CMD_01dd_dddd_dddd_dddd_CODE_LOAD = 0x4000, //!< 16'b0100000000000000 |
whismanoid | 1:e73245718b2a | 183 | CMD_10xx_xxxx_xxxx_xxxx_LOAD = 0x8000, //!< 16'b1000000000000000 |
whismanoid | 1:e73245718b2a | 184 | CMD_1100_xxxx_xxxx_xxxx_NOP = 0xc000, //!< 16'b1100000000000000 |
whismanoid | 1:e73245718b2a | 185 | CMD_1101_xxxx_xxxx_xxxx_SHUTDOWN = 0xd000, //!< 16'b1101000000000000 |
whismanoid | 1:e73245718b2a | 186 | CMD_1110_0xxx_xxxx_xxxx_UPO_LOW = 0xe000, //!< 16'b1110000000000000 |
whismanoid | 1:e73245718b2a | 187 | CMD_1110_1xxx_xxxx_xxxx_UPO_HIGH = 0xe800, //!< 16'b1110100000000000 |
whismanoid | 1:e73245718b2a | 188 | CMD_1111_0xxx_xxxx_xxxx_MODE1_DOUT_SCLK_RISING_EDGE = 0xf000, //!< 16'b1111000000000000 |
whismanoid | 1:e73245718b2a | 189 | CMD_1111_1xxx_xxxx_xxxx_MODE0_DOUT_SCLK_FALLING_EDGE = 0xf800, //!< 16'b1111100000000000 |
whismanoid | 1:e73245718b2a | 190 | } MAX5171_CMD_enum_t; |
whismanoid | 1:e73245718b2a | 191 | |
whismanoid | 1:e73245718b2a | 192 | // TODO1: CODE GENERATOR: ic_variant -- IC's supported with this driver |
whismanoid | 1:e73245718b2a | 193 | /** |
whismanoid | 1:e73245718b2a | 194 | * @brief IC's supported with this driver |
whismanoid | 1:e73245718b2a | 195 | * @details MAX5171 |
whismanoid | 1:e73245718b2a | 196 | */ |
whismanoid | 2:d1340b334b0d | 197 | typedef enum |
whismanoid | 2:d1340b334b0d | 198 | { |
whismanoid | 1:e73245718b2a | 199 | MAX5171_IC = 0, |
whismanoid | 1:e73245718b2a | 200 | //MAX5171_IC = 1 |
whismanoid | 1:e73245718b2a | 201 | } MAX5171_ic_t; |
whismanoid | 0:80a9add62408 | 202 | |
whismanoid | 1:e73245718b2a | 203 | // TODO1: CODE GENERATOR: class constructor declaration |
whismanoid | 1:e73245718b2a | 204 | /**********************************************************//** |
whismanoid | 1:e73245718b2a | 205 | * @brief Constructor for MAX5171 Class. |
whismanoid | 1:e73245718b2a | 206 | * |
whismanoid | 1:e73245718b2a | 207 | * @details Requires an existing SPI object as well as a DigitalOut object. |
whismanoid | 1:e73245718b2a | 208 | * The DigitalOut object is used for a chip enable signal |
whismanoid | 1:e73245718b2a | 209 | * |
whismanoid | 1:e73245718b2a | 210 | * On Entry: |
whismanoid | 1:e73245718b2a | 211 | * @param[in] spi - pointer to existing SPI object |
whismanoid | 1:e73245718b2a | 212 | * @param[in] cs_pin - pointer to a DigitalOut pin object |
whismanoid | 1:e73245718b2a | 213 | * CODE GENERATOR: class constructor docstrings gpio InputPin pins |
whismanoid | 1:e73245718b2a | 214 | * @param[in] RS_pin - pointer to a DigitalOut pin object |
whismanoid | 1:e73245718b2a | 215 | * @param[in] PDLb_pin - pointer to a DigitalOut pin object |
whismanoid | 1:e73245718b2a | 216 | * @param[in] CLRb_pin - pointer to a DigitalOut pin object |
whismanoid | 1:e73245718b2a | 217 | * @param[in] SHDN_pin - pointer to a DigitalOut pin object |
whismanoid | 1:e73245718b2a | 218 | * CODE GENERATOR: class constructor docstrings gpio OutputPin pins |
whismanoid | 1:e73245718b2a | 219 | * @param[in] UPO_pin - pointer to a DigitalIn pin object |
whismanoid | 1:e73245718b2a | 220 | * @param[in] ic_variant - which type of MAX5171 is used |
whismanoid | 1:e73245718b2a | 221 | * |
whismanoid | 1:e73245718b2a | 222 | * On Exit: |
whismanoid | 1:e73245718b2a | 223 | * |
whismanoid | 1:e73245718b2a | 224 | * @return None |
whismanoid | 1:e73245718b2a | 225 | **************************************************************/ |
whismanoid | 1:e73245718b2a | 226 | MAX5171(SPI &spi, DigitalOut &cs_pin, // SPI interface |
whismanoid | 1:e73245718b2a | 227 | // CODE GENERATOR: class constructor declaration gpio InputPin pins |
whismanoid | 1:e73245718b2a | 228 | // AnalogOut &FB_pin, // Analog Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 229 | DigitalOut &RS_pin, // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 230 | DigitalOut &PDLb_pin, // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 231 | DigitalOut &CLRb_pin, // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 232 | DigitalOut &SHDN_pin, // Digital Configuration Input to MAX5171 device |
whismanoid | 1:e73245718b2a | 233 | // CODE GENERATOR: class constructor declaration gpio OutputPin pins |
whismanoid | 1:e73245718b2a | 234 | // AnalogIn &OUT_pin, // Analog Output from MAX5171 device |
whismanoid | 1:e73245718b2a | 235 | DigitalIn &UPO_pin, // Digital General-Purpose Output from MAX5171 device |
whismanoid | 1:e73245718b2a | 236 | MAX5171_ic_t ic_variant); |
whismanoid | 1:e73245718b2a | 237 | |
whismanoid | 1:e73245718b2a | 238 | // CODE GENERATOR: class destructor declaration |
whismanoid | 1:e73245718b2a | 239 | /************************************************************ |
whismanoid | 1:e73245718b2a | 240 | * @brief Default destructor for MAX5171 Class. |
whismanoid | 1:e73245718b2a | 241 | * |
whismanoid | 1:e73245718b2a | 242 | * @details Destroys SPI object if owner |
whismanoid | 1:e73245718b2a | 243 | * |
whismanoid | 1:e73245718b2a | 244 | * On Entry: |
whismanoid | 1:e73245718b2a | 245 | * |
whismanoid | 1:e73245718b2a | 246 | * On Exit: |
whismanoid | 1:e73245718b2a | 247 | * |
whismanoid | 1:e73245718b2a | 248 | * @return None |
whismanoid | 1:e73245718b2a | 249 | **************************************************************/ |
whismanoid | 1:e73245718b2a | 250 | ~MAX5171(); |
whismanoid | 1:e73245718b2a | 251 | |
whismanoid | 1:e73245718b2a | 252 | // CODE GENERATOR: spi_frequency setter declaration |
whismanoid | 1:e73245718b2a | 253 | // set SPI SCLK frequency |
whismanoid | 1:e73245718b2a | 254 | void spi_frequency(int spi_sclk_Hz); |
whismanoid | 1:e73245718b2a | 255 | |
whismanoid | 1:e73245718b2a | 256 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 257 | // CODE GENERATOR: omit typedef enum MAX5171_device_t, class members instead of global device object |
whismanoid | 1:e73245718b2a | 258 | public: |
whismanoid | 1:e73245718b2a | 259 | |
whismanoid | 1:e73245718b2a | 260 | /// reference voltage, in Volts |
whismanoid | 1:e73245718b2a | 261 | double VRef; |
whismanoid | 1:e73245718b2a | 262 | |
whismanoid | 1:e73245718b2a | 263 | /// shadow of write-only dacCodeLsbs field CMD_00dd_dddd_dddd_dddd_CODE or CMD_01dd_dddd_dddd_dddd_CODE_LOAD |
whismanoid | 1:e73245718b2a | 264 | int16_t DACCode; |
whismanoid | 1:e73245718b2a | 265 | |
whismanoid | 1:e73245718b2a | 266 | // CODE GENERATOR: omit global g_MAX5171_device |
whismanoid | 1:e73245718b2a | 267 | |
whismanoid | 1:e73245718b2a | 268 | // CODE GENERATOR: extern function declarations |
whismanoid | 1:e73245718b2a | 269 | // CODE GENERATOR: extern function declaration SPIoutputCS |
whismanoid | 1:e73245718b2a | 270 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 271 | // Assert SPI Chip Select |
whismanoid | 1:e73245718b2a | 272 | // SPI chip-select for MAX5171 |
whismanoid | 1:e73245718b2a | 273 | // |
whismanoid | 1:e73245718b2a | 274 | void SPIoutputCS(int isLogicHigh); |
whismanoid | 1:e73245718b2a | 275 | |
whismanoid | 1:e73245718b2a | 276 | // CODE GENERATOR: extern function declaration SPIwrite16bits |
whismanoid | 1:e73245718b2a | 277 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 278 | // SPI write 16 bits |
whismanoid | 1:e73245718b2a | 279 | // SPI interface to MAX5171 shift 16 bits mosiData into MAX5171 DIN |
whismanoid | 1:e73245718b2a | 280 | // |
whismanoid | 1:e73245718b2a | 281 | void SPIwrite16bits(int16_t mosiData16); |
whismanoid | 1:e73245718b2a | 282 | |
whismanoid | 1:e73245718b2a | 283 | // CODE GENERATOR: class member data |
whismanoid | 1:e73245718b2a | 284 | private: |
whismanoid | 1:e73245718b2a | 285 | // CODE GENERATOR: class member data for SPI interface |
whismanoid | 1:e73245718b2a | 286 | // SPI object |
whismanoid | 1:e73245718b2a | 287 | SPI &m_spi; |
whismanoid | 1:e73245718b2a | 288 | int m_SPI_SCLK_Hz; |
whismanoid | 1:e73245718b2a | 289 | int m_SPI_dataMode; |
whismanoid | 1:e73245718b2a | 290 | int m_SPI_cs_state; |
whismanoid | 1:e73245718b2a | 291 | |
whismanoid | 1:e73245718b2a | 292 | // Selector pin object |
whismanoid | 1:e73245718b2a | 293 | DigitalOut &m_cs_pin; |
whismanoid | 1:e73245718b2a | 294 | |
whismanoid | 1:e73245718b2a | 295 | // CODE GENERATOR: class member data for gpio InputPin pins |
whismanoid | 1:e73245718b2a | 296 | // InputPin Name = FB |
whismanoid | 1:e73245718b2a | 297 | // InputPin Description = Feedback Input |
whismanoid | 1:e73245718b2a | 298 | // InputPin Function = Analog |
whismanoid | 1:e73245718b2a | 299 | // |
whismanoid | 1:e73245718b2a | 300 | // InputPin Name = RS |
whismanoid | 1:e73245718b2a | 301 | // InputPin Description = Reset Mode Select (digital input). Connect to VDD to select midscale reset output value. Connect to DGND |
whismanoid | 1:e73245718b2a | 302 | // to select 0 reset output value. |
whismanoid | 1:e73245718b2a | 303 | // InputPin Function = Configuration |
whismanoid | 1:e73245718b2a | 304 | DigitalOut &m_RS_pin; |
whismanoid | 1:e73245718b2a | 305 | // |
whismanoid | 1:e73245718b2a | 306 | // InputPin Name = PDL# |
whismanoid | 1:e73245718b2a | 307 | // InputPin Description = Power-Down Lockout (digital input). Connect to VDD to allow shutdown. Connect to DGND to disable shutdown. |
whismanoid | 1:e73245718b2a | 308 | // InputPin Function = Configuration |
whismanoid | 1:e73245718b2a | 309 | DigitalOut &m_PDLb_pin; |
whismanoid | 1:e73245718b2a | 310 | // |
whismanoid | 1:e73245718b2a | 311 | // InputPin Name = CLR# |
whismanoid | 1:e73245718b2a | 312 | // InputPin Description = Clear DAC (digital input). Clears the DAC to its predetermined output state as set by RS. |
whismanoid | 1:e73245718b2a | 313 | // InputPin Function = Configuration |
whismanoid | 1:e73245718b2a | 314 | DigitalOut &m_CLRb_pin; |
whismanoid | 1:e73245718b2a | 315 | // |
whismanoid | 1:e73245718b2a | 316 | // InputPin Name = SHDN |
whismanoid | 1:e73245718b2a | 317 | // InputPin Description = Shutdown (digital input). Pulling SHDN high when PDL = VDD places the chip in shutdown mode with a |
whismanoid | 1:e73245718b2a | 318 | // maximum shutdown current 0f 10uA. |
whismanoid | 1:e73245718b2a | 319 | // InputPin Function = Configuration |
whismanoid | 1:e73245718b2a | 320 | DigitalOut &m_SHDN_pin; |
whismanoid | 1:e73245718b2a | 321 | // |
whismanoid | 1:e73245718b2a | 322 | // CODE GENERATOR: class member data for gpio OutputPin pins |
whismanoid | 1:e73245718b2a | 323 | // OutputPin Name = OUT |
whismanoid | 1:e73245718b2a | 324 | // OutputPin Description = Analog Voltage Output. High impedance in shutdown. Output voltage is limited to VDD. |
whismanoid | 1:e73245718b2a | 325 | // OutputPin Function = Analog |
whismanoid | 1:e73245718b2a | 326 | // AnalogIn &m_OUT_pin; |
whismanoid | 1:e73245718b2a | 327 | // |
whismanoid | 1:e73245718b2a | 328 | // OutputPin Name = UPO |
whismanoid | 1:e73245718b2a | 329 | // OutputPin Description = User-Programmable Output. State is set by serial input. |
whismanoid | 1:e73245718b2a | 330 | // OutputPin Function = General-Purpose |
whismanoid | 1:e73245718b2a | 331 | DigitalIn &m_UPO_pin; |
whismanoid | 1:e73245718b2a | 332 | // |
whismanoid | 1:e73245718b2a | 333 | |
whismanoid | 1:e73245718b2a | 334 | // Identifies which IC variant is being used |
whismanoid | 1:e73245718b2a | 335 | MAX5171_ic_t m_ic_variant; |
whismanoid | 1:e73245718b2a | 336 | |
whismanoid | 1:e73245718b2a | 337 | public: |
whismanoid | 1:e73245718b2a | 338 | |
whismanoid | 1:e73245718b2a | 339 | // CODE GENERATOR: class member function declarations |
whismanoid | 1:e73245718b2a | 340 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 341 | /// Initialize device |
whismanoid | 1:e73245718b2a | 342 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 343 | uint8_t Init(void); |
whismanoid | 1:e73245718b2a | 344 | |
whismanoid | 1:e73245718b2a | 345 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 346 | /// Return the DAC register value corresponding to physical voltage. |
whismanoid | 1:e73245718b2a | 347 | /// Does not perform any offset or gain correction. |
whismanoid | 1:e73245718b2a | 348 | /// |
whismanoid | 1:e73245718b2a | 349 | /// @pre g_MAX5171_device.VRef = Voltage of REF input, in Volts |
whismanoid | 1:e73245718b2a | 350 | /// @param[in] voltage = physical voltage in Volts |
whismanoid | 1:e73245718b2a | 351 | /// @return raw 14-bit MAX5171 code (right justified). |
whismanoid | 1:e73245718b2a | 352 | uint16_t DACCodeOfVoltage(double voltageV); |
whismanoid | 1:e73245718b2a | 353 | |
whismanoid | 1:e73245718b2a | 354 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 355 | /// Return the physical voltage corresponding to DAC register. |
whismanoid | 1:e73245718b2a | 356 | /// Does not perform any offset or gain correction. |
whismanoid | 1:e73245718b2a | 357 | /// |
whismanoid | 1:e73245718b2a | 358 | /// @pre g_MAX5171_device.VRef = Voltage of REF input, in Volts |
whismanoid | 1:e73245718b2a | 359 | /// @param[in] value_u14: raw 14-bit MAX5171 code (right justified). |
whismanoid | 1:e73245718b2a | 360 | /// @return physical voltage corresponding to MAX5171 code. |
whismanoid | 1:e73245718b2a | 361 | double VoltageOfCode(uint16_t value_u14); |
whismanoid | 1:e73245718b2a | 362 | |
whismanoid | 1:e73245718b2a | 363 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 364 | /// CMD_00dd_dddd_dddd_dddd_CODE |
whismanoid | 1:e73245718b2a | 365 | /// |
whismanoid | 1:e73245718b2a | 366 | /// Load input register; DAC registers are unchanged. |
whismanoid | 1:e73245718b2a | 367 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 368 | uint8_t CODE(uint16_t dacCodeLsbs); |
whismanoid | 1:e73245718b2a | 369 | |
whismanoid | 1:e73245718b2a | 370 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 371 | /// CMD_01dd_dddd_dddd_dddd_CODE_LOAD |
whismanoid | 1:e73245718b2a | 372 | /// |
whismanoid | 1:e73245718b2a | 373 | /// Load input register; DAC registers are updated (start up DAC with new data). |
whismanoid | 1:e73245718b2a | 374 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 375 | uint8_t CODE_LOAD(uint16_t dacCodeLsbs); |
whismanoid | 1:e73245718b2a | 376 | |
whismanoid | 1:e73245718b2a | 377 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 378 | /// CMD_10xx_xxxx_xxxx_xxxx_LOAD |
whismanoid | 1:e73245718b2a | 379 | /// |
whismanoid | 1:e73245718b2a | 380 | /// Update DAC register from input register (start up DAC with data previously |
whismanoid | 1:e73245718b2a | 381 | /// stored in the input registers). |
whismanoid | 1:e73245718b2a | 382 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 383 | uint8_t LOAD(void); |
whismanoid | 1:e73245718b2a | 384 | |
whismanoid | 1:e73245718b2a | 385 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 386 | /// CMD_1100_xxxx_xxxx_xxxx_NOP |
whismanoid | 1:e73245718b2a | 387 | /// |
whismanoid | 1:e73245718b2a | 388 | /// No operation (NOP). |
whismanoid | 1:e73245718b2a | 389 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 390 | uint8_t NOP(void); |
whismanoid | 1:e73245718b2a | 391 | |
whismanoid | 1:e73245718b2a | 392 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 393 | /// CMD_1101_xxxx_xxxx_xxxx_SHUTDOWN |
whismanoid | 1:e73245718b2a | 394 | /// |
whismanoid | 1:e73245718b2a | 395 | /// Shut down DAC (provided PDL# = 1). |
whismanoid | 1:e73245718b2a | 396 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 397 | uint8_t SHUTDOWN(void); |
whismanoid | 1:e73245718b2a | 398 | |
whismanoid | 1:e73245718b2a | 399 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 400 | /// CMD_1110_0xxx_xxxx_xxxx_UPO_LOW |
whismanoid | 1:e73245718b2a | 401 | /// |
whismanoid | 1:e73245718b2a | 402 | /// UPO goes low (default). |
whismanoid | 1:e73245718b2a | 403 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 404 | uint8_t UPO_LOW(void); |
whismanoid | 1:e73245718b2a | 405 | |
whismanoid | 1:e73245718b2a | 406 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 407 | /// CMD_1110_1xxx_xxxx_xxxx_UPO_HIGH |
whismanoid | 1:e73245718b2a | 408 | /// |
whismanoid | 1:e73245718b2a | 409 | /// UPO goes high. |
whismanoid | 1:e73245718b2a | 410 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 411 | uint8_t UPO_HIGH(void); |
whismanoid | 1:e73245718b2a | 412 | |
whismanoid | 1:e73245718b2a | 413 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 414 | /// CMD_1111_0xxx_xxxx_xxxx_MODE1_DOUT_SCLK_RISING_EDGE |
whismanoid | 1:e73245718b2a | 415 | /// |
whismanoid | 1:e73245718b2a | 416 | /// Mode 1, DOUT clocked out on SCLK’s rising edge. |
whismanoid | 1:e73245718b2a | 417 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 418 | uint8_t MODE1_DOUT_SCLK_RISING_EDGE(void); |
whismanoid | 1:e73245718b2a | 419 | |
whismanoid | 1:e73245718b2a | 420 | //---------------------------------------- |
whismanoid | 1:e73245718b2a | 421 | /// CMD_1111_1xxx_xxxx_xxxx_MODE0_DOUT_SCLK_FALLING_EDGE |
whismanoid | 1:e73245718b2a | 422 | /// |
whismanoid | 1:e73245718b2a | 423 | /// Mode 0, DOUT clocked out on SCLK’s falling edge (default). |
whismanoid | 1:e73245718b2a | 424 | /// @return 1 on success; 0 on failure |
whismanoid | 1:e73245718b2a | 425 | uint8_t MODE0_DOUT_SCLK_FALLING_EDGE(void); |
whismanoid | 1:e73245718b2a | 426 | |
whismanoid | 1:e73245718b2a | 427 | }; // end of class MAX5171 |
whismanoid | 1:e73245718b2a | 428 | |
whismanoid | 1:e73245718b2a | 429 | #endif // __MAX5171_H__ |
whismanoid | 1:e73245718b2a | 430 | |
whismanoid | 1:e73245718b2a | 431 | // End of file |