SSD1306 顯示 MPU6050 加速度計讀數功能評測

硬件環境

• 主控芯片 : Renesas FPB-RA6E2
• 外設模塊 :
  • SSD1306 OLED 屏幕 （SPI 接口）
  • MPU6050 六軸傳感器 （I2C 接口）
• 連接方式 :
  • SSD1306 : SCK=P111, MOSI=P109, D/C=P110, CS=P301, RES=P208（SPI 通信）
  • MPU6050 : SDA=P411, SCL=P410（通過 SCI0 實現 I2C 通信）

1. 功能描述

本項目實現了通過 SSD1306 OLED 屏幕實時顯示 MPU6050 加速度計的三軸（X、Y、Z）讀數。程序運行時，FPB-RA6E2 主控芯片通過 I2C 總線從 MPU6050 獲取加速度數據，并通過 SPI 接口將數據渲染到 SSD1306 屏幕上。整個流程以固定時間間隔刷新屏幕內容，確保數據顯示的實時性與穩定性。

2. 軟件配置

2.1 Device Tree Overlay (fpb_ra6e2.overlay)

設備樹文件中定義了 SSD1306 和 MPU6050 的硬件資源綁定：

• SSD1306 配置 :
  • 使用 SPI0 接口，設置屏幕分辨率為 128x64。
  • 定義了關鍵引腳：CS（片選）、D/C（數據/命令切換）、RES（復位）。
  • 開啟 SPI 外設并指定最大頻率為 4MHz。
• MPU6050 配置 :
  • 使用 SCI0 模塊作為 I2C 控制器，設置通信速率為 100kHz。
  • 定義了傳感器地址 0x68，并配置采樣率分頻器（smplrt-div）和量程參數（gyro-fs 和 accel-fs）。

2.2 Kconfig 配置 (prj.conf)

啟用必要的驅動支持：

CONFIG_I2C=y
CONFIG_SENSOR=y
CONFIG_MPU6050_TRIGGER_NONE=y
CONFIG_CBPRINTF_FP_SUPPORT=y

CONFIG_STDOUT_CONSOLE=y

CONFIG_HEAP_MEM_POOL_SIZE=16384

CONFIG_DISPLAY=y

CONFIG_LOG=y

CONFIG_CFB_LOG_LEVEL_DBG=y
CONFIG_CHARACTER_FRAMEBUFFER=y

CONFIG_GPIO=y
CONFIG_SPI=y

CONFIG_DISPLAY=y
CONFIG_SSD1306=y
CONFIG_SSD1306_DEFAULT_CONTRAST=128

3. 核心邏輯分析

3.1 主程序（main.c）

#include < zephyr/kernel.h >
#include < zephyr/device.h >
#include < zephyr/drivers/display.h >
#include < zephyr/display/cfb.h >
#include < zephyr/drivers/sensor.h >
#include < stdio.h >
#include < zephyr/logging/log.h >

LOG_MODULE_REGISTER(main, LOG_LEVEL_INF);

int main(void)
{
    /* 1. 獲取顯示設備 (自動根據 chosen 節點找到 ssd1306_spi) */
    const struct device *display = DEVICE_DT_GET(DT_CHOSEN(zephyr_display));
    const struct device *mpu6050 = DEVICE_DT_GET_ONE(invensense_mpu6050);

    if (!device_is_ready(display)) {
        LOG_ERR("Display not ready! Check SPI wiring.");
        return 0;
    }

    if (!device_is_ready(mpu6050)) {
        LOG_ERR("MPU6050 device not ready");
        return 0;
    }

    /* 2. 初始化顯示 */
    display_blanking_off(display);
    cfb_framebuffer_init(display);
    cfb_framebuffer_set_font(display, 0);
    cfb_framebuffer_invert(display);

    struct sensor_value accel[3];
    char buf[64];

    while (1) {
        // 獲取加速度數據
        if (sensor_sample_fetch(mpu6050) == 0) {
            if (sensor_channel_get(mpu6050, SENSOR_CHAN_ACCEL_XYZ, accel) == 0) {
                // 清屏并顯示數據
                cfb_framebuffer_clear(display, false);
                cfb_print(display, "MPU6050_ACC", 0, 0);
                
                // 格式化并顯示X軸加速度
                snprintf(buf, sizeof(buf), "X: %.2f", sensor_value_to_double(&accel[0]));
                cfb_print(display, buf, 0, 16);
                
                // 格式化并顯示Y軸加速度
                snprintf(buf, sizeof(buf), "Y: %.2f", sensor_value_to_double(&accel[1]));
                cfb_print(display, buf, 0, 32);
                
                // 格式化并顯示Z軸加速度
                snprintf(buf, sizeof(buf), "Z: %.2f", sensor_value_to_double(&accel[2]));
                cfb_print(display, buf, 0, 48);
                
                cfb_framebuffer_finalize(display);
            }
        }
        
        k_sleep(K_MSEC(200)); // 每0.2秒刷新一次
    }
    return 0;
}

