Add a post about how to use idf-rust the docker image

Author: paul356

_org/2024-11-11-rust-on-esp-series_1.org

@@ -23,7 +23,9 @@ sync_wexin: 1
 如果你熟悉docker的使用，有一个更加简便的方法就是使用docker镜像[[https://hub.docker.com/r/espressif/idf-rust/tags][idf-rust]]，这个镜像已经包含一个安装好了的Rust开发环境。下面是安装Rust on ESP的详细过程。
 
 1. 安装Rust on ESP开发环境
+
    开发环境基于通用的Rust的开发环境，第一步和安装普通的Rust开发环境一样。如果是Linux环境，可以在命令行中运行[[https://rustup.rs/][rustup]]网站的安装命令。这个命令会自动下载Rust开发环境并安装。
+
    #+begin_src shell
      curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    #+end_src
@@ -45,9 +47,10 @@ sync_wexin: 1
 
    - GCC工具链用于链接过程，并负责生成二进制文件
 
-   安装过程可能需要花不少时间，一方面因为需要下载不少软件组件，另外还受到下载速度影响。如果网速不稳，经常遇到下载软件包失败的问题，可能需要通过代理或镜像来解决。网络问题是当前安装过程中的最大麻烦，其他过程还比较简单。
+     安装过程可能需要花不少时间，一方面因为需要下载不少软件组件，另外还受到下载速度影响。如果网速不稳，经常遇到下载软件包失败的问题，可能需要通过代理或镜像来解决。网络问题是当前安装过程中的最大麻烦，其他过程还比较简单。
 
 2. 安装系统库的依赖
+
    成功完成上面的步骤，我们已经安装好了开发环境。但要使用Rust系统库std，我们还要安装std依赖的组件。面向ESP的系统库std有两个依赖，ESP-IDF开发框架和ldproxy库。
 
    先安装ESP-IDF开发框架，第一步安装ESP-IDF依赖的第三方工具。
@@ -66,28 +69,28 @@ sync_wexin: 1
        sudo pacman -S --needed gcc git make flex bison gperf python cmake ninja ccache dfu-util libusb
      #+end_src
 
-   下面安装ESP-IDF框架本身，先下载ESP-IDF的源代码。当前的稳定版本是5.3，所以这里选择代码分支release/v5.3，并更新所有子模块。
-   #+begin_src shell
-     mkdir -p ~/esp
-     cd ~/esp
-     git clone --recursive https://github.com/espressif/esp-idf.git
-     git checkout release/v5.3
-     git submodule update --init --recursive
-   #+end_src
+     下面安装ESP-IDF框架本身，先下载ESP-IDF的源代码。当前的稳定版本是5.3，所以这里选择代码分支release/v5.3，并更新所有子模块。
+     #+begin_src shell
+       mkdir -p ~/esp
+       cd ~/esp
+       git clone --recursive https://github.com/espressif/esp-idf.git
+       git checkout release/v5.3
+       git submodule update --init --recursive
+     #+end_src
 
-   下载好代码后开始ESP-IDF安装过程，进入esp-idf目录，执行下面命令。第二条命令用于将下载源导向乐鑫科技为国内网络提供的资源，这样下载速度会更快。
-   #+begin_src shell
-     cd ~/esp/esp-idf/
-     export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
-     ./install.sh esp32,esp32s2,esp32s3
-   #+end_src
+     下载好代码后开始ESP-IDF安装过程，进入esp-idf目录，执行下面命令。第二条命令用于将下载源导向乐鑫科技为国内网络提供的资源，这样下载速度会更快。
+     #+begin_src shell
+       cd ~/esp/esp-idf/
+       export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
+       ./install.sh esp32,esp32s2,esp32s3
+     #+end_src
 
-   安装好ESP-IDF框架后，再安装ldproxy库，这个比较简单。
-   #+begin_src shell
-     cargo install ldproxy
-   #+end_src
+     安装好ESP-IDF框架后，再安装ldproxy库，这个比较简单。
+     #+begin_src shell
+       cargo install ldproxy
+     #+end_src
 
-   到这里就完成了系统库std依赖的安装，系统库已经包含在espup安装的组件内了，所以系统库本身已经安装好了。
+     到这里就完成了系统库std依赖的安装，系统库已经包含在espup安装的组件内了，所以系统库本身已经安装好了。
 
 ** 开发环境测试
    我们创建Rust on ESP项目需要用到乐鑫提供的一个工具cargo-generate。先安装cargo-generate工具。

_org/2024-11-27-rust-on-esp-series_1_1.org

@@ -0,0 +1,47 @@
+#+OPTIONS: ^:nil
+#+BEGIN_EXPORT html
+---
+layout: default
+title: 使用Rust语言为ESP编程系列一 -- 准备开发环境（续）
+tags: [Rust on ESP, Rust, ESP32]
+nav_order: {{ page.date }}
+sync_wexin: 1
+---
+#+END_EXPORT
+
+* 使用Rust语言为ESP编程系列一 -- 准备开发环境（续） 
+
+** 前言
+前一篇文章[[https://paul356.github.io/2024/11/11/rust-on-esp-series_1.html][使用Rust语言为ESP编程系列一 -- 准备开发环境]]介绍了如何逐个组件安装Rust on ESP环境的方法，过程比较复杂。其实还有一种更加简便的方法，那就是使用乐鑫制作好的docker镜像。这一篇续就是介绍如何通过docker镜像来获得开发环境。
+
+** 安装过程
+使用docker需要先安装docker-ce，安装步骤大家可以自行搜索。另外docker-ce默认从docker.com下载镜像。如果出现下载速度的问题，可以修改成国内的docker仓库，具体步骤可以搜索网上教程。
+
+1. 获取[[https://hub.docker.com/r/espressif/idf-rust/tags][idf-rust]]镜像。
+
+   使用docker pull命令就可以下载idf-rust镜像。这个镜像有不同的tag分别表示针对不同的芯片和环境版本的镜像，我们使用了all_lastest这个tag，可以支持全系列芯片。
+   #+begin_src shell
+     docker pull espressif/idf-rust:all_latest
+     docker images
+   #+end_src
+   最后使用 ~docker images~ 查看下载的镜像信息。
+
+2. 创建idf-rust容器实例。
+
+   使用 ~docker run~ 命令创建容器实例。将 ~<code_path>~ 替换成实际的代码目录。
+   #+begin_src shell
+     docker run -itd -v <code_path>:/code espressif/idf-rust:all_latest bash
+     docker ps
+   #+end_src
+   使用 ~docker ps~ 查看创建的实例ID和名称。下面的命令需要用到实例ID或名称。
+
+   上一条命令创建了容器实例，但创建的容器处于后台运行的状态。需要使用容器时，需要通过下列命令。
+   #+begin_src shell
+     docker exec -it <实例ID或名称> bash
+   #+end_src
+
+   环境安装好了，下面可以进去代码目录，执行 ~cargo build~ 命令编译Rust代码。需要注意的是在上一篇文章中，为了使用已安装好的ESP-IDF环境我们需要在Cargo.toml中增加了配置段 ~[package.metadata.esp-idf-sys]~ ，在idf-rust镜像中是不需要的。
+
+** 总结
+使用docker镜像使得Rust on ESP安装过程变得非常方便，所以花一点时间学习如何docker使用也是非常值得的。现在刀磨好了，我们下面就可以正式砍材了（真正开始探索Rust on ESP）。
+   

_posts/2024-11-11-rust-on-esp-series_1.md

@@ -26,7 +26,9 @@ sync_wexin: 1
 
 如果你熟悉docker的使用，有一个更加简便的方法就是使用docker镜像[idf-rust](https://hub.docker.com/r/espressif/idf-rust/tags)，这个镜像已经包含一个安装好了的Rust开发环境。下面是安装Rust on ESP的详细过程。
 
-1.  安装Rust on ESP开发环境 开发环境基于通用的Rust的开发环境，第一步和安装普通的Rust开发环境一样。如果是Linux环境，可以在命令行中运行[rustup](https://rustup.rs/)网站的安装命令。这个命令会自动下载Rust开发环境并安装。
+1.  安装Rust on ESP开发环境
+    
+    开发环境基于通用的Rust的开发环境，第一步和安装普通的Rust开发环境一样。如果是Linux环境，可以在命令行中运行[rustup](https://rustup.rs/)网站的安装命令。这个命令会自动下载Rust开发环境并安装。
 
     ```shell
     curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
@@ -50,10 +52,12 @@ sync_wexin: 1
     -   支持Xtensa核心的LLVM
 
     -   GCC工具链用于链接过程，并负责生成二进制文件
-    
-    安装过程可能需要花不少时间，一方面因为需要下载不少软件组件，另外还受到下载速度影响。如果网速不稳，经常遇到下载软件包失败的问题，可能需要通过代理或镜像来解决。网络问题是当前安装过程中的最大麻烦，其他过程还比较简单。
+        
+        安装过程可能需要花不少时间，一方面因为需要下载不少软件组件，另外还受到下载速度影响。如果网速不稳，经常遇到下载软件包失败的问题，可能需要通过代理或镜像来解决。网络问题是当前安装过程中的最大麻烦，其他过程还比较简单。
 
-2.  安装系统库的依赖 成功完成上面的步骤，我们已经安装好了开发环境。但要使用Rust系统库std，我们还要安装std依赖的组件。面向ESP的系统库std有两个依赖，ESP-IDF开发框架和ldproxy库。
+2.  安装系统库的依赖
+    
+    成功完成上面的步骤，我们已经安装好了开发环境。但要使用Rust系统库std，我们还要安装std依赖的组件。面向ESP的系统库std有两个依赖，ESP-IDF开发框架和ldproxy库。
 
     先安装ESP-IDF开发框架，第一步安装ESP-IDF依赖的第三方工具。
 
@@ -74,32 +78,32 @@ sync_wexin: 1
         ```shell
         sudo pacman -S --needed gcc git make flex bison gperf python cmake ninja ccache dfu-util libusb
         ```
-    
-    下面安装ESP-IDF框架本身，先下载ESP-IDF的源代码。当前的稳定版本是5.3，所以这里选择代码分支release/v5.3，并更新所有子模块。
-    
-    ```shell
-    mkdir -p ~/esp
-    cd ~/esp
-    git clone --recursive https://github.com/espressif/esp-idf.git
-    git checkout release/v5.3
-    git submodule update --init --recursive
-    ```
-    
-    下载好代码后开始ESP-IDF安装过程，进入esp-idf目录，执行下面命令。第二条命令用于将下载源导向乐鑫科技为国内网络提供的资源，这样下载速度会更快。
-    
-    ```shell
-    cd ~/esp/esp-idf/
-    export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
-    ./install.sh esp32,esp32s2,esp32s3
-    ```
-    
-    安装好ESP-IDF框架后，再安装ldproxy库，这个比较简单。
-    
-    ```shell
-    cargo install ldproxy
-    ```
-    
-    到这里就完成了系统库std依赖的安装，系统库已经包含在espup安装的组件内了，所以系统库本身已经安装好了。
+        
+        下面安装ESP-IDF框架本身，先下载ESP-IDF的源代码。当前的稳定版本是5.3，所以这里选择代码分支release/v5.3，并更新所有子模块。
+        
+        ```shell
+        mkdir -p ~/esp
+        cd ~/esp
+        git clone --recursive https://github.com/espressif/esp-idf.git
+        git checkout release/v5.3
+        git submodule update --init --recursive
+        ```
+        
+        下载好代码后开始ESP-IDF安装过程，进入esp-idf目录，执行下面命令。第二条命令用于将下载源导向乐鑫科技为国内网络提供的资源，这样下载速度会更快。
+        
+        ```shell
+        cd ~/esp/esp-idf/
+        export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
+        ./install.sh esp32,esp32s2,esp32s3
+        ```
+        
+        安装好ESP-IDF框架后，再安装ldproxy库，这个比较简单。
+        
+        ```shell
+        cargo install ldproxy
+        ```
+        
+        到这里就完成了系统库std依赖的安装，系统库已经包含在espup安装的组件内了，所以系统库本身已经安装好了。
 
 
 ## 开发环境测试

_posts/2024-11-27-rust-on-esp-series_1_1.md

@@ -0,0 +1,55 @@
+---
+layout: default
+title: 使用Rust语言为ESP编程系列一 -- 准备开发环境（续）
+tags: [Rust on ESP, Rust, ESP32]
+nav_order: {{ page.date }}
+sync_wexin: 1
+---
+
+
+# 使用Rust语言为ESP编程系列一 – 准备开发环境（续）
+
+
+## 前言
+
+前一篇文章[使用Rust语言为ESP编程系列一 – 准备开发环境](https://paul356.github.io/2024/11/11/rust-on-esp-series_1.html)介绍了如何逐个组件安装Rust on ESP环境的方法，过程比较复杂。其实还有一种更加简便的方法，那就是使用乐鑫制作好的docker镜像。这一篇续就是介绍如何通过docker镜像来获得开发环境。
+
+
+## 安装过程
+
+使用docker需要先安装docker-ce，安装步骤大家可以自行搜索。另外docker-ce默认从docker.com下载镜像。如果出现下载速度的问题，可以修改成国内的docker仓库，具体步骤可以搜索网上教程。
+
+1.  获取[idf-rust](https://hub.docker.com/r/espressif/idf-rust/tags)镜像。
+    
+    使用docker pull命令就可以下载idf-rust镜像。这个镜像有不同的tag分别表示针对不同的芯片和环境版本的镜像，我们使用了all\_lastest这个tag，可以支持全系列芯片。
+    
+    ```shell
+    docker pull espressif/idf-rust:all_latest
+    docker images
+    ```
+    
+    最后使用 `docker images` 查看下载的镜像信息。
+
+2.  创建idf-rust容器实例。
+    
+    使用 `docker run` 命令创建容器实例。将 `<code_path>` 替换成实际的代码目录。
+    
+    ```shell
+    docker run -itd -v <code_path>:/code espressif/idf-rust:all_latest bash
+    docker ps
+    ```
+    
+    使用 `docker ps` 查看创建的实例ID和名称。下面的命令需要用到实例ID或名称。
+    
+    上一条命令创建了容器实例，但创建的容器处于后台运行的状态。需要使用容器时，需要通过下列命令。
+    
+    ```shell
+    docker exec -it <实例ID或名称> bash
+    ```
+    
+    环境安装好了，下面可以进去代码目录，执行 `cargo build` 命令编译Rust代码。需要注意的是在上一篇文章中，为了使用已安装好的ESP-IDF环境我们需要在Cargo.toml中增加了配置段 `[package.metadata.esp-idf-sys]` ，在idf-rust镜像中是不需要的。
+
+
+## 总结
+
+使用docker镜像使得Rust on ESP安装过程变得非常方便，所以花一点时间学习如何docker使用也是非常值得的。现在刀磨好了，我们下面就可以正式砍材了（真正开始探索Rust on ESP）。