From 0a033b5e053bf05144d8624abf3e946fd862d7b4 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Tue, 26 Jun 2018 12:54:15 +0800 Subject: [PATCH 01/11] Update eclipse-setup.rst according to https://gitlab.espressif.cn:6688/idf/esp-idf/merge_requests/2617 --- docs/zh_CN/get-started/eclipse-setup.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/zh_CN/get-started/eclipse-setup.rst b/docs/zh_CN/get-started/eclipse-setup.rst index 886ee03faa..699864de28 100644 --- a/docs/zh_CN/get-started/eclipse-setup.rst +++ b/docs/zh_CN/get-started/eclipse-setup.rst @@ -59,12 +59,18 @@ Windows 用户 * 点击 “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 command pattern“ 输入框的起始位置输入 ``xtensa-esp32-elf-``，最终的完整编译器命令应为 ``xtensa-esp32-elf-(g?cc)|([gc]\+\+)|(clang)``。 + * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)``。 * 前往 “C/C++ General” -> “Indexer” 属性页面。 * 去除 "Allow heuristic resolution of includes" 勾选。启用此选项时，Eclipse 有时无法找到正确的头文件目录。 +点击 “C/C++ General" -> "Indexer” 属性页。 + + * 选择 “Enable project specific settings” 以启用本页上的其他设置。 + + * 取消选中 “Allow heuristic resolution of includes”。启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 + .. _eclipse-build-project: 在 Eclipse IDE 中创建项目 From d57649aed1e562165e10c1e28b7a113d8948e131 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Tue, 26 Jun 2018 12:55:34 +0800 Subject: [PATCH 02/11] Update eclipse-setup-windows.rst according to https://gitlab.espressif.cn:6688/idf/esp-idf/merge_requests/2617. --- docs/zh_CN/get-started/eclipse-setup-windows.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/zh_CN/get-started/eclipse-setup-windows.rst b/docs/zh_CN/get-started/eclipse-setup-windows.rst index f386d83b8d..a31f5def76 100644 --- a/docs/zh_CN/get-started/eclipse-setup-windows.rst +++ b/docs/zh_CN/get-started/eclipse-setup-windows.rst @@ -61,7 +61,13 @@ Windows 平台上的 Eclipse 配置 * 从 “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))``。 + * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)``。 + +点击 “C/C++ General" -> "Indexer” 属性页。 + + * 选择 “Enable project specific settings” 以启用本页上的其他设置。 + + * 取消选中 “Allow heuristic resolution of includes”。启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 在 Eclipse IDE 中创建项目 From fe7647936acce6b9351bb3d66a8dcd68c7cf150d Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Tue, 26 Jun 2018 13:13:08 +0800 Subject: [PATCH 03/11] Update eclipse-setup-windows.rst --- docs/zh_CN/get-started/eclipse-setup-windows.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zh_CN/get-started/eclipse-setup-windows.rst b/docs/zh_CN/get-started/eclipse-setup-windows.rst index a31f5def76..7ba6e22723 100644 --- a/docs/zh_CN/get-started/eclipse-setup-windows.rst +++ b/docs/zh_CN/get-started/eclipse-setup-windows.rst @@ -44,7 +44,7 @@ Windows 平台上的 Eclipse 配置 * 点击 “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” 属性页面。 @@ -61,7 +61,7 @@ Windows 平台上的 Eclipse 配置 * 从 “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 command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)``。 + * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` 点击 “C/C++ General" -> "Indexer” 属性页。 From 6a1250cf191493e784068b50962fc913ead50f7f Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Tue, 26 Jun 2018 13:15:13 +0800 Subject: [PATCH 04/11] Update eclipse-setup.rst --- docs/zh_CN/get-started/eclipse-setup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh_CN/get-started/eclipse-setup.rst b/docs/zh_CN/get-started/eclipse-setup.rst index 699864de28..41974a80b5 100644 --- a/docs/zh_CN/get-started/eclipse-setup.rst +++ b/docs/zh_CN/get-started/eclipse-setup.rst @@ -59,7 +59,7 @@ Windows 用户 * 点击 “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 command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)``。 + * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` * 前往 “C/C++ General” -> “Indexer” 属性页面。 From c17c0a2dc594d4cdaf535ed6557eebed1f2417a6 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Tue, 26 Jun 2018 13:19:14 +0800 Subject: [PATCH 05/11] Update eclipse-setup-windows.rst From a0928b4ce286acb0c860f835dd96add1048709ee Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Thu, 28 Jun 2018 15:00:40 +0800 Subject: [PATCH 06/11] Update eclipse-setup-windows.rst --- docs/zh_CN/get-started/eclipse-setup-windows.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/zh_CN/get-started/eclipse-setup-windows.rst b/docs/zh_CN/get-started/eclipse-setup-windows.rst index 7ba6e22723..32f312c3c3 100644 --- a/docs/zh_CN/get-started/eclipse-setup-windows.rst +++ b/docs/zh_CN/get-started/eclipse-setup-windows.rst @@ -40,7 +40,7 @@ Windows 平台上的 Eclipse 配置 项目属性 ---------- -* 新项目将出现在 “Project Explorer” 下。请右键选择该项目，并在菜单中选择顶层 “Properties”。 +* 新项目将出现在 “Project Explorer” 下。请右键选择该项目，并在菜单中选 “Properties”。 * 点击 “C/C++ Build” 属性页。 @@ -50,7 +50,7 @@ Windows 平台上的 Eclipse 配置 * 选择 “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 安装到其他目​​录，这里请自行调整）。 @@ -61,13 +61,15 @@ Windows 平台上的 Eclipse 配置 * 从 “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 command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` + * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` 点击 “C/C++ General" -> "Indexer” 属性页。 * 选择 “Enable project specific settings” 以启用本页上的其他设置。 - * 取消选中 “Allow heuristic resolution of includes”。启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 +.. note:: + +取消选中 “Allow heuristic resolution of includes”。因为启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 在 Eclipse IDE 中创建项目 From 084a6b54e29f5754611042dec33facd63cf6a3e0 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Thu, 28 Jun 2018 15:10:36 +0800 Subject: [PATCH 07/11] Update eclipse-setup-windows.rst --- docs/zh_CN/get-started/eclipse-setup-windows.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zh_CN/get-started/eclipse-setup-windows.rst b/docs/zh_CN/get-started/eclipse-setup-windows.rst index 32f312c3c3..9b7fa45391 100644 --- a/docs/zh_CN/get-started/eclipse-setup-windows.rst +++ b/docs/zh_CN/get-started/eclipse-setup-windows.rst @@ -58,8 +58,8 @@ Windows 平台上的 Eclipse 配置 * 点击 “C/C++ General” -> “Preprocessor Include Paths, Macros, etc.” 属性页。 * 点击 “Providers” 选项卡。 - - * 从 “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 Cross GCC Built-in Compiler Settings”，将 “Command to get compiler specs” 修改为 ``xtensa-esp32-elf-gcc ${FLAGS} -E -P -v -dD "${INPUTS}"`` * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` From d9653e75e988b40fe6340666bb4ccb938882126d Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Thu, 28 Jun 2018 15:16:20 +0800 Subject: [PATCH 08/11] Update eclipse-setup.rst --- docs/zh_CN/get-started/eclipse-setup.rst | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/zh_CN/get-started/eclipse-setup.rst b/docs/zh_CN/get-started/eclipse-setup.rst index 41974a80b5..bcd73e0cd2 100644 --- a/docs/zh_CN/get-started/eclipse-setup.rst +++ b/docs/zh_CN/get-started/eclipse-setup.rst @@ -57,9 +57,11 @@ Windows 用户 * 前往 “C/C++ General” -> “Preprocessor Include Paths” 属性页面。 - * 点击 “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 command pattern:” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` + * 点击 “Providers” 选项卡。 + + * 从 “Providers” 列表中选择 “CDT Cross GCC Built-in Compiler Settings”，将 “Command to get compiler specs” 修改为 ``xtensa-esp32-elf-gcc ${FLAGS} -E -P -v -dD "${INPUTS}"`` + + * 从 “Providers” 列表中选择 “CDT GCC Build Output Parser”，将 “Compiler command pattern” 修改为 ``xtensa-esp32-elf-(gcc|g\+\+|c\+\+|cc|cpp|clang)`` * 前往 “C/C++ General” -> “Indexer” 属性页面。 @@ -69,7 +71,9 @@ Windows 用户 * 选择 “Enable project specific settings” 以启用本页上的其他设置。 - * 取消选中 “Allow heuristic resolution of includes”。启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 +.. note:: + +取消选中 “Allow heuristic resolution of includes”。因为启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 .. _eclipse-build-project: @@ -95,11 +99,11 @@ Windows 用户 * 打开 “Project Explorer”，并右击您的项目（请注意右击项目本身，而非项目下的子文件，否则 Eclipse 可能会找到错误的 ``Makefile``）。 -* 从菜单中选择 “Make Targets” -> “Create”。 +* 从菜单中选择 “Build Targets” -> “Create”。 * 输入 “flash” 为目标名称，其他选项使用默认值。 -* 选择 “Project” -> “Make Target” -> “Build (快捷键：Shift + F9）”，创建自定义烧录目标，用于编译、烧录项目。 +* 选择 “Project” -> “Build Target” -> “Build (快捷键：Shift + F9）”，创建自定义烧录目标，用于编译、烧录项目。 注意，您将需要通过 ``make menuconfig``，设置串行端口和其他烧录选项。``make menuconfig`` 仍需通过命令行操作（请见平台的对应指南）。 From 7fe130c1713668aec19e00ba2b341bbe56a90530 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Thu, 28 Jun 2018 16:28:54 +0800 Subject: [PATCH 09/11] Update eclipse-setup.rst From 3d6d252b3ea3d743b86de9f49fd8152c9f6a2b76 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Thu, 28 Jun 2018 17:57:55 +0800 Subject: [PATCH 10/11] Update eclipse-setup-windows.rst --- docs/zh_CN/get-started/eclipse-setup-windows.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/zh_CN/get-started/eclipse-setup-windows.rst b/docs/zh_CN/get-started/eclipse-setup-windows.rst index 9b7fa45391..6b9de3696b 100644 --- a/docs/zh_CN/get-started/eclipse-setup-windows.rst +++ b/docs/zh_CN/get-started/eclipse-setup-windows.rst @@ -69,8 +69,7 @@ Windows 平台上的 Eclipse 配置 .. note:: -取消选中 “Allow heuristic resolution of includes”。因为启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 - + 取消选中 “Allow heuristic resolution of includes”。因为启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 在 Eclipse IDE 中创建项目 --------------------------- From 9e3c3f267e2bc59404a7a9f48a708df579b79458 Mon Sep 17 00:00:00 2001 From: Jin Fang Cheng Cheng Date: Thu, 28 Jun 2018 17:58:19 +0800 Subject: [PATCH 11/11] Update eclipse-setup.rst --- docs/zh_CN/get-started/eclipse-setup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh_CN/get-started/eclipse-setup.rst b/docs/zh_CN/get-started/eclipse-setup.rst index bcd73e0cd2..566b7de5c5 100644 --- a/docs/zh_CN/get-started/eclipse-setup.rst +++ b/docs/zh_CN/get-started/eclipse-setup.rst @@ -73,7 +73,7 @@ Windows 用户 .. note:: -取消选中 “Allow heuristic resolution of includes”。因为启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 + 取消选中 “Allow heuristic resolution of includes”。因为启用此选项时，有时会导致 Eclipse 无法找到正确的头文件目录。 .. _eclipse-build-project: