Espressif Logo

开始: 在Espressif ESP32-WROVER-KIT V4.1平台上开发应用

使用MicroEJ Software Development Kit在Espressif ESP32-WROVER-KIT V4.1开发板上开发多种语言(C, Java等)的应用.

请按照以下步骤,让您的第一个应用在虚拟设备和真实设备(最终的硬件平台)上运行. 如果您不熟悉MicroEJ, 可以访问Discover MicroEJ 了解我们的技术原理.

1 – 下载MICROEJ SDK

MICROEJ SDK 是基于Eclipse构建的IDE,用于为基于MicroEJ Virtual Execution Environment (VEE)平台创建特性丰富的应用程序.


支持的操作系统

MICROEJ SDK 可以运行在所有常见的操作系统上: Windows (7; 8-8.1; 10), Linux, macOS.

运行MICROEJ SDK 需要 Java™ Runtime Environment 8, 下载Java™ Runtime Environments.


下载MICROEJ SDK

点击下列按钮获得安装包(MICROEJ SDK下载说明)

下载 MicroEJ SDK Dist. 20.12

2 – 安装MICROEJ SDK

  • 解压缩下载的安装包
  • 运行解压缩后的可执行文件
  • 如果是windows系统,允许应用对你的设备进行更改(拥有管理员权限)
  • 执行后续的安装步骤
  • 安装MICROEJ SDK后,必须检查是否有任何更新,并且最终安装这些更新
    • 启动MICROEJ SDK
    • 在主窗口的菜单栏,选择 Help, 然后点击 Check for Updates

    Check for updates

    • 完成后续升级步骤

 

3 – 示例根据黑色VEE示例,下载并使用ESP32WROVER虚拟设备

MicroEJ 提供了各种VEE 示例示例,以不同颜色命名,用来区分这些VEE提供给应用程序的的各种API接口

  • 开始 MICROEJ SDK
  • 选在存储应用的workspace, 如果你不熟悉Eclipse的workspace,选择默认值点击 Launch.
  • 选择MicroEJ repository用来存储虚拟设备,如果你不熟悉MicroEJ repositories机制,选择默认值点击 OK.
  • 选择Window > Preferences > MicroEJ > Virtual Device menu.
  • 下载  ESP32WROVER 虚拟设备 (See release notes)
  • 点击 Import... 按键 选择刚才下载的ESP32WROVER虚拟设备 (所有的虚拟设备文件都以 .vde 结尾).
  •  接受许可条款并点击Finish. ESP32WROVER虚拟设备将被成功安装.
  • s获得示例应用合集. 下载 application samples
  • 选择File > Import... > General > Existing Projects into Workspace > Select archive file 选择下载的压缩包.
  • 导入所有可选内容.
  • 打开 Project Explorer Window > Show View > Project Explorer. 第一个可运行的应用已经导入完成,可以运行了:
    • Hello World APP: com.microej.demo.hello
    • Hello Bluetooth APP: com.microej.example.bluetooth.hello
    • Hello REST APP:com.microej.example.iot.ssl.rest.headless

Demo APP for Espressif ESP32WROVER VD

4 – 在ESP32WROVER虚拟设备上动态下载和运行示例程序

在ESP32WROVER虚拟设备上下载和运行HelloWorld示例

  • 右键点击MicroEJ工程 com.microej.demo.hello.

Run an embedded application on MicroEJ SDK

  • 右键点击MicroEJ工程 Run As > MicroEJ Application.
  •  如果程序需要虚拟设备信息 则选择ESP32WROVER虚拟设备 : VDE-BLACK-ESP32WROVER-RQQAW.
  • ESP32WROVER虚拟设备会运行并且在显示器上显示简单的UI界面.

 

Developement on Espressif ESP32 WROVER KIT UI Example


5 – 基于黑色VEE示例,在ESP32WROVER硬件上动态下载和运行示例程序

硬件配置

 

  • 本文所有例程都在 ESP32 WROVER kit v4.1 上测试通过(如果您使用其他ESP32开发板,请联系MicroEJ支持部门)

Software Development on ESP32 WROVER ESPRESSIF

  • 移除电阻R167: 这样可以同时支持显示屏和SD卡(移除R167可以解决SD卡失效检测出错)

Software Development on ESP32 ESPRESSIF Board

  • 插入microSD卡
  • JP5 USB接口连接到电脑,可以获得UART标准打印输出,配置如下: : 115200 bps, 8N1, no handshake

在ESP32WROVER硬件上运行黑色VEE: 烧写固件代码

