Arduino开发的BLE踏频传感器无法被Wahoo iOS应用检测，求配置排查方案

Hey there, let's dig into why your BLE crank sensor works with Bryton but gets ignored by Wahoo's iOS app. I've spotted a few potential issues in your code that likely clash with Wahoo's stricter adherence to the BLE Cycling Speed and Cadence (CSC) profile spec:

Key Issues in Your Original Code #

• Incorrect CSC Measurement Characteristic Properties
  The CSC Measurement characteristic (UUID 2A5B) should only use BLENotify—it's designed for the sensor to push updates to the central device, not to be read directly. Your code includes BLERead, which violates the official spec and Wahoo's compliance checks.

• Missing Initial Values for Required Characteristics
  You defined the CSC Feature (2A5C) and Sensor Location (2A5D) characteristics but never set their initial values. While Bryton might overlook this, Wahoo's app expects these characteristics to have valid, accessible data the moment it connects.

• Wrong Buffer Size for Crank Data
  Your original bleBuffer was sized for a 2-byte crank revolution count, but the BLE CSC spec requires this to be a 4-byte (uint32) value. Malformed data like this will definitely cause Wahoo's app to reject the sensor.

Fixed Code Example #

Here's a corrected version that aligns with the BLE CSC profile, with comments explaining each change:

// Define CSC Feature (crank revolution data only)
#define CSC_FEATURES CSC_FEATURE_CRANK_REV_DATA

// Buffer for CSC Measurement: flags (1) + crank rev count (4) + last event time (2)
unsigned char bleBuffer[1 + 4 + 2];
unsigned char slBuffer[1];
unsigned char fBuffer[2];

// CSC Service and characteristics with spec-compliant properties
BLEService CSCService("1816");
// CSC Measurement should ONLY use Notify (no Read)
BLECharacteristic CSCMeasurement("2A5B", BLENotify, sizeof(bleBuffer));
// CSC Feature is Read-only
BLECharacteristic CSCFeature("2A5C", BLERead, sizeof(fBuffer));
// Sensor Location is Read-only
BLECharacteristic CSCSensorLocation("2A5D", BLERead, sizeof(slBuffer));

// CSC Measurement flags (only crank data is present)
byte flags = CSC_MEASUREMENT_CRANK_REV_PRESENT;
// CSC Feature value (crank rev data supported)
unsigned short features = CSC_FEATURE_CRANK_REV_DATA;
// Sensor location (right crank)
byte sensorlocation = SENSOR_LOCATION_RIGHT_CRANK;

// BLE appearance code for a cycling cadence sensor (from official spec)
const uint16_t CYCLING_CADENCE_SENSOR_APPEARANCE = 0x0483;

void setup() {
  BLE.begin();

  // Set device identifiers
  BLE.setDeviceName("My Crank Sensor"); // Replace with your device name
  BLE.setLocalName("My Crank Sensor");

  // Set appearance to help Wahoo's app identify the sensor type
  BLE.setAppearance(CYCLING_CADENCE_SENSOR_APPEARANCE);

  // Initialize characteristics with valid values BEFORE adding to service
  // CSC Feature: convert uint16 to big-endian (required for BLE)
  fBuffer[0] = highByte(features);
  fBuffer[1] = lowByte(features);
  CSCFeature.setValue(fBuffer, sizeof(fBuffer));

  // Sensor Location: set initial value
  slBuffer[0] = sensorlocation;
  CSCSensorLocation.setValue(slBuffer, sizeof(slBuffer));

  // Initialize CSC Measurement buffer with flags
  bleBuffer[0] = flags;
  CSCMeasurement.setValue(bleBuffer, sizeof(bleBuffer));

  // Assemble and start the BLE service
  CSCService.addCharacteristic(CSCFeature);
  CSCService.addCharacteristic(CSCMeasurement);
  CSCService.addCharacteristic(CSCSensorLocation);
  BLE.addService(CSCService);

  // Start advertising with the CSC service UUID
  BLE.setAdvertisedService(CSCService);
  BLE.advertise();

  // Initialize your sensor data buffers
  update(millis());
}

// Example update function (ensure data is in big-endian format per BLE spec)
void update(unsigned long currentMillis) {
  // Replace with actual sensor readings
  uint32_t crankRevCount = 1234; // 4-byte total crank revolutions
  uint16_t lastCrankEventTime = (currentMillis % 65536); // Time since last crank (1/1024s units)

  // Fill buffer with big-endian values
  bleBuffer[0] = flags;
  bleBuffer[1] = (crankRevCount >> 24) & 0xFF;
  bleBuffer[2] = (crankRevCount >> 16) & 0xFF;
  bleBuffer[3] = (crankRevCount >> 8) & 0xFF;
  bleBuffer[4] = crankRevCount & 0xFF;
  bleBuffer[5] = highByte(lastCrankEventTime);
  bleBuffer[6] = lowByte(lastCrankEventTime);

  // Push updated data to connected devices
  CSCMeasurement.setValue(bleBuffer, sizeof(bleBuffer));
  CSCMeasurement.notify();
}

Additional Notes #

• Endianness Matters: BLE requires multi-byte values to be in big-endian format. The example above handles this correctly for both the crank revolution count and event time.
• Appearance Value: Setting the appearance to 0x0483 explicitly tells Wahoo's app this is a cycling cadence sensor, which helps with proper categorization and recognition.
• Test the Update Logic: Make sure your update() function correctly populates the 4-byte crank revolution count—this is a common pitfall that breaks compatibility with strict BLE clients like Wahoo's app.

内容的提问来源于stack exchange，提问作者Christian Lindig