设计器地址&详细功能介绍见原开源贴，本贴仅介绍设计到代码部署流程

最后修改日期：2025/03/24，当前版本：V1.3.2

•静态版与动态版区别

设计器在V1.3.0版本起提供静态版与动态版两种版本代码生成

静态版为原先版本，生成代码时将通过group属性静态的确定各元素在数据包中的位置，最细只能按数据包级别进行更新，但运行时开销几乎为零

动态版为V1.3.0新增功能，代码生成时不会确定数据包的具体内容，在运行时检测发生更新的元素并动态打包，节省了进行数据包设计的工时，在部分情况下提升了通信性能，但会产生更高的运行时开销（包含内存开销和运行时间开销）

请根据具体情况选择两种版本的代码生成，两个版本的代码具备较为相似的api，但不能通用

•使用设计器设计UI

设计器以frame为单次显示的场景单位，在顶部菜单栏frame选项卡中可以执行切换、删除等操作

设计器的背景可以在uiWindow中进行更换（下文介绍），或者直接复制想要使用的图片在设计器界面中ctrl+v粘贴即可（可用于标定视觉摄像头可视范围）

左上角Elements栏中可以看到当前frame中的所有元素，默认按照元素的图层进行分组，在卡片右上角也可以切换为根据元素group进行分组。在列表中单击选中，可以按住ctrl进行多选，但多选后仅支持进行批量复制、删除、移动操作，其他操作暂不支持

左下角Properties栏中为当前选中元素的属性列表，除了协议中规定的属性外还包括name和group两个设计器定义的属性。name和group都将作为生成代码中元素变量名的一部分，故须符合C语言变量命名规范；在动态版代码中，group属性没有具体作用，仅用于设计时方便区分。

设计器中的数字、字符串字体与客户端中不同，客户端中使用了未公开的自有字体，设计器只能做到尽可能相似，具体效果需在实机中调试。

选中的元素可以进行复制粘贴，也可以粘贴到qq等软件中发给其他人（会自动转为json字符串），可以再次粘贴到设计器中。

Elements栏中的uiWindow为设计器渲染窗的属性，其可用属性如下图所示。长宽默认使用1080P，需根据裁判系统选手端实际使用分辨率调整（裁判系统ui绘制使用像素坐标系）；队伍属性会影响设置为队伍颜色的元素的显示效果；同时队伍和角色属性还会影响设计器模拟串口从机器人接收时自认为的机器人id，使用该功能时需要按实际情况修改；背景图片除了直接粘贴以外也可以在此处调整。

•生成代码

点击File菜单，Generate Dynamic Code按钮进入如下问题检查界面，程序会检查元素命名是否符合C语言变量命名规范。

解决所有error后可以进入如下下载界面，可以单独预览或下载单个文件（可以用于部分修改元素时快速更新），右下角按钮可以下载所有文件的压缩包。

适配生成代码

将生成的文件加入到所使用工具链的编译目标中，需要使用ui相关功能时只需要在其他文件中引入ui.h即可，该头文件中包含了所有frame对应的init、update函数以及元素对象，所有公开的函数及变量均以ui_开头，方便区分。

为了使消息能够发送给裁判系统，必须要自定义 ui_interface.h中的 SEND_MESSAGE宏，该宏默认指向打印消息包内容的函数，这个函数是打印出来给人阅读用的！！！，不是发送消息的！！！参考修改示例

#define SEND_MESSAGE(message, len) HAL_UART_Transmit_DMA(&huart1, message, len); os_delay(10);

注意：HAL库DMA发送时无法保证发送消息的完整性，如果连续调用DMA发送函数会导致后一条消息覆盖前一条消息，需要使用fifo队列/合理的延时保证消息完整性，示例代码中的os_delay函数需替换成所使用RTOS的延时函数，发送时遇到问题建议先使用阻塞式发送函数进行测试以排除问题。

同时本代码中只自带了关闭gcc编译器和keil编译器（仅限V5版本）上内存对齐的代码，其他编译器如果没有默认关闭内存对齐，需要修改 ui_type.h中的 MESSAGE_PACK宏来禁用消息结构体的内存对齐

在ui_interface.c文件中还可以修改ui_self_id变量的默认值，该值应该为当前机器人的id，具体值请参考串口协议文档附录（该变量也被导出到了ui.h中，以便从裁判系统读入当前机器人id后动态修改）

必须使用init函数进行初始化，客户端才会显示图形，仅调用update函数不会显示，可以将init函数调用放置于main函数中，同时还建议绑定一个遥控器按键调用所有的init函数，方便操作手自行刷新ui

如果有动态更新元素，新建一个RTOS任务（用定时器会比较浪费时间，因为发送需要延时，还是建议用RTOS），在该任务中调用frame对应的update函数；然后在需要修改属性的位置引入ui.h，直接修改对应元素变量的值即可，元素类型均已按实际类型做语义化，建议每次更新的元素数目为1、2、5、7个，避免浪费带宽，同时尽量不要动态更新字符串元素，一个字符串元素将占用相当于7个其他元素的带宽；如果使用了RTOS，请在修改元素变量值的代码前后插入临界区保护，通过调度锁等机制防止元素修改未完成时发送

与静态版代码不同，动态版没有提供直接的remove函数，因为无法确定需要删除的对象，需要重新初始化、删除、更新等操作时只需要调整对应元素的operate_tpyel属性即可，在init函数调用完成后该属性将被自动置为2（更新模式），如果仅进行更新可以不用额外调整

动态版代码默认情况下会保存一份所有元素上一次扫描时的副本以供比对是否出现更改，但这个默认行为会带来更高的内存和运行时间开销，我们提供了一个MANUAL_DIRTY宏可以启用手动标记模式，在ui_types.h中解除该宏的注释即可使该frame进入手动模式。在手动模式下，会为每个元素提供ui_XXXXXX_dirty（XXXXX同元素变量名）变量，需要在修改元素后手动将该值设置为1，update函数仅打包发送dirty值为1的元素。

常见问题（仅包含常见的上述内容中未加粗或未提及的问题）：

1.内存对齐未关闭，症状如下图：A5后面，SEQ之前多出一个00，需检查内存对齐宏是否支持你的编译器并进行针对性修改