黑色VEE包含了动态应用加载程序,一旦烧写完成 ESP32WROVER硬件就可以动态加载(链接并运行)应用代码, 并且不用重新启动硬件.

  • 使用USB(J5插座)电缆连接计算机,确认 JP7 跳到USB_5V位置.
  • 需要使用ESP-IDF提供的 esptool python 脚本.
  • 可以从 GitHub 下载ESP-IDF 3.1.1, 并解压缩.
  • 相对于ESP-IDF根目录,下载工具脚本位于 /components/esptool_py/esptool/esptool.py
  • 脚本执行需要安装 Python 及相关依赖包(使用pip工具在CMD终端里执行) python -m pip install serial pyserial
  • 获取ESP32-WROVER开发板的黑色VEE : 下载所有的.bin文件 (参考 release notes) 并且把他们放到独立的bin文件夹.
  • 下面的命令用来烧写ESP32-WROVER. 假设你在放置bin文件的目录执行这些命令
    • 将 ESPTOOLSXXX替换为Espressif工具链的目录
    • 替换COMXXX为开发板使用的串口(ESP32 Wrover Kit v4.1包含两个串口, 点击这里获得更多信息).
python.exe ESPTOOLSXXX/components/esptool_py/esptool/esptool.py --chip esp32 --port COMXXX --baud 921600 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size detect 0x1000 bootloader_1.1.1.bin 0x8000 partitions_microej_multiapp_1.1.1.bin 0x10000 BLACK-ESP32WROVER-RQQAW-1.1.1.bin
  • 启动烧写了MicroEJ 黑色 VEE的ESP32-WROVER, 它会在microSD卡中自动创建WiFi配置文件.
  • 开发板断电取出microSD卡.
  • 使用计算机读取microSD卡.
  • 编辑文件 /usr/storage/features/EspressifLauncher/wifi.properties.list, 填入WiFi热点信息(不用设置安全选项).
    Wifi config
    确认删除了两行开头的#号
  • 将microSD卡插回开发板并且上电启动.
  • ESP32-WROVER开发板会连接到指定的WiFi热点,在连接成功后屏幕上会显示IP地址,通过UART可以查看日志信息(有关参数值,请参见上面的硬件配置).注意如果WiFi信号不佳, BLACK VEE会不断尝试连接直到成功为止.Wifi connection

动态下载和运行hello world示例

有很多方式可以下载应用到MicroEJ支持的设备: 应用商店, push/pull模式等. 对于第一个应用, 我们使用一个简单的步骤:
MicroEJ SDK使用Runner的方式执行启动命令(所有的Runner都可以在 Windows > Show views > Others...General > Runners 找到或者点击 图标). 你应该已经启动过 com.microej.demo.hello 如果没有请试着执行一次,我们会重用已经创建好的Runner

  • Run > Run Configurations..., 选择 com.microej.demo.hello HelloEntryPoint 并创建一个副本.

  • 新创建的Runner会被命名为 com.microej.demo.hello HelloEntryPoint (1).
  • 选择并改名为Deploy com.microej.demo.hello HelloEntryPoint.
  • Execution / Execute on Device 选项里选择 Local Deployment to Local Deployment (Socket).

  • Configuration
  • 页填入开发板IP地址(已经显示在屏幕上).

  • 点击Run按钮: 应用会被增量OTA下载到硬件设备
  • 应用下载完成之后, BLACK VEE会自动执行它: Hello World会被执行并显示.
  • BLACK VEE通过可在板载4001端口访问的web应用提供了远程APP管理服务,.它是BLACK VEE提供的一个内置的应用:Forge Connect. 打开浏览器访问 IP_OF_THE_BOARD:4001. 你可以启动或者停止Hello应用. 这个应用被安装在文件系统里, 所以开发板重启之后你可以使用Forge Connect APP(内置远程服务)重新启动应用.

Play with forge connect

  • BLACK VEE是一个完整安全的嵌入式平套, 拥有整套的API接口:UI/UX, File System, Network, Security, OSGi-like components framework等

Black VEE API


(可选项)打包WPK文件, 动态下载和运行Hello World例程

这是一个可选步骤,是另外一种部署应用到真实硬件的方法. WPK文件打包了应用需要的所有资源. 获取WPK需要:

  • 选择工程com.microej.demo.hello 在右键菜单里选择 Build Module.

Build an APP

  • 应用会被编译并存储在工程文件目录com.microej.demo.hello\target~\artifacts\hello.wpk
  • 选择com.microej.demo.hello 在右键菜单里选择 Run As > Run Configuration....

Run configuration

  • 选择 MicroEJ Tools, 在右键菜单选择 New. 这将会创建一个新的Runner. 填入名字比如 Download Hello APP, 接着选择通信方式: WPK Local deployment over Socket.

Run configuration

  • 选择 Configuration标签填写开发板IP地址(显示在屏幕上) 并且提供hello.wpk 文件地址.Run configuration
  • 点击Run按钮: 应用会被增量OTA下载到硬件设备.
  • 与第一次运行应用一样, BLACK VEE会自动启动应用: Hello APP会被启动并显示.