Ameba MicroPython 解决方案
用 Python 直接在 Ameba 芯片上开发 Wi-Fi、网络与外设应用
概述
Python 语法简洁、无需手动管理内存或处理指针，配合脚本化的开发方式（改完即跑，无需编译）和庞大的社区与库生态，是目前应用最广泛的编程语言之一。在网络服务、数据处理、自动化测试等领域，Python 长期是首选语言之一，大多数工程师即使不是专职后端或脚本开发，也具备一定的 Python 使用经验。
MicroPython 是 Python 3 的精简实现，专为微控制器和资源受限环境设计：它把标准 CPython 裁剪成可以塞进几百 KB Flash、几十 KB RAM 的字节码解释器，同时保留了绝大部分标准库的编程习惯。这意味着开发者不需要重新学习一套嵌入式专用语言，也不需要为了跑一段逻辑而搭建交叉编译工具链——通过串口就能拿到一个可以直接敲代码、立刻执行的交互式环境，适合快速验证协议、调试外设行为，或者作为产品的上层脚本逻辑长期运行。
Ameba-MicroPython 是 Realtek 基于 Ameba-RTOS SDK 移植的 MicroPython 版本：底层复用 Ameba 已经过量产验证的 Wi-Fi、网络协议栈与外设驱动，上层直接以标准 Python 模块（network、socket、machine 等）暴露给开发者。也就是说，不需要先掌握 Ameba-RTOS 的任务调度、驱动接口和工程结构，就可以直接用 Python 在 Ameba 芯片上完成联网、外设访问和文件读写，把开发精力集中在应用逻辑本身。
用 Python 替代 C/C++ 编写应用层逻辑，语法简单、上手快；通过 LOGUART 串口进入交互式 REPL，代码改动无需重新编译刷机，改完即跑，显著缩短调试周期，适合快速原型验证、教学演示与自动化脚本。
Wi-Fi STA/AP 模式切换、基于 socket 的网络通信、TLS 加密连接——这些原本需要处理不少协议细节的工作，这里都已经封装成标准 Python 接口，几行代码即可完成。
基于开源 MicroPython 上游项目移植，Ameba 与 MicroPython 官方主线上游保持紧密同步，与全球开发者共享维护成果。也正因为遵循官方标准 API，为其他 MicroPython 平台编写的代码，通常只需少量改动即可迁移到 Ameba 芯片上运行。
Ameba 平台覆盖多款 SoC，可根据项目对成本、封装、外设与算力的实际需求选型，不必为了使用 MicroPython 而局限在单一型号。
核心能力
省去传统嵌入式开发中编译、烧录、复位的循环：通过 LOGUART 串口即可进入交互式 REPL，逐行执行代码并立即看到结果，支持软重置与粘贴模式；也可以通过 WebREPL 远程连接调试。代码验证完成后保存为 main.py，设备上电即自动运行。
无线网络模块（network.WLAN）封装了 STA/AP 模式的扫描、连接与状态查询；配合基于 lwIP 的 BSD socket（支持 TCP/UDP 与 SSL），可以直接用标准 Python 网络编程方式完成设备联网、云端通信；内置的 umqtt 还能直接对接 MQTT Broker，上报数据到云平台。
内置 littlefs 作为 Flash 文件系统（VFS），boot.py / main.py 等脚本与配置可以持久化保存，掉电不丢失。
_thread 模块基于 FreeRTOS 实现，支持多任务并行执行，适合需要同时处理采集、通信、响应等多条逻辑的应用编排场景。
machine 模块统一封装了 Pin、UART、SPI、I2C、ADC、PWM、RTC、WDT、Timer、I2S 等外设访问接口，用标准 Python API 即可完成外设读写。
支持 OTA 固件升级，设备出厂后仍可远程修复问题、迭代功能；同时提供 hashlib/cryptolib 密码学模块，用于保护数据与密钥安全。
软件架构
Ameba-MicroPython 的软件架构由上到下分为四层：
- 应用层：代码可以来自两个入口，一是保存在设备上的 main.py / boot.py，上电后自动加载执行； 二是通过 LOGUART 或 WebREPL 建立的交互式会话，代码逐行输入、逐行执行。
- MicroPython 解释器核心：负责解析并执行上述两类入口对应的字节码，它是“用 Python 写、直接在 芯片上跑”的运行时载体。
- 标准 Python 模块层：负责把下层的通信协议、硬件驱动等能力封装成统一的 Python API。解释器 执行到对应调用时，直接分发给这一层处理。
- Ameba 硬件抽象层（HAL）：对接 Wi-Fi（network_wlan.c）、Socket（modsocket.c）、文件系统 （littlefs）与外设驱动，把 RTOS 任务调度和寄存器操作等细节留在这一层，不会渗透到上层的 Python 模块；整套软件 运行在 Ameba SoC 之上。
推荐 IC 型号
| 功能 | 筛选 | RTL8720F | RTL8721F | RTL8721Dx | RTL8720E | RTL8710E | RTL8726E | RTL8713E | RTL8730E | RTL872xD | RTL8735B |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 应用处理器 | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-M | Cortex-A | Cortex-M | Cortex-M | |
| DSP | N | N | N | N | N | Y | Y | N | N | N | |
| ISP | N | N | N | N | N | N | N | N | N | Y | |
| Arm TrustZone | Y | Y | Y | Y | N | Y | N | Y | Y | Y | |
| 双频 | N | Y | Y | N | N | N | N | Y | Y | Y | |
| Wi-Fi 6 | Y | Y | N | Y | Y | Y | Y | Y | N | N | |
| R-MESH | Y | Y | Y | N | N | N | N | N | N | N | |
| 超低功耗 | Y | Y | Y | N | N | N | N | N | Y | Y | |
| 以太网 | N | Y | N | N | N | N | N | N | N | N | |
| BT 双模 | N | N | N | N | N | Y | Y | Y | N | N | |
| HMI | N | Y | Y | Y | N | Y | Y | Y | N | N | |
| Audio ADC | N | N | N | N | N | Y | Y | Y | Y | Y | |
| Audio DAC | N | N | N | N | N | Y | Y | Y | Y | Y | |
| SDIO Host | N | Y | N | N | N | N | N | N | N | N | |
| SD/EMMC Host | N | Y | N | N | N | N | N | Y | Y | Y | |
| USB | N | Y | Y | N | N | N | N | Y | Y | Y | |
| BT 独立天线 | N | N | N | N | N | N | N | Y | N | N | |
| CAN | N | Y | N | N | N | N | N | N | N | N |
