ESP32-MPY-Jama：实践指南

真正理解ESP32-MPY-Jama，要从它处理的任务开始：v1.2 - UI 工具，用于管理带有嵌入式 MicroPython 的 Espressif ESP32 微控制器。一旦进入界面与前端开发环节，视觉还原、交互状态和响应式细节容易遗漏会直接影响交付，这也是我最关心的风险。先选一个包含多状态的真实组件完成实现更稳妥；过程中要观察尺寸、状态、可访问性、资源和不同视口表现，失败也应能解释原因。对愿意逐状态验收界面质量的前端团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

ESP32 MPY-Jama

What's new in version 1.2

:small_orange_diamond: Welcome to ESP32 MPY-Jama, a powerful and versatile cross-platform tool, designed to simplify your development with Espressif's ESP32 microcontrollers and MicroPython.

:small_orange_diamond: The lightweight IDE, file manager, terminal, and real-time dashboards provide all the essential features you need to develop your IoT projects quickly and efficiently on MacOS, Windows, and Linux.

:small_orange_diamond: With startup settings and customizable features, this tool can adapt to your workflow and preferences, making your coding experience seamless and enjoyable.

MacOS on arm64 ▪ MacOS on Intel x86/64 ▪ Windows 64-bits

To make it work under Linux :penguin: click here!

:bookmark_tabs: 目录

• 特点
• 实时系统仪表板
• 实时网络仪表板
• 点击 2 次即可连接 Wi-Fi
• 轻量级集成 IDE
• 嵌入式 Jama 功能
  • 已包含
• SD 卡支持
• 固件升级
• 构建并运行
• Linux版本说明
• 作者
• 特别感谢
• 许可证

：火箭：特点

• 用户友好的图形界面，易于使用
• 连接到多个 ESP32 板类型
• 轻量级 IDE 方便编程
• 终端访问以简化命令执行
• 流行板类型的引脚图
• 通过 PyPI 或 MIP 轻松安装串联模块
• Flash 文件系统浏览器，方便文件访问
• 本机文件传输和管理
• GPIO 状态的实时可视化
• 访问重要的系统信息
• Wi-Fi 和 以太网 网络接口的配置
• SD 卡 支持外部存储
• 简化的闪存固件更新
• 高级外部组件测试功能
• 控制和操作设备，例如LEDs条、MP3播放器等
• 在数字或模拟模式下快速测试IOs
• 可定制的功能用于可扩展的开发
• 如果需要，板上的持久配置
• 实时内存和温度坚控

:gear: 实时系统仪表板

访问所有重要的system information，调整MCU frequency，坚控current status set GPIOs， 检查startup配置options并显示Flash memory. 的various partitions startup options 允许您在板上 startup save 您的 configurations ，以便您在每次重新启动后始终可以 maintain them 。

:globe_with_meridians：实时网络仪表板

配置并显示Wi-Fi connection和access点interfaces的信息， 设置带有集成 Ethernet PHY interface 的板并验证 Internet connection 是 available.

也可以将 act 放在网络接口的 state 上，包括 BLE 的接口。

:satellite: 点击 2 次即可连接 Wi-Fi

快速将 connect 您的设备连接到可用的 Wi-Fi networks 并设置 access point 与 ease.

authentication options 和 clients 的 maximum 编号为 adjustable.

:desktop_computer: 轻量级集成 IDE

Develop 您的 MicroPython 程序和库以及 test them 直接使用 lightweight IDE.

另外，a终端是usable，与commands的history的管理在同一窗口中，就像shell. 一样 Manage 并从设备的 flash memory 或 SD card 传输 content。

在代码编辑器中，common键盘shortcuts如save、undo、search或move行blocks均为available.

Tips：将鼠标放在文件上以显示其完整名称和大小，或双击选项卡栏以创建另一个 quickly.

将 Espressif 的引脚排列 diagrams 用于 GPIOs，on 和 boards 均可用：

:control_knobs: 嵌入式 Jama 函数

Jama Funcs 是小型 dedicated functions，运行 on 您的 device 来执行 specific task.

它们可用于 quickly test ESP32 或 external modules 的功能，并设计为 easily configured。

Choose 是 Jama Func 的建议，然后 configure 是 parameters ，直接是 in 是图形化的 interface，然后在设备上执行：

当 executing 为 Jama Func 时，会打开一个带有 terminal 的窗口，允许您查看 its output：

当然可以将 develop 为您自己的 Jama Funcs，以便将 import them 放入接口中，从而通过实现 integrated parameters. 来方便其使用 您可以直接在软件中或点击 MicroPython 中找到 full this link.

下表列出了 Jama Funcs 中已经 included 中的 ESP32 MPY-Jama:

