#ifdef USE_HOST #include #include #include "esphome/components/tmp102/tmp102.h" #include "esphome/core/application.h" #include "esphome/core/hal.h" namespace esphome::tmp102::testing { class RegisterBus final : public i2c::I2CBus { public: std::array registers{0x1900, 0x60A0, 0x4B00, 0x5000}; int fail_read{-1}; int fail_write{-1}; int fail_select{-1}; unsigned transactions{0}; unsigned writes{0}; uint8_t pointer{0}; i2c::ErrorCode write_readv(uint8_t address, const uint8_t *data, size_t size, uint8_t *out, size_t out_size) override { ++this->transactions; if (size != 0) { if (data[0] >= this->registers.size() || data[0] == this->fail_select) return i2c::ERROR_NOT_ACKNOWLEDGED; this->pointer = data[0]; if (size == 3) { if (this->pointer == this->fail_write) return i2c::ERROR_NOT_ACKNOWLEDGED; ++this->writes; this->registers[this->pointer] = (uint16_t(data[1]) << 8) | data[2]; } } if (out_size != 0) { if (out_size != 2 || this->pointer == this->fail_read) return i2c::ERROR_NOT_ACKNOWLEDGED; out[0] = this->registers[this->pointer] >> 8; out[1] = this->registers[this->pointer]; } return i2c::ERROR_OK; } }; class TMP102Test : public ::testing::Test { protected: RegisterBus bus_; TMP102Component chip_; binary_sensor::BinarySensor alert_; unsigned publications_{0}; void SetUp() override { new (&App) Application; char name[] = "tmp102-regression-tests"; char friendly_name[] = "TMP102 tests"; App.pre_setup(name, 23, friendly_name, 12); this->chip_.set_i2c_bus(&this->bus_); this->chip_.set_i2c_address(0x48); this->chip_.add_on_state_callback([this](float) { ++this->publications_; }); } void TearDown() override { App.scheduler.cancel_timeout(&this->chip_, uint32_t{0}); App.scheduler.call(millis()); App.~Application(); } static void run_timers(uint32_t duration) { App.scheduler.call(millis()); delay(duration); App.scheduler.call(millis()); } void configure(uint16_t config = 0x0080, uint16_t high = 0x5000, uint16_t low = 0x4B00) { this->chip_.set_configuration(config, high, low); } }; TEST_F(TMP102Test, LegacySetupAndContinuousReadDoNotWriteRegisters) { const auto original = this->bus_.registers; this->chip_.setup(); EXPECT_EQ(this->bus_.transactions, 0); this->chip_.update(); run_timers(55); EXPECT_FLOAT_EQ(this->chip_.state, 25); EXPECT_EQ(this->publications_, 1); EXPECT_EQ(this->bus_.writes, 0); EXPECT_EQ(this->bus_.registers, original); } TEST_F(TMP102Test, SampleFormatOverridesConfiguredModeInBothDirections) { for (bool configured_extended : {false, true}) { this->configure(configured_extended ? 0x0010 : 0, configured_extended ? 0x2800 : 0x5000, configured_extended ? 0x2580 : 0x4B00); this->chip_.setup(); const auto writes = this->bus_.writes; for (auto raw : {0x1900, 0x0C81, 0xFF00, 0xFF81}) { this->bus_.registers[0] = raw; this->chip_.update(); EXPECT_FLOAT_EQ(this->chip_.state, raw & 0x8000 ? -1 : 25); EXPECT_FALSE(this->chip_.status_has_warning()); EXPECT_EQ(this->bus_.writes, writes); } } } TEST_F(TMP102Test, WritableConfigurationFields) { this->configure(0x1FD0, 0x2800, 0x2580); this->chip_.setup(); EXPECT_EQ(this->bus_.registers[1], 0x1FD0); EXPECT_EQ(this->bus_.registers[3], 0x2800); EXPECT_EQ(this->bus_.registers[2], 0x2580); } TEST_F(TMP102Test, AlertEntityPreservesHardwareAndUsesObservedPolarity) { this->chip_.set_alert_binary_sensor(&this->alert_); this->chip_.setup(); EXPECT_EQ(this->bus_.transactions, 0); for (uint16_t config : {0x60A0, 0x6080, 0x64A0, 0x6480}) { this->bus_.registers[1] = config; this->chip_.update(); run_timers(55); ASSERT_TRUE(this->alert_.has_state()); EXPECT_EQ(this->alert_.state, bool(config & 0x20) == bool(config & 0x400)); EXPECT_EQ(this->bus_.registers[1], config); } EXPECT_EQ(this->bus_.writes, 0); } TEST_F(TMP102Test, FailedTemperatureOrAlertReadInvalidatesAlert) { this->chip_.set_alert_binary_sensor(&this->alert_); this->chip_.setup(); this->chip_.update(); run_timers(55); ASSERT_TRUE(this->alert_.has_state()); for (int reg : {0, 1}) { this->bus_.fail_read = reg; this->chip_.update(); run_timers(55); EXPECT_TRUE(this->chip_.status_has_warning()); EXPECT_FALSE(this->alert_.has_state()); this->bus_.fail_read = -1; this->chip_.update(); run_timers(55); EXPECT_FALSE(this->chip_.status_has_warning()); EXPECT_TRUE(this->alert_.has_state()); } } TEST_F(TMP102Test, ConfiguredAlertUsesObservedPolarity) { this->chip_.set_alert_binary_sensor(&this->alert_); for (uint16_t config : {0x0080, 0x00A0, 0x0480, 0x04A0}) { this->configure(config & ~0x0020); this->chip_.setup(); this->bus_.registers[1] = config; this->chip_.update(); ASSERT_TRUE(this->alert_.has_state()); EXPECT_EQ(this->alert_.state, bool(config & 0x0020) == bool(config & 0x0400)); EXPECT_FALSE(this->chip_.status_has_warning()); } } TEST_F(TMP102Test, ConfiguredAlertInvalidatesDuringRecoveryAndRepublishes) { this->chip_.set_alert_binary_sensor(&this->alert_); this->configure(0x0090, 0x2D00, 0x2A80); this->chip_.setup(); this->chip_.update(); ASSERT_TRUE(this->alert_.has_state()); this->bus_.registers = {0x1900, 0x60A0, 0x4B00, 0x5000}; this->chip_.update(); EXPECT_FALSE(this->alert_.has_state()); EXPECT_TRUE(this->chip_.status_has_warning()); this->chip_.update(); EXPECT_TRUE(this->alert_.has_state()); EXPECT_FALSE(this->chip_.status_has_warning()); } TEST_F(TMP102Test, OneShotPublishesAlertAfterDelayedRead) { this->chip_.set_alert_binary_sensor(&this->alert_); this->configure(0x0180); this->chip_.setup(); this->chip_.update(); EXPECT_FALSE(this->alert_.has_state()); run_timers(45); EXPECT_TRUE(this->alert_.has_state()); EXPECT_TRUE(this->alert_.state); EXPECT_FALSE(this->chip_.status_has_warning()); } TEST_F(TMP102Test, RestoresRegistersAfterChipOnlyResetBeforePublishing) { this->configure(0x0090, 0x2D00, 0x2A80); this->chip_.setup(); const auto configured = this->bus_.registers; this->chip_.update(); this->bus_.registers = {0x1900, 0x60A0, 0x4B00, 0x5000}; this->chip_.update(); EXPECT_EQ(this->publications_, 1); EXPECT_TRUE(this->chip_.status_has_warning()); for (size_t reg = 1; reg < 4; ++reg) EXPECT_EQ(this->bus_.registers[reg], configured[reg]); this->chip_.update(); EXPECT_EQ(this->publications_, 2); EXPECT_FLOAT_EQ(this->chip_.state, 25); EXPECT_FALSE(this->chip_.status_has_warning()); } TEST_F(TMP102Test, RecoveryRetriesFailedWritesAndDetectsThresholdOnlyChange) { this->configure(); this->chip_.setup(); this->bus_.registers[3] = 0; this->bus_.fail_write = 3; this->chip_.update(); EXPECT_EQ(this->publications_, 0); this->bus_.fail_write = -1; this->chip_.update(); EXPECT_EQ(this->bus_.registers[3], 0x5000); this->chip_.update(); EXPECT_EQ(this->publications_, 1); } TEST_F(TMP102Test, ConfigurationReadFailuresDoNotPublishOrOverwriteRegisters) { this->configure(); this->chip_.setup(); for (int reg : {1, 2, 3}) { const auto publications = this->publications_; const auto writes = this->bus_.writes; this->bus_.fail_read = reg; this->chip_.update(); EXPECT_TRUE(this->chip_.status_has_warning()); EXPECT_EQ(this->publications_, publications); EXPECT_EQ(this->bus_.writes, writes); this->bus_.fail_read = -1; } } TEST_F(TMP102Test, ReadOnlyConfigurationBitsDoNotTriggerRecovery) { this->configure(); this->chip_.setup(); const auto writes = this->bus_.writes; this->bus_.registers[1] ^= 0xE020; this->chip_.update(); EXPECT_EQ(this->publications_, 1); EXPECT_EQ(this->bus_.writes, writes); EXPECT_FALSE(this->chip_.status_has_warning()); } TEST_F(TMP102Test, OneShotTriggerFailureSetsWarning) { this->chip_.set_alert_binary_sensor(&this->alert_); this->configure(0x0180); this->chip_.setup(); this->alert_.publish_state(false); this->bus_.fail_write = 1; this->chip_.update(); run_timers(45); EXPECT_EQ(this->publications_, 0); EXPECT_TRUE(this->chip_.status_has_warning()); EXPECT_FALSE(this->alert_.has_state()); } TEST_F(TMP102Test, OneShotRestartsPendingReadAndReselectsTemperature) { this->configure(0x0180); this->chip_.setup(); this->chip_.update(); this->chip_.update(); EXPECT_EQ(this->publications_, 0); this->bus_.pointer = 3; run_timers(45); EXPECT_EQ(this->publications_, 1); EXPECT_FLOAT_EQ(this->chip_.state, 25); } TEST_F(TMP102Test, LimitsAreOnlyCheckedWhenConfigurationMatchesResetDefault) { this->configure(); this->chip_.setup(); this->bus_.registers[2] = 0; this->chip_.update(); EXPECT_EQ(this->publications_, 0); EXPECT_TRUE(this->chip_.status_has_warning()); EXPECT_EQ(this->bus_.registers[2], 0x4B00); this->configure(0x00C0); this->chip_.setup(); this->bus_.registers[2] = 0; const auto transactions = this->bus_.transactions; const auto writes = this->bus_.writes; this->chip_.update(); EXPECT_EQ(this->bus_.transactions - transactions, 2); EXPECT_EQ(this->bus_.writes, writes); EXPECT_EQ(this->publications_, 1); } TEST_F(TMP102Test, FailureOfAnySetupWriteMarksComponentFailed) { for (int reg : {1, 2, 3}) { TMP102Component failed; failed.set_i2c_bus(&this->bus_); failed.set_i2c_address(0x48); failed.set_configuration(0x0080, 0x5000, 0x4B00); this->bus_.fail_write = reg; failed.setup(); EXPECT_TRUE(failed.is_failed()); } } } // namespace esphome::tmp102::testing #endif