OLED 显示屏（C 语言）

Luckfox Pico, Luckfox Pico Plus, Luckfox Pico Mini A, Luckfox Pico Mini B, Luckfox Pico Pro, Luckfox Pico Max

本文旨在详细介绍如何使用 Luckfox Pico Plus 来驱动 1.3inch 屏幕（Pico版本的区别在于右侧引脚编号），我们采用的是微雪的 Pico-OLED-1.3，屏幕的具体参数可以查看 Pico-OLED-1.3 的产品wiki。您可以下载镜像文件和示例程序直接使用或按照下面步骤自己配置。

1. 引脚配置

• Luckfox Pico / Plus / Pro / Max 系列主要参考了 Raspberry Pi Pico 的引脚布局，通过引脚配置可以兼容部分 Raspberry Pi Pico 的外设。
  

• Luckfox Pico 不同型号支持的兼容设备列表参考Luckfox-Pico_support-List

• 兼容设备选项本质上是多种引脚配置的组合，可以简化配置的步骤

• Luckfox Pico 在 ubuntu 下由于没有 io 命令直接配置寄存器，配置兼容设备 Pico-LCD 时引脚无法配置为默认上拉，无法正常控制按键

• 启动兼容设备配置时会覆盖原有配置，需要取消兼容设备到 Advanced Options 界面关闭启动的设备功能即可

2. 示例程序

Pico-OLED-1.3 可以实现显示以及按键检测功能。要实现这些功能，我们需要在程序中定义引脚以及实现 SPI/I2C 通讯，再通过交叉编译工具对程序进行编译。接下来，我们一起来看看具体的实现步骤。

1. 引脚定义

   1. 在 DEV_Config.h 中定义引脚编号

      #define OLED_DC_PIN    34
      #define OLED_RST_PIN   51
      
      /*PICO*/
      // #define KEY0_PIN        57
      // #define KEY1_PIN        136
      
      /*PLUS*/
      #define KEY0_PIN        57
      #define KEY1_PIN        103

   2. 在 DEV_Config.h 中添加读取引脚电平宏定义

      #define GET_KEY0         DEV_Digital_Read(KEY0_PIN)
      #define GET_KEY1         DEV_Digital_Read(KEY1_PIN)

   3. 在 DEV_GPIO_Init 函数中对GPIO进行初始化

      static void DEV_GPIO_Init(void)
      {
          DEV_GPIO_Mode(OLED_RST_PIN, 1);
          DEV_GPIO_Mode(OLED_DC_PIN, 1);
          DEV_GPIO_Mode(KEY0_PIN, 0);
          DEV_GPIO_Mode(KEY1_PIN, 0);
      }

   4. 在 OLED_1in3_c_test.c 中对引脚电平进行判断

      /*key*/
      while(1)
      {
          /*判断引脚电平是否为低电平*/
          if(GET_KEY1 == 0){ 
              /*在此添加用户按键1按下后的操作*/            
           }else{
              /*在此添加用户按键1松开时的操作*/  
          }
      
          if(GET_KEY0 == 0){
              /*在此添加用户按键0按下后的操作*/            
          }else{
              /*在此添加用户按键0松开时的操作*/  
          }
      }  

2. SPI/I2C通讯

   1. 在 DEV_Config.h 中选择通讯方式，默认使用SPI通讯，使用I2C通讯时需要修改Pico-OLED-1.3背面电阻

      #define USE_SPI  1
      #define USE_IIC  0

   2. 在 DEV_ModuleInit 函数中申请SPI/I2C资源

      UBYTE DEV_ModuleInit(void)
      {
       #ifdef USE_DEV_LIB
      
          DEV_GPIO_Init();
          #if USE_SPI
              printf("USE_SPI\r\n"); 
              DEV_HARDWARE_SPI_beginSet("/dev/spidev0.0",SPI_MODE_3,10000000);
          #elif USE_IIC   
              printf("USE_IIC\r\n");      
              OLED_DC_0;
              OLED_CS_0;
              DEV_HARDWARE_I2C_begin("/dev/i2c-3");
              DEV_HARDWARE_I2C_setSlaveAddress(0x3c);
          #endif
      
      #endif
          return 0;
      }

   3. 初始化

      在 main 函数中调用 OLED_1in3_C_Init 函数对OLED进行初始化

      void OLED_1in3_C_Init()
      {
          //Hardware reset
          OLED_Reset();
      
          //Set the initialization register
          OLED_InitReg();
      }

   4. 发送数据

      OLED_WriteReg 函数中将OLED_DC引脚拉低，表示发送命令，再调用 DEV_SPI_WriteByte / I2C_Write_Byte 函数向OLED发送数据

      static void OLED_WriteReg(uint8_t Reg)
      {
      #if USE_SPI
          OLED_DC_0;
          DEV_SPI_WriteByte(Reg);
      #elif USE_IIC
          I2C_Write_Byte(Reg,IIC_CMD);
      #endif
      }

      OLED_WriteData 函数中将OLED_DC引脚置高，表示发送数据，再调用 DEV_SPI_WriteByte / I2C_Write_Byte 函数向OLED发送数据

      static void OLED_WriteData(uint8_t Data)
      {   
      #if USE_SPI
          OLED_DC_1;
          DEV_SPI_WriteByte(Data);
      #elif USE_IIC
          I2C_Write_Byte(Data,IIC_RAM);
      #endif
      }

