oled/LIS3DH显示屏

看到你提到 OLED/LIS3DH 显示屏组合，我理解你大概率是希望在项目中同时使用 OLED 显示屏和 LIS3DH 加速度计传感器，并将 LIS3DH 读取的数据（如倾斜角度、运动方向等）实时显示在 OLED 屏幕上。?

这两个器件是电子项目中非常常见的组合：

LIS3DH：一款由意法半导体 (STMicroelectronics) 生产的低成本、低功耗、三轴加速度计传感器（不是显示屏）。
- 它通过 I2C 或 SPI 接口输出 X, Y, Z 三个方向的加速度数据。
- 常用于检测倾斜、运动、振动、点击/双击等。
OLED (Organic Light-Emitting Diode) 显示屏：一种使用有机发光二极管的显示屏幕。
- 常见规格：128x64像素、128x32像素、0.96英寸或1.3英寸尺寸（最常见的是0.96英寸 128x64）。
- 优点是：自发光（不需要背光）、高对比度、宽视角、响应速度快、可显示清晰图案和文字。
- 接口通常是 I2C (省线) 或 SPI (速度快)，接口选择会影响到代码和接线方式。

如何将两者结合使用？

硬件连接 (核心是共享 I2C 总线)：
- 选择接口： 大多数情况下，为了方便，OLED 和 LIS3DH 都选择 I2C 接口模式。它们可以共享同一个 I2C 总线（即 SCL 和 SDA 两根线）。
- 连线要点：
  - 将 OLED 的 VCC 连接到主控板（如 Arduino）的 3.3V 或 5V (取决于OLED模块规格，多数5V兼容)。
  - 将 OLED 的 GND 连接到主控板的 GND。
  - 将 OLED 的 SCL 连接到主控板的 I2C SCL 引脚（如 Arduino Uno/Nano 的 A5）。
  - 将 OLED 的 SDA 连接到主控板的 I2C SDA 引脚（如 Arduino Uno/Nano 的 A4）。
  - 将 LIS3DH 的 VCC 连接到 3.3V ⚠️非常重要！ LIS3DH 通常工作在 2.16V - 3.6V 范围，连接到 5V 可能损坏！如果你的主控板只有 5V，需要使用电平转换器。
  - 将 LIS3DH 的 GND 连接到主控板的 GND。
  - 将 LIS3DH 的 SCL 连接到主控板的 SCL (与 OLED 共享)。
  - 将 LIS3DH 的 SDA 连接到主控板的 SDA (与 OLED 共享)。
  - LIS3DH 可能需要连接 CS 引脚到高电平 (VCC) 以启用 I2C 模式（具体看模块说明）。
  - (可选) LIS3DH 的中断引脚 (INT1, INT2) 可以连接到主控板的数字输入引脚用于触发中断。
- ? 关键点：I2C 地址冲突检查！
  - OLED I2C 地址常见为 0x3C (最普遍) 或 0x3D (当模块上有电阻配置时)。
  - LIS3DH I2C 地址取决于 SA0/SDO 引脚的电平：接地 (LOW) 时为 0x18，接电源 (HIGH) 时为 0x19。
  - 必须确保 OLED 和 LIS3DH 的 I2C 地址不同（0x3C vs 0x18 或 0x19）才能同时挂在总线上！ 如果不相同，配置地址即可解决冲突问题。

软件 (Arduino 示例思路)：

安装库：
- OLED 库： 安装 Adafruit SSD1306 和 Adafruit GFX Library (通过 Arduino IDE 库管理器搜索安装)。
- LIS3DH 库： 安装 Adafruit LIS3DH 库 (通过 Arduino IDE 库管理器搜索安装)。

代码流程：

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#include <Adafruit_LIS3DH.h>
#include <Adafruit_Sensor.h>

// 定义OLED尺寸 (常见128x64, 128x32)
#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
#define OLED_ADDR 0x3C // OLED的I2C地址，通常0x3C

// 创建OLED对象
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire);

// 创建LIS3DH对象
Adafruit_LIS3DH lis = Adafruit_LIS3DH(); // 使用默认地址0x18
// 如果地址不同(0x19)，需修改构造函数: Adafruit_LIS3DH lis = Adafruit_LIS3DH(0x19);

void setup() {
  Serial.begin(9600);

  // 初始化OLED
  if(!display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDR)) {
    Serial.println(F("SSD1306 allocation failed"));
    for(;;); // 死循环
  }
  display.display(); // 显示Adafruit Logo
  delay(2000);       // 暂停2秒
  display.clearDisplay(); // 清除缓冲区
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0,0);

  // 初始化LIS3DH
  if (! lis.begin(0x18)) { // 根据实际连接的SA0/SDO引脚调整地址参数 (0x18 或 0x19)
    Serial.println("LIS3DH not found");
    display.println("LIS3DH not found!");
    display.display();
    while (1);
  }

  lis.setRange(LIS3DH_RANGE_4_G); // 设置量程(可选: 2_G, 4_G, 8_G, 16_G)

  Serial.println("LIS3DH and OLED found!");
  display.println("LIS3DH OK!");
  display.display();
  delay(1000);
  display.clearDisplay();
}

void loop() {
  // 清除显示缓冲区
  display.clearDisplay();
  display.setCursor(0,0);

  // 读取LIS3DH数据 (G为单位)
  sensors_event_t event;
  lis.getEvent(&event);

  // 在串口监视器打印
  Serial.print("X: "); Serial.print(event.acceleration.x); Serial.print("  ");
  Serial.print("Y: "); Serial.print(event.acceleration.y); Serial.print("  ");
  Serial.print("Z: "); Serial.print(event.acceleration.z); Serial.println(" m/s^2");

  // 在OLED上显示标题
  display.println("Accel (m/s^2):");

  // 在OLED上格式化显示X, Y, Z数据
  display.print("X: "); display.println(event.acceleration.x, 2); // 保留2位小数
  display.print("Y: "); display.println(event.acceleration.y, 2);
  display.print("Z: "); display.println(event.acceleration.z, 2);

  // 你也可以显示其他信息，比如角度或状态
  // float angleX = atan2(event.acceleration.y, event.acceleration.z) * RAD_TO_DEG;
  // display.print("Angle X: "); display.println(angleX, 1);

  // 将缓冲区内容发送到OLED显示
  display.display();

  delay(200); // 稍作延时，更新速率约为5Hz
}

常见问题 & 解决：

⚡LIS3DH 没反应/发热： 最大的可能！LIS3DH 只接受 3.3V 供电！ 如果错接到 5V，它可能会损坏或行为异常。务必确认 LIS3DH 连接到 3.3V 电源。
?️ OLED 或 LIS3DH 找不到：
- 接线错误： 仔细检查 VCC, GND, SCL, SDA 是否接对。
- I2C 地址冲突： 用 I2C Scanner 示例程序扫描 I2C 总线，确认两个设备的地址是否不同且能被检测到。
- 库未安装或版本不对： 确保安装了正确版本的库。
- OLED/LIS3DH 模块故障： 单独测试模块。
OLED 显示乱码： 检查 SCREEN_WIDTH 和 SCREEN_HEIGHT 定义是否与实际屏幕匹配。确认 OLED_ADDR 是否正确。