环境配置: 参考 Arduino IDE 上手教程完成 IDE 安装,并根据实际使用的开发板安装对应的板管理,与需要的驱动库。
使用到的驱动库:
使用到的硬件产品:

G12 (SDA)、G11 (SCL)。#include <M5Unified.h>
#include <Wire.h>
#include "Adafruit_PWMServoDriver.h"
#define SERVO_FREQ 50 // Servo PWM frequency.
#define SERVO2_I2C_ADDRESS 0x41
Adafruit_PWMServoDriver* pwm = nullptr;
void setup()
{
auto cfg = M5.config();
M5.begin(cfg);
M5.Lcd.setFont(&fonts::FreeMonoBold12pt7b);
Serial.begin(115200);
// Get M5Bus I2C pins.
const int8_t wireSda = M5.getPin(m5::pin_name_t::in_i2c_sda);
const int8_t wireScl = M5.getPin(m5::pin_name_t::in_i2c_scl);
// Find the configured SERVO2 address.
Serial.printf("Scanning SERVO2 address 0x%02X...\n", SERVO2_I2C_ADDRESS);
if (M5.In_I2C.scanID(SERVO2_I2C_ADDRESS)) {
Serial.printf("Found PCA9685 at 0x%02X\n", SERVO2_I2C_ADDRESS);
} else {
Serial.println("PCA9685 not found on M5Bus");
M5.Display.drawString("PCA9685 not found", 10, 80);
while (true) {
delay(1000);
}
}
Wire.setPins(wireSda, wireScl);
pwm = new Adafruit_PWMServoDriver(SERVO2_I2C_ADDRESS, Wire);
if (!pwm->begin()) {
Serial.printf("Wire could not initialize PCA9685 at 0x%02X\n", SERVO2_I2C_ADDRESS);
M5.Display.drawString("Wire init failed", 10, 80);
while (true) {
delay(1000);
}
}
// Set the PWM frequency for analog servos.
pwm->setPWMFreq(SERVO_FREQ);
M5.Lcd.setTextColor(TFT_GREEN, TFT_BLACK);
M5.Lcd.drawCenterString("Module13.2 Servo2 Test", 160, 10);
}
// Set one PCA9685 channel using a pulse width in milliseconds.
void setServoPulse(uint8_t n, double pulse)
{
double pulselength;
// Calculate the PWM period in microseconds.
pulselength = 1000000;
pulselength /= SERVO_FREQ;
// Print the period for debugging.
Serial.print(pulselength);
Serial.println(" us per period");
// Convert the period to one 12-bit PWM step.
pulselength /= 4096;
Serial.print(pulselength);
Serial.println(" us per bit");
// Convert the pulse width from milliseconds to PWM steps.
pulse *= 1000;
pulse /= pulselength;
Serial.println(pulse);
// Output the requested high pulse.
pwm->setPWM(n, 0, pulse);
}
void loop()
{
// Drive all channels with a 0.5 ms pulse.
for (int i = 0; i < 16; i++) {
setServoPulse(i, 0.5);
}
M5.Lcd.fillRect(0, 70, 320, 20, TFT_BLACK);
M5.Lcd.drawCenterString("Pulse width: 0.5 ms", 160, 80);
delay(1000);
// Drive all channels with a 2.5 ms pulse.
for (int i = 0; i < 16; i++) {
setServoPulse(i, 2.5);
}
M5.Lcd.fillRect(0, 70, 320, 20, TFT_BLACK);
M5.Lcd.drawCenterString("Pulse width: 2.5 ms", 160, 80);
delay(1000);
}PCA9685 芯片默认使能 ALL_CALL 广播地址0x70,用于多个芯片同步控制。模块上电后,除接收本机的 I2C 通信地址 (0x40 ~ 0x47) 的请求以外,还会额外响应 ALL_CALL 功能的 I2C 地址 0x70。如果当前 I2C 总线上连接了相同地址的设备,将引发地址冲突,导致通信异常。该情况可通过配置 PCA9685 的工作模式寄存器 (0x00H) 中的 ALLCALL (bit:0),将其设置为 0 即可禁用ALL_CALL功能。#include <M5Unified.h>
#include <Wire.h>
#define SERVO2_I2C_ADDRESS 0x41
constexpr uint8_t PCA9685_MODE1_REG = 0x00;
constexpr uint8_t PCA9685_ALLCALL_BIT = 0x01;
bool readRegister8(uint8_t address, uint8_t reg, uint8_t &value)
{
Wire.beginTransmission(address);
Wire.write(reg);
if (Wire.endTransmission(false) != 0) {
return false;
}
if (Wire.requestFrom(address, static_cast<uint8_t>(1)) != 1) {
return false;
}
value = Wire.read();
return true;
}
bool writeRegister8(uint8_t address, uint8_t reg, uint8_t value)
{
Wire.beginTransmission(address);
Wire.write(reg);
Wire.write(value);
return Wire.endTransmission(true) == 0;
}
bool setAllCall(uint8_t address, bool enable)
{
uint8_t mode1 = 0;
if (!readRegister8(address, PCA9685_MODE1_REG, mode1)) {
return false;
}
// Set or clear MODE1 bit 0 and preserve the other MODE1 bits.
if (enable) {
mode1 |= PCA9685_ALLCALL_BIT;
} else {
mode1 &= static_cast<uint8_t>(~PCA9685_ALLCALL_BIT);
}
return writeRegister8(address, PCA9685_MODE1_REG, mode1);
}
bool probeI2C(uint8_t address)
{
Wire.beginTransmission(address);
return Wire.endTransmission(true) == 0;
}
void setup()
{
auto cfg = M5.config();
M5.begin(cfg);
Serial.begin(115200);
delay(500);
const int8_t wireSda = M5.getPin(m5::pin_name_t::in_i2c_sda);
const int8_t wireScl = M5.getPin(m5::pin_name_t::in_i2c_scl);
Wire.setPins(wireSda, wireScl);
Wire.begin();
if (!probeI2C(SERVO2_I2C_ADDRESS)) {
Serial.printf("PCA9685 not found at 0x%02X\n", SERVO2_I2C_ADDRESS);
while (true) {
delay(1000);
}
}
// Enable ALL_CALL and test the 0x70 address.
if (setAllCall(SERVO2_I2C_ADDRESS, true)) {
uint8_t mode1 = 0;
if (readRegister8(SERVO2_I2C_ADDRESS, PCA9685_MODE1_REG, mode1)) {
Serial.printf("ALL_CALL enabled, MODE1: 0x%02X\n", mode1);
} else {
Serial.println("ALL_CALL enabled, but MODE1 readback failed");
}
} else {
Serial.println("Failed to enable ALL_CALL");
}
Serial.println("Test 0x70 with ALL_CALL enabled:");
if (probeI2C(0x70)) {
Serial.println("0x70: ACK");
} else {
Serial.println("0x70: NACK");
}
// Disable ALL_CALL and test the 0x70 address again.
if (setAllCall(SERVO2_I2C_ADDRESS, false)) {
uint8_t mode1 = 0;
if (readRegister8(SERVO2_I2C_ADDRESS, PCA9685_MODE1_REG, mode1)) {
Serial.printf("ALL_CALL disabled, MODE1: 0x%02X\n", mode1);
} else {
Serial.println("ALL_CALL disabled, but MODE1 readback failed");
}
} else {
Serial.println("Failed to disable ALL_CALL");
}
Serial.println("Test 0x70 with ALL_CALL disabled:");
if (probeI2C(0x70)) {
Serial.println("0x70: ACK");
} else {
Serial.println("0x70: NACK");
}
}
void loop()
{
delay(1000);
}串口返回信息输出示例:
ALL_CALL disabled
MODE1: 0x20
0x70: NACK
ALL_CALL enabled, MODE1: 0x21
Test 0x70 with ALL_CALL enabled:
0x70: ACK
ALL_CALL disabled, MODE1: 0x20
Test 0x70 with ALL_CALL disabled:
0x70: NACK
