ESPHome 2026.11.0b6
Loading...
Searching...
No Matches
mpr121.cpp
Go to the documentation of this file.
1#include "mpr121.h"
2
3#include <cstdint>
4
5#include "esphome/core/hal.h"
7#include "esphome/core/log.h"
8
9namespace esphome::mpr121 {
10
11ESPHOME_LOG_TAG(TAG, "mpr121");
12
14 this->disable_loop();
15 // soft reset device
16 this->write_byte(MPR121_SOFTRESET, 0x63);
17 this->set_timeout(100, [this]() {
18 if (!this->write_byte(MPR121_ECR, 0x0)) {
19 this->mark_failed(LOG_STR(ESP_LOG_MSG_COMM_FAIL));
20 return;
21 }
22 // set touch sensitivity for all 12 channels
23 for (auto *channel : this->channels_) {
24 channel->setup();
25 }
26 this->write_byte(MPR121_MHDR, 0x01);
27 this->write_byte(MPR121_NHDR, 0x01);
28 this->write_byte(MPR121_NCLR, 0x0E);
29 this->write_byte(MPR121_FDLR, 0x00);
30
31 this->write_byte(MPR121_MHDF, 0x01);
32 this->write_byte(MPR121_NHDF, 0x05);
33 this->write_byte(MPR121_NCLF, 0x01);
34 this->write_byte(MPR121_FDLF, 0x00);
35
36 this->write_byte(MPR121_NHDT, 0x00);
37 this->write_byte(MPR121_NCLT, 0x00);
38 this->write_byte(MPR121_FDLT, 0x00);
39
41 // default, 16uA charge current
42 this->write_byte(MPR121_CONFIG1, 0x10);
43 // 0.5uS encoding, 1ms period
44 this->write_byte(MPR121_CONFIG2, 0x20);
45
46 // Write the Electrode Configuration Register
47 // * Highest 2 bits is "Calibration Lock", which we set to a value corresponding to 5 bits.
48 // * The 2 bits below is "Proximity Enable" and are left at 0.
49 // * The 4 least significant bits control how many electrodes are enabled. Electrodes are enabled
50 // as a range, starting at 0 up to the highest channel index used.
51 this->write_byte(MPR121_ECR, 0x80 | (this->max_touch_channel_ + 1));
52
53 this->flush_gpio_();
54 this->enable_loop();
55 });
56}
57
59 uint8_t mask = debounce << 4;
60 this->debounce_ &= 0x0f;
61 this->debounce_ |= mask;
62}
63
65 uint8_t mask = debounce & 0x0f;
66 this->debounce_ &= 0xf0;
67 this->debounce_ |= mask;
68};
69
71 ESP_LOGCONFIG(TAG, "MPR121:");
72 LOG_I2C_DEVICE(this);
73}
75 uint16_t val = 0;
77
78 for (auto *channel : this->channels_)
79 channel->process(val);
80
82}
83
84bool MPR121Component::digital_read(uint8_t pin) { return (this->gpio_input_ & (1 << (pin - 4))) != 0; }
85
86void MPR121Component::digital_write(uint8_t pin, bool value) {
87 const uint8_t ionum = pin - 4;
88 assign_bits(this->gpio_output_, 1 << ionum, value);
89 this->flush_gpio_();
90}
91
93 const uint8_t ionum = pin - 4;
94 this->gpio_enable_ |= (1 << ionum);
95 if (flags & gpio::FLAG_INPUT) {
96 this->gpio_direction_ &= ~(1 << ionum);
97 } else if (flags & gpio::FLAG_OUTPUT) {
98 this->gpio_direction_ |= 1 << ionum;
99 }
100 this->flush_gpio_();
101}
102
104 if (this->is_failed()) {
105 return false;
106 }
107
108 // TODO: The CTL registers can configure internal pullup/pulldown resistors.
109 this->write_byte(MPR121_GPIOCTL0, 0x00);
110 this->write_byte(MPR121_GPIOCTL1, 0x00);
113
114 return this->status_comm_result(this->write_byte(MPR121_GPIODATA, this->gpio_output_));
115}
116
117} // namespace esphome::mpr121
118
119ESPHOME_EXPANDER_PIN_SUMMARY(esphome::mpr121::MPR121Component, "ELE%u on MPR121")
void mark_failed()
Mark this component as failed.
bool is_failed() const
Definition component.h:287
bool status_comm_result(bool ok)
Clears the warning when ok, else sets it with message (default "Communication failed"); returns ok.
void enable_loop()
Enable this component's loop.
Definition component.h:261
void set_timeout(const char *name, uint32_t timeout, std::function< void()> &&f)
Set a timeout function with a const char* name.
Definition component.cpp:96
void disable_loop()
Disable this component's loop.
bool write_byte(uint8_t a_register, uint8_t data) const
Definition i2c.h:312
bool read_byte(uint8_t a_register, uint8_t *data)
Definition i2c.h:272
bool read_byte_16_le(uint8_t a_register, uint16_t *data)
Read a 16-bit value stored least significant byte first.
Definition i2c.h:296
uint8_t gpio_enable_
The enable mask - zero means high Z, 1 means GPIO usage.
Definition mpr121.h:92
void set_release_debounce(uint8_t debounce)
Definition mpr121.cpp:64
uint8_t gpio_direction_
Mask for the pin mode - 1 means output, 0 means input.
Definition mpr121.h:94
std::vector< MPR121Channel * > channels_
Definition mpr121.h:83
uint8_t gpio_output_
The mask to write as output state - 1 means HIGH, 0 means LOW.
Definition mpr121.h:96
bool digital_read(uint8_t pin)
Definition mpr121.cpp:84
void pin_mode(uint8_t pin, gpio::Flags flags)
Definition mpr121.cpp:92
uint8_t gpio_input_
The mask to read as input state - 1 means HIGH, 0 means LOW.
Definition mpr121.h:98
void digital_write(uint8_t pin, bool value)
Definition mpr121.cpp:86
void set_touch_debounce(uint8_t debounce)
Definition mpr121.cpp:58
uint16_t flags
mopeka_std_values val[3]
ESPHOME_LOG_TAG(TAG, "mpr121")
@ MPR121_TOUCHSTATUS_L
Definition mpr121.h:15
uint32_t value
Definition hal.cpp:41
ESPHOME_ALWAYS_INLINE constexpr void assign_bits(T &value, std::type_identity_t< T > mask, bool on)
Set the bits of mask in value when on is true, clear them otherwise.
Definition helpers.h:1150