AIR32F103(十一) 在AIR32F103上移植微雪墨水屏驅動

来源:https://www.cnblogs.com/milton/archive/2023/03/11/17205061.html
-Advertisement-
Play Games

在合宙上買了一片1.54寸的墨水屏一直在吃灰, 這次趁點亮的機會把AIR32F103上的驅動示例給做了. 將微雪的墨水屏驅動移植到 AIR32F103 上, 代碼已經提交到 GitHub 倉庫, 如果需要驅動其它型號的墨水屏, 編輯 EPD_Config.h 將 #define EPD_1IN54 ... ...


目錄

電子墨水屏 Electronic Paper, Digital Paper

電子墨水屏又稱電子紙, 其結構是兩片基板, 上面分佈著微小透明顆粒, 顆粒是一種帶正負電的黑色, 紅色和白色粒子密封於內部液態微膠囊. 不同顏色的帶電粒子會因施加電場的不同, 朝不同的方向運動，在顯示屏錶面呈現出黑或白, 紅或白的效果, 這樣，在電子紙的錶面就可以顯示出圖案和文字, 視覺效果與紙張極為類似, 不發光, 只有畫素顏色變化時(例如從黑轉到白)才耗電, 掉電後屏上畫面仍保留, 這個特性使其特別適合於在路牌, 標簽, 價簽這樣的場合使用. 但是這個特性也會帶來一些副作用, 例如長時間展示同一畫面, 會導致顯示顆粒老化, 畫面不易清除, 以及刷新慢等情況. 在長時間不使用時, 建議清屏(白屏)後再斷電, 放置時顯示面朝上. 如果需要長時間展示一個畫面, 最好設置為每隔數小時刷新一次, 減緩老化.

之前在合宙上買了一片1.54寸的墨水屏一直在吃灰, 這次趁點亮的機會把AIR32F103上的驅動示例給做了.

微雪驅動庫

微雪可能是因為墨水屏才被大家熟知, 其實這家做了相當多的電路模塊, 主要做外銷, 國內瞭解的比較少.

他們維護了一個品類眾多(45種)的墨水屏型號列表, 在 GitHub 上有一個專門的代碼倉庫

https://github.com/waveshare/e-Paper

微雪的這個驅動庫代碼質量還是不錯的. 裡面帶了針對 RaspberryPi, Arduino 和 STM32 的驅動, STM32的這個驅動, 用的硬體是 STM32F103ZET6, 遷移到AIR32F103很方便.

驅動庫當前支持以下的45種墨水屏型號, 從1.54寸到7.5寸, 其命名方式是 1N54 代表 1.54英寸, 如果同一尺寸有多個, 用 B, C, D, V2, V3 等尾碼區分.

EPD_1IN54
EPD_1IN54B_V2
EPD_1IN54B
EPD_1IN54C
EPD_1IN64G
EPD_2IN7_V2
EPD_2IN7
EPD_2IN7B_V2
EPD_2IN7B
EPD_2IN9_V2
EPD_2IN9
EPD_2IN9B_V3
EPD_2IN9BC
EPD_2IN9D
EPD_2IN13_V2
EPD_2IN13_V3
EPD_2IN13
EPD_2IN13B_V3
EPD_2IN13B_V4
EPD_2IN13BC
EPD_2IN13D
EPD_2IN36G
EPD_2IN66
EPD_2IN66B
EPD_3IN0G
EPD_3IN7
EPD_3IN52
EPD_4IN01F
EPD_4IN2
EPD_4IN2B_V2
EPD_4IN2BC
EPD_4IN37G
EPD_5IN65F
EPD_5IN83_V2
EPD_5IN83
EPD_5IN83B_V2
EPD_5IN83BC
EPD_7IN3F
EPD_7IN3G
EPD_7IN5_HD
EPD_7IN5_V2
EPD_7IN5
EPD_7IN5B_HD
EPD_7IN5B_V2
EPD_7IN5BC

將微雪驅動庫移植到AIR32F103

添加驅動庫代碼

將微雪倉庫導出, 需要的部分都在 STM32/STM32-F103ZET6/User 目錄下, 將其中代碼部分複製到AIR32F103的庫目錄下, 形成目錄結構為

Libraries
├── AIR32F10xLib
├── CMSIS
├── Debug
├── DeviceSupport
├── EPaper
│    ├── Config            # 配置文件
│    ├── e-Paper           # 對應每一個型號的 .c 和 .h 文件, 驅動的核心
│    ├── Examples          # 對應每一個型號的測試示例, 都實現了 EPD_test(void) 這個方法
│    ├── Fonts             # 字體, 5個英文字體, 2個中文字體(只是少數幾個漢字)
│    └── GUI               # 點線面的繪製方法

