b71c1adb26
* stm32wl: add hardware RTC support infrastructure Wires the STM32WL chip's internal RTC (running off the LSE 32.768kHz crystal) into meshtastic's existing time-of-day framework (perhapsSetRTC()/readFromRTC()), following the same pattern already used for I2C RTC chips (RV3028, PCF8563/85063, RX8130CE). LSE is started and polled manually before ever calling into the STM32RTC library, with our own bounded timeout - the library's own internal LSE startup path has no bounded fallback and hangs forever via Error_Handler() if the crystal never locks, so this is required for a board with a missing/faulty crystal to boot normally rather than hang. Gated behind a new HAS_LSE variant flag (currently unset everywhere, so this is inert until a variant opts in - see follow-up commit). Signed-off-by: Andrew Yong <me@ndoo.sg> Assisted-by: Claude Sonnet 5 <noreply@anthropic.com> * gps: qualify RTC.h includes to avoid case-insensitive filesystem collision with STM32RTC The stm32duino STM32RTC library (added to lib_deps in a follow-up commit) ships its own src/rtc.h. On case-insensitive filesystems (the macOS default), an unqualified #include "RTC.h"/<RTC.h> from any file outside src/gps/ resolves to the library's rtc.h instead of src/gps/RTC.h, since PlatformIO's LDF puts lib_deps include paths ahead of the project's own -Isrc/gps. Qualify every include as gps/RTC.h so it can't collide with any same-named header a future dependency might ship, regardless of filesystem case sensitivity. Purely mechanical, no behavior change. Signed-off-by: Andrew Yong <me@ndoo.sg> Assisted-by: Claude Sonnet 5 <noreply@anthropic.com> * stm32wl(rak3172): enable hardware RTC support Opts rak3172 into the HAS_LSE infrastructure added previously: sets STM32WL_LSE_DRIVE to a conservative default and pulls in the STM32RTC library. rak3172 has ~63KB flash headroom going in; build-verified at 76.7% flash usage after this change (up from a 73.8% baseline), well within budget. wio-e5 is not opted in here despite sharing the same STM32WLE5 chip - it's already at 96.8% flash usage today (GPS + I2C sensor support compiled in, unlike rak3172), leaving too little headroom to safely add STM32RTC without first trimming something else. Signed-off-by: Andrew Yong <me@ndoo.sg> Assisted-by: Claude Sonnet 5 <noreply@anthropic.com> * stm32wl: add docstrings for LSE/RTC setup functions Addresses CodeRabbit's docstring coverage check on PR #10961. Signed-off-by: Andrew Yong <me@ndoo.sg> Assisted-by: Claude Sonnet 5 <noreply@anthropic.com> * stm32wl: address CodeRabbit nitpicks on PR #10961 - Brace the single-statement HAS_LSE branch in perhapsSetRTC() to match the sibling readFromRTC() branch's style. - Quote the RTC.h include in PhoneAPI.cpp for consistency with every other qualified include site. Signed-off-by: Andrew Yong <me@ndoo.sg> Assisted-by: Claude Sonnet 5 <noreply@anthropic.com> --------- Signed-off-by: Andrew Yong <me@ndoo.sg> Co-authored-by: Ben Meadors <benmmeadors@gmail.com>
66 lines
2.2 KiB
C++
66 lines
2.2 KiB
C++
#include "configuration.h"
|
|
|
|
#if !MESHTASTIC_EXCLUDE_AIR_QUALITY_SENSOR && __has_include(<SensirionI2cScd4x.h>)
|
|
|
|
#include "../detect/ReClockI2C.h"
|
|
#include "../mesh/generated/meshtastic/telemetry.pb.h"
|
|
#include "TelemetrySensor.h"
|
|
#include "gps/RTC.h"
|
|
#include <SensirionI2cScd4x.h>
|
|
|
|
// Max speed 400kHz
|
|
#define SCD4X_I2C_CLOCK_SPEED 400000
|
|
#define SCD4X_WARMUP_MS 5000
|
|
|
|
class SCD4XSensor : public TelemetrySensor
|
|
{
|
|
private:
|
|
SensirionI2cScd4x scd4x;
|
|
#ifdef SCD4X_I2C_CLOCK_SPEED
|
|
ReClockI2C reClockI2C;
|
|
#endif
|
|
|
|
bool performFRC(uint32_t targetCO2);
|
|
bool setASCBaseline(uint32_t targetCO2);
|
|
bool getASC(uint16_t &ascEnabled);
|
|
bool setASC(bool ascEnabled);
|
|
bool setTemperature(float tempReference);
|
|
bool getAltitude(uint16_t &altitude);
|
|
bool setAltitude(uint32_t altitude);
|
|
bool getAmbientPressure(uint32_t &ambientPressure);
|
|
bool setAmbientPressure(uint32_t ambientPressure);
|
|
bool factoryReset();
|
|
bool setPowerMode(bool _lowPower);
|
|
bool startMeasurement();
|
|
bool stopMeasurement();
|
|
|
|
uint16_t ascActive = 1;
|
|
// low power measurement mode (on sensirion side). Disables sleep mode
|
|
// Improvement and testing needed for timings
|
|
bool lowPower = true;
|
|
uint32_t co2MeasureStarted = 0;
|
|
|
|
public:
|
|
SCD4XSensor();
|
|
virtual bool getMetrics(meshtastic_Telemetry *measurement) override;
|
|
virtual bool initDevice(TwoWire *bus, ScanI2C::FoundDevice *dev) override;
|
|
|
|
enum SCD4XState { SCD4X_OFF, SCD4X_IDLE, SCD4X_MEASUREMENT };
|
|
SCD4XState state = SCD4X_OFF;
|
|
SCD4xSensorVariant sensorVariant{};
|
|
|
|
virtual bool isActive() override;
|
|
|
|
virtual void sleep() override; // Stops measurement (measurement -> idle)
|
|
virtual uint32_t wakeUp() override; // Starts measurement (idle -> measurement)
|
|
bool powerDown(); // Powers down sensor (idle -> power-off)
|
|
bool powerUp(); // Powers the sensor (power-off -> idle)
|
|
virtual bool canSleep() override;
|
|
virtual int32_t wakeUpTimeMs() override;
|
|
virtual int32_t pendingForReadyMs() override;
|
|
AdminMessageHandleResult handleAdminMessage(const meshtastic_MeshPacket &mp, meshtastic_AdminMessage *request,
|
|
meshtastic_AdminMessage *response) override;
|
|
};
|
|
|
|
#endif
|