前言

本手册主要介绍 ApusTAI 的快速入门、组态控件、Lua 编程、通信应用及常见问题，帮助用户快速完成从界面设计到设备应用的开发。

ApusTAI 是为嵌入式人机界面打造的组态开发平台，采用变量驱动的设计方式，将界面显示与控制逻辑分离，集画面搭建、通信配置和模拟调试于一体，让界面开发更简单，让设备显示更出色。

ApusTAI 集成了 DCBUS、XGUS、Modbus（主/从机）、FX2N（标准/扩展）、FX3U、台达、信捷等协议，也可通过 Lua 实现自定义通信与业务逻辑。

ApusTAI 具有以下优势：

• 自主开发的 HMI 图形框架：围绕组态应用打造控件与运行系统，针对页面切换、图片显示和文字绘制持续优化，兼顾界面表现与运行效率。

• 高效图片压缩：结合图片压缩与硬件解压，让有限存储容纳更多背景、按钮和图标。现有示例中的 115 张不同尺寸图片，压缩后整包约 2.12 MiB，较原始像素数据节省约 87.5% 存储空间。

• 自研 RW 掉电存储：采用增量记录与双区轮换，只保存变化的数据，减少 Flash 擦写损耗，结合数据校验与掉电恢复提升可靠性。E 系列按 Flash 10 万次额定擦写寿命估算，累计可完成约 8.2 亿次单个 16 位寄存器变化写入；按全机合计每秒 1 次，相当于约 26 年的写入量。以上为理论擦写寿命估算，实际随器件规格、写入方式及工况变化。

• AI 辅助组态：可结合 AI 辅助画面搭建、控件配置、Lua 脚本编写和问题排查，减少重复操作，加快工程开发。

• 矢量字体加速：支持多种字号与字体样式，结合字形缓存、整段文字缓存及硬件图形加速，减少重复绘制开销，让文字丰富的页面切换和动态数值刷新更流畅。

• 丰富组态控件：提供按钮、状态指示、数值输入、仪表、曲线等控件，通过配置即可实现常见的人机交互功能。

• 画面预览与模拟调试：电脑模拟器与屏端共用控件和文字绘制逻辑，便于提前验证画面与交互，减少反复下载调试。

• 多语言与页面交互：支持多语言切换、嵌入画面、滑动切页及半透明对话框，方便构建层次清晰的操作界面。

• 权限、分期与配方：支持登录权限、控件权限、分期管理和配方应用，满足设备管理与参数切换需求。

• Lua 灵活扩展：通过脚本实现条件判断、数据处理、定时任务和自定义协议，让组态功能适应不同设备需求。

• 数据记录与导出：支持历史告警、数据表格、历史曲线和操作记录，方便查询设备运行情况，并可导出到 SD 卡。

• 音频播放：支持 WAV、MP3 音频，方便实现操作提示与语音提醒。

全屏图片容量参考

以下按常见型号估算全屏图片数量，便于规划工程资源：

屏幕尺寸	分辨率	Flash 配置	全屏图片参考数量
2.8 英寸	240×320	4MB	约 10～25 张
4.3 英寸	480×272	16MB	约 90～190 张
7 英寸	800×480	16MB	约 30～60 张
7 / 10.1 英寸	1024×600	16MB	约 20～40 张

注：按 24 位色全屏图片、压缩后占原始像素数据的 1/3～1/6 估算；2.8 英寸型号按 1 MiB、其余型号按 12 MiB 可用图片空间计算，已为字体、工程等资源预留空间。该范围并非压缩上限，实际数量随画面内容及资源占用变化，以工程编译结果为准。

按钮、图标等小尺寸素材单张占用更少，通常可存放更多张；纯色区域多、重复内容多的图片，压缩效果通常更好。