Get Started

[中文]

本文档希望用十分钟的阅读以及三十分钟的实操时间, 使用户获得缤图平台开发软件的第一印象. 包括PC平台的模拟器运行和硬件平台运行两个部分.

模拟器运行

模拟器在win10/11环境下测试运行

1. 安装Microsoft Visual Studio 2022 Community开发环境
    * 下载 Microsoft Visual Studio 2022 Community installer
        https://www.visualstudio.com/downloads/
    * 启动安装器,在workloads标签选择"Desktop development for C++"选项. 在"Individual Components"标签,
      选择"Windows 10 SDK (10.0.19041.0)" (win10会自动选择, win11需要手工选择). 处理后续安装.
    * 确认可以启动"x86 Native Tools Command Prompt for VS 2022"命令行终端
2. 配置BEANTO开发环境,读入host底包
    * 下载发行包 beanable_lts.zip 并解压缩到x:\beanable_lts, 磁盘可以自由选择, 这里假设存储在x:
    * 设置环境变量 BEANABLE 为 x:\beanable_lts
    * 在环境变量Path里加入%BEANABLE%\build\bin\win\release
    * 设置环境变量 FONTBM 为 %BEANABLE%\third_party\fontbm\fontbm.exe
    * 启动"x86 Native Tools Command Prompt for VS 2022"命令行终端
        cd %BEANABLE%\beanto_host
    * 执行xsbug启动debugger
        xsbug
    * 执行mcsim启动模拟器, 在模拟器里open选择x:\beanable_lts\beanto_host目录下的mc.dll载入host驱动底包
        mcsim
mcsim — 主窗口

mcsim

3. 读入app运行
    * 启动新的"x86 Native Tools Command Prompt for VS 2022"命令行终端
        cd %BEANABLE%\beanto_examples\testScreen
    * 运行testScreen测试
        mcrun -d -m -p win
testScreen — 主窗口

testScreen

4. 更多的例子
    * 运行dashboard例子
        cd %BEANABLE%\beanto_examples\dashboard
    * 运行dashboard测试
        mcrun -d -m -p win
dashboard — 主窗口

dashboard

4. 更新beanable_lts发行包会更新host底包, 重新读取mc.dll即可

硬件平台运行

缤图目前支持的平台是esp32s3_hmi：

  • 2.4 GHz Wi-Fi

  • 低功耗蓝牙

  • 高性能 Xtensa® 32 位 LX7 双核处理器

  • 运行 RISC-V 或 FSM 内核的超低功耗协处理器

  • 多种外设

  • 内置安全硬件

  • USB OTG 接口

  • USB 串口/JTAG 控制器

  • 800*400 4.3寸显示屏支持电容触摸

1. 安装esp-idf-v4.4.3开发环境
    * 下载 esp-idf-v4.4.3

2. 硬件已经烧写好了host底包, 会自动运行已经读取的例子
    * 这里默认已经配置好beanable_lts发行包, win模拟器可以正确运行
    * 将硬件usb线与PC连接好
3. 在硬件运行例子程序
    * testScreen
    * dashboard
4. 更新beanable_lts发行包会提供新的host底包固件
    * 执行beanto_host目录里的flash.bat即可重新烧写