AC695N_使用AD10X灯板（带flash）说明V2

📎 原始文档：https://www.kdocs.cn/l/civrsh6euToJ

AC695N_使用AD10X灯板（带flash）说明

本文档旨在指导客户AC695N_使用AD10X灯板（带flash）的使用说明
注： 1. AD10x默认串口波特率配置为500000，以实际为准

2.全功能完整灯板功能代码量大约33K，其中字库解析代码量2K左右

一、AC695N SDK配置说明

1.使能歌词显示功能，board_ac695x_demo_cfg.h文件配置

（1） TCFG_LRC_LYRICS_ENABLE 为本地歌词解析需要打开的配置，usb、 sd卡播歌时需要打开
（2）LED_LYRICS_ENABLE 为歌词显示配置，作用是将获取的歌词编码转换成字符点阵用来推屏
（3） CONFIG_UI_STYLE配置用以区分UI显示格式

2. AC695N与AD10X 串口通讯协议使能，app_config.h文件配置

打开该配置使能串口协议
3. isd_config.ini 中配置歌词存放区域，当解析播歌设备中的歌词文件时，歌词信息需要保存到flash 时则需要配置isd_config.ini如下图，此时需要将LRC_ENABLE_SAVE_LABEL_TO_FLASH配置使能，当不使能LRC_ENABLE_SAVE_LABEL_TO_FLASH，isd_config.ini 中不需要配置歌词存放区域
配置完成后AC695N 解析完生成字符点阵buf后，通过串口发送给AD10X驱动显示 4、配置是否在AC695N端解析字库
UI_LED_LRC_DECODE_FONT配置是否在AC695N端解析字库，置 1表示在AC695N端解析字库，将解析完的点阵buf通过串口发给AD10X直接驱动显示；
置0 时表示不在AC695N端解析字库，只将字符串发给AD10X，在AD10X端进行字库解析，然后再通过AD10X驱动显示；
注意的是，如果AD10X不带flash，则必须在将UI_LED_LRC_DECODE_FONT置1；此外，AD10X_WITHOUT_FLASH这个宏是当AD10X不带fal h 时需要置 1，反之则置0

二、AD10x带flash版本介绍

1、AC695N下载完程序上电后，在AC695端进行播歌，歌词会通过串口发送给AD10x进行驱动显示，AC695和AD10x 的串口接线为：AC695N 的PA3接AD10x 的p50，AC695N端io可在 uart_update_master.c 中更改，如下图，请注意AD10x暂不支持修改IO

三、AD10X带flash版本升级程序和资源（暂只支持U盘、SD卡方式升级）

1.将有升级文件的U盘、SD卡通过AC695N升级AD10X程序和资源，该功能的实现方式是将编译好的AC695N和AD10x 的代码打包成新的ufw文件，将新的ufw 放到U盘或SD卡中，将U盘或者SD卡插进AC695N，即可进行升级；
2. ufw如果有AD10x 的升级文件就先升级AD10x，升级AD10x 的过程中，AC695 端会打印 “wa”的字符，同时在AD10x端打印会出现buf打印，最终在ad10x端打印 “upgrade succ”，此时AD10x升级成功；同样，如果ufw升级文件内包含AC695N 的升级文件，升级完成AD10X后会对AC695N进行升级，695端升级成功后会有“<<<<<<UPDATA_SUCC”字样的打印；
3.打包升级文件的方法如下：
编译完AD10x 的工程后，在AD10x工程的下载目录会生成ad100_update_all.ufw， ad100_update_code.ufw,将这两个文件都复制到cpu\br23\tools\download\standard 目录下，重新点击standard 目录下的download.bat或者重新编译AC695N工程
（1）如果只升级AC695N代码，将AC695N下载目录里的 update.ufw或者 AC695X_all.ufw文件放进u盘或sd卡，插进AC695N样机就可以进行升级
（2) 如果需要升级AD10x代码或者AD10x代码加字库资源将AC695N下载目录里的ad100_code.ufw或者ad100_all.ufw文件放进u盘或sd卡，插进AC695N 样机就可以进行升级
（3）如果需要升级AD10x代码和AC695N代码将AC695N下载目录里的AC695X_ad100_code.ufw文件放进u盘或sd卡，插进AC695N
样机就可以进行升级
（4）如果需要升级AD10x代码、字库资源和AC695N代码将AC695N下载目录里的AC695X_ad100_all.ufw文件放进u盘或sd卡，插进AC695N 样机就可以进行升级