3. 交叉编译

   1. 指定交叉编译工具

      用户需要将整个 "c" 文件夹移到虚拟机，并编辑 "c" 文件夹中的 Makefile 文件，修改其中的 CC= 后的内容以指定交叉编译工具。

      将 Makefile 中<SDK Directory>修改为自己的 SDK 路径，如 /home/luckfox/luckfox-pico/

      DIR_Config   = ./lib/Config
      DIR_EPD      = ./lib/OLED
      DIR_FONTS    = ./lib/Fonts
      DIR_GUI      = ./lib/GUI
      DIR_Examples = ./examples
      DIR_BIN      = ./bin
      
      OBJ_C = $(wildcard ${DIR_EPD}/*.c ${DIR_Config}/*.c ${DIR_GUI}/*.c ${DIR_Examples}/*.c ${DIR_FONTS}/*.c)
      OBJ_O = $(patsubst %.c,${DIR_BIN}/%.o,$(notdir ${OBJ_C}))
      
      TARGET = main
      
      USELIB = USE_DEV_LIB
      DEBUG = -D $(USELIB)
      ifeq ($(USELIB), USE_DEV_LIB)
          LIB = -lpthread -lm 
      endif
      
      
      CC = <SDK Directory>/tools/linux/toolchain/arm-rockchip830-linux-uclibcgnueabihf/bin/arm-rockchip830-linux-uclibcgnueabihf-gcc
      MSG = -g -O0 -Wall
      CFLAGS += $(MSG) $(DEBUG)
      
      ${TARGET}:${OBJ_O}
          $(CC) $(CFLAGS) $(OBJ_O) -o $@ $(LIB)
          
      ${DIR_BIN}/%.o:$(DIR_Examples)/%.c
          $(CC) $(CFLAGS) -c  $< -o $@ -I $(DIR_Config) -I $(DIR_GUI) -I $(DIR_EPD)
          
      ${DIR_BIN}/%.o:$(DIR_EPD)/%.c
          $(CC) $(CFLAGS) -c  $< -o $@ -I $(DIR_Config)
          
      ${DIR_BIN}/%.o:$(DIR_FONTS)/%.c
          $(CC) $(CFLAGS) -c  $< -o $@
          
      ${DIR_BIN}/%.o:$(DIR_GUI)/%.c
          $(CC) $(CFLAGS) -c  $< -o $@ -I $(DIR_Config)  -I $(DIR_EPD) -I $(DIR_Examples)
      
      ${DIR_BIN}/%.o:$(DIR_Config)/%.c
          $(CC) $(CFLAGS) -c  $< -o $@ $(LIB)
      
          
      clean :
          rm $(DIR_BIN)/*.* 
          rm $(TARGET) 

   2. 编译程序

      修改完 Makefile 后，使用 make 命令对程序进行交叉编译。

      luckfox@luckfox:~/c$ make

      交叉编译成功后，将在当前目录下生成可执行文件 main 。

      luckfox@luckfox:~/c$ ls
      bin  examples  lib  main  Makefile  pic  readme_CN.txt  readme_EN.txt

3. 实现效果

1. 将编译好的文件传输到开发板

   先将整个 "c" 文件夹从虚拟机传输到 Windows，再通过 TFTP 或 ADB 传输到开发板，将文件从 Windows 通过 ADB 将文件传输到开发板的步骤如下：

   adb push 文件所在路径 开发板存储路径
   
   eg:(将当前目录下的c文件夹传输到开发板的根目录)
   adb push c / 

2. 运行程序

   修改 main 文件的操作权限后运行程序

   #cd c/
   #chmod 777 main
   #./main

3. 实验现象

   GUI界面1
   

   GUI界面2
   

   GUI界面3
   

   图片显示
   

   按键操作