ESPHome  2024.12.2
max7219digit.h
Go to the documentation of this file.
1 #pragma once
2 
4 #include "esphome/core/time.h"
5 
8 
9 #include <vector>
10 
11 namespace esphome {
12 namespace max7219digit {
13 
15  ZIGZAG = 0,
17 };
18 
19 enum ScrollMode {
22 };
23 
24 class MAX7219Component;
25 
26 using max7219_writer_t = std::function<void(MAX7219Component &)>;
27 
29  public spi::SPIDevice<spi::BIT_ORDER_MSB_FIRST, spi::CLOCK_POLARITY_LOW,
30  spi::CLOCK_PHASE_LEADING, spi::DATA_RATE_1MHZ> {
31  public:
32  void set_writer(max7219_writer_t &&writer) { this->writer_local_ = writer; };
33 
34  void setup() override;
35 
36  void loop() override;
37 
38  void dump_config() override;
39 
40  void update() override;
41 
42  float get_setup_priority() const override;
43 
44  void display();
45 
46  void invert_on_off(bool on_off);
47  void invert_on_off();
48 
49  void turn_on_off(bool on_off);
50 
51  void draw_absolute_pixel_internal(int x, int y, Color color) override;
52  int get_height_internal() override;
53  int get_width_internal() override;
54 
55  void set_intensity(uint8_t intensity) { this->intensity_ = intensity; };
56  void set_num_chips(uint8_t num_chips) { this->num_chips_ = num_chips; };
57  void set_num_chip_lines(uint8_t num_chip_lines) { this->num_chip_lines_ = num_chip_lines; };
58  void set_chip_lines_style(ChipLinesStyle chip_lines_style) { this->chip_lines_style_ = chip_lines_style; };
59  void set_chip_orientation(uint8_t rotate) { this->orientation_ = rotate; };
60  void set_scroll_speed(uint16_t speed) { this->scroll_speed_ = speed; };
61  void set_scroll_dwell(uint16_t dwell) { this->scroll_dwell_ = dwell; };
62  void set_scroll_delay(uint16_t delay) { this->scroll_delay_ = delay; };
63  void set_scroll(bool on_off) { this->scroll_ = on_off; };
65  void set_reverse(bool on_off) { this->reverse_ = on_off; };
66  void set_flip_x(bool flip_x) { this->flip_x_ = flip_x; };
67 
68  void send_char(uint8_t chip, uint8_t data);
69  void send64pixels(uint8_t chip, const uint8_t pixels[8]);
70 
71  void scroll_left();
72  void scroll(bool on_off, ScrollMode mode, uint16_t speed, uint16_t delay, uint16_t dwell);
73  void scroll(bool on_off, ScrollMode mode);
74  void scroll(bool on_off);
75  void intensity(uint8_t intensity);
76 
78  uint8_t printdigitf(uint8_t pos, const char *format, ...) __attribute__((format(printf, 3, 4)));
80  uint8_t printdigitf(const char *format, ...) __attribute__((format(printf, 2, 3)));
81 
83  uint8_t printdigit(uint8_t pos, const char *str);
85  uint8_t printdigit(const char *str);
86 
88  uint8_t strftimedigit(uint8_t pos, const char *format, ESPTime time) __attribute__((format(strftime, 3, 0)));
89 
91  uint8_t strftimedigit(const char *format, ESPTime time) __attribute__((format(strftime, 2, 0)));
92 
94 
95  protected:
96  void send_byte_(uint8_t a_register, uint8_t data);
97  void send_to_all_(uint8_t a_register, uint8_t data);
98  uint8_t orientation_180_();
99 
100  uint8_t intensity_;
101  uint8_t num_chips_;
104  bool scroll_;
105  bool reverse_;
106  bool flip_x_;
107  bool update_{false};
108  uint16_t scroll_speed_;
109  uint16_t scroll_delay_;
110  uint16_t scroll_dwell_;
111  uint16_t old_buffer_size_ = 0;
113  bool invert_ = false;
114  uint8_t orientation_;
115  uint8_t bckgrnd_ = 0x0;
116  std::vector<std::vector<uint8_t>> max_displaybuffer_;
117  uint32_t last_scroll_ = 0;
118  uint16_t stepsleft_;
119  size_t get_buffer_length_();
121 };
122 
123 } // namespace max7219digit
124 } // namespace esphome
void set_writer(max7219_writer_t &&writer)
Definition: max7219digit.h:32
void draw_absolute_pixel_internal(int x, int y, Color color) override
void set_chip_lines_style(ChipLinesStyle chip_lines_style)
Definition: max7219digit.h:58
void send64pixels(uint8_t chip, const uint8_t pixels[8])
uint16_t x
Definition: tt21100.cpp:17
A more user-friendly version of struct tm from time.h.
Definition: time.h:15
void send_to_all_(uint8_t a_register, uint8_t data)
int speed
Definition: fan.h:35
optional< max7219_writer_t > writer_local_
Definition: max7219digit.h:120
void set_scroll_mode(ScrollMode mode)
Definition: max7219digit.h:64
uint16_t y
Definition: tt21100.cpp:18
uint8_t strftimedigit(uint8_t pos, const char *format, ESPTime time) __attribute__((format(strftime
Evaluate the strftime-format and print the result at the given position.
The SPIDevice is what components using the SPI will create.
Definition: spi.h:391
void send_char(uint8_t chip, uint8_t data)
void set_num_chip_lines(uint8_t num_chip_lines)
Definition: max7219digit.h:57
std::vector< std::vector< uint8_t > > max_displaybuffer_
Definition: max7219digit.h:116
void set_num_chips(uint8_t num_chips)
Definition: max7219digit.h:56
void void void void void void strftime(int x, int y, BaseFont *font, Color color, Color background, TextAlign align, const char *format, ESPTime time) __attribute__((format(strftime
Evaluate the strftime-format format and print the result with the anchor point at [x...
Definition: display.cpp:665
BedjetMode mode
BedJet operating mode.
Definition: bedjet_codec.h:183
float get_setup_priority() const override
std::function< void(MAX7219Component &)> max7219_writer_t
Definition: max7219digit.h:26
uint8_t uint8_t uint8_t printdigit(uint8_t pos, const char *str)
Print str at the given position.
void scroll(bool on_off, ScrollMode mode, uint16_t speed, uint16_t delay, uint16_t dwell)
enum esphome::EntityCategory __attribute__
uint8_t num_chips_
Intensity of the display from 0 to 15 (most)
Definition: max7219digit.h:101
uint8_t printdigitf(uint8_t pos, const char *format,...) __attribute__((format(printf
Evaluate the printf-format and print the result at the given position.
void send_byte_(uint8_t a_register, uint8_t data)
void set_chip_orientation(uint8_t rotate)
Definition: max7219digit.h:59
void set_intensity(uint8_t intensity)
Definition: max7219digit.h:55
uint8_t uint8_t display::DisplayType get_display_type() override
Definition: max7219digit.h:93
void printf(int x, int y, BaseFont *font, Color color, Color background, TextAlign align, const char *format,...) __attribute__((format(printf
Evaluate the printf-format format and print the result with the anchor point at [x,y] with font.
Definition: display.cpp:594
Implementation of SPI Controller mode.
Definition: a01nyub.cpp:7
void IRAM_ATTR HOT delay(uint32_t ms)
Definition: core.cpp:26