diff --git a/docs/en/get-started/index.rst b/docs/en/get-started/index.rst index f126be3ee4..916cffb916 100644 --- a/docs/en/get-started/index.rst +++ b/docs/en/get-started/index.rst @@ -630,6 +630,7 @@ Related Documents establish-serial-connection eclipse-setup + vscode-setup ../api-guides/tools/idf-monitor toolchain-setup-scratch :esp32: ../get-started-legacy/index diff --git a/docs/en/get-started/vscode-setup.rst b/docs/en/get-started/vscode-setup.rst new file mode 100644 index 0000000000..244f5333d2 --- /dev/null +++ b/docs/en/get-started/vscode-setup.rst @@ -0,0 +1,34 @@ +******************************** +Getting Started with VS Code IDE +******************************** + + +We have official support for VS Code and we aim to provide complete end to end support for all actions related to ESP-IDF namely build, flash, monitor, debug, tracing, core-dump, System Trace Viewer, etc. + +Quick Install Guide +=================== + +Recommended way to install ESP-IDF Visual Studio Code Extension is by downloading it from `VS Code Marketplace `_ or following `Quick Installation Guide `_. + +Supported Features +================== + +* **Onboarding**, will help you to quickly install ESP-IDF and its relevant toolchain with just few clicks. +* **Build**, with one click build and multi target build, you can easily build and deploy your applications. +* **Flash**, with both UART and JTAG flash out of the box. +* **Monitoring** comes with inbuilt terminal where you can trigger IDF Monitor Commands from within VS Code as you are used to in traditional terminals. +* **Debugging**, with out of box hardware debugging and also support for postmortem debugging like core-dump, you can analyze the bugs with convenience. +* **GUI Menu Config**, provides with simplified UI for configuring your chip. +* **App & Heap Tracing**, provides support for collecting traces from your application and simplified UI for analyzing them. +* **System View Tracing Viewer**, aims to read and display the *.svdat* files into trace UI, we also support multiple core tracing views. +* **IDF Size Analysis Overview** presents an UI for binary size analysis. +* **`Rainmaker Cloud `_**, we have inbuilt Rainmaker Cloud support where you can edit/read state of your connected IoT devices easily. +* **Code Coverage**, we have inbuilt code coverage support which shall highlight in color which line have been covered. We also render the existing HTML report directly inside the IDE. + + +Bugs & Feature Requests +======================= + +If you face an issue with certain feature of VS Code or VS Code in general we recommend to ask your question in the `forum `_, or open a `github issue `_ for our dev teams to review. + +We also welcome new feature request, most of the features we have today is result of people asking it to implement, or improve certain aspect of the extension, `raise your feature request on github `_. \ No newline at end of file diff --git a/docs/zh_CN/get-started/index.rst b/docs/zh_CN/get-started/index.rst index c85186d04b..291899ab4d 100644 --- a/docs/zh_CN/get-started/index.rst +++ b/docs/zh_CN/get-started/index.rst @@ -531,6 +531,7 @@ Windows 操作系统 establish-serial-connection eclipse-setup + vscode-setup ../api-guides/tools/idf-monitor toolchain-setup-scratch :esp32: ../get-started-legacy/index diff --git a/docs/zh_CN/get-started/vscode-setup.rst b/docs/zh_CN/get-started/vscode-setup.rst new file mode 100644 index 0000000000..bd09d0a171 --- /dev/null +++ b/docs/zh_CN/get-started/vscode-setup.rst @@ -0,0 +1 @@ +.. include:: ../../en/get-started/vscode-setup.rst \ No newline at end of file