4. 初始化失败或读出全 0
初始化函数(如 GT_Font_Init)的返回值只有两层含义:底层 SPI 通没通、库有没有认出芯片。排查前先分层:
- 底层读不通(读 ID 都错)→ 回到第 2 章查通信;
- 底层能读、初始化仍失败或字模全 0 → 大概率是库与型号不匹配(4.3),或收发方式时序有问题(4.2)。
本章案例来自真实技术支持记录(如 GT5SLAD2E-1A、GT5SLCD2E-1A 等型号的客户反馈)。初始化失败并非特定型号的问题——在售各型号使用中都可能出现,本章排查方法通用。
4.1 Q05 GT_Font_Init 初始化失败(模拟 SPI 方式)
现象
按操作配置好 SPI(软件模拟方式),执行 GT_Font_Init 返回失败。
原因分析
软件模拟 SPI 常见错误:采样沿错、CS 时序错、延时不足、MISO 方向切换错;也可能是库与型号不匹配。
解决办法
- MISO 配置为输入(必要时上拉),MOSI/CLK 推挽输出。
- 延时用示波器校准,先慢后快。
- CS 整帧保持低,最后一字节后才拉高。
- 逻辑分析仪对比硬件 SPI 波形,逐位核对。
- 先绕过库,直接用9F指令读数据,确认底层能通(见2.3 Q03 的最小测试)。
- 确认库与实际型号匹配(见第 7 章 库文件生成)。
单字节收发的参考实现:
// 软件模拟 SPI:发送一个字节(MSB first)
void Send_Byte(unsigned char out)
{
unsigned char i = 0;
for (i = 0; i < 8; i++)
{
Rom_sckL;
if (((out << i) & 0x80) == 0)
MOSIL;
else
MOSIH;
Rom_sckH;
}
}
// 软件模拟 SPI:接收一个字节(时钟下降沿前采样)
unsigned char Get_Byte(void)
{
unsigned char i;
unsigned char read_dat;
Rom_sckH;
for (i = 0; i < 8; i++)
{
Rom_sckL;
read_dat = read_dat << 1;
if (MISO)
read_dat |= 0x01;
else
read_dat &= 0xfe;
Rom_sckH;
}
return (read_dat);
}
/**
* @brief 发送读取函数
*
* @param sendbuf 发送数据的buff
* @param sendlen 发送数据长度
* @param receivebuf 读取数据的buff
* @param receivelen 读取数据长度
*/
unsigned char gt_read_data(unsigned char * sendbuf, unsigned char sendlen, unsigned char * receivebuf, unsigned int receivelen)
{
unsigned int i;
Rom_csL; //拉低片选cs,选中flash
for(i = 0; i < sendlen; i++)
{
SPI1_ReadWriteByte(sendbuf[i]); //发送数据
}
for(i = 0; i < receivelen; i++)
{
receivebuf[i] = SPI1_ReadWriteByte(0x00); //接收数据,保存到receivebuf[]
}
Rom_csH; //拉高片选cs,空间
return 1;
}
//注:如何验证gt_read_data()是正常工作的?
//使用如下代码验证,看tmp_buf里面的数据。如果tmp_buf里面的数据不是0或0xff, 而是有规律的一组数字,前三位的最后一位在12-19范围内或者是C9,
//则是大概率是正确的。数据正确后并实现了r_dat_bat()函数,r_dat_bat()实现方式请参考本文件夹其余3个文档,根据自己的情况选其中一个实现
//即可则可以尝试在SPI初始化后加入GT_Font_Init函数,如果GT_Font_Init返回值大于0则表示字库初始化成功。
uint8_t tmp_buf[8] = {0};
tmp_buf[0] = 0x9F;
gt_read_data(tmp_buf , 1 , tmp_buf , 8);
for(int i =0;i<8;i++)
{
printf("tmp_buf:%x\r\n",tmp_buf[i]);
}
unsigned char r_dat_bat(unsigned long address, unsigned long r_data_len, unsigned char *p_rbuf)
{
#define _TX_DATA_LEN (4)
unsigned char tx_buf[_TX_DATA_LEN] = {0};
tx_buf[0] = 0x03; //读取数据的命令
tx_buf[1] = (unsigned char)((address & 0xFF0000) >> 16);
tx_buf[2] = (unsigned char)((address & 0x00FF00) >> 8);
tx_buf[3] = (unsigned char)((address & 0x0000FF));
return gt_read_data(tx_buf, _TX_DATA_LEN, p_rbuf, r_data_len);
}
r_dat_bat(0xC0,16,DZ_Data);// 核对"03_SPI驱动\spi_模拟时序参考代码.txt"里面的字库型号对应的数据,一般地址为C0或者2C0,如果和型号后面的数据对的上则表示SPI通信正常,如果对不上则需要找MCU原厂帮忙调试SPI驱动
验证方法
先用9F指令读数据,再执行GT_Font_Init看返回值,返回值正确后,再读字母 A;软件模拟 SPI 速率低,初始化阶段可以接受,显示刷新阶段注意性能。
4.2 Q06 GT_Font_Init 返回 -1,逐字节收发和 HALSPI驱动函数连续不定长收发哪种对
现象
GT_Font_Init 返回 -1,ASCII_GetData(0x41, ASCII_8X16, DZ_Data) 读不到数据;先用逐字节收发,后改为 HAL 不定长连续收发,不确定哪种正确。答案,两种都正确,不定长连续收发效率更高。
原因分析
逐字节收发容易在字节间产生额外 CS/CLK 停顿、函数调用开销和时序偏差;部分 HAL 逐字节接口还会在调用间改变 CS 状态。批量收发更加提高效率。
解决办法
- 确认函数原型(地址、缓冲区、长度)以 SDK 头文件为准。
- 推荐
HAL_SPI_Transmit连续发,HAL_SPI_Receive连续读;或HAL_SPI_TransmitReceive一次完成(HAL 接口用法以 STM32 HAL 文档为准):
// HAL 批量收发骨架:CS 整帧保持低,指令+地址连续发,数据连续读
unsigned char gt_read_data(unsigned char * sendbuf, unsigned char sendlen, unsigned char * receivebuf, unsigned int receivelen)
{
HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_RESET); // 拉低 CS
HAL_SPI_Transmit(&hspi1, sendbuf, sendlen, 100); // 发送,100为超时设置
HAL_SPI_Receive(&hspi1, receivebuf, receivelen, 100); // 接收 100为超时设置
HAL_GPIO_WritePin(CS_PORT, CS_PIN, GPIO_PIN_SET); // 最后才拉高 CS
return 1;
}
- 字节间不要拉高 CS,不要中途改 SPI 模式。
- 注意超时、DMA、RTOS 互斥。
硬件 SPI(ST 标准库)的完整初始化与收发代码见字库芯片开发资料 · 硬件 SPI 驱动参考。
验证方法
逻辑分析仪对比逐字节与批量收发的波形;批量方式应看到连续 CLK 和完整帧。读字母 A 的 16 字节点阵,与数据验证表比对。
4.3 Q07 GT_Font_Init 返回 0,但 get_font 读出来全是 0
现象
r_dat_bat 和 gt_read_data 返回正常,但 GT_Font_Init 总是返回 0,get_font 返回的数据全部为 0。
原因分析
GT_Font_Init返回 0 代表初始化失败,SPI底层很大程度上是不通的,需要客户按MCU原厂SDK去调SPI驱动,常见原因:CS 未真正拉低、MISO 未接、SPI 模式错、库与型号不匹配、芯片虚焊或者损坏。
解决办法
- 底层全 0 → 按第 2 章排查通信。
- 底层有数据但取模全 0 → 查编码、字号、库配置。
- 优先核对库与型号是否匹配:换型号必须重新生成库(见第 7 章 库文件生成)。
验证方法
分层打印:SPI 原始字节 → 字模缓冲区 → 显示缓冲区,定位数据在哪一层变成 0。可直接用9F指令读数据的方式验证底层:
// 假设 GT_Font_Init 返回为 0,先绕开库验证底层读回值
uint8_t tmp_buf[8] = {0};
tmp_buf[0] = 0x9F;
gt_read_data(tmp_buf, 1, tmp_buf, 8); // 验证函数
for (int i = 0; i < 8; i++)
{
printf("tmp_buf:%x\r\n", tmp_buf[i]); // 打印返回的值
}
读出数据直接和 图2-1 进行对比
读回值正常后,再读字母 A 的点阵与数据验证表逐字节比对。