四、修改led灯板的分辨率说明

1. AC695N led灯板宽高配置

在led_lyric.h文件配置led灯板的宽高，代码根据这两个宏适配最终合成的字符点阵大小，注意这里LED_HEIGHT不能小于字号，否则显示不完整

2. AD10X led灯板宽高设置

LED_HEIGHT和LED_WIDTH在font.h 中配置，如下图
AD10X代码需要配置led屏的宽高时，只需要修改font.h 中的LED_WIDTH和 LED_HEIGHT 即可

五、gbk2utf8.tab文件下载

程序运行时，gbk编码的歌词文件需要通过该文件转换成utf8格式才能显示；该文件可以放到AC695N，也可以放到AD10X，以下介绍这两种方式

1、gbk2utf8.tab放到AC695N

（1）该文件在AC695N的cpu\br23\tools\download\standard目录下，
（2）修改cpu\br23\tools\download\standard\download. bat，将其下载到res区，具体操作如下图

2、gbk2utf8.tab放到AD10X

和AC695N不同的是，放到AD10X这边时，gbk2utf8.tab是拼接到font.bin里的，如下图
USE_GBK_TO_UTF8_TABFILE有三种配置：NONE_TABFILE表示不拼接gbk2utf8.tab到font.bin， CJK_TABFILE表示将gbk2utf8.tab拼接到中日韩英全字库的文件尾部，GB2312_TABFILE 表示将GB2312_TABFILE拼接到简体中文(包含英文)的文件尾部；FONT_END_ADDR表示没有拼接FONT_END_ADDR的字库文件结尾处地址(即gbk2utf8.tab在font.bin 中的起始地址)，如果需要生成其他字库，则需要自己按照这样的方法将gbk2utf8.tab拼接到新字库的文件末尾，并改变FONT_END_ADDR 的值，使用时只需要拼接好的font.bin 即可，公版提供了以下文件，放在了对应sdk 的工程目录下，如下图，使用时需要将文件名改成fong.bin

六、big5_utf8.tab文件下载

程序运行时，big 5编码的歌词文件需要通过该文件转换成utf8格式才能显示；该文件可以放到AC695N，也可以放到AD10X，以下介绍这两种方式

1、gbk2utf8.tab放到AC695N

（1）该文件在AC695N的cpu\br23\tools\download\standard目录下，
（2）修改cpu\br23\tools\download\standard\download. bat，将其下载到res区，具体操作如下图

2、big5_utf8.tab放到AD10X

和AC695N不同的是，放到AD10X这边时，big5_utf8.tab是拼接到font.bin里的，如下图
BIG5_TABLE_OFFSET表示big 5_utf8拼接到font. bin文件中的文件偏移量，对应AD10X下载目录中的font_cjk_gbk2utf8_big 5_to_utf8 . bin，在使用中更改为font. bin即可
其中big5_utf8.tab为big5转utf8原文件，font_cjk_gbk2utf8_big5_to_utf8 . bin为cjk全字库、gbk 转utf8、 big 5转utf8 的拼接文件，需要注意，使用时需要将font_cjk_gbk2utf8_big 5_to_utf8 . bin 改名为font. bin

七、字库文件下载说明

字库可以按需要选择放置在AC695N或者ADl0X，字库文件名：font.bin

l、如果字库需要放到AC695N，字库文件下载如下
将 font.bin 放到 AC695N 工程 cpu\br23\tools\download\standard\download 下载目录(和 download.bat 同一路径下)，修改cpu\br23\tools\download\standard\download\download.bat，将 font.bin放到res 区，如下图