max7219.h

Go to the documentation of this file.

#pragma once
 
#include "esphome/core/component.h"
#include "esphome/core/time.h"
 
#include "esphome/components/spi/spi.h"
#include "esphome/components/display/display.h"
 
namespace esphome::max7219 {
 
class MAX7219Component;
 
using max7219_writer_t = display::DisplayWriter<MAX7219Component>;
 
class MAX7219Component : public PollingComponent,
                         public spi::SPIDevice<spi::BIT_ORDER_MSB_FIRST, spi::CLOCK_POLARITY_LOW,
                                               spi::CLOCK_PHASE_LEADING, spi::DATA_RATE_1MHZ> {
 public:
  explicit MAX7219Component(uint8_t num_chips);
 
  void set_writer(max7219_writer_t &&writer);
 
  void setup() override;
 
  void dump_config() override;
 
  void update() override;
 
  float get_setup_priority() const override;
 
  void display();
 
  void set_intensity(uint8_t intensity);
  void set_reverse(bool reverse) { this->reverse_ = reverse; };
 
  uint8_t printf(uint8_t pos, const char *format, ...) __attribute__((format(printf, 3, 4)));
  uint8_t printf(const char *format, ...) __attribute__((format(printf, 2, 3)));
 
  uint8_t print(uint8_t pos, const char *str);
  uint8_t print(const char *str);
 
  uint8_t strftime(uint8_t pos, const char *format, ESPTime time) __attribute__((format(strftime, 3, 0)));
 
  uint8_t strftime(const char *format, ESPTime time) __attribute__((format(strftime, 2, 0)));
 
 protected:
  void send_byte_(uint8_t a_register, uint8_t data);
  void send_to_all_(uint8_t a_register, uint8_t data);
 
  uint8_t intensity_{15};     // Intensity of the display from 0 to 15 (most)
  bool intensity_changed_{};  // True if we need to re-send the intensity
  uint8_t num_chips_{1};
  uint8_t *buffer_{nullptr};
  bool reverse_{false};
  max7219_writer_t writer_{};
};
 
}  // namespace esphome::max7219