UI_Editor-III 组态开发

1.文件概述

开发流程：准备素材 → 新建工程 → 设计页面 → 编译/模拟 → 烧录。

2. 新建工程

2.1 工程目录与素材规范

文件夹名必须严格一致（可直接复制 Examples 示例工程再清空内容）：

命名规则：

• 4 位数字不可重复（0000.png 与 0000.bmp 也算重复，会导致调用错乱，可以用Numbering_Vx.x.exe，给图片素材快速编号）
• 编号可留空，留空处生成无底图的页
• 禁用字符：\ / : * ? " < > | . ,
• 未被引用的素材不打包进 bin（音频除外，都会打包）

2.2 工程设置

参数	说明
芯片型号	选 LT7589
flash 空间大小	与实际 SPI Flash 一致
Horizontal / Vertical	屏幕分辨率（含 HBPD/HFPD/HSPW 等时序）
波特率	默认 115200，须与 MCU 端一致
Modbus 通讯帧头	默认 0x5A 0xA5
设备地址	默认 0x01

其余常用项：

• 变量初始化：勾选后上位机设的默认值上电才显示，不勾则烧完 bin 看不到默认值

2.3 新建步骤

选择工程文件夹 → 命名 → 选底图（或取消）。页列表右键 新建页面 可增页。

2.4 无法删除中间页

中间多余的页面无需删除，界面没有调用默认不编译，不会占用多余空间

2.5 UI_projectname.h

编译后在工程文件夹根目录生成，内含每个控件的名字 + 地址宏。

3. 页面与控件

3.1 页面参数

点击页列表或页面空白处调出。常用项：

• 向左/右/上/下滑动跳转页：滑动跳页目标
• 返回值（reportToHost）：勾选后跳页/触摸时向串口回传

3.2 常用控件

3.3 LT7589 单页控件数量上限

具体上限见LT7589_UE-III_V1.0_20250925_LIB\User\module_select.h
曲线特别占内存，Curve_Size一栏不要随意放大，按需设置。

4. 变量与寄存器

4.1 地址空间

• LT7589 RAM 64KB：0x0000 ~ 0x7FFF，每地址 2 字节
• 0x7000 ~ 0x71FF 为特殊寄存器，用户变量不要放这里

两者共用 RAM，分配时要算好长度避免重叠。

4.2 特殊寄存器

5. 串口协议

5.1 帧格式

写: 5A A5 | LEN | 10 | ADDR(2) | DATA(2n) | CRC(2)
读: 5A A5 | LEN | 03 | ADDR(2) | WORDS(2) | CRC(2)

• 单次写入 > 250 字节：帧头后插 0x00，LEN 变 2 字节，上限 2043 字节
• 写指令必回反馈：成功 5A A5 04 10 FF 4C 30，失败 5A A5 04 10 00 0C 70

5.2 CRC

• 算法：标准 CRC16/MODBUS（poly 0xA001，init 0xFFFF）
• 参与计算：指令码 + 地址 + 数据（不含帧头与 LEN）
• 发送：低字节在前

查表函数返回值已做字节交换，直接用易与常见 MODBUS 代码混淆。下列代码已用手册 4 个示例逐字节验证：

uint16_t LT_CRC16(const uint8_t *p, uint16_t len)
{
    uint16_t crc = 0xFFFF;
    while (len--) {
        crc ^= *p++;
        for (uint8_t i = 0; i < 8; i++)
            crc = (crc & 1) ? (uint16_t)((crc >> 1) ^ 0xA001) : (crc >> 1);
    }
    return crc;
}

/* 写 n 个字到地址 addr */
void LT_Write(uint16_t addr, const uint16_t *w, uint8_t n)
{
    uint8_t  b[256], i = 0;

    b[i++] = 0x5A;  b[i++] = 0xA5;
    b[i++] = 1 + 2 + 2 * n + 2;                 /* LEN */
    b[i++] = 0x10;                              /* 写 */
    b[i++] = (uint8_t)(addr >> 8);              /* 地址高字节在前 */
    b[i++] = (uint8_t)(addr & 0xFF);
    for (uint8_t k = 0; k < n; k++) {
        b[i++] = (uint8_t)(w[k] >> 8);          /* 数据高字节在前 */
        b[i++] = (uint8_t)(w[k] & 0xFF);
    }
    uint16_t crc = LT_CRC16(&b[3], 1 + 2 + 2 * n);
    b[i++] = (uint8_t)(crc & 0xFF);             /* CRC 低字节在前 */
    b[i++] = (uint8_t)(crc >> 8);

    Uart_Send(b, i);
}

/* 读 addr 起的 words 个字 */
void LT_Read(uint16_t addr, uint16_t words)
{
    uint8_t  b[16], i = 0;

    b[i++] = 0x5A;  b[i++] = 0xA5;
    b[i++] = 1 + 2 + 2 + 2;
    b[i++] = 0x03;
    b[i++] = (uint8_t)(addr >> 8);   b[i++] = (uint8_t)(addr & 0xFF);
    b[i++] = (uint8_t)(words >> 8);  b[i++] = (uint8_t)(words & 0xFF);
    uint16_t crc = LT_CRC16(&b[3], 1 + 2 + 2);
    b[i++] = (uint8_t)(crc & 0xFF);  b[i++] = (uint8_t)(crc >> 8);

    Uart_Send(b, i);
}

5.3 指令速查

左列可直接粘进 UI_Debugger-III（工具自动补帧头/LEN/CRC），右列是 MCU 端要发的完整帧。

工具里 ++ 1000 是指令间延时 1000 ms，不是串口指令。
连续下发多条指令时（尤其曲线缓冲 → 清除），中间要留间隔。

5.4 屏 → MCU：触摸上报

控件勾选 reportToHost 后，触摸时屏主动发：

5A A5 | 07 | 41 | ADDR(2) | returnValue(2) | CRC(2)

• ADDR 常为 0xFFFF（按键类），或控件变量地址（滑条 / 键盘类）
• returnValue 为控件里设的值，用于区分按的是哪个键

6. 编译与烧录

6.1 编译

File → Build Project 生成 UartTFT-V3_Flash.bin 与 UI_projectname.h。
改完 UI 必须重新编译 + 重新烧录 + 重新复制 .h。

6.2 预览并烧录

用 UI_Emulator-III 直接打开编译好的 bin，在 PC 上模拟运行，确认无误后烧录到单片机中。

7. 排障

更多细节：控件参数见手册第 6 章，ModBus 见第 11 章，