因為目的是要在 GNU GCC 下使用 Makefile 編譯, 所以有些地方需要優化一下

  1. 將目錄重命名一下, e-Paper 改為 Lib
  2. 將 Debug.h 刪除, 其內容集成到 DEV_Config.h
  3. 將 DEV_Config.c 和 DEV_Config.h 的公用部分(固定部分)提取為 EPD_Common.c 和 EPD_Common.h, 放到 Lib 下
  4. 將 DEV_Config.h 中的配置部分提出來創建 EPD_Config_Template.h, 這個文件在創建項目時, 可以更名為 EPD_Config.h 放到項目目錄下.

變成這樣的結構

├── EPaper
│    ├── EPD_Config_Template.h
│    ├── Examples
│    ├── Fonts
│    ├── GUI
│    └── Lib

進一步將每一個型號提取為巨集, 然後對 Lib 和 Examples 下的每個驅動和測試 c 文件, 增加巨集判斷

#ifdef EPD_1IN54

...

#endif

這樣可以在 EPD_Config.h 中使用巨集配置啟用哪一個型號, 例如對於合宙這塊1.54的屏, 只需要啟用 1N54 這個巨集

/**
 * Uncomment the part number to enable
*/

// #define EPD_1IN02
// #define EPD_1IN54_V2
#define EPD_1IN54
// #define EPD_1IN54B_V2
// #define EPD_1IN54B
// #define EPD_1IN54C
// #define EPD_1IN64G
...
...
// #define EPD_7IN5B_V2
// #define EPD_7IN5BC

這樣編譯時未啟用的型號, 其驅動和測試會直接跳過

修改 Makefile

編輯項目模板的 Makefile, 增加配置項, y 代表啟用墨水屏驅動

# Build with Waveshare e-paper lib, y:yes, n:no
USE_EPAPER    ?= y

以及對應的編譯包含項, 這裡使用的是修改過名稱後的目錄名

ifeq ($(USE_EPAPER),y)
CDIRS   += Libraries/EPaper/Lib \
      Libraries/EPaper/Examples \
      Libraries/EPaper/Fonts \
      Libraries/EPaper/GUI

INCLUDES  += Libraries/EPaper/Lib \
      Libraries/EPaper/Examples \
      Libraries/EPaper/Fonts \
      Libraries/EPaper/GUI
endif

驅動墨水屏的示例項目

硬體部分

  • AIR32F103CBT6, 墨水屏驅動編譯完只有30多KByte, 所以用哪個型號都可以
  • 合宙的1.54寸墨水屏. 如果使用其它墨水屏, 記得修改啟用對應的巨集

接線是典型的 SPI 接線方式, 和普通LCD一樣, 但是沒有背光, 增加了一個 Busy 腳

 * Waveshare 1.54' E-Paper Demo
 * 
 * AIR32        E-Paper
 * - PA2        BUSY
 * - PA3        CS
 * - PA4        DC(Data/Command)
 * - PA5        SCK/SCL
 * - PA6        RES
 * - PA7        SI/SDA
 * - GND        GND
 * - 3.3V       VCC

軟體部分

設置 EPD_Config.h

  1. 將 EPD_Config_Template.h 複製到項目目錄下, 更名為 EPD_Config.h 並打開編輯
  2. 啟用 EPD_1IN54, 將其反註釋
  3. EPD_DEBUG設為1, 可以開啟串口日誌輸出
  4. 定義 RESET, DC, CS, BUSY 這幾個 GPIO 對應的 PORT和 PIN, 這些 PIN 腳隨後需要在程式中初始化
  5. 定義幾個關鍵方法的巨集

/**
 * Uncomment to enable the part
*/
// #define EPD_1IN02
// #define EPD_1IN54_V2
#define EPD_1IN54
// #define EPD_1IN54B_V2
// ...
// #define EPD_7IN5BC

#define EPD_DEBUG 1

/**
 * e-Paper GPIO
 */
#define EPD_RST_PIN     GPIOA, GPIO_Pin_6
#define EPD_DC_PIN      GPIOA, GPIO_Pin_4
#define EPD_CS_PIN      GPIOA, GPIO_Pin_3
#define EPD_BUSY_PIN    GPIOA, GPIO_Pin_2

/**
 * GPIO read and write
 */
#define EPD_Digital_Write(_pin, _value) GPIO_WriteBit(_pin, _value == 0? Bit_RESET:Bit_SET)
#define EPD_Digital_Read(_pin)          GPIO_ReadInputDataBit(_pin)
#define EPD_SPI_WriteByte(_value)       SPI_TxRx(_value)
#define EPD_Delay_ms(__xms)             Delay_Ms(__xms)

