esp8266_web_settings beta
Public Member Functions | List of all members
grmcdorman::device::Sht31Sensor Class Reference

This class supports the SHT31-D sensor as a device. More...

#include <grmcdorman/device/Sht31Sensor.h>

Inheritance diagram for grmcdorman::device::Sht31Sensor:
grmcdorman::device::AbstractTemperaturePressureSensor grmcdorman::device::Device

Public Member Functions

void setup () override
 Setup the device. More...
 
void loop () override
 Main loop. More...
 
virtual String get_status () const
 Get a status report. More...
 
- Public Member Functions inherited from grmcdorman::device::AbstractTemperaturePressureSensor
 AbstractTemperaturePressureSensor (const __FlashStringHelper *device_name, const __FlashStringHelper *device_identifier)
 Construct a new Abstract Temperature Pressure Sensor object. More...
 
DynamicJsonDocument as_json () const override
 Get the values, as a JSON document. More...
 
bool publish (DynamicJsonDocument &json) const
 Publish the value and attributes. More...
 
float get_temperature () const
 Get the last temperature reading. More...
 
float get_humidity () const
 Get the last humidity reading. More...
 
- Public Member Functions inherited from grmcdorman::device::Device
 Device (const __FlashStringHelper *device_name, const __FlashStringHelper *device_identifier)
 Construct a new Device object. More...
 
virtual ~Device ()
 Destroy the Device object.
 
const __FlashStringHelper * name () const
 Get the device name; used for UI names and IDs. More...
 
virtual const __FlashStringHelper * identifier () const
 Get the device identifier. More...
 
virtual void set_defaults ()
 Set defaults, if necessary. More...
 
virtual void set_devices (const std::vector< Device * > &list)
 For devices that support it, add devices to manage. More...
 
const definition_list_tget_definitions () const
 Get the definitions list. More...
 
const ::grmcdorman::SettingInterface::settings_list_t & get_settings () const
 Get the settings list. More...
 
bool is_enabled () const
 Get whether this device is enabled. More...
 
void set_enabled (bool state)
 Set whether this device is enabled. More...
 
void set (const String &setting, const String &value)
 If possible, set a setting's value. More...
 
String get (const String &setting) const
 Get a setting value, as a string. More...
 
virtual bool get_is_published () const
 Get whether the device readings have been published. More...
 
void set_is_published ()
 Set the device as having published readings. More...
 
void clear_is_published ()
 Set the device as not having published readings.
 

Additional Inherited Members

- Public Types inherited from grmcdorman::device::Device
typedef std::vector< const Definition * > definition_list_t
 The type containing a list of Definition objects.
 
- Static Public Member Functions inherited from grmcdorman::device::Device
static void set_system_identifiers (const __FlashStringHelper *firmware_name_value, const String &system_identifier_value=String())
 Set the system identifier values. More...
 
static const __FlashStringHelper * get_firmware_name ()
 Get the firmware prefix. More...
 
static const String & get_system_identifier ()
 Get the system identifier. More...
 
- Static Public Attributes inherited from grmcdorman::device::AbstractTemperaturePressureSensor
static constexpr int INVALID_READING = -273
 The invalid reading value.
 
- Static Public Attributes inherited from grmcdorman::device::Device
static constexpr int D0 = 16
 D0 is GPIO16, HIGH at boot, not suitable for most usages.
 
static constexpr int D1 = 5
 D1 is GPIO5; often used as SCL.
 
static constexpr int D2 = 4
 D2 is GPIO4; often used as SDA.
 
static constexpr int D3 = 0
 D3 is GPIO0; pulled up; connected to FLASH button; not for input.
 
static constexpr int D4 = 2
 D4 is GPIO2; pulled up; HIGH at boot; on-board LED; not for input.
 
static constexpr int D5 = 14
 D5 is GPIO14; SPI (SCLK)
 
static constexpr int D6 = 12
 D6 is GPIO12; SPI (MISO)
 
static constexpr int D7 = 13
 D7 is GPIO13; SPI (MOSI)
 
static constexpr int D8 = 15
 D8 is GPIO15; pulled to GND; SPI (CS); not recommended.
 
static const ExclusiveOptionSetting::names_list_t data_line_names { FPSTR("D1"), FPSTR("D2"), FPSTR("D3"), FPSTR("D5"), FPSTR("D6"), FPSTR("D7")}
 Names for each configurable data line; see settingsMap.
 
- Protected Member Functions inherited from grmcdorman::device::Device
void initialize (definition_list_t &&definition_list, ::grmcdorman::SettingInterface::settings_list_t &&setting_list)
 Initialize the definition and setting lists. More...
 
- Static Protected Member Functions inherited from grmcdorman::device::Device
static int index_to_dataline (int index)
 Convert a data line index to a ESP data line. More...
 
static int dataline_to_index (int dataLine)
 Convert a data line to an index. More...
 
- Protected Attributes inherited from grmcdorman::device::AbstractTemperaturePressureSensor
Accumulator< float, 5, INVALID_READINGtemperature
 The temperature accumulator.
 
Accumulator< float, 5, INVALID_READINGhumidity
 The humidity accumulator.
 
- Protected Attributes inherited from grmcdorman::device::Device
ToggleSetting enabled
 Whether this device is enabled.
 
- Static Protected Attributes inherited from grmcdorman::device::Device
static const int settingsMap [6]
 The set of data lines usable for communication. More...
 

Detailed Description

This class supports the SHT31-D sensor as a device.

The device provides humidity and temperature. Readings are published as the average of all readings made since the last publish.

Member Function Documentation

◆ get_status()

String grmcdorman::device::Sht31Sensor::get_status ( ) const
virtual

Get a status report.

This is also used for the device_status info message, with the exception of various disabled states.

When the SHT31Sensor is disabled or nonoperational, this returns an empty string.

Returns
String containing status report.

Reimplemented from grmcdorman::device::Device.

◆ loop()

void grmcdorman::device::Sht31Sensor::loop ( )
overridevirtual

Main loop.

This is called in the main application loop. This should avoid blocking as doing so will prevent the other devices from running.

An exception is a "device" which requires user interaction, e.g. WiFi association, before the rest of the system can run.

Implements grmcdorman::device::Device.

◆ setup()

void grmcdorman::device::Sht31Sensor::setup ( )
overridevirtual

Setup the device.

Call once when the system boots. This should perform device-specific setup, if the device is enabled, as well as preparing UI settings (notably info settings) for communication.

This must be called after initial values are loaded.

Implements grmcdorman::device::Device.


The documentation for this class was generated from the following files: