Implemented review comments to zh_CN version of eclipse setup and PICO-KIT get started guides. Resolved issues after rebasing on master of several commits.
This commit is contained in:
krzychb
parent
286874eca4
commit
b7f7ac3b28
|
|
@ -90,7 +90,7 @@ Minimizing Noise
|
|||
|
||||
The ESP32 ADC can be sensitive to noise leading to large discrepancies in ADC readings. To minimize noise, users may connect a 0.1uF capacitor to the ADC input pad in use. Multisampling may also be used to further mitigate the effects of noise.
|
||||
|
||||
.. figure:: ../../_static/adc-noise-graph.jpg
|
||||
.. figure:: ../../../_static/adc-noise-graph.jpg
|
||||
:align: center
|
||||
:alt: ADC noise mitigation
|
||||
|
||||
|
|
@ -101,7 +101,7 @@ ADC Calibration
|
|||
|
||||
The :component_file:`esp_adc_cal/include/esp_adc_cal.h` API provides functions to correct for differences in measured voltages caused by variation of ADC reference voltages (Vref) between chips. Per design the ADC reference voltage is 1100mV, however the true reference voltage can range from 1000mV to 1200mV amongst different ESP32s.
|
||||
|
||||
.. figure:: ../../_static/adc-vref-graph.jpg
|
||||
.. figure:: ../../../_static/adc-vref-graph.jpg
|
||||
:align: center
|
||||
:alt: ADC reference voltage comparison
|
||||
|
||||
|
|
|
|||
1
docs/zh_CN/api-guides/thread-local-storage.rst
Normal file
1
docs/zh_CN/api-guides/thread-local-storage.rst
Normal file
|
|
@ -0,0 +1 @@
|
|||
.. include:: ../../en/api-guides/thread-local-storage.rst
|
||||
|
|
@ -22,15 +22,26 @@ import shlex
|
|||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
sys.path.insert(0, os.path.abspath('..'))
|
||||
|
||||
from repo_util import run_cmd_get_output
|
||||
from local_util import run_cmd_get_output, copy_if_modified
|
||||
|
||||
builddir = '_build'
|
||||
if 'BUILDDIR' in os.environ:
|
||||
builddir = os.environ['BUILDDIR']
|
||||
|
||||
# Call Doxygen to get XML files from the header files
|
||||
print "Calling Doxygen to generate latest XML files"
|
||||
os.system("doxygen ../Doxyfile")
|
||||
# Doxygen has generated XML files in 'xml' directory.
|
||||
# Copy them to 'xml_in', only touching the files which have changed.
|
||||
copy_if_modified('xml/', 'xml_in/')
|
||||
|
||||
# Generate 'api_name.inc' files using the XML files by Doxygen
|
||||
os.system("python ../gen-dxd.py")
|
||||
os.system('python ../gen-dxd.py')
|
||||
|
||||
# Generate 'kconfig.inc' file from components' Kconfig files
|
||||
os.system("python ../gen-kconfig-doc.py > _build/inc/kconfig.inc")
|
||||
kconfig_inc_path = '{}/inc/kconfig.inc'.format(builddir)
|
||||
os.system('python ../gen-kconfig-doc.py > ' + kconfig_inc_path + '.in')
|
||||
copy_if_modified(kconfig_inc_path + '.in', kconfig_inc_path)
|
||||
|
||||
# http://stackoverflow.com/questions/12772927/specifying-an-online-image-in-sphinx-restructuredtext-format
|
||||
#
|
||||
|
|
@ -63,7 +74,11 @@ rackdiag_fontpath = '../_static/DejaVuSans.ttf'
|
|||
packetdiag_fontpath = '../_static/DejaVuSans.ttf'
|
||||
|
||||
# Breathe extension variables
|
||||
breathe_projects = { "esp32-idf": "xml/" }
|
||||
|
||||
# Doxygen regenerates files in 'xml/' directory every time,
|
||||
# but we copy files to 'xml_in/' only when they change, to speed up
|
||||
# incremental builds.
|
||||
breathe_projects = { "esp32-idf": "xml_in/" }
|
||||
breathe_default_project = "esp32-idf"
|
||||
|
||||
# Add any paths that contain templates here, relative to this directory.
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ Eclipse IDE 的创建和烧录指南（Windows 平台）
|
|||
|
||||
Windows 平台上的 Eclipse 配置略有不同，具体步骤请见下文。
|
||||
|
||||
*注意：OS X 和 Linux 平台上的 Eclipse IDE 配置，请见 :doc:`Eclipse IDE page <eclipse-setup>`。*
|
||||
注意：OS X 和 Linux 平台上的 Eclipse IDE 配置，请见 :doc:`Eclipse IDE page <eclipse-setup>`。
|
||||
|
||||
安装 Eclipse IDE
|
||||
==================
|
||||
|
|
@ -17,7 +17,7 @@ Windows 平台的 Eclipse 安装步骤与其他平台相同，请见 :ref:`Insta
|
|||
Windows 平台上的 Eclipse 配置
|
||||
================================
|
||||
|
||||
点击安装 Eclipse IDE，并按照下列步骤操作：
|
||||
完成 Eclipse IDE 的安装后，请按照下列步骤继续操作：
|
||||
|
||||
导入新项目
|
||||
-------------
|
||||
|
|
@ -28,7 +28,7 @@ Windows 平台上的 Eclipse 配置
|
|||
|
||||
* 在弹出的对话框中选择 “C/C++” -> “Existing Code as Makefile Project”，然后点击 “Next”。
|
||||
|
||||
* 跳转至下个界面，在 “Existing Code Location” 位置输入您的 IDF 项目的路径。注意，这里应填入 ESP-IDF 项目的路径，而非 ESP-IDF 的路径（稍后再填写）。此外，您指定的目标路径中应包含名为 “Makefile”（项目 Makefile）的文件。
|
||||
* 下个界面，在 “Existing Code Location” 位置输入您的 IDF 项目的路径。注意，这里应填入 ESP-IDF 项目的路径，而非 ESP-IDF 的路径（稍后再填写）。此外，您指定的目录中应包含名为 “Makefile”（项目 Makefile）的文件。
|
||||
|
||||
* 在同一页面上，在 “Toolchain for Indexer Settings” 下取消选中 “Show only available toolchains that support this platform”。
|
||||
|
||||
|
|
@ -39,27 +39,28 @@ Windows 平台上的 Eclipse 配置
|
|||
项目属性
|
||||
----------
|
||||
|
||||
* 新项目将出现在 “Project Explorer” 下。请右键选择该项目，并在菜单中选择 “Properties”。
|
||||
* 新项目将出现在 “Project Explorer” 下。请右键选择该项目，并在菜单中选择顶层 “Properties”。
|
||||
|
||||
* 点击 “C/C++ Build” 属性页。
|
||||
|
||||
* 取消选中 “Use default build command”，然后输入命令：``python${IDF_PATH}/tools/windows/eclipse_make.py``，开始自定义新建。
|
||||
* 取消选中 “Use default build command”，然后输入命令：``python${IDF_PATH}/tools/windows/eclipse_make.py``，开始自定义创建。
|
||||
|
||||
* 点击 “C/C++ Build” 下的 “Environment” 属性页面。
|
||||
|
||||
* 选择 “Add...”，并在对应位置输入 ``BATCH_BUILD`` 和 ``1``。
|
||||
* 选择 “Add...”，并在对应位置输入 ``BATCH_BUILD`` 和 ``1``。
|
||||
|
||||
* 再次点击 “Add...”，输入名称 ``IDF_PATH``，并填写 ESP-IDF 的完整安装路径。``IDF_PATH`` 目录路径应使用正斜杠，而非反斜线，即 ``C:/Users/MyUser/Development/esp-idf``。
|
||||
* 再次点击 “Add...”，输入名称 ``IDF_PATH``，并填写 ESP-IDF 的完整安装路径。``IDF_PATH`` 目录路径应使用正斜杠，而非反斜线，即 ``C:/Users/MyUser/Development/esp-idf``。
|
||||
|
||||
* 选择 PATH 环境变量，删除默认值，并将其替换为 ``C:\msys32\usr\bin;C:\msys32\mingw32\bin;C:\msys32\opt\xtensa-esp32-elf\bin`` （如果您已经将 msys32 安装到其他目录，这里请自行调整）。
|
||||
|
||||
* 选择 ``PATH`` 环境变量，删除默认值，并将其替换为 ``C:\msys32\usr\bin;C:\msys32\mingw32\bin;C:\msys32\opt\xtensa-esp32-elf\bin`` （如果您已经将 msys32 安装到其他目录，这里请自行调整）。
|
||||
|
||||
* 点击 “C/C++ General” -> “Preprocessor Include Paths, Macros, etc.” 属性页。
|
||||
|
||||
* 点击 “Providers” 选项卡。
|
||||
* 点击 “Providers” 选项卡。
|
||||
|
||||
* 从 “Providers” 列表中选择 “CDT GCC Built-in Compiler Settings Cygwin”。进入 “Command to get compiler specs” 目录下，用 ``xtensa-esp32-elf-gcc`` 替换行首的 ``text${COMMAND}``，最终完整的 ``Command to get compiler specs`` 应为 ``xtensa-esp32-elf-gcc${FLAGS}-E-P-v-dD"${INPUTS}``。
|
||||
|
||||
* 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，然后在 Compiler 命令模式的起始位置输入 ``xtensa-esp32-elf-``，并用括号把剩余部分扩起来。最终的完整 Compiler 命令模式应为 ``xtensa-esp32-elf-((g?cc)|([gc]\+\+)|(clang))``。
|
||||
* 从 “Providers” 列表中选择 “CDT GCC Built-in Compiler Settings Cygwin”。在 “Command to get compiler specs” 输入框中，用 ``xtensa-esp32-elf-gcc`` 替换行首的 ``${COMMAND}``，最终完整的 ``Command to get compiler specs`` 应为 ``xtensa-esp32-elf-gcc ${FLAGS} -E -P -v -dD "${INPUTS}"``。
|
||||
|
||||
* 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，然后在 Compiler 命令模式的起始位置输入 ``xtensa-esp32-elf-``，并用括号把剩余部分扩起来。最终的完整 Compiler 命令模式应为 ``xtensa-esp32-elf-((g?cc)|([gc]\+\+)|(clang))``。
|
||||
|
||||
|
||||
在 Eclipse IDE 中创建项目
|
||||
|
|
@ -72,9 +73,9 @@ Windows 平台的 Eclipse 项目创建步骤与其他平台相同，请见 :ref:
|
|||
|
||||
**以下内容仅供 Windows 平台专家或非常感兴趣的开发者阅读。**
|
||||
|
||||
Windows 平台的 Eclipse 介绍到此结束，下方将主要将介绍一些关键操作的原理，助您了解更多 Eclipse 的背景信息。
|
||||
Windows 平台的 Eclipse 介绍到此结束，下方将主要将介绍一些关键步骤的原理，助您了解更多 Eclipse 的背景信息。
|
||||
|
||||
* 首先，xtensa-esp32-elf-gcc 交叉编译器 *并非* Cygwin 工具链，但我们会在 Eclipse 中指定其为 Cygwin 工具链。主要原因在于：msys2 需要使用 Cygwin，并支持 Unix 风格的路径，即 ``type/c/blah``，而非 ``c:/blah`` 或 ``c:\\blah``。特别需要说明的是，``xtensa-esp32-elf-gcc`` 会“告知” Eclipse 的 ``built-in compiler settings`` 功能，其内置 “include” 目录全部位于 ``/usr/`` 路径下，这也是 Eclipse 唯一可以解析的 ``Unix/Cygwin`` 样式路径。通过在 Eclipse 中指定 ``xtensa-esp32-elf-gcc`` 交叉编译器为 Cygwin 编译器，可以让 Eclipse 使用 cygpath 实用程序直接内部解析路径。
|
||||
* 首先，xtensa-esp32-elf-gcc 交叉编译器 *并非* Cygwin 工具链，但我们会在 Eclipse 中指定其为 Cygwin 工具链。主要原因在于：msys2 需要使用 Cygwin，并支持 Unix 风格的路径，即 ``/c/blah``，而非 ``c:/blah`` 或 ``c:\\blah``。特别需要说明的是，``xtensa-esp32-elf-gcc`` 会“告知” Eclipse 的 ``built-in compiler settings`` 功能，其内置 “include” 目录全部位于 ``/usr/`` 路径下，这也是 Eclipse 唯一可以解析的 ``Unix/Cygwin`` 风格路径。通过在 Eclipse 中指定 ``xtensa-esp32-elf-gcc`` 交叉编译器为 Cygwin 编译器，可以让 Eclipse 使用 cygpath 实用程序直接内部解析路径。
|
||||
|
||||
|
||||
* 在解析 ESP-IDF 的 make 结果时也经常会出现同样的问题。Eclipse 可以解析 make 的结果，查找头文件目录，但是无法脱离 cygpath，直接解析包含 ``/c/blah`` 格式的目录。``Eclipse Build Output Parser`` 将利用该机制确认是否调用 cygpath，但由于未知原因，目前 ESP-IDF 配置并不会触发该功能。出于这个原因，我们会使用 ``eclipse_make.py`` 包装脚本调用 make，然后使用 cygpath 处理 Eclipse 的结果。
|
||||
* 在解析 ESP-IDF 的 make 结果时也经常会出现同样的问题。Eclipse 可以解析 make 的结果，查找头文件目录，但是无法脱离 ``cygpath``，直接解析类似 ``/c/blah`` 的目录。``Eclipse Build Output Parser`` 将利用该机制确认是否调用 ``cygpath``，但由于未知原因，目前 ESP-IDF 配置并不会触发该功能。出于这个原因，我们会使用 ``eclipse_make.py`` 包装脚本调用 ``make``，然后使用 ``cygpath`` 处理 Eclipse 的结果。
|
||||
|
|
@ -20,7 +20,7 @@ Eclipse IDE 是一个可视化的集成开发环境，可用于编写、编译
|
|||
Windows 用户
|
||||
============
|
||||
|
||||
Eclipse IDE 的 Windows 用户，请参考 :ref: `Windows 用户的 Eclipse IDE 使用指南 <eclipse-windows-setup>`。
|
||||
在 Windows 平台上使用 Eclipse IDE 的用户，请参考 :ref:`Windows 用户的 Eclipse IDE 使用指南 <eclipse-windows-setup>`。
|
||||
|
||||
配置 Eclipse IDE
|
||||
=================
|
||||
|
|
@ -36,7 +36,7 @@ Eclipse IDE 的 Windows 用户，请参考 :ref: `Windows 用户的 Eclipse IDE
|
|||
|
||||
* 在弹出的对话框中选择 “C/C++” -> “Existing Code as Makefile Project”，然后点击 “Next”。
|
||||
|
||||
* 跳转至下个界面，在 “Existing Code Location” 位置输入您的 IDF 项目的路径。注意，这里应输入 ESP-IDF 项目的路径，而非 ESP-IDF 本身的路径（这个稍后再填）。此外，您指定的目标路径中应包含名为 ``Makefile`` （项目 Makefile）的文件。
|
||||
* 在下个界面中 “Existing Code Location” 位置输入您的 IDF 项目的路径。注意，这里应输入 ESP-IDF 项目的路径，而非 ESP-IDF 本身的路径（这个稍后再填）。此外，您指定的目标路径中应包含名为 ``Makefile`` （项目 Makefile）的文件。
|
||||
|
||||
* 在本界面，找到 “Toolchain for Indexer Settings”，选择 “Cross GCC”，最后点击 “Finish”。
|
||||
|
||||
|
|
@ -46,53 +46,53 @@ Eclipse IDE 的 Windows 用户，请参考 :ref: `Windows 用户的 Eclipse IDE
|
|||
|
||||
* 新项目将出现在 “Project Explorer” 下。请右键选择该项目，并在菜单中选择 “Properties”。
|
||||
|
||||
* 点击 “C/C++ Build” 下的 “Environment” 属性页，选择 “Add...”，并在对应位置输入 “BATCH_BUILD” 和 “1”。
|
||||
* 点击 “C/C++ Build” 下的 “Environment” 属性页，选择 “Add...”，并在对应位置输入 ``BATCH_BUILD`` 和 ``1``。
|
||||
|
||||
* 再次点击 “Add...”，并在 “IDF_PATH” 中输入 ESP-IDF 所在的完整安装路径。
|
||||
|
||||
* 选择 “PATH” 环境变量，不要改变默认值。如果 IDF 设置中的 Xtensa 工具链尚不在 “PATH” 列表中，则应将该路径增加至列表 (``something/xtensa-esp32-elf/bin``)。
|
||||
* 选择 “PATH” 环境变量，不要改变默认值。如果 Xtensa 工具链的路径尚不在 “PATH” 列表中，则应将该路径 (``something/xtensa-esp32-elf/bin``) 增加至列表。
|
||||
|
||||
* 在 macOS 平台上，增加一个 “PYTHONPATH” 环境变量，并将其设置为 ``/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages``， 保证预先安装的系统 Python 可以覆盖 Eclipse 内置的任何 Python。
|
||||
* 在 macOS 平台上，增加一个 “PYTHONPATH” 环境变量，并将其设置为 ``/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages``， 保证系统中预先安装的 Python （需安装 pyserial 模块）可以覆盖 Eclipse 内置的任何 Python。
|
||||
|
||||
* 前往 “C/C++ General” -> “Preprocessor Include Paths” 属性页面。
|
||||
|
||||
* 点击 “Providers” 选项卡。从 “Providers” 列表中选择 “CDT Cross GCC Built-in Compiler Settings”。进入 “Command to get compiler specs” 目录，用 ``xtensa-esp32-elf-gcc`` 替换行首的 ``text${COMMAND}``，最终的完整 “Command to get compiler specs” 应为 ``xtensa-esp32-elf-gcc ${FLAGS} -E -P -v -dD "${INPUTS}"``。
|
||||
* 点击 “Providers” 选项卡。从 “Providers” 列表中选择 “CDT Cross GCC Built-in Compiler Settings”。在 “Command to get compiler specs” 输入框中，用 ``xtensa-esp32-elf-gcc`` 替换行首的 ``${COMMAND}``，最终的完整 “Command to get compiler specs” 应为 ``xtensa-esp32-elf-gcc ${FLAGS} -E -P -v -dD "${INPUTS}"``。
|
||||
|
||||
* 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，然后在 Compiler 命令模式的起始位置输入 ``xtensa-esp32-elf-``，最终的完整编译器命令应为 ``xtensa-esp32-elf-(g?cc)|([gc]\+\+)|(clang)``。
|
||||
* 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，然后在 “Compiler command pattern“ 输入框的起始位置输入 ``xtensa-esp32-elf-``，最终的完整编译器命令应为 ``xtensa-esp32-elf-(g?cc)|([gc]\+\+)|(clang)``。
|
||||
|
||||
.. _eclipse-build-project:
|
||||
|
||||
在 Eclipse IDE 中创建项目
|
||||
--------------------------
|
||||
|
||||
在首次创建项目前，Eclipse IDE 可能会显示大量有关未定义值的错误和警告，主要原因在于项目编译过程中所需的一些源文件是在 ESP-IDF 项目新建过程中自动生成的。因此，这些错误和警告将在 ESP-IDF 项目生成完成后消失。
|
||||
在首次创建项目前，Eclipse IDE 可能会显示大量有关未定义值的错误和警告，主要原因在于项目编译过程中所需的一些源文件是在 ESP-IDF 项目创建过程中自动生成的。因此，这些错误和警告将在 ESP-IDF 项目生成完成后消失。
|
||||
|
||||
* 点击 “OK”，关闭 Eclipse IDE 中的 “Properties” 对话框。
|
||||
|
||||
* 在 Eclipse IDE 界面外，打开命令管理器。进入项目目录，并通过 ``make menuconfig`` 命令对您的 ESP-IDF 项目进行配置。现阶段，Eclipse 还不能完成这一步操作。
|
||||
* 在 Eclipse IDE 界面外，打开命令管理器。进入项目目录，并通过 ``make menuconfig`` 命令对您的 ESP-IDF 项目进行配置。现阶段，您还无法在 Eclipse 中完成本操作。
|
||||
|
||||
* 如果您跳过了最开始的配置步骤，ESP-IDF 将在命令行中提示应进行配置 - 但由于 Eclipse 暂时不支持相关功能，因此该项目将挂起或失败。*
|
||||
*如果您未进行最开始的配置步骤，ESP-IDF 将提示在命令行中进行配置 - 但由于 Eclipse 暂时不支持相关功能，因此该项目将挂起或创建失败。*
|
||||
|
||||
* 返回 Eclipse IDE 界面中，选择 “Project” -> “Build” 建立您的项目。
|
||||
* 返回 Eclipse IDE 界面中，选择 “Project” -> “Build” 创建您的项目。
|
||||
|
||||
**提示**：如果您已经在 Eclipse IDE 环境外创建了项目，则可能需要选择 “Project” -> “Clean before choosing Project” -> “Build”，允许 Eclipse 查看所有源文件的编译器参数，并借此确定头文件包含路径。
|
||||
|
||||
在 Eclipse IDE 中烧录项目
|
||||
--------------------------
|
||||
|
||||
您可以将 ``make flash`` 目标放在 Eclipse 项目中，使用 Eclipse UI 中的 ``esptool.py`` 进行烧录：
|
||||
您可以将 ``make flash`` 目标放在 Eclipse 项目中，通过 Eclipse UI 调用 ``esptool.py`` 进行烧录：
|
||||
|
||||
* 打开 “Project Explorer”，并右击您的项目（请注意右击项目本身，而非项目下的子文件，否则 Eclipse 可能无法找到正确的 ``Makefile``）。
|
||||
* 打开 “Project Explorer”，并右击您的项目（请注意右击项目本身，而非项目下的子文件，否则 Eclipse 可能会找到错误的 ``Makefile``）。
|
||||
|
||||
* 从菜单中选择 “Make Targets” -> “Create”。
|
||||
|
||||
* 输入 “flash” 为目标名称，其他选项使用默认值。
|
||||
|
||||
* 选择 “Project” -> “Make Target” -> “Build (快捷键：Shift + F9）”，创建自定义烧录目标，用于编辑、烧录项目。
|
||||
* 选择 “Project” -> “Make Target” -> “Build (快捷键：Shift + F9）”，创建自定义烧录目标，用于编译、烧录项目。
|
||||
|
||||
注意，您将需要通过 ``make menuconfig``，设置串行端口和其他烧录选项。``make menuconfig`` 仍需通过命令操作（请见平台的对应指南）。
|
||||
注意，您将需要通过 ``make menuconfig``，设置串行端口和其他烧录选项。``make menuconfig`` 仍需通过命令行操作（请见平台的对应指南）。
|
||||
|
||||
如有必要，请按照相同步骤添加 ``bootloader`` 和 ``partition_table``。
|
||||
如有需要，请按照相同步骤添加 ``bootloader`` 和 ``partition_table``。
|
||||
|
||||
相关文档
|
||||
--------
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
ESP32-PICO-KIT V4 入门指南
|
||||
============================
|
||||
|
||||
用户指南介绍了如何开始使用 ESP32-PICO-KIT V4 迷你开发板。有关 ESP32-PICO-KIT 其他版本的内容，请见 :doc:`../hw-reference/index`。
|
||||
本指南介绍了如何开始使用 ESP32-PICO-KIT V4 迷你开发板。有关 ESP32-PICO-KIT 其他版本的介绍，请见 :doc:`../hw-reference/index`。
|
||||
|
||||
|
||||
准备工作
|
||||
|
|
@ -17,11 +17,11 @@ ESP32-PICO-KIT V4 入门指南
|
|||
简介
|
||||
----
|
||||
|
||||
ESP32-PICO-KIT V4 是一款来自`乐鑫 <https://espressif.com>`_，其内核采用了具有完整 Wi-Fi 和蓝牙功能的 ESP32 系 SIP 模组 ESP32-PICO-D4。与其他 ESP32 系模组相比，ESP32-PICO-D4 模组已将 40 MHz 晶体振荡器、4 MB flash、滤波电容及射频匹配链路等所有外围器件无缝集成进封装内，无需外围元器件即可工作。这将大大降低了用户额外采购元器件的数量和成本，及额外组装测试的复杂度。
|
||||
ESP32-PICO-KIT V4 是一款来自 `乐鑫 <https://espressif.com>`_ 的开发板，其核心采用了具有完整 Wi-Fi 和蓝牙功能的 ESP32 系列 SIP 模组 ESP32-PICO-D4。与其他 ESP32 系列模组相比，ESP32-PICO-D4 模组已将 40 MHz 晶体振荡器、4 MB flash、滤波电容及射频匹配链路等所有外围器件无缝集成进封装内，无需外围元器件即可工作。这将大大降低了用户额外采购元器件的数量和成本，及额外组装测试的复杂度。
|
||||
|
||||
ESP32-PICO-KIT V4 集成了一个 USB-UART 桥接电路，可连接至 PC 的 USB 端口进行下载和调试。
|
||||
|
||||
为了便于连接，ESP32-PICO-D4 上的所有 IO 信号和系统电源管脚均通过开发板两侧的排针（每侧 20 个 x 0.1 英寸）引出。为了方便在微型面包板上的使用，ESP32-PICO-KIT V4 开发板每侧的 20 个管脚中，有 17 个引出了排针，另外 3 个靠近天线的管脚不引出，可供用户最后焊接使用。
|
||||
为了便于连接，ESP32-PICO-D4 上的所有 IO 信号和系统电源管脚均通过开发板两侧的排针（每侧 20 个 x 0.1 英寸间隔）引出。为了方便在微型面包板上的使用，ESP32-PICO-KIT V4 开发板每侧的 20 个管脚中，有 17 个引出了排针，另外 3 个靠近天线的管脚不引出，可供用户最后焊接使用。
|
||||
|
||||
.. note::
|
||||
|
||||
|
|
@ -40,28 +40,28 @@ ESP32-PICO-KIT V4 开发板的尺寸为 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4")
|
|||
功能说明
|
||||
--------
|
||||
|
||||
ESP32-PICO-KIT V4 开发板的关键元件、接口及控制方式如下文所示。
|
||||
ESP32-PICO-KIT V4 开发板的主要元件、接口及控制方式如下文所示。
|
||||
|
||||
ESP32-PICO-D4
|
||||
标准 ESP32-PICO-D4 模组，已焊接至 ESP32-PICO-KIT V4 开发板，具备 ESP32 芯片的完整功能，仅需连接天线、LC 匹配电路、耦合电容和 EN 信号上拉电阻即可正常工作。
|
||||
ESP32-PICO-KIT V4 开发板上焊接的标准 ESP32-PICO-D4 模组，集成了 ESP32 芯片的完整系统，仅需连接天线、LC 匹配电路、退耦电容和 EN 信号上拉电阻即可正常工作。
|
||||
|
||||
LDO
|
||||
5V-to-3.3V 低压差稳压器
|
||||
|
||||
USB-UART 桥
|
||||
单芯片 USB-UART 桥，可提供高达 1 Mbps 的传输速率。
|
||||
USB-UART 桥接器
|
||||
单芯片 USB-UART 桥接器，可提供高达 1 Mbps 的传输速率。
|
||||
|
||||
Micro USB 接口
|
||||
USB 接口，可用作电路板的供电电源及连接 PC 端的通信接口。
|
||||
|
||||
5V LED 电源指示灯
|
||||
当开发板通电后（USB 或外部 5V），该指示灯将亮起。更多信息，请见 `相关文档`_ 技术规格书中的原理图。
|
||||
当开发板通电后（USB 或外部 5V），该指示灯将亮起。更多信息，请见 `相关文档`_ 中的原理图。
|
||||
|
||||
I/O
|
||||
I/O ESP32-PICO-D4 上的所有管脚均通过开发板的排针引出。用户可以对 ESP32 进行编程，实现 PWM、ADC、DAC、I2C、I2S、SPI 等多种功能。更多信息，请见章节 `管脚说明`_。
|
||||
|
||||
BOOT 键
|
||||
长按 BOOT 键，并按下 EN 键进入固件下载模式，通过串口下载固件。
|
||||
按下 BOOT 键并保持，同时按一下 EN 键（此时不要松开 BOOT 键）进入固件下载模式，通过串口下载固件。
|
||||
|
||||
EN 键
|
||||
复位键，可重置系统。
|
||||
|
|
@ -87,7 +87,7 @@ ESP32-PICO-KIT V4 支持以下几种供电模式：
|
|||
|
||||
.. warning::
|
||||
|
||||
上述供电模式不可同时使用，否则可能会损坏电路板和/或电源。
|
||||
上述供电模式不可同时连接，否则可能会损坏电路板和/或电源。
|
||||
|
||||
|
||||
应用程序开发
|
||||
|
|
@ -98,16 +98,16 @@ ESP32-PICO-KIT V4 支持以下几种供电模式：
|
|||
|
||||
有关应用程序开发的具体步骤，请见章节 :doc:`index`：
|
||||
|
||||
* :ref:`设置 Toolchain <get-started-setup-toolchain>`，用 C 语言开发应用
|
||||
* :ref:`设置 Toolchain <get-started-setup-toolchain>`，以便用 C 语言开发应用
|
||||
* :ref:`连接 <get-started-connect>` 模组至 PC，并确认访问状态
|
||||
* :ref:`构建并向 ESP32 烧录 example <get-started-build-flash>`
|
||||
* 即刻 :ref:`监测 <get-started-build-monitor>` 应用程序的动作
|
||||
* :ref:`即刻监测 <get-started-build-monitor>` 应用程序的动作
|
||||
|
||||
|
||||
管脚说明
|
||||
--------
|
||||
|
||||
下表提供了介绍了开发板 I/O 管脚的**名称**和**功能**，具体布局与 `相关文档`_ 中的原理图一致。请参考 :ref:`get-started-pico-kit-v4-board-front`。
|
||||
下表介绍了开发板 I/O 管脚的 **名称** 和 **功能**，具体布局请见 `相关文档`_ 中的原理图。请参考 :ref:`get-started-pico-kit-v4-board-front` 。
|
||||
|
||||
|
||||
Header J2
|
||||
|
|
@ -178,12 +178,12 @@ Header J3
|
|||
|
||||
.. _get-started-pico-kit-v4-pin-notes:
|
||||
|
||||
**Notes to** `管脚说明`_
|
||||
**备注**
|
||||
|
||||
1. 该管脚已连接至 ESP32-PICO-D4 的内置 flash 管脚。
|
||||
2. 当用作 ADC_PRE_AMP 时，请在以下位置增加 270 pF 电容：(a) SENSOR_VP 和 IO37 之间；(b) SENSOR_VN 和 IO38 之间。
|
||||
3. 32.768 kHz 晶振：(a) 输入；(b) 输出。
|
||||
4. 该管脚已连接至开发板的 USB 桥芯片。
|
||||
4. 该管脚已连接至开发板的 USB 桥接器芯片。
|
||||
5. ESP32-PICO-KIT 内置 SPI flash 的工作电压为 3.3V。因此，strapping 管脚 MTDI 在模组重启过程中应保持低电平。
|
||||
|
||||
|
||||
|
|
@ -209,7 +209,7 @@ Header J3
|
|||
-----------------
|
||||
|
||||
* `ESP32-PICO-KIT V4 原理图 <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4_schematic.pdf>`_ (PDF)
|
||||
* `ESP32-PICO-D4 技术规格书 <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
|
||||
* `ESP32-PICO-D4 技术规格书 <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_cn.pdf>`_ (PDF)
|
||||
* :doc:`../hw-reference/index`
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -142,7 +142,7 @@ ESP-IDF 将会被下载到 ``~/esp/esp-idf``。
|
|||
将 :example:`get-started/hello_world` 拷贝到 ``~/esp`` 目录： ::
|
||||
|
||||
cd ~/esp
|
||||
cp -r $IDF_PATH/examples/get-started/hello_world
|
||||
cp -r $IDF_PATH/examples/get-started/hello_world .
|
||||
|
||||
ESP-IDF 的 :idf:`examples` 目录下有一系列示例工程，都可以按照上面的方法进行创建。
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue