/***************************************************************************** * | File : Readme_CN.txt * | Author : Waveshare team * | Function : Help with use * | Info : *---------------- * | This version: V1.0 * | Date : 2020-08-28 * | Info : 在这里提供一个中文版本的使用文档,以便你的快速使用 ******************************************************************************/ 这个文件是帮助您使用本例程。 由于我们的OLED屏越来越多,不便于我们的维护,因此把所有的OLED程序做成一个工程。 在这里简略的描述本工程的使用: 1.基本信息: 本例程基于树莓派4B+开发的,内核版本 Linux raspberrypi 5.4.51-v7l+ #1333 SMP Mon Aug 10 16:51:40 BST 2020 armv7l GNU/Linux 本例程可以在工程的examples\中查看对应的测试例程; 2.管脚连接: 管脚连接你可以打开/lib/Config/DEV_Config.h查看,这里也再重述一次: SPI: OLED => RPI(BCM) VCC -> 3.3 GND -> GND DIN -> 10(MOSI) CLK -> 11(SCLK) CS -> 8 DC -> 25 RST -> 27 IIC: OLED => RPI(BCM) VCC -> 3.3 GND -> GND DIN -> 2(SDA) CLK -> 3(SCL) CS -> 8 DC -> 25 RST -> 27 3.基本使用: 由于本工程是一个综合工程,对于使用而言,你可能需要阅读以下内容: 请注意你购买的是哪一款的OLED。 栗子1: 如果你购买的1.3inch OLED Module (C),那么在主目录输入: sudo make clean sudo make sudo ./main 1.3c 栗子2: 如果你购买的1.5inch RGB OLED Module,那么在主目录输入: sudo make clean sudo make sudo ./main 1.5rgb 栗子3: 如果你购买的0.91inch OLED Module,注意由于该模块只有IIC接口,而例程默认是SPI,需要去Config.h中修改,即: #define USE_SPI_4W 1 #define USE_IIC 0 修改成: #define USE_SPI_4W 0 #define USE_IIC 1 并在主目录输入: sudo make clean sudo make sudo ./main 0.91 4.目录结构(选读): 如果你经常使用我们的产品,对我们的程序目录结构会十分熟悉,关于具体的函数的我们有一份 函数的API手册,你可以在我们的WIKI上下载或像售后客服索取,这里简单介绍一次: Config\:此目录为硬件接口层文件,在DEV_Config.c(.h)可以看到很多定义,包括: 数据类型: #define UBYTE uint8_t #define UWORD uint16_t #define UDOUBLE uint32_t SPI和IIC的选择: #define USE_SPI_4W 1 #define USE_IIC 0 IIC地址: #define IIC_CMD 0X00 #define IIC_RAM 0X40 GPIO读写: #define OLED_CS_0 HAL_GPIO_WritePin(OLED_CS_GPIO_Port, OLED_CS_Pin, GPIO_PIN_RESET) #define OLED_CS_1 HAL_GPIO_WritePin(OLED_CS_GPIO_Port, OLED_CS_Pin, GPIO_PIN_SET) #define OLED_DC_0 HAL_GPIO_WritePin(OLED_DC_GPIO_Port, OLED_DC_Pin, GPIO_PIN_RESET) #define OLED_DC_1 HAL_GPIO_WritePin(OLED_DC_GPIO_Port, OLED_DC_Pin, GPIO_PIN_SET) #define OLED_RST_0 HAL_GPIO_WritePin(OLED_RST_GPIO_Port, OLED_RST_Pin, GPIO_PIN_RESET) #define OLED_RST_1 HAL_GPIO_WritePin(OLED_RST_GPIO_Port, OLED_RST_Pin, GPIO_PIN_SET) SPI传输数据: void SPI4W_Write_Byte(UBYTE value); IIC传输数据: void I2C_Write_Byte(UBYTE value, UBYTE Cmd); 延时: #define DEV_Delay_ms(__xms) HAL_Delay(__xms); 注意:此延时函数并未使用示波器测量具体数值 模块初始化与退出的处理: UBYTE System_Init(void); void System_Exit(void); 注意:1.这里是处理使用OLED前与使用完之后一些GPIO的处理。 GUI\:此目录为一些基本的图像处理函数,在GUI_Paint.c(.h)中: 常用图像处理:创建图形、翻转图形、镜像图形、设置像素点、清屏等; 常用画图处理:画点、线、框、圆、中文字符、英文字符、数字等; 常用时间显示:提供一个常用的显示时间函数; 常用显示图片:提供一个显示位图的函数; Fonts\:为一些常用的字体: Ascii: font8: 5*8 font12: 7*12 font16: 11*16 font20: 14*20 font24: 17*24 中文: font12CN: 16*21 font24CN: 32*41 OLED\:此目录下为OLED驱动函数; Examples\:此目录下为OLED的测试程序,你可在其中看到具体的使用方法;