3.2 初始化階段

1. 獲取設備句柄 :
   • 使用 DEVICE_DT_GET 宏分別獲取 SSD1306 和 MPU6050 的設備實例。
   • 檢查設備是否就緒，若失敗則記錄錯誤日志并退出。
2. 初始化顯示模塊 :
   • 調用 cfb_framebuffer_init 初始化幀緩沖區。
   • 設置字體樣式并啟用反色模式以提升顯示效果。
3. 傳感器配置 :
   • 設置 MPU6050 的采樣率分頻器為 249，對應輸出頻率為 4Hz。
   • 配置加速度計量程為 ±2g，陀螺儀量程為 ±250°/s。

3.3 運行時邏輯

主循環中實現以下操作：

1. 數據采集 :
   • 調用 sensor_sample_fetch 獲取 MPU6050 的最新數據。
   • 使用 sensor_channel_get 提取加速度計的三軸讀數。
2. 屏幕更新 :
   • 清除幀緩沖區內容。
   • 格式化加速度數據并逐行渲染到屏幕，包括標題和 X/Y/Z 軸的具體數值。
3. 定時刷新 :
   • 每隔 200ms 執行一次屏幕更新，確保數據顯示流暢且不占用過多 CPU 資源。

3.4 關鍵 API 使用

• 設備初始化與狀態檢查 :

const struct device *display = DEVICE_DT_GET(DT_CHOSEN(zephyr_display));
if (!device_is_ready(display)) {
    LOG_ERR("Display not ready!");
    return;
}

• 傳感器數據讀取 :

sensor_sample_fetch(mpu6050);
sensor_channel_get(mpu6050, SENSOR_CHAN_ACCEL_XYZ, accel);

• 屏幕內容渲染 :

cfb_framebuffer_clear(display, false);
cfb_print(display, "MPU6050_ACC", 0, 0);
snprintf(buf, sizeof(buf), "X: %.2f", sensor_value_to_double(&accel[0]));
cfb_print(display, buf, 0, 16);

4. 實驗現象與數據分析

4.1 屏幕顯示內容

SSD1306 屏幕上應顯示如下信息：

MPU6050_ACC
X: 0.12
Y: -0.05
Z: 9.78

• 標題 : 固定顯示 MPU6050_ACC，表明當前顯示的是加速度計數據。
• 數值 : 動態更新 X、Y、Z 軸的加速度值，單位為 m/s2。

4.2 數據變化規律

• 靜止狀態 : Z 軸接近重力加速度（約 9.8m/s2），X 和 Y 軸接近零。
• 動態測試 : 移動開發板時，各軸數值會隨方向和加速度變化而波動，驗證了 MPU6050 的正常工作。

4.3 刷新頻率

屏幕每 200ms 更新一次，保證了數據的實時性，同時避免了因頻繁刷新導致的視覺閃爍問題。

5. 測評總結

本項目成功展示了如何利用 SSD1306 屏幕和 MPU6050 傳感器在 Zephyr RTOS 下實現加速度計數據的實時顯示。代碼結構清晰，充分利用了 Zephyr 的設備驅動框架和傳感器接口，適合嵌入式開發者學習和參考。通過本實驗，用戶可以直觀地觀察 MPU6050 的加速度數據變化，進一步驗證了硬件連接的正確性和軟件邏輯的可靠性。