#endif

初始化外設

因為是示例項目, 就不單獨分文件了, 都添加到 main.c.

初始化普通 GPIO, PA2是輸入, PA3, PA4, PA6 都是輸出

void APP_GPIO_Config(void)
{
  GPIO_InitTypeDef GPIO_InitStructure;

  RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);

  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_6;
  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_10MHz;
  GPIO_Init(GPIOA, &GPIO_InitStructure);
  GPIO_SetBits(GPIOA, GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_6);

  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2;
  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPD;
  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_10MHz;
  GPIO_Init(GPIOA, &GPIO_InitStructure);
  GPIO_SetBits(GPIOA, GPIO_Pin_2);
}

初始化SPI1, 這裡用 PA5作為SCL, PA7作為SDA

void APP_SPI_Config(void)
{
  GPIO_InitTypeDef GPIO_InitStructure;
  SPI_InitTypeDef  SPI_InitStructure;

  RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
  RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE);

  GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5 | GPIO_Pin_7;
  GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
  GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
  GPIO_Init(GPIOA, &GPIO_InitStructure);

  GPIO_SetBits(GPIOA,GPIO_Pin_5 | GPIO_Pin_7);

  SPI_InitStructure.SPI_Direction = SPI_Direction_1Line_Tx;
  SPI_InitStructure.SPI_Mode = SPI_Mode_Master;
  SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;
  SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low;
  SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge;
  SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;
  SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_8;
  SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;
  SPI_InitStructure.SPI_CRCPolynomial = 0;
  SPI_Init(SPI1, &SPI_InitStructure);

  SPI_Cmd(SPI1, ENABLE);
}

對應 EPD_Config.h 中的 EPD_SPI_WriteByte() 巨集定義, 創建 SPI 的位元組讀寫方法

uint8_t SPI_TxRx(uint8_t data)
{
  uint8_t retry = 0;
  while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) == RESET && ++retry);
  SPI_I2S_SendData(SPI1, data);
  while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) == RESET && ++retry);
  return SPI_I2S_ReceiveData(SPI1);
}

運行驅動測試

在 main() 中初始化後直接調用微雪自帶的測試函數. 這個測試會寫入圖, 然後寫入文字, 局部刷新, 最後清屏, 進入睡眠.

int main(void)
{
  //...

  APP_GPIO_Config();
  APP_SPI_Config();

  EPD_test();

  while (1);
}

遇到的問題

字體編譯錯誤

原驅動庫中文使用的是 GB2312 的編碼, 而我在 Ubuntu 下肯定是不用 GBK 的, 所以會亂碼, 我把這部分都改成 UTF-8 了, 因此對應的漢字的位元組數也從2變成了3, 需要做對應的修改

fonts.h

typedef struct
{
  unsigned char index[3];                                  //<-- 從 2 改成 3
  const char matrix[MAX_HEIGHT_FONT*MAX_WIDTH_FONT/8];
} CH_CN;

GUI_Paint.c

