Datasheet map¶
The driver follows the ADS7952 datasheet. This page says which revision, where to get it, and where each part of the driver is described in it, so you can check any behaviour against the source. Section names and page numbers are the datasheet's own (the printed page numbers).
- Datasheet: ADS79xx 12-, 10-, 8-Bit, 1-MSPS, 16-, 12-, 8-, 4-Channel, Single-Ended, Serial Interface ADCs, Texas
Instruments SLAS605, revision C (2018-07). Get it from the vendor page or as a
PDF.
SHA-256 of the file used:
e7922065e4d1691d2c1b9599273a07d1854331a47f7818d70fe830e9a8811d8b.
| Topic | Datasheet section | Page | In the driver | Explained on |
|---|---|---|---|---|
| The family, its channel counts and resolutions | 1 Features; 3 Description; 5 Device Comparison Table | p. 1 | Variant, ChannelCount() |
Hardware, Configuration |
| Pins, packages and the GPIOs each package brings out | 6 Pin Configuration and Functions | p. 5 | Package, GpioConfig |
Hardware, Quickstart |
| Absolute limits of the inputs and supplies | 7.1 Absolute Maximum Ratings | p. 10 | Config::va_min_mv (documented limits only: no register) |
Reference, range and supplies, Hardware |
| Supplies, reference and SCLK limits | 7.3 Recommended Operating Conditions | p. 10 | Config::vref_mv, Config::va_min_mv, Validate() |
Hardware, Configuration, Porting, Reference, range and supplies |
| Input ranges, power-up time and the invalid first conversion | 7.6 Electrical Characteristics (ADS7950 to ADS7953) | p. 12 | Range, kPowerUpUs, EnsureInitialized(), Validate() |
Hardware, Contract, Configuration, Reference, range and supplies |
| Serial timing, CS high time and the 16-clock frame | 7.9 Timing Requirements; Figures 1 and 2 | p. 17 | SpiInterface, kFrameBytes |
Porting, Hardware |
| Frame, reply word, GPIO refresh and alarm timing | 8.1 Overview | p. 28 | reg::ReplyAddress(), reg::ReplyCode(), SetGpioOutputs() |
Hardware, Architecture, Contract |
| The external reference and its 10 µF capacitor | 8.3.1 Reference | p. 29 | Config::vref_mv, ScaleMonitor |
Reference, range and supplies, Hardware |
| Power-down through DI05 | 8.3.2 Power Saving | p. 29 | Deinitialize() |
API guide, Contract |
| Channel sequencing modes and the program registers' reset values | 8.4.1 Channel Sequencing Modes; 8.4.2 Device Programming and Mode Control | p. 29 | ResetConfig(), Config::auto1_channels, Config::auto2_last_channel |
Hardware, Configuration |
| Power-up and the programming sequence | 8.4.3 Device Power-Up Sequence, Figure 49 | p. 30 | EnsureInitialized(), ApplyConfig(), Error::DeviceReset, Config::park_channel |
Contract, Troubleshooting, Status and limitations |
| Manual mode and the two-frame read latency | 8.4.4 Operating in Manual Mode, Figures 50 and 51, Table 1 | p. 31 | ReadChannel(), ReadChannels(), TraceFrames(), SetRange() |
API guide, Architecture, Hardware, Troubleshooting |
| Auto-1 mode and its program register | 8.4.5 Operating in Auto-1 Mode, Figures 52 to 54, Tables 2 to 4 | p. 34 | ReadAuto1(), SetAuto1Channels(), Error::SequenceMismatch |
API guide, Architecture, Hardware |
| Auto-2 mode and its program register | 8.4.6 Operating in Auto-2 Mode, Figures 55 to 57, Tables 5 and 6 | p. 38 | ReadAuto2(), SetAuto2LastChannel() |
API guide, Hardware |
| The "continue" word | 8.4.7 Continued Operation in a Selected Mode, Table 7 | p. 41 | reg::kContinue, TraceFrames() |
Architecture, Hardware |
| Output codes and the LSB size | 8.5.1 Digital Output, Table 8 | p. 41 | CodeToMicrovolts(), ToMicrovolts(), Bank::range, CheckScaleCode() |
API guide, Configuration, Reference, range and supplies |
| GPIO program register and the register reset | 8.5.2 GPIO Registers, Figure 58, Table 11 | p. 42 | GpioConfig, AlarmOutput, ReadGpio(), SetGpioOutputs(), EnsureInitialized() |
Hardware, Configuration, API guide, Contract, Reference, range and supplies |
| Alarm thresholds | 8.5.3 Alarm Thresholds for GPIO Pins, Figure 59, Tables 12 and 13 | p. 43 | AlarmThreshold, SetAlarmThresholds() |
API guide, Configuration, Hardware |
| Analog input, source impedance and MXO to AINP | 9.1.1 Analog Input, Figures 60 and 61 | p. 46 | none: board design | Reference, range and supplies, Hardware |
| Supply range, decoupling and +VA at or above +VBD | 10 Power Supply Recommendations | p. 51 | Config::va_min_mv |
Reference, range and supplies, Hardware |
| Layout of grounds, supply and reference capacitors | 11.1 Layout Guidelines; 11.2 Layout Examples, Figures 69 and 70 | p. 52 | none: board design | Reference, range and supplies |
When the datasheet and the driver differ¶
The driver is written against the revision above. If you have a newer revision, compare its revision history with the topics above; a change to a pin, a register, a timing or a value the driver uses is a bug report for this repository. Where the driver deliberately goes beyond the datasheet, the Contract says so.
The repository never contains the PDF itself: vendors own their documents. Download it from the vendor, and compare its SHA-256 with the one above to confirm you have the same file.