From e53f7015773a77ac283bdf30971149de6508c0c1 Mon Sep 17 00:00:00 2001 From: Krzysztof Budzynski Date: Mon, 17 Dec 2018 13:18:32 +0800 Subject: [PATCH] Update information on ADC's eFuse Vref. Inspired by https://esp32.com/viewtopic.php?f=12&t=6832. --- docs/_static/chip_surface_marking.png | Bin 0 -> 50190 bytes docs/en/api-reference/peripherals/adc.rst | 41 ++++++++++++++++++++-- 2 files changed, 38 insertions(+), 3 deletions(-) create mode 100644 docs/_static/chip_surface_marking.png diff --git a/docs/_static/chip_surface_marking.png b/docs/_static/chip_surface_marking.png new file mode 100644 index 0000000000000000000000000000000000000000..c4f615fd0135b7cc302fd17a54552d20ac4fba78 GIT binary patch literal 50190 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 F~G0I#v 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 FngE{=0zv=) literal 0 HcmV?d00001 diff --git a/docs/en/api-reference/peripherals/adc.rst b/docs/en/api-reference/peripherals/adc.rst index 55b613a8ce..c030b462a9 100644 --- a/docs/en/api-reference/peripherals/adc.rst +++ b/docs/en/api-reference/peripherals/adc.rst @@ -113,11 +113,46 @@ Calibration Values Calibration values are used to generate characteristic curves that account for the unique ADC reference voltage of a particular ESP32. There are currently three sources of calibration values. The availability of these calibration values will depend on the type and production date of the ESP32 chip/module. -**Two Point** values represent each of the ADCs’ readings at 150mV and 850mV. To obtain more accurate calibration results these values should be measured by user and burned into eFuse ``BLOCK3``. +* **Two Point** values represent each of the ADCs’ readings at 150mV and 850mV. To obtain more accurate calibration results these values should be measured by user and burned into eFuse ``BLOCK3``. -**eFuse Vref** represents the true ADC reference voltage. This value is measured and burned into eFuse ``BLOCK0`` during factory calibration. +* **eFuse Vref** represents the true ADC reference voltage. This value is measured and burned into eFuse ``BLOCK0`` during factory calibration. -**Default Vref** is an estimate of the ADC reference voltage provided by the user as a parameter during characterization. If Two Point or eFuse Vref values are unavailable, **Default Vref** will be used. +* **Default Vref** is an estimate of the ADC reference voltage provided by the user as a parameter during characterization. If Two Point or eFuse Vref values are unavailable, **Default Vref** will be used. + +Individual measurement and burning of the **eFuse Vref** has been applied to ESP32-D0WD and ESP32-D0WDQ6 chips produced on/after the 1st week of 2018. Such chips may be recognized by date codes on/later than 012018 (see Line 4 on figure below). + +.. figure:: ../../../_static/chip_surface_marking.png + :align: center + :alt: ESP32 Chip Surface Marking + + ESP32 Chip Surface Marking + +If you would like to purchase chips or modules with calibration, double check with distributor or Espressif directly. + +.. highlight:: none + +If you are unable to check the date code (i.e. the chip may be enclosed inside a canned module, etc.), you can still verify if **eFuse Vref** is present by running `espefuse.py `_ tool with ``adc_info`` parameter :: + + $IDF_PATH/components/esptool_py/esptool/espefuse.py --port /dev/ttyUSB0 adc_info + +Replace ``/dev/ttyUSB0`` with ESP32 board's port name. + +A chip that has specific **eFuse Vref** value programmed (in this case 1093mV) will be reported as follows:: + + ADC VRef calibration: 1093mV + +In another example below the **eFuse Vref** is not programmed:: + + ADC VRef calibration: None (1100mV nominal) + +For a chip with two point calibration the message will look similar to:: + + ADC VRef calibration: 1149mV + ADC readings stored in efuse BLK3: + ADC1 Low reading (150mV): 306 + ADC1 High reading (850mV): 3153 + ADC2 Low reading (150mV): 389 + ADC2 High reading (850mV): 3206 Application Example ^^^^^^^^^^^^^^^^^^^