贾玛功能	描述
1-Wire 设备扫描	初始化单个 GPIO 上的 1-Wire 总线，并查找所有 IDs 系列和从设备的序列号。
ADC 读卡器	GPIO 上使用模数转换器 (ADC) 的简单电平和电压读取器。您可以指定 dB 应用的衰减和位分辨率。
BLE 扫描	初始化低功耗蓝牙无线电并通过广告数据扫描 BLE 设备。
BLE iBeacon	初始化低功耗蓝牙无线电并模拟 Apple iBeacon 对象。广告消息以二进制形式广播对应于“B.JAMA-FUNC.TEST”的 UUID，短名称为“MPY-Jama”，而 iBeacon 是对活动扫描器的响应。 iBeacon（Apple 信标格式）数据为： Major = 123 / Minor = 456 / TX at 1 米 = -55 dB
DAC 输出	使用数模转换器 (DAC) 将 GPIO 输出设置为特定电压。
GPIO 输入	GPIO（引脚）输入上的 low/high 电压信号的简单读取器。您可以启用或不启用内部拉电阻。
GPIO 输出	将 GPIO（引脚）输出设置为 ON 或 OFF。
I2C 从机扫描	初始化两个 GPIO 上的 I2C 总线并扫描它以查找所有 I2C 从机的地址。您可以选择总线标识符、SCL 和 SDA、GPIO 以及 MHz 中的频率。
KT403A MP3 玩家	适用于基于 KT403A 芯片组的 MP3 模块，例如 DFPlayer、Grove-MP3 v2 等。您将能够通过 UART 总线连接您的开发板，循环播放预期存储源（microSD、USB、闪存）中的所有声音文件，调节音量，还可以选择音频 EQ 效果（正常、流行、摇滚、爵士、古典、低音）。信息：KT403A 在 FAT16 或 FAT32 文件系统上支持 MP3 和 WAV 音频格式，microSD 最多 32 个 GB。
LEDs - DotStar RGB 条	通过 SPI 总线尝试您的 DotStar RGB LEDs，与条带 APA102、SK9822 等兼容。您可以选择 LEDs 的数量以及总线连接设置和全功率或渐变彩虹照明。可以通过下面的链接找到嵌入式库。
LEDs - NeoPixel RBG(+W/Y) 条	仅通过一个 GPIO 尝试您的 NeoPixel RGB(+W/Y) LEDs，与条带 WS2812(B)、SK6812 兼容， ADAxxxx、APA106、FLORA 等。您可以选择 LEDs 的数量和类型（如 RGB 或 RGB+W/Y）、频率以及全功率或渐变彩虹照明。 NeoPixel 库由 Damien P. George 编码。
磁力传感器	允许测试 ESP32 芯片的霍尔传感器，自动校准后检测两个磁极。
最大线程数	返回使用可配置堆栈大小创建的可能线程的最大数量。
内存检查	这个小工具只是允许您在芯片上分配最大内存量，以便强制在几乎所有可用插槽上进行写入。
NTP 时间同步	该工具从 NTP 服务器同步 UTC 日期和时间。您可以选择要连接的 NTP 服务器主机。
PWM 和照明	在 GPIO 上使用 PWM 并改变其占空比，使 LED 在 0 至 3.3V 之间平稳闪烁。
PWM & 伺服电机	在 GPIO 上使用 PWM，并通过改变占空比来驱动伺服电机。有多种选项可用于配置伺服电机，例如脉冲频率、脉冲宽度和旋转时间。
UART 测试	初始化两个 GPIO 上的 UART 总线，发送或不发送自定义命令并从总线接收数据。您可以选择总线标识符、波特率、每个字符位数、奇偶校验、停止位和 TX/RX GPIO
Wi-Fi 扫描	对无线接入点执行详细扫描。

You are welcome to share your own Jama Funcs!

:file_folder: SD 卡支持

如果板上有SD card，则激活它，并激活mount对应的file system.

所有内容的 reformatting 也是可能的。

:zap: 固件升级

利用Espressif esptool连接bootloader mode中的设备并轻松load新二进制images.

此外，该工具允许您擦除 completely 以进行完全重置。

:hammer_and_wrench：构建并运行

• Required dependencies

  pyWebView（查看GitHub）：

  python -m pip install pywebview
  

  pySerial（查看GitHub）：

  python -m pip install pyserial
  

• Run application

  只需使用Python：

  python src/app.py
  

:penguin: Linux 版本说明

这描述了如何克隆存储库以及如何从源运行。在第三步中，您将找到如何从源代码创建二进制文件的说明。所有圣 eps 已在 Ubuntu 22.04 上进行了测试，但在类似的发行版上只需稍加修改即可工作。

• Installation

  首先，请确保您拥有所有必需的文件：

  # clone the repository:
  git clone https://github.com/jczic/ESP32-MPY-Jama
  
  # install python modules requirements:
  sudo apt install libcairo2-dev libgirepository1.0-dev python3-pyqt5 python3-pyqt5.qtwebengine python3-pyqt5.qtwebchannel libqt5webkit5-dev gir1.2-webkit2-4.0
  
  # initialize python venv:
  cd ESP32-MPY-Jama
  python3 -m venv venv
  
  . venv/bin/activate
  
  pip3 install wheel setuptools
  pip3 install pyserial pywebview[qt] pycairo PyGObject pyinstaller
  

• Running from source

  当您执行“安装”下列出的所有步骤时，您可以通过执行以下步骤直接从源运行：

  cd ESP32-MPY-Jama
  . venv/bin/activate
  python3 src/app.py
  

  如果图形用户界面初始化出现问题，可以通过使用参数 --gui（或 -g）后跟 qt 或 gtk 来强制使用所需的界面。

  # example:
  python3 src/app.py -g gtk
  

• Building executable

  执行“安装”下列出的步骤，然后继续如下所示：

  cd ESP32-MPY-Jama
  ./create_binary.sh
  

  脚本完成后，您应该在“dist”子文件夹中得到一个“esp32-mpy-jama”可执行文件。