在江科大STM32 OLED库的基础上添加了硬件SPI和DMA的适配
一、SPI相关配置
1.硬件SPI配置
#define SPIX SPI1 //使用哪个SPI
// 使能SPI1时钟,SPI1时钟在RCC_APB2Periph_SPI1,SPI2在RCC_APB1Periph_SPI2
#define SPI_RCC_SPIX RCC_APB2Periph_SPI1
// 使能gpio时钟,使用的GPIO不一样时可定义如下:
#define SPI_RCC_APB2Periph_GPIOX RCC_APB2Periph_GPIOA|RCC_APB2Periph_GPIOB
// SPI1 CLK(D0-PA5)时钟、miso(PA6)、mosi(D1-PA7)引脚
#define SPI_HW_ALL_PINS (GPIO_Pin_5 | GPIO_Pin_7)
#define SPI_HW_ALL_GPIOX GPIOA
// CS片选(软件片选)
#define OLED_CS_PIN GPIO_Pin_4
#define OLED_CS_PORT GPIOA
// 复位引脚RES
#define OLED_RES_PIN GPIO_Pin_1
#define OLED_RES_PORT GPIOA
// 控制引脚DC
#define OLED_DC_PIN GPIO_Pin_6 //(STM32硬件SPI资源PA6的MISO,屏幕只用输出,所以SPI协议未用到,如果多个SPI设备连接到SPI1,该引脚需要更换到其他位置)
#define OLED_DC_PORT GPIOA
#define OLED_RESET_LOW() GPIO_ResetBits(OLED_RES_PORT, OLED_RES_PIN) //低电平复位
#define OLED_RESET_HIGH() GPIO_SetBits(OLED_RES_PORT, OLED_RES_PIN)
#define OLED_CMD_MODE() GPIO_ResetBits(OLED_DC_PORT, OLED_DC_PIN) //命令模式
#define OLED_DATA_MODE() GPIO_SetBits(OLED_DC_PORT, OLED_DC_PIN) //数据模式
#define OLED_CS_HIGH() GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN)//片选
#define OLED_CS_LOW() GPIO_ResetBits(OLED_CS_PORT, OLED_CS_PIN)
void OLED_GPIO_Init(void)
{
SPI_InitTypeDef SPI_InitStructure;
GPIO_InitTypeDef GPIO_InitStructure;
RCC_APB2PeriphClockCmd(SPI_RCC_SPIX, ENABLE);//使能SPI时钟
RCC_APB2PeriphClockCmd(SPI_RCC_APB2Periph_GPIOX,ENABLE);
GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = SPI_HW_ALL_PINS;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(SPI_HW_ALL_GPIOX, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure);
SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;//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 = 7;
SPI_Init(SPIX, &SPI_InitStructure);
SPI_Cmd(SPIX, ENABLE);
OLED_RESET_LOW();
Delay_ms(50);
OLED_RESET_HIGH();
}
void SPI_WriterByte(unsigned char dat)
{
while (SPI_I2S_GetFlagStatus(SPIX, SPI_I2S_FLAG_TXE) == RESET ); //检查指定的SPI标志位设置与否:发送缓存空标志位
SPI_I2S_SendData(SPIX, dat); //通过外设SPIx发送一个数据
// while (SPI_I2S_GetFlagStatus(SPIX, SPI_I2S_FLAG_RXNE) == RESET);//检查指定的SPI标志位设置与否:接受缓存非空标志位
// SPI_I2S_ReceiveData(SPIX); //返回通过SPIx最近接收的数据
}
void OLED_WriteCommand(unsigned char cmd)
{
OLED_CMD_MODE();
SPI_WriterByte(cmd);
}
void OLED_WriteData(uint8_t *Data, uint8_t Count)
{
uint8_t i;
OLED_DATA_MODE();
for (i = 0; i < Count; i ++)
{
SPI_WriterByte(Data[i]);//依次发送Data的每一个数据
}
}
2.硬件SPI+DMA 配置
代码如下:
#define SPIX SPI1
// 使能SPI1时钟,SPI1时钟在RCC_APB2Periph_SPI1,SPI2在RCC_APB1Periph_SPI2
#define SPI_RCC_SPIX RCC_APB2Periph_SPI1
// 使能gpio时钟,使用的GPIO不一样时可定义如下:
#define SPI_RCC_APB2Periph_GPIOX RCC_APB2Periph_GPIOA|RCC_APB2Periph_GPIOB
// SPI1 CLK(D0-PA5)时钟、miso(PA6)、mosi(D1-PA7)引脚
#define SPI_HW_ALL_PINS (GPIO_Pin_5 | GPIO_Pin_7)
#define SPI_HW_ALL_GPIOX GPIOA
// CS片选(软件片选)
#define OLED_CS_PIN GPIO_Pin_4
#define OLED_CS_PORT GPIOA
// 复位引脚RES
#define OLED_RES_PIN GPIO_Pin_1
#define OLED_RES_PORT GPIOA
// 控制引脚DC
#define OLED_DC_PIN GPIO_Pin_6 //(STM32硬件SPI资源PA6的MISO,屏幕只用输出,所以SPI协议未用到,如果多个SPI设备连接到SPI1,该引脚需要更换到其他位置)
#define OLED_DC_PORT GPIOA
#define OLED_RESET_LOW() GPIO_ResetBits(OLED_RES_PORT, OLED_RES_PIN) //低电平复位
#define OLED_RESET_HIGH() GPIO_SetBits(OLED_RES_PORT, OLED_RES_PIN)
#define OLED_CMD_MODE() GPIO_ResetBits(OLED_DC_PORT, OLED_DC_PIN) //命令模式
#define OLED_DATA_MODE() GPIO_SetBits(OLED_DC_PORT, OLED_DC_PIN) //数据模式
#define OLED_CS_HIGH() GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN)//片选
#define OLED_CS_LOW() GPIO_ResetBits(OLED_CS_PORT, OLED_CS_PIN)
/**
* @brief: SPI1 DMA配置
* @param {unsigned char} SendBuff 发送数据,发送字节数
* @param {unsigned int} buffer_size
* @return {*}
*/
void OLED_SPI1_DMA_Configuration(uint8_t *SendBuff,uint32_t buffer_size)
{
DMA_InitTypeDef DMA_InitStruct;
DMA_InitStruct.DMA_PeripheralBaseAddr = (uint32_t)&SPIX->DR; // SPI数据寄存器地址
DMA_InitStruct.DMA_MemoryBaseAddr = (uint32_t)SendBuff;// 内存地址(要传输的变量的指针)
DMA_InitStruct.DMA_DIR = DMA_DIR_PeripheralDST;// 方向(从内存到外设)// DMA_DIR_PeripheralSRC为从外设到内存
DMA_InitStruct.DMA_BufferSize = buffer_size; // 传输内容的大小
DMA_InitStruct.DMA_PeripheralInc = DMA_PeripheralInc_Disable;// 外设地址不增
DMA_InitStruct.DMA_MemoryInc = DMA_MemoryInc_Enable; // 内存地址自增
DMA_InitStruct.DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte;// 外设数据单位8位
DMA_InitStruct.DMA_MemoryDataSize = DMA_MemoryDataSize_Byte;// 内存数据单位8位
DMA_InitStruct.DMA_Mode = DMA_Mode_Normal;// DMA模式:一次传输
DMA_InitStruct.DMA_Priority = DMA_Priority_Medium;// 优先级:高
DMA_InitStruct.DMA_M2M = DMA_M2M_Disable;// 禁止内存到内存的传输
DMA_Init(DMA1_Channel3, &DMA_InitStruct);// 配置DMA1的3通道
}
/**
* @brief:硬件引脚初始化
* @return {*}
*/
void OLED_GPIO_Init(void)
{
SPI_InitTypeDef SPI_InitStructure;
GPIO_InitTypeDef GPIO_InitStructure;
RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1,ENABLE);//开启DMA时钟
RCC_APB2PeriphClockCmd(SPI_RCC_SPIX, ENABLE);//使能SPI时钟
RCC_APB2PeriphClockCmd(SPI_RCC_APB2Periph_GPIOX,ENABLE);
GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = SPI_HW_ALL_PINS;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(SPI_HW_ALL_GPIOX, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure);
SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;//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_2;//时钟分频,决定SPI(SCK的频率)传输速度
SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;
SPI_InitStructure.SPI_CRCPolynomial = 7;
OLED_SPI1_DMA_Configuration(OLED_DisplayBuf[0],1024);//DMA初始化,但不启动SPI传输
SPI_Init(SPIX, &SPI_InitStructure);
SPI_Cmd(SPIX, ENABLE);
OLED_RESET_LOW();
Delay_ms(50);
OLED_RESET_HIGH();
}
/**
* @brief: 开启SPI+DMA传输
* @param {uint8_t} *data 要传输的数据
* @param {uint32_t} Count数据长度
* @return {*}
*/
void DMA_Buffercounter_reset(uint8_t *data,uint32_t Count)
{
DMA_Cmd(DMA1_Channel3, DISABLE ); //失能DMA,使得DMA_SetCurrDataCounter能够使用
DMA1_Channel3->CMAR = (uint32_t)data;//内存地址
DMA_SetCurrDataCounter(DMA1_Channel3,Count); //一次传输模式,DMA_BufferSize执行一次后会清零,后续需要重复传输的时候,需要使用该函数再次设置DMA_BufferSize
DMA_Cmd(DMA1_Channel3, ENABLE); //使能DMA
SPI_I2S_DMACmd(SPI1,SPI_I2S_DMAReq_Tx,ENABLE);//告诉DMA要进行SPI传输
}
void SPI_WriterByte(unsigned char dat)
{
DMA_Buffercounter_reset(&dat, 1);
while (DMA_GetFlagStatus(DMA1_FLAG_TC3) == RESET); //等待DMA传输完成
DMA_ClearFlag(DMA1_FLAG_TC3); //必须手动清除标志位
}
void OLED_WriteCommand(unsigned char cmd)
{
OLED_CMD_MODE();
SPI_WriterByte(cmd);
}
void OLED_WriteData(uint8_t *Data, uint32_t Count)
{
OLED_DATA_MODE();
DMA_Buffercounter_reset(Data, Count);
while (DMA_GetFlagStatus(DMA1_FLAG_TC3) == RESET); //等待DMA传输完成
DMA_ClearFlag(DMA1_FLAG_TC3); //必须手动清除标志位
}
3.原本的软件SPI代码
代码如下:
#define OLED_GPIO_CLK_ENABLE RCC_APB2Periph_GPIOA//|RCC_APB2Periph_GPIOB //spi屏幕引脚时钟
#define OLED_GPIO_PORT1 GPIOA //OLED端口1
#define OLED_CS_PORT GPIOA //CS-SPI---PA4
#define OLED_CS_PIN GPIO_Pin_4 //接地选择,如果只有一个SPI设备就直接接地
#define OLED_RES_PORT GPIOA //RES-SPI--PA1
#define OLED_RES_PIN GPIO_Pin_1 //接vcc就行
#define OLED_DC_PORT GPIOA //DC-SPI---PA6
#define OLED_DC_PIN GPIO_Pin_6 //
#define OLED_D0_PORT GPIOA //CLK------PA5
#define OLED_D0_PIN GPIO_Pin_5 //D0-SPI
#define OLED_D1_PORT GPIOA //MOSI-----PA7
#define OLED_D1_PIN GPIO_Pin_7 //D1-SPI
/**
* 函 数:OLED写D0(CLK)高低电平
* 参 数:要写入D0的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写D0时,此函数会被调用
* 用户需要根据参数传入的值,将D0置为高电平或者低电平
* 当参数传入0时,置D0为低电平,当参数传入1时,置D0为高电平
*/
void OLED_W_D0(uint8_t BitValue)
{
/*根据BitValue的值,将D0置高电平或者低电平*/
GPIO_WriteBit(OLED_D0_PORT, OLED_D0_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写D1(MOSI)高低电平
* 参 数:要写入D1的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写D1时,此函数会被调用
* 用户需要根据参数传入的值,将D1置为高电平或者低电平
* 当参数传入0时,置D1为低电平,当参数传入1时,置D1为高电平
*/
void OLED_W_D1(uint8_t BitValue)
{
/*根据BitValue的值,将D1置高电平或者低电平*/
GPIO_WriteBit(OLED_D1_PORT, OLED_D1_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写RES高低电平
* 参 数:要写入RES的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写RES时,此函数会被调用
* 用户需要根据参数传入的值,将RES置为高电平或者低电平
* 当参数传入0时,置RES为低电平,当参数传入1时,置RES为高电平
*/
void OLED_W_RES(uint8_t BitValue)
{
/*根据BitValue的值,将RES置高电平或者低电平*/
GPIO_WriteBit(OLED_RES_PORT, OLED_RES_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写DC高低电平
* 参 数:要写入DC的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写DC时,此函数会被调用
* 用户需要根据参数传入的值,将DC置为高电平或者低电平
* 当参数传入0时,置DC为低电平,当参数传入1时,置DC为高电平
*/
void OLED_W_DC(uint8_t BitValue)
{
/*根据BitValue的值,将DC置高电平或者低电平*/
GPIO_WriteBit(OLED_DC_PORT, OLED_DC_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写CS高低电平
* 参 数:要写入CS的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写CS时,此函数会被调用
* 用户需要根据参数传入的值,将CS置为高电平或者低电平
* 当参数传入0时,置CS为低电平,当参数传入1时,置CS为高电平
*/
void OLED_W_CS(uint8_t BitValue)
{
/*根据BitValue的值,将CS置高电平或者低电平*/
GPIO_WriteBit(OLED_CS_PORT, OLED_CS_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED引脚初始化
* 参 数:无
* 返 回 值:无
* 说 明:当上层函数需要初始化时,此函数会被调用
* 用户需要将D0、D1、RES、DC和CS引脚初始化为推挽输出模式
*/
void OLED_GPIO_Init(void)
{
uint32_t i, j;
/*在初始化前,加入适量延时,待OLED供电稳定*/
for (i = 0; i < 1000; i ++)
{
for (j = 0; j < 1000; j ++);
}
/*将D0、D1、RES、DC和CS引脚初始化为推挽输出模式*/
RCC_APB2PeriphClockCmd(OLED_GPIO_CLK_ENABLE, ENABLE);
// RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE);
GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN;
GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN;
GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN;
GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_D0_PIN;
GPIO_Init(OLED_D0_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_D1_PIN;
GPIO_Init(OLED_D1_PORT, &GPIO_InitStructure);
/*置引脚默认电平*/
OLED_W_D0(0);//clk
OLED_W_D1(1);//mosi
OLED_W_RES(1);//
OLED_W_DC(1);
OLED_W_CS(1);
}
/*********************引脚配置********************/
/*********************通信协议********************/
/**
* 函 数:SPI发送一个字节
* 参 数:Byte 要发送的一个字节数据,范围:0x00~0xFF
* 返 回 值:无
*/
void OLED_SPI_SendByte(uint8_t Byte)
{
uint8_t i;
/*循环8次,主机依次发送数据的每一位*/
for (i = 0; i < 8; i++)
{
/*使用掩码的方式取出Byte的指定一位数据并写入到D1线*/
/*两个!的作用是,让所有非零的值变为1*/
OLED_W_D1(!!(Byte & (0x80 >> i)));
OLED_W_D0(1); //拉高D0,从机在D0上升沿读取SDA
OLED_W_D0(0); //拉低D0,主机开始发送下一位数据
}
}
/**
* 函 数:OLED写命令
* 参 数:Command 要写入的命令值,范围:0x00~0xFF
* 返 回 值:无
*/
void OLED_WriteCommand(uint8_t Command)
{
OLED_W_CS(0); //拉低CS,开始通信
OLED_W_DC(0); //拉低DC,表示即将发送命令
OLED_SPI_SendByte(Command); //写入指定命令
OLED_W_CS(1); //拉高CS,结束通信
}
/**
* 函 数:OLED写数据
* 参 数:Data 要写入数据的起始地址
* 参 数:Count 要写入数据的数量
* 返 回 值:无
*/
void OLED_WriteData(uint8_t *Data, uint8_t Count)
{
uint8_t i;
OLED_W_CS(0); //拉低CS,开始通信
OLED_W_DC(1); //拉高DC,表示即将发送数据
/*循环Count次,进行连续的数据写入*/
for (i = 0; i < Count; i ++)
{
OLED_SPI_SendByte(Data[i]); //依次发送Data的每一个数据
}
OLED_W_CS(1); //拉高CS,结束通信
}
4.OLED.c文件代码
在OLED.h文件中加上下面这行,可以选择哪个
//SW_SPI 使用软件SPI
//HW_SPI 使用硬件SPI1
//HW_SPI_DMA,使用硬件SPI+DMA
#define USER_SPI1_CONFIG HW_SPI_DMA //使用硬件SPI和DMA
/***************************************************************************************
* 本程序由江协科技创建并免费开源共享
* 你可以任意查看、使用和修改,并应用到自己的项目之中
* 程序版权归江协科技所有,任何人或组织不得将其据为己有
*
* 程序名称: 0.96寸OLED显示屏驱动程序(7针脚SPI接口)
* 程序创建时间: 2023.10.24
* 当前程序版本: V1.1
* 当前版本发布时间: 2023.12.8
*
* 江协科技官方网站: jiangxiekeji.com
* 江协科技官方淘宝店: jiangxiekeji.taobao.com
* 程序介绍及更新动态: jiangxiekeji.com/tutorial/oled.html
*
* 如果你发现程序中的漏洞或者笔误,可通过邮件向我们反馈:feedback@jiangxiekeji.com
* 发送邮件之前,你可以先到更新动态页面查看最新程序,如果此问题已经修改,则无需再发邮件
***************************************************************************************
*/
#include "stm32f10x.h"
#include "OLED.h"
#include <string.h>
#include <math.h>
#include <stdio.h>
#include <stdarg.h>
#include "Delay.h"
/**
* 数据存储格式:
* 纵向8点,高位在下,先从左到右,再从上到下
* 每一个Bit对应一个像素点
*
* B0 B0 B0 B0
* B1 B1 B1 B1
* B2 B2 B2 B2
* B3 B3 -------------> B3 B3 --
* B4 B4 B4 B4 |
* B5 B5 B5 B5 |
* B6 B6 B6 B6 |
* B7 B7 B7 B7 |
* |
* -----------------------------------
* |
* | B0 B0 B0 B0
* | B1 B1 B1 B1
* | B2 B2 B2 B2
* --> B3 B3 -------------> B3 B3
* B4 B4 B4 B4
* B5 B5 B5 B5
* B6 B6 B6 B6
* B7 B7 B7 B7
*
* 坐标轴定义:
* 左上角为(0, 0)点
* 横向向右为X轴,取值范围:0~127
* 纵向向下为Y轴,取值范围:0~63
* 0 X轴 127
* .------------------------------->
* 0 |
* |
* |
* Y轴 |
* |
* |
* 63 |
* v
*
*/
/***********************全局变量*********************/
/**
* OLED显存数组
* 所有的显示函数,都只是对此显存数组进行读写
* 随后调用OLED_Update函数或OLED_UpdateArea函数
* 才会将显存数组的数据发送到OLED硬件,进行显示
*/
uint8_t OLED_DisplayBuf[8][128];
/*********************全局变量**********************/
//预定宏定义
#define HW_SPI 0
#define HW_SPI_DMA 1
#define SW_SPI 2
/*********************引脚配置*********************/
#if (USER_SPI1_CONFIG == HW_SPI)//使用硬件SPI,不使用DMA
#define SPIX SPI1
// 使能SPI1时钟,SPI1时钟在RCC_APB2Periph_SPI1,SPI2在RCC_APB1Periph_SPI2
#define SPI_RCC_SPIX RCC_APB2Periph_SPI1
// 使能gpio时钟,使用的GPIO不一样时可定义如下:
#define SPI_RCC_APB2Periph_GPIOX RCC_APB2Periph_GPIOA|RCC_APB2Periph_GPIOB
// SPI1 CLK(D0-PA5)时钟、miso(PA6)、mosi(D1-PA7)引脚
#define SPI_HW_ALL_PINS (GPIO_Pin_5 | GPIO_Pin_7)
#define SPI_HW_ALL_GPIOX GPIOA
// CS片选(软件片选)
#define OLED_CS_PIN GPIO_Pin_4
#define OLED_CS_PORT GPIOA
// 复位引脚RES
#define OLED_RES_PIN GPIO_Pin_1
#define OLED_RES_PORT GPIOA
// 控制引脚DC
#define OLED_DC_PIN GPIO_Pin_6 //(STM32硬件SPI资源PA6的MISO,屏幕只用输出,所以SPI协议未用到,如果多个SPI设备连接到SPI1,该引脚需要更换到其他位置)
#define OLED_DC_PORT GPIOA
#define OLED_RESET_LOW() GPIO_ResetBits(OLED_RES_PORT, OLED_RES_PIN) //低电平复位
#define OLED_RESET_HIGH() GPIO_SetBits(OLED_RES_PORT, OLED_RES_PIN)
#define OLED_CMD_MODE() GPIO_ResetBits(OLED_DC_PORT, OLED_DC_PIN) //命令模式
#define OLED_DATA_MODE() GPIO_SetBits(OLED_DC_PORT, OLED_DC_PIN) //数据模式
#define OLED_CS_HIGH() GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN)//片选
#define OLED_CS_LOW() GPIO_ResetBits(OLED_CS_PORT, OLED_CS_PIN)
void OLED_GPIO_Init(void)
{
SPI_InitTypeDef SPI_InitStructure;
GPIO_InitTypeDef GPIO_InitStructure;
RCC_APB2PeriphClockCmd(SPI_RCC_SPIX, ENABLE);//使能SPI时钟
RCC_APB2PeriphClockCmd(SPI_RCC_APB2Periph_GPIOX,ENABLE);
GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = SPI_HW_ALL_PINS;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(SPI_HW_ALL_GPIOX, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure);
SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;//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 = 7;
SPI_Init(SPIX, &SPI_InitStructure);
SPI_Cmd(SPIX, ENABLE);
OLED_RESET_LOW();
Delay_ms(50);
OLED_RESET_HIGH();
}
void SPI_WriterByte(unsigned char dat)
{
while (SPI_I2S_GetFlagStatus(SPIX, SPI_I2S_FLAG_TXE) == RESET ); //检查指定的SPI标志位设置与否:发送缓存空标志位
SPI_I2S_SendData(SPIX, dat); //通过外设SPIx发送一个数据
// while (SPI_I2S_GetFlagStatus(SPIX, SPI_I2S_FLAG_RXNE) == RESET);//检查指定的SPI标志位设置与否:接受缓存非空标志位
// SPI_I2S_ReceiveData(SPIX); //返回通过SPIx最近接收的数据
}
void OLED_WriteCommand(unsigned char cmd)
{
OLED_CMD_MODE();
SPI_WriterByte(cmd);
}
void OLED_WriteData(uint8_t *Data, uint8_t Count)
{
uint8_t i;
OLED_DATA_MODE();
for (i = 0; i < Count; i ++)
{
SPI_WriterByte(Data[i]);//依次发送Data的每一个数据
}
}
#elif(USER_SPI1_CONFIG == HW_SPI_DMA)//使用硬件SPI+DMA
#define SPIX SPI1
// 使能SPI1时钟,SPI1时钟在RCC_APB2Periph_SPI1,SPI2在RCC_APB1Periph_SPI2
#define SPI_RCC_SPIX RCC_APB2Periph_SPI1
// 使能gpio时钟,使用的GPIO不一样时可定义如下:
#define SPI_RCC_APB2Periph_GPIOX RCC_APB2Periph_GPIOA|RCC_APB2Periph_GPIOB
// SPI1 CLK(D0-PA5)时钟、miso(PA6)、mosi(D1-PA7)引脚
#define SPI_HW_ALL_PINS (GPIO_Pin_5 | GPIO_Pin_7)
#define SPI_HW_ALL_GPIOX GPIOA
// CS片选(软件片选)
#define OLED_CS_PIN GPIO_Pin_4
#define OLED_CS_PORT GPIOA
// 复位引脚RES
#define OLED_RES_PIN GPIO_Pin_1
#define OLED_RES_PORT GPIOA
// 控制引脚DC
#define OLED_DC_PIN GPIO_Pin_6 //(STM32硬件SPI资源PA6的MISO,屏幕只用输出,所以SPI协议未用到,如果多个SPI设备连接到SPI1,该引脚需要更换到其他位置)
#define OLED_DC_PORT GPIOA
#define OLED_RESET_LOW() GPIO_ResetBits(OLED_RES_PORT, OLED_RES_PIN) //低电平复位
#define OLED_RESET_HIGH() GPIO_SetBits(OLED_RES_PORT, OLED_RES_PIN)
#define OLED_CMD_MODE() GPIO_ResetBits(OLED_DC_PORT, OLED_DC_PIN) //命令模式
#define OLED_DATA_MODE() GPIO_SetBits(OLED_DC_PORT, OLED_DC_PIN) //数据模式
#define OLED_CS_HIGH() GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN)//片选
#define OLED_CS_LOW() GPIO_ResetBits(OLED_CS_PORT, OLED_CS_PIN)
/**
* @brief: SPI1 DMA配置
* @param {unsigned char} SendBuff 发送数据,发送字节数
* @param {unsigned int} buffer_size
* @return {*}
*/
void OLED_SPI1_DMA_Configuration(uint8_t *SendBuff,uint32_t buffer_size)
{
DMA_InitTypeDef DMA_InitStruct;
DMA_InitStruct.DMA_PeripheralBaseAddr = (uint32_t)&SPIX->DR; // SPI数据寄存器地址
DMA_InitStruct.DMA_MemoryBaseAddr = (uint32_t)SendBuff;// 内存地址(要传输的变量的指针)
DMA_InitStruct.DMA_DIR = DMA_DIR_PeripheralDST;// 方向(从内存到外设)// DMA_DIR_PeripheralSRC为从外设到内存
DMA_InitStruct.DMA_BufferSize = buffer_size; // 传输内容的大小
DMA_InitStruct.DMA_PeripheralInc = DMA_PeripheralInc_Disable;// 外设地址不增
DMA_InitStruct.DMA_MemoryInc = DMA_MemoryInc_Enable; // 内存地址自增
DMA_InitStruct.DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte;// 外设数据单位8位
DMA_InitStruct.DMA_MemoryDataSize = DMA_MemoryDataSize_Byte;// 内存数据单位8位
DMA_InitStruct.DMA_Mode = DMA_Mode_Normal;// DMA模式:一次传输
DMA_InitStruct.DMA_Priority = DMA_Priority_Medium;// 优先级:高
DMA_InitStruct.DMA_M2M = DMA_M2M_Disable;// 禁止内存到内存的传输
DMA_Init(DMA1_Channel3, &DMA_InitStruct);// 配置DMA1的3通道
}
/**
* @brief:硬件引脚初始化
* @return {*}
*/
void OLED_GPIO_Init(void)
{
SPI_InitTypeDef SPI_InitStructure;
GPIO_InitTypeDef GPIO_InitStructure;
RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1,ENABLE);//开启DMA时钟
RCC_APB2PeriphClockCmd(SPI_RCC_SPIX, ENABLE);//使能SPI时钟
RCC_APB2PeriphClockCmd(SPI_RCC_APB2Periph_GPIOX,ENABLE);
GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = SPI_HW_ALL_PINS;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(SPI_HW_ALL_GPIOX, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure);
SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;//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_2;//时钟分频,决定SPI(SCK的频率)传输速度
SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;
SPI_InitStructure.SPI_CRCPolynomial = 7;
OLED_SPI1_DMA_Configuration(OLED_DisplayBuf[0],1024);//DMA初始化,但不启动SPI传输
SPI_Init(SPIX, &SPI_InitStructure);
SPI_Cmd(SPIX, ENABLE);
OLED_RESET_LOW();
Delay_ms(50);
OLED_RESET_HIGH();
}
/**
* @brief: 开启SPI传输,告诉DMA接管
* @param {uint8_t} *data 要传输的数据
* @param {uint32_t} Count数据长度
* @return {*}
*/
void DMA_Buffercounter_reset(uint8_t *data,uint32_t Count)
{
DMA_Cmd(DMA1_Channel3, DISABLE ); //失能DMA,使得DMA_SetCurrDataCounter能够使用
DMA1_Channel3->CMAR = (uint32_t)data;//内存地址
DMA_SetCurrDataCounter(DMA1_Channel3,Count); //一次传输模式,DMA_BufferSize执行一次后会清零,后续需要重复传输的时候,需要使用该函数再次设置DMA_BufferSize
DMA_Cmd(DMA1_Channel3, ENABLE); //使能DMA
SPI_I2S_DMACmd(SPI1,SPI_I2S_DMAReq_Tx,ENABLE);//告诉DMA要进行SPI传输
}
void SPI_WriterByte(unsigned char dat)
{
DMA_Buffercounter_reset(&dat, 1);
while (DMA_GetFlagStatus(DMA1_FLAG_TC3) == RESET); //等待DMA传输完成
DMA_ClearFlag(DMA1_FLAG_TC3); //必须手动清除标志位
}
void OLED_WriteCommand(unsigned char cmd)
{
OLED_CMD_MODE();
SPI_WriterByte(cmd);
}
void OLED_WriteData(uint8_t *Data, uint32_t Count)
{
OLED_DATA_MODE();
DMA_Buffercounter_reset(Data, Count);
while (DMA_GetFlagStatus(DMA1_FLAG_TC3) == RESET); //等待DMA传输完成
DMA_ClearFlag(DMA1_FLAG_TC3); //必须手动清除标志位
}
#elif(USER_SPI1_CONFIG == SW_SPI)//使用软件模拟SPI
#define OLED_GPIO_CLK_ENABLE RCC_APB2Periph_GPIOA//|RCC_APB2Periph_GPIOB //spi屏幕引脚时钟
#define OLED_GPIO_PORT1 GPIOA //OLED端口1
#define OLED_CS_PORT GPIOA //CS-SPI---PA4
#define OLED_CS_PIN GPIO_Pin_4 //接地选择,如果只有一个SPI设备就直接接地
#define OLED_RES_PORT GPIOA //RES-SPI--PA1
#define OLED_RES_PIN GPIO_Pin_1 //接vcc就行
#define OLED_DC_PORT GPIOA //DC-SPI---PA6
#define OLED_DC_PIN GPIO_Pin_6 //
#define OLED_D0_PORT GPIOA //CLK------PA5
#define OLED_D0_PIN GPIO_Pin_5 //D0-SPI
#define OLED_D1_PORT GPIOA //MOSI-----PA7
#define OLED_D1_PIN GPIO_Pin_7 //D1-SPI
/**
* 函 数:OLED写D0(CLK)高低电平
* 参 数:要写入D0的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写D0时,此函数会被调用
* 用户需要根据参数传入的值,将D0置为高电平或者低电平
* 当参数传入0时,置D0为低电平,当参数传入1时,置D0为高电平
*/
void OLED_W_D0(uint8_t BitValue)
{
/*根据BitValue的值,将D0置高电平或者低电平*/
GPIO_WriteBit(OLED_D0_PORT, OLED_D0_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写D1(MOSI)高低电平
* 参 数:要写入D1的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写D1时,此函数会被调用
* 用户需要根据参数传入的值,将D1置为高电平或者低电平
* 当参数传入0时,置D1为低电平,当参数传入1时,置D1为高电平
*/
void OLED_W_D1(uint8_t BitValue)
{
/*根据BitValue的值,将D1置高电平或者低电平*/
GPIO_WriteBit(OLED_D1_PORT, OLED_D1_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写RES高低电平
* 参 数:要写入RES的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写RES时,此函数会被调用
* 用户需要根据参数传入的值,将RES置为高电平或者低电平
* 当参数传入0时,置RES为低电平,当参数传入1时,置RES为高电平
*/
void OLED_W_RES(uint8_t BitValue)
{
/*根据BitValue的值,将RES置高电平或者低电平*/
GPIO_WriteBit(OLED_RES_PORT, OLED_RES_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写DC高低电平
* 参 数:要写入DC的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写DC时,此函数会被调用
* 用户需要根据参数传入的值,将DC置为高电平或者低电平
* 当参数传入0时,置DC为低电平,当参数传入1时,置DC为高电平
*/
void OLED_W_DC(uint8_t BitValue)
{
/*根据BitValue的值,将DC置高电平或者低电平*/
GPIO_WriteBit(OLED_DC_PORT, OLED_DC_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED写CS高低电平
* 参 数:要写入CS的电平值,范围:0/1
* 返 回 值:无
* 说 明:当上层函数需要写CS时,此函数会被调用
* 用户需要根据参数传入的值,将CS置为高电平或者低电平
* 当参数传入0时,置CS为低电平,当参数传入1时,置CS为高电平
*/
void OLED_W_CS(uint8_t BitValue)
{
/*根据BitValue的值,将CS置高电平或者低电平*/
GPIO_WriteBit(OLED_CS_PORT, OLED_CS_PIN, (BitAction)BitValue);
}
/**
* 函 数:OLED引脚初始化
* 参 数:无
* 返 回 值:无
* 说 明:当上层函数需要初始化时,此函数会被调用
* 用户需要将D0、D1、RES、DC和CS引脚初始化为推挽输出模式
*/
void OLED_GPIO_Init(void)
{
uint32_t i, j;
/*在初始化前,加入适量延时,待OLED供电稳定*/
for (i = 0; i < 1000; i ++)
{
for (j = 0; j < 1000; j ++);
}
/*将D0、D1、RES、DC和CS引脚初始化为推挽输出模式*/
RCC_APB2PeriphClockCmd(OLED_GPIO_CLK_ENABLE, ENABLE);
// RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE);
GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN;
GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN;
GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN;
GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_D0_PIN;
GPIO_Init(OLED_D0_PORT, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = OLED_D1_PIN;
GPIO_Init(OLED_D1_PORT, &GPIO_InitStructure);
/*置引脚默认电平*/
OLED_W_D0(0);//clk
OLED_W_D1(1);//mosi
OLED_W_RES(1);//
OLED_W_DC(1);
OLED_W_CS(1);
}
/*********************引脚配置********************/
/*通信协议*********************/
/**
* 函 数:SPI发送一个字节
* 参 数:Byte 要发送的一个字节数据,范围:0x00~0xFF
* 返 回 值:无
*/
void OLED_SPI_SendByte(uint8_t Byte)
{
uint8_t i;
/*循环8次,主机依次发送数据的每一位*/
for (i = 0; i < 8; i++)
{
/*使用掩码的方式取出Byte的指定一位数据并写入到D1线*/
/*两个!的作用是,让所有非零的值变为1*/
OLED_W_D1(!!(Byte & (0x80 >> i)));
OLED_W_D0(1); //拉高D0,从机在D0上升沿读取SDA
OLED_W_D0(0); //拉低D0,主机开始发送下一位数据
}
}
/**
* 函 数:OLED写命令
* 参 数:Command 要写入的命令值,范围:0x00~0xFF
* 返 回 值:无
*/
void OLED_WriteCommand(uint8_t Command)
{
OLED_W_CS(0); //拉低CS,开始通信
OLED_W_DC(0); //拉低DC,表示即将发送命令
OLED_SPI_SendByte(Command); //写入指定命令
OLED_W_CS(1); //拉高CS,结束通信
}
/**
* 函 数:OLED写数据
* 参 数:Data 要写入数据的起始地址
* 参 数:Count 要写入数据的数量
* 返 回 值:无
*/
void OLED_WriteData(uint8_t *Data, uint8_t Count)
{
uint8_t i;
OLED_W_CS(0); //拉低CS,开始通信
OLED_W_DC(1); //拉高DC,表示即将发送数据
/*循环Count次,进行连续的数据写入*/
for (i = 0; i < Count; i ++)
{
OLED_SPI_SendByte(Data[i]); //依次发送Data的每一个数据
}
OLED_W_CS(1); //拉高CS,结束通信
}
#endif
二.使用
,到江科大的视频底下下载文件,可以直接复制4的代码替换,再定义一下使用哪个SPI
,最后显示的时候要用OLED_Update()更新到屏幕.
总结
如果要使用串口+DMA可以参考void DMA_Buffercounter_reset(uint8_t *data,uint32_t Count)函数
第一次写CSDN