# Luatosmv

**Repository Path**: miuser00/Luatosmv

## Basic Information

- **Project Name**: Luatosmv
- **Description**: LuatOSMV嵌入式 Lua 物联网固件
基于 Lua 语言，专为开源硬件平台打造。极简语法，强大功能，结合便捷开源的硬件生态产品让每一位开发者都能快速上手物联网硬件开发。
- **Primary Language**: Lua
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.luafans.com/luatosmv
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 2
- **Created**: 2022-11-07
- **Last Updated**: 2026-04-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 关于 LuatOSMV

## 项目简介

**LuatOSMV** 是一款面向物联网嵌入式开发的开源 Lua 固件，基于上海合宙开源固件 LuatOS 的 IDF5 分支，针对 M5Stack多款主流开源硬件平台进行了深度适配与优化。

固件将 **Lua 5.3 脚本引擎** mpeg/jpg 音视频解码模块直接嵌入嵌入式固件之中，使开发者无需深入掌握 C 语言底层开发，即可通过简洁的 Lua 脚本完成 UI设计、设备控制、网络通信、传感器读取、OTA 升级等常见业务逻辑，大幅降低物联网产品的开发门槛。

## 项目主页

- **LuatosMV**：[https://www.luafans.com/luatosmv](https://www.luafans.com/luatosmv)

---

## 设计理念

> "让每一位开发者都能快速上手嵌入式物联网硬件开发"

LuatOSMV 的核心设计原则：

- **轻量**：Lua 虚拟机编译后体积极小，适合内存受限的嵌入式环境
- **高效**：Lua 5.3 的运行速度在脚本语言中具有显著优势
- **开放**：完整 MIT 开源协议，源码可自由查阅、修改与分发
- **实用**：所有已发布功能均经过真实硬件的测试验证

---

## 支持的开源硬件平台

目前已完成适配并经过验证的平台：

| 平台 | 主控 | 特色外设 |
|------|------|---------|
| **Cardputer ADV** | ESP32-S3 | TCA8418 键盘 · ST7789V2 LCD · BMI270 六轴 · ES8311 音频 · WS2812B |
| **AtomS3** | ESP32-S3 | GC9107(01) LCD · WS2812B LED 灯带 |
| **Lua Board** | ESP32-C3 | ST7735S LCD · PDM 音频 · WS2812B LED 灯带 |
| **ESP32-C3 核心板** | ESP32-C3 | 通用开发板，适合入门学习 |

计划适配（开发中）：

- **Yap Terminal**
- **AtomS3R**

---

## 已验证的核心功能

### 基础外设

GPIO · I2C · SPI · UART · ADC · PWM · 1-Wire

### 存储系统

NOR Flash · NAND Flash（1 Gbit）· SD Card · FAT32通用文件系统 · LittleFS嵌入式文件系统 · LuaDB/Romfs 只读文件系统

### 无线通信

Wi-Fi（802.11 b/g/n）· BLE 5.0 · ESP-NOW 点对点通信

### 应用协议

HTTP · MQTT · UDP · OTA 固件升级

### 显示与音频

ST7789V2 / GC9107 / ST7735S LCD · WS2812B LED 灯带 · ES8311 音频播放 · PDM 麦克风 · I2S MP3

### 传感器与输入

BMI270 六轴加速度计/陀螺仪 · 电池电量监测 · TCA8418 I2C 键盘矩阵

### 特色接口协议

SBus · REPL

---

## 开源协议

LuatOSMV 采用 **MIT 许可证**开源发布，您可以：

- ✅ 几乎无限制的免费用于个人、教育和商业项目
- ✅ 自由查阅、修改和分发源代码
- ✅ 基于此固件构建自己的产品
- ℹ️ 分发时需保留原始版权声明

LuatOSMV 基于上海合宙 [LuatOS](https://github.com/openLuat/LuatOS) 项目（MIT 协议）开发，特此致谢。

---

## 代码仓库

- **Gitee**：[https://www.gitee.com/luatosmv](https://www.gitee.com/luatosmv)
- **GitHub**：[https://www.github.com/luatosmv](https://www.github.com/luatosmv)


---

## 联系与社区

如果您在使用过程中遇到问题，或希望参与贡献，欢迎通过以下方式联系：

- 在 **GitHub / Gitee** 仓库提交 Issue 或 Pull Request
- 关注项目更新，获取最新版本通知