RT-ThreadStudio-STM32F103C8T6_江协科技+移植RT-Thread v4.11
- 
- 
- 1.江协资料(接线图+视频+相关资料下载)
- 
- [视频-(3-2 LED流水灯和4-1 OLED显示屏)](#视频-(3-2 LED流水灯和4-1 OLED显示屏))
- [示例程序-(3-2 LED流水灯和4-1 OLED显示屏)](#示例程序-(3-2 LED流水灯和4-1 OLED显示屏))
- [接线图-(3-2 LED流水灯和4-1 OLED显示屏)](#接线图-(3-2 LED流水灯和4-1 OLED显示屏))
- 资料下载
 
- [2.RT-Thread v4.11](#2.RT-Thread v4.11)
- 
- 3.移植项目
- 
- [移植3-2 LED闪烁](#移植3-2 LED闪烁)
- [移植4-1 OLED显示屏](#移植4-1 OLED显示屏)
 
- 4.查看效果
- 5.百度云
 
 
1.江协资料(接线图+视频+相关资料下载)
视频-(3-2 LED流水灯和4-1 OLED显示屏)
3-2\] LED闪烁\&LED流水灯\&蜂鸣器
\[4-1\] OLED调试工具
##### 示例程序-(3-2 LED流水灯和4-1 OLED显示屏)

##### 接线图-(3-2 LED流水灯和4-1 OLED显示屏)
  

> 因为需要Serial串口+OLED显示,所以最终接线如图  
> 
##### 资料下载

[江协STM32资料下载](https://jiangxiekeji.com/download.html)
#### 2.RT-Thread v4.11
##### 下载\|安装
  
[RT-Thread官网](https://www.rt-thread.org/studio.html)  
  
[RT-Thread-Studio-百度云下载](https://pan.baidu.com/s/1976y4ARxi0wUFhyrTWN1eA?pwd=RTV5)  
  

##### 新建-STM32F103C8T6-项目

###### 安装RT-Thread v4.11
  

> 继续创建项目

#### 3.移植项目
##### 移植3-2 LED闪烁

> 新建led.c和led.h,修改main.c
led.c
```bash
#include 
#include 
#include "led.h"
void LED_Init(void)
{
    rt_pin_mode(LED1, PIN_MODE_OUTPUT);
    rt_pin_mode(LED2, PIN_MODE_OUTPUT);
}
void LED1_ON(void)
{
    rt_pin_write(LED1, PIN_HIGH);
}
void LED1_OFF(void)
{
    rt_pin_write(LED1, PIN_LOW);
}
void LED2_ON(void)
{
    rt_pin_write(LED2, PIN_HIGH);
}
void LED2_OFF(void)
{
    rt_pin_write(LED2, PIN_LOW);
}
```
led.h
```bash
#ifndef _led_H
#define _led_H
#define LED1 GET_PIN(A,0)
#define LED2 GET_PIN(A,1)
void LED_Init(void);
void LED1_ON(void);
void LED1_OFF(void);
void LED2_ON(void);
void LED2_OFF(void);
#endif
```
main.c
```bash
/*
 * Copyright (c) 2006-2025, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2025-10-06     RT-Thread    first version
 */
#include 
#define DBG_TAG "main"
#define DBG_LVL DBG_LOG
#include 
#include "led.h"
int main(void)
{
    int count = 1;
    
    // 初始化LED
    LED_Init();
    rt_kprintf("Hello RT-Thread!\n");
    while (count++)
    {
        //LOG_D("Hello RT-Thread!");
        rt_kprintf("Hello RT-Thread! Count: %d\n", count);
        // 切换LED状态
        LED1_ON();
        LED2_OFF();
        rt_thread_mdelay(200);
        LED1_OFF();
        LED2_ON();
        rt_thread_mdelay(800);
    }
    return RT_EOK;
}
```
##### 移植4-1 OLED显示屏
> 在 江协 - 4-1 OLED项目中找到OLED.c和OLED.h和OLED_Font.h

> 修改OLED.c
```bash
#include 
#include 
#include 
#include "OLED_Font.h"
/*引脚定义*/
#define OLED_SCL_PIN    GET_PIN(B, 8)
#define OLED_SDA_PIN    GET_PIN(B, 9)
/*引脚配置宏*/
#define OLED_W_SCL(x)   rt_pin_write(OLED_SCL_PIN, x)
#define OLED_W_SDA(x)   rt_pin_write(OLED_SDA_PIN, x)
/*引脚初始化*/
void OLED_I2C_Init(void)
{
    /* 配置SCL引脚为推挽输出 */
    rt_pin_mode(OLED_SCL_PIN, PIN_MODE_OUTPUT_OD);
    /* 配置SDA引脚为推挽输出 */
    rt_pin_mode(OLED_SDA_PIN, PIN_MODE_OUTPUT_OD);
    
    /* 初始化引脚状态 */
    OLED_W_SCL(1);
    OLED_W_SDA(1);
}
/**
  * @brief  I2C开始
  * @param  无
  * @retval 无
  */
void OLED_I2C_Start(void)
{
	OLED_W_SDA(1);
	OLED_W_SCL(1);
	OLED_W_SDA(0);
	OLED_W_SCL(0);
}
/**
  * @brief  I2C停止
  * @param  无
  * @retval 无
  */
void OLED_I2C_Stop(void)
{
	OLED_W_SDA(0);
	OLED_W_SCL(1);
	OLED_W_SDA(1);
}
/**
  * @brief  I2C发送一个字节
  * @param  Byte 要发送的一个字节
  * @retval 无
  */
void OLED_I2C_SendByte(uint8_t Byte)
{
	uint8_t i;
	for (i = 0; i < 8; i++)
	{
		OLED_W_SDA(!!(Byte & (0x80 >> i)));
		OLED_W_SCL(1);
		OLED_W_SCL(0);
	}
	OLED_W_SCL(1);	//额外的一个时钟,不处理应答信号
	OLED_W_SCL(0);
}
/**
  * @brief  OLED写命令
  * @param  Command 要写入的命令
  * @retval 无
  */
void OLED_WriteCommand(uint8_t Command)
{
	OLED_I2C_Start();
	OLED_I2C_SendByte(0x78);		//从机地址
	OLED_I2C_SendByte(0x00);		//写命令
	OLED_I2C_SendByte(Command); 
	OLED_I2C_Stop();
}
/**
  * @brief  OLED写数据
  * @param  Data 要写入的数据
  * @retval 无
  */
void OLED_WriteData(uint8_t Data)
{
	OLED_I2C_Start();
	OLED_I2C_SendByte(0x78);		//从机地址
	OLED_I2C_SendByte(0x40);		//写数据
	OLED_I2C_SendByte(Data);
	OLED_I2C_Stop();
}
/**
  * @brief  OLED设置光标位置
  * @param  Y 以左上角为原点,向下方向的坐标,范围:0~7
  * @param  X 以左上角为原点,向右方向的坐标,范围:0~127
  * @retval 无
  */
void OLED_SetCursor(uint8_t Y, uint8_t X)
{
	OLED_WriteCommand(0xB0 | Y);					//设置Y位置
	OLED_WriteCommand(0x10 | ((X & 0xF0) >> 4));	//设置X位置高4位
	OLED_WriteCommand(0x00 | (X & 0x0F));			//设置X位置低4位
}
/**
  * @brief  OLED清屏
  * @param  无
  * @retval 无
  */
void OLED_Clear(void)
{  
	uint8_t i, j;
	for (j = 0; j < 8; j++)
	{
		OLED_SetCursor(j, 0);
		for(i = 0; i < 128; i++)
		{
			OLED_WriteData(0x00);
		}
	}
}
/**
  * @brief  OLED显示一个字符
  * @param  Line 行位置,范围:1~4
  * @param  Column 列位置,范围:1~16
  * @param  Char 要显示的一个字符,范围:ASCII可见字符
  * @retval 无
  */
void OLED_ShowChar(uint8_t Line, uint8_t Column, char Char)
{      	
	uint8_t i;
	OLED_SetCursor((Line - 1) * 2, (Column - 1) * 8);		//设置光标位置在上半部分
	for (i = 0; i < 8; i++)
	{
		OLED_WriteData(OLED_F8x16[Char - ' '][i]);			//显示上半部分内容
	}
	OLED_SetCursor((Line - 1) * 2 + 1, (Column - 1) * 8);	//设置光标位置在下半部分
	for (i = 0; i < 8; i++)
	{
		OLED_WriteData(OLED_F8x16[Char - ' '][i + 8]);		//显示下半部分内容
	}
}
/**
  * @brief  OLED显示字符串
  * @param  Line 起始行位置,范围:1~4
  * @param  Column 起始列位置,范围:1~16
  * @param  String 要显示的字符串,范围:ASCII可见字符
  * @retval 无
  */
void OLED_ShowString(uint8_t Line, uint8_t Column, char *String)
{
	uint8_t i;
	for (i = 0; String[i] != '\0'; i++)
	{
		OLED_ShowChar(Line, Column + i, String[i]);
	}
}
/**
  * @brief  OLED次方函数
  * @retval 返回值等于X的Y次方
  */
uint32_t OLED_Pow(uint32_t X, uint32_t Y)
{
	uint32_t Result = 1;
	while (Y--)
	{
		Result *= X;
	}
	return Result;
}
/**
  * @brief  OLED显示数字(十进制,正数)
  * @param  Line 起始行位置,范围:1~4
  * @param  Column 起始列位置,范围:1~16
  * @param  Number 要显示的数字,范围:0~4294967295
  * @param  Length 要显示数字的长度,范围:1~10
  * @retval 无
  */
void OLED_ShowNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length)
{
	uint8_t i;
	for (i = 0; i < Length; i++)							
	{
		OLED_ShowChar(Line, Column + i, Number / OLED_Pow(10, Length - i - 1) % 10 + '0');
	}
}
/**
  * @brief  OLED显示数字(十进制,带符号数)
  * @param  Line 起始行位置,范围:1~4
  * @param  Column 起始列位置,范围:1~16
  * @param  Number 要显示的数字,范围:-2147483648~2147483647
  * @param  Length 要显示数字的长度,范围:1~10
  * @retval 无
  */
void OLED_ShowSignedNum(uint8_t Line, uint8_t Column, int32_t Number, uint8_t Length)
{
	uint8_t i;
	uint32_t Number1;
	if (Number >= 0)
	{
		OLED_ShowChar(Line, Column, '+');
		Number1 = Number;
	}
	else
	{
		OLED_ShowChar(Line, Column, '-');
		Number1 = -Number;
	}
	for (i = 0; i < Length; i++)							
	{
		OLED_ShowChar(Line, Column + i + 1, Number1 / OLED_Pow(10, Length - i - 1) % 10 + '0');
	}
}
/**
  * @brief  OLED显示数字(十六进制,正数)
  * @param  Line 起始行位置,范围:1~4
  * @param  Column 起始列位置,范围:1~16
  * @param  Number 要显示的数字,范围:0~0xFFFFFFFF
  * @param  Length 要显示数字的长度,范围:1~8
  * @retval 无
  */
void OLED_ShowHexNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length)
{
	uint8_t i, SingleNumber;
	for (i = 0; i < Length; i++)							
	{
		SingleNumber = Number / OLED_Pow(16, Length - i - 1) % 16;
		if (SingleNumber < 10)
		{
			OLED_ShowChar(Line, Column + i, SingleNumber + '0');
		}
		else
		{
			OLED_ShowChar(Line, Column + i, SingleNumber - 10 + 'A');
		}
	}
}
/**
  * @brief  OLED显示数字(二进制,正数)
  * @param  Line 起始行位置,范围:1~4
  * @param  Column 起始列位置,范围:1~16
  * @param  Number 要显示的数字,范围:0~1111 1111 1111 1111
  * @param  Length 要显示数字的长度,范围:1~16
  * @retval 无
  */
void OLED_ShowBinNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length)
{
	uint8_t i;
	for (i = 0; i < Length; i++)							
	{
		OLED_ShowChar(Line, Column + i, Number / OLED_Pow(2, Length - i - 1) % 2 + '0');
	}
}
/**
  * @brief  OLED初始化
  * @param  无
  * @retval 无
  */
void OLED_Init(void)
{
	//上电延时
	rt_thread_mdelay(100);
	
	OLED_I2C_Init();			//端口初始化
	
	OLED_WriteCommand(0xAE);	//关闭显示
	
	OLED_WriteCommand(0xD5);	//设置显示时钟分频比/振荡器频率
	OLED_WriteCommand(0x80);
	
	OLED_WriteCommand(0xA8);	//设置多路复用率
	OLED_WriteCommand(0x3F);
	
	OLED_WriteCommand(0xD3);	//设置显示偏移
	OLED_WriteCommand(0x00);
	
	OLED_WriteCommand(0x40);	//设置显示开始行
	
	OLED_WriteCommand(0xA1);	//设置左右方向,0xA1正常 0xA0左右反置
	
	OLED_WriteCommand(0xC8);	//设置上下方向,0xC8正常 0xC0上下反置
	OLED_WriteCommand(0xDA);	//设置COM引脚硬件配置
	OLED_WriteCommand(0x12);
	
	OLED_WriteCommand(0x81);	//设置对比度控制
	OLED_WriteCommand(0xCF);
	OLED_WriteCommand(0xD9);	//设置预充电周期
	OLED_WriteCommand(0xF1);
	OLED_WriteCommand(0xDB);	//设置VCOMH取消选择级别
	OLED_WriteCommand(0x30);
	OLED_WriteCommand(0xA4);	//设置整个显示打开/关闭
	OLED_WriteCommand(0xA6);	//设置正常/倒转显示
	OLED_WriteCommand(0x8D);	//设置充电泵
	OLED_WriteCommand(0x14);
	OLED_WriteCommand(0xAF);	//开启显示
		
	OLED_Clear();				//OLED清屏
}
```
> 修改OLED.h
```bash
#ifndef __OLED_H
#define __OLED_H
#include 
void OLED_Init(void);
void OLED_Clear(void);
void OLED_ShowChar(uint8_t Line, uint8_t Column, char Char);
void OLED_ShowString(uint8_t Line, uint8_t Column, char *String);
void OLED_ShowNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length);
void OLED_ShowSignedNum(uint8_t Line, uint8_t Column, int32_t Number, uint8_t Length);
void OLED_ShowHexNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length);
void OLED_ShowBinNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length);
#endif
```
> 修改main.c
```bash
/*
 * Copyright (c) 2006-2025, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2025-10-06     RT-Thread    first version
 */
#include 
#define DBG_TAG "main"
#define DBG_LVL DBG_LOG
#include 
#include "led.h"
#include "OLED.h"
int main(void)
{
    int count = 1;
    
    // 初始化LED
    LED_Init();
    // 初始化OLED
    OLED_Init();
    // 在OLED上显示信息
    OLED_ShowString(1, 1, "Hello RT-Thread!");
    OLED_ShowString(2, 1, "OLED Test");
    rt_kprintf("Hello RT-Thread!\n");
    while (count++)
    {
        //LOG_D("Hello RT-Thread!");
        rt_kprintf("Hello RT-Thread! Count: %d\n", count);
        // 显示计数值
        OLED_ShowString(3, 1, "Count: ");
        OLED_ShowNum(3, 7, count, 5);
        // 切换LED状态
        LED1_ON();
        LED2_OFF();
        rt_thread_mdelay(200);
        LED1_OFF();
        LED2_ON();
        rt_thread_mdelay(800);
    }
    return RT_EOK;
}
```
#### 4.查看效果

> 串口终端输出:  
> 
#### 5.百度云

[百度云-STM32F103C8T6Demo+RT-Thread Studio](https://pan.baidu.com/s/1Yn6djEUJtY1JVXc38nuZzg?pwd=9pnf)