#ifndef __OLED_H
#define __OLED_H

#include "main.h"

/* 128x64 OLED（SSD1306 兼容指令）+ 晶联讯 GB2312 字库 IC，全部 GPIO 模拟 SPI。
 * 接线：CLK=PC12  MOSI=PC9  DC=PC8  CS1=PC7(屏幕片选)  FSO=PC6(字库输出,接MCU输入)
 *       CS2=PB15(字库片选)
 * 显示字符串必须是 GB2312/GBK 编码（本工程源文件即 GBK，直接写中文字面量即可）。
 * 屏幕 128x64：16 像素高的行共 4 行（row 0~3），每行 8 个汉字或 16 个 ASCII。 */

void oled_init(void);                        /* GPIO + 屏幕初始化（app_init 调用） */
void oled_clear(void);                       /* 全屏清屏 */
void oled_locate(uint8_t row, uint8_t col8); /* 定位：row 0~3，col8 为 8 像素单位 0~15 */
void oled_xoff(uint8_t px);                  /* 在当前列基础上右移 px 像素（防烧屏偏移用） */
void oled_print(const char *gbk_str);        /* 从当前位置显示 GBK 字符串 */
void oled_print_line(const char *gbk_str);   /* 整行显示：不足 128px 用空格补齐覆盖旧内容 */

#endif /* __OLED_H */