oled_status_display.h

Go to the documentation of this file.

#pragma once
 
#include <Arduino.h>
 
#include "fault_policy.h"
#include "sensor_manager.h"
 
enum class OledDisplayMode : uint8_t {
  kDisabled,    
  kBoot,        
  kTemperature, 
  kFault,       
};
 
struct OledStatusDisplayConfig {
  uint8_t sdaPin;            
  uint8_t sclPin;            
  uint8_t width;             
  uint8_t height;            
  uint8_t primaryAddress;    
  uint8_t secondaryAddress;  
  uint32_t busFrequencyHz;   
};
 
class OledStatusDisplay {
 public:
  explicit OledStatusDisplay(
      const OledStatusDisplayConfig& config = {
          32,
          27,
          128,
          32,
          0x3C,
          0x3D,
          400000,
      });
 
  bool begin(uint32_t nowMs);
 
  void update(uint32_t nowMs,
              const SensorSnapshot& sensorSnapshot,
              bool faultSnapshotValid,
              const FaultPolicySnapshot& policySnapshot);
 
  bool isAvailable() const;
 
  OledDisplayMode mode() const;
 
  const char* modeLabel() const;
 
  const char* primaryText() const;
 
  const char* secondaryText() const;
 
  uint8_t address() const;
 
 private:
  struct PendingState {
    OledDisplayMode mode;
    char primaryText[12];
    char secondaryText[12];
  };
 
  static const uint8_t* glyphForChar(char c);
  static const char* faultTextForAlarm(AlarmCode alarmCode);
  static const char* modeLabelFor(OledDisplayMode mode);
 
  bool detectDisplay();
  bool initializeController();
  bool sendCommand(uint8_t command);
  bool sendCommands(const uint8_t* commands, size_t count);
  bool sendData(const uint8_t* data, size_t count);
  bool flushBuffer();
  void disableDisplay();
 
  void clearBuffer();
  void drawPixel(int16_t x, int16_t y);
  void drawGlyph5x7(int16_t x, int16_t y, char c, uint8_t scale);
  int16_t textWidth(const char* text, uint8_t scale) const;
  void drawText(int16_t x, int16_t y, const char* text, uint8_t scale);
 
  PendingState buildPendingState(const SensorSnapshot& sensorSnapshot,
                                 bool faultSnapshotValid,
                                 const FaultPolicySnapshot& policySnapshot) const;
  bool renderState(const PendingState& state);
  bool stateEquals(const PendingState& lhs, const PendingState& rhs) const;
  void copyState(PendingState* destination, const PendingState& source) const;
 
  OledStatusDisplayConfig config_;
  uint8_t address_;
  bool available_;
  bool i2cReady_;
  PendingState currentState_;
  uint8_t buffer_[128 * 32 / 8];
};