在电脑上运行聆思设备固件。
Lisem 是聆思芯片平台的设备模拟器。导入 LPK 固件包，在桌面上操作设备、 查看画面，通过电脑的麦克风、扬声器、摄像头和网络与固件交互。
在桌面上调试交互，用 Python 和 pytest 把问题变成回归用例，或让 coding agent 通过 MCP 操作设备、观察结果。固件也可以在无头环境中运行，接入 CI。
下载应用 · 使用说明 · Python SDK · Coding agent 接入
查看固件界面、操作按键，接入麦克风与摄像头，体验语音和视觉交互。 也可以连接串口、挂载 SD 卡镜像、调整热点环境和板级输入，观察固件如何 响应断网、介质插拔、供电变化等条件。
每台设备拥有独立的 Flash、OTP、UID 和设置，可以分别运行不同版本的固件， 保留各自的使用状态。桌面与命令行共用实例库，便于在交互调试与脚本操作之间 切换；内置芯片 ROM，还可通过虚拟 UART 执行串口烧录流程。
随应用提供的 Python SDK 可以创建指定 UID、导入指定 LPK 的临时设备， 管理运行与清理。用 pytest 组织回归，或用状态机测试探索输入组合，按测试 需要保存日志、截图、音频和动作记录。
控制长按、连按和条件触发动作，注入 WAV 或摄像头图片，再通过 UART、画面、 音频及数字信号时序检查固件响应。测试工程定义预期结果，SDK 提供输入和 观测接口。
准备 Python 3.10+，在测试虚拟环境中安装 pytest，即可通过 Lisem 运行：
lisem python -- script.py
lisem python -- -m pytest tests/SDK 随应用一起安装，版本与 Lisem 配套。入门见 Python SDK， 接口、pytest 集成和完整示例见 Python API。
通过 MCP 或 CLI，让 agent 启动固件、操作按键、提供音视频输入，结合串口、 截图和信号变化走查交互、定位问题。设备能力可以按器件类别或型号查询， agent 也可以结合原理图，使用已有器件模型生成自定义板型配置。
安装 Lisem skill，为 agent 提供设备操作、板型配置和 Python 固件测试指导：
npx skills add LISTENAI/LisemMCP 服务通过 lisem mcp 启动，客户端配置见接入说明。
Lisem 提供 macOS、Windows 和 Linux 的原生应用包。从 下载页面选择对应系统和处理器 架构的包，解压后打开应用。平台要求见对应版本的发布说明。
macOS 也可以通过 Homebrew 安装：
brew install --cask listenai/tap/lisem准备好对应板型的 LPK 固件包后：
- 打开 Lisem，点击右上角的添加按钮，选择「新建实例…」和板型。
- 导入 LPK，创建实例。
- 双击打开设备并上电；固件若需要长按开机，按住对应的功能键。
固件包需要自行准备。关闭窗口或退出 Lisem 后，设备继续在后台运行； 使用下电按钮停止运行。媒体、网络和串口操作见使用说明。
从应用菜单选择「安装命令行工具」后，也可以在终端创建和运行设备：
lisem create --board arcs-mini --name Mini --lpk firmware.lpk
lisem run INSTANCE_ID --seconds 30 --timeout 120INSTANCE_ID 使用创建结果中的 ID。CLI 的宿主网络和音频按需启用；
完整命令见 CLI 使用说明或 lisem --help。
| 芯片 | 平台 | 内置板型 |
|---|---|---|
| LS2684 | Arcs | Arcs-Mini、Arcs-EVB |
| LS2663 | Arcs | Arcs-Mini3 |
| CSK7004J8U | VenusA | VenusA RD EVB |
板型使用 JSON 描述器件、连线和外部输入。可以组合已有模型，导入自己的 板型配置；可用型号、信号和接线要求以当前版本的能力查询 结果为准。显示、存储、LUNA 推理等能力用于运行对应固件，具体外设按板型配置。
Lisem 面向固件运行、调试和自动化测试。电气特性、射频性能和物理精确时序 仍需在真机上验证。宿主接口也有平台差异：Windows UART 使用回环 TCP； Linux 摄像头使用未压缩单平面 V4L2 格式。Python 临时实例及日记回收需要 POSIX 文件锁，当前在 macOS、Linux 上提供，详见各接口的使用条件。
| 文档 | 内容 |
|---|---|
| 使用说明 | 桌面交互、媒体、网络、存储与 CLI |
| Python SDK | 脚本启动、API、pytest 与固件测试示例 |
| Coding agent 接入 | MCP 配置、工具与 Lisem skill |
| 自定义板型 | 器件能力查询、JSON 格式与接线 |
| 开发说明 | 构建、验证与发布 |
| 架构说明 | 芯片、器件、宿主接口与运行控制 |
问题反馈与功能建议欢迎提交到 Issues。
独立自有源码采用 MIT，QEMU 相关代码保留 GPL；LUNA 静态库与芯片 ROM 使用 单独许可。详见 LICENSE。