void Paint_DrawString_CN(UWORD Xstart, UWORD Ystart, const char * pString, cFONT* font,
                        UWORD Color_Foreground, UWORD Color_Background)
{
//...

            /* Point on the next character */
            p_text += 3;                                  //<-- 從 2 改成 3
//...

原先的字體定義方式為

/*--  文字:  好  --*/
/*--  微軟雅黑12;  此字體下對應的點陣為：寬x高=16x21   --*/
{"好",
0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x30,0x00,0x73,0xFF,0x70,0x0F,0xFE,0x1E,
0x7E,0x3C,0x6E,0x38,0xEE,0x30,0xEF,0xFF,0xFC,0x30,0x7C,0x30,0x38,0x30,0x3E,0x30,
0x7E,0x30,0xE0,0x30,0xC1,0xF0,0x00,0x00,0x00,0x00},

這種初始化賦值應該是 ARM GCC 支持, 但是 GUN GCC 不支持, 編譯會報錯, 兩個struct成員變數不能用同一個花括弧, 需要改為

  /*--  文字:  好  --*/
/*--  微軟雅黑12;  此字體下對應的點陣為：寬x高=16x21   --*/
{
  index:"好",
  matrix: {
    0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x30,0x00,0x73,0xFF,0x70,0x0F,0xFE,0x1E,
    0x7E,0x3C,0x6E,0x38,0xEE,0x30,0xEF,0xFF,0xFC,0x30,0x7C,0x30,0x38,0x30,0x3E,0x30,
    0x7E,0x30,0xE0,0x30,0xC1,0xF0,0x00,0x00,0x00,0x00}
},

或者下麵這種形式

  /*--  文字:  好  --*/
/*--  微軟雅黑12;  此字體下對應的點陣為：寬x高=16x21   --*/
{
  "好",
  {
    0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x30,0x00,0x73,0xFF,0x70,0x0F,0xFE,0x1E,
    0x7E,0x3C,0x6E,0x38,0xEE,0x30,0xEF,0xFF,0xFC,0x30,0x7C,0x30,0x38,0x30,0x3E,0x30,
    0x7E,0x30,0xE0,0x30,0xC1,0xF0,0x00,0x00,0x00,0x00}
},

經過以上的修改, 就可以正常編譯了.

示例項目源代碼

代碼已經提交到 GitHub 倉庫

https://github.com/IOsetting/air32f103-template/tree/master/Examples/NonFreeRTOS/SPI/Waveshare_1N54_E-Paper

將目錄下的文件複製替換掉 User 目錄下的文件, 再編輯 Makefile, 開啟 EPaper 庫就能編譯.

如果需要驅動其它型號的墨水屏, 編輯 EPD_Config.h 將#define EPD_1IN54註釋掉, 再將需要啟用的型號取消註釋即可.


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 03-RabbitMQ的工作模式
    RabbitMQ的工作模式 一、模式概述 **RabbitMQ提供了6種工作模式：**簡單模式、工作隊列模式、訂閱模式、路由模式、通配符模式、遠程調用模式 其中遠程調用模式（RPC）暫不作介紹。 官網對於模式介紹：https://www.rabbitmq.com/getstarted.html 二、 ...
  • C++筆記--函數、預處理
    1 函數 1.1函數的介紹 1.1.1 函數的概述 函數是c語言的功能單位。實現一個功能可以封裝一個函數來實現。 定義函數的時候一切以功能為目的，根據功能去定函數的參數和返回值需要傳哪些數據給函數?(實參)、函數的功能代碼（函數體）如何實現?函數需要返回什麼類型的數據?考慮（傳入參數、函數體、返回值 ...
  • C#值傳遞引用傳遞
    C#參數修飾 ref修飾符： 使用ref修飾符可以使參數成為一個引用類型，從而允許我們在函數中修改該參數的值。如果我們將一個變數傳遞給一個使用ref修飾符的參數，那麼任何對該參數的修改都將影響到原始變數的值。例如： void MyFunction(ref int myParam) { myParam ...
  • 【WinForm】 自學筆記二：連接資料庫以及查詢結果顯示
    本次使用 SqlConnection 來連接資料庫，使用 DataGridView 來顯示查詢的結果。最終效果如下： 一、連接資料庫 1.獲取連接資料庫所需的字元串，包括伺服器名稱，資料庫名稱，用戶名以及密碼，可在配置文件中配置，或直接在代碼里寫死 在配置文件 App.config 中配置的代碼： ...
  • ASP.NET Core Web API 介面限流
    前言 ASP.NET Core Web API 介面限流、限制介面併發數量，我也不知道自己寫的有沒有問題，拋磚引玉、歡迎來噴！ 需求 寫了一個介面，參數可以傳多個人員，也可以傳單個人員，時間範圍限制最長一個月。簡單來說，當傳單個人員時，介面耗時很短，當傳多個人員時，一般人員會較多，介面耗時較長，一般 ...
  • 在 Sitecore 里使用 Solr 搜索 SortOrder 關聯的 Item
    在 C# 使用 Solr 搜索 sitecore 的配置信息文件可直接丟進 <Instance>\App_Config 下，sitecore 會自動檢測配置文件更新並載入到記憶體中。 通常情況下，配置信息文件是放在 <Instance>\App_Config\Include\<Project> 下，< ...
  • .Net -- EF Core
    1. EF Core簡介Entity Framework (EF) Core 是輕量化、可擴展、開源和跨平臺版的常用 Entity Framework 數據訪問技術。 EF Core 可用作對象關係映射程式 (O/RM)，這可以實現以下兩點： 使 .NET 開發人員能夠使用 .NET 對象處理資料庫 ...
  • 給C#auto屬性一個初始值的最佳方法是什麼？
    如果熟悉 GIthub 我們經常可以在一些開源項目的 PR 上看到會配置測試的驗證以及覆蓋率的報告，並且可以強制覆蓋率不低於設定的值才可以進行 Merge PR。 1.測試 創建一個 xUnit 單元測試項目。 Class /// <summary> /// Represents a class w ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類