SensESP 3.3.0
Universal Signal K sensor toolkit ESP32
Loading...
Searching...
No Matches
sensesp_app_builder.h
Go to the documentation of this file.
1#ifndef SENSESP_APP_BUILDER_H
2#define SENSESP_APP_BUILDER_H
3
4#include <memory>
5
6#include "Arduino.h"
10#include "sensesp_app.h"
12
13constexpr const char* kDefaultSystemInfoSensorPrefix = "sensorDevice.";
14
15namespace sensesp {
16
22 private:
23 String hostname_ = "SensESP";
24 String ssid_ = "";
25 String password_ = "";
26 String sk_server_address_ = "";
27 uint16_t sk_server_port_ = 0;
28
29 protected:
30 std::shared_ptr<SensESPApp> app_;
31
32 public:
40 app_ = std::shared_ptr<SensESPApp>(new SensESPApp());
41 app_->set_instance(app_);
42 }
43
53 SensESPAppBuilder* set_wifi_client(String ssid, String password) {
54 app_->set_ssid(ssid);
55 app_->set_wifi_password(password);
56 return this;
57 }
58
59 [[deprecated("Use set_wifi_client instead")]]
60 SensESPAppBuilder* set_wifi(String ssid, String password) {
61 return set_wifi_client(ssid, password);
62 }
63
74 const String& password) {
75 app_->set_ap_ssid(ssid);
76 app_->set_ap_password(password);
77 return this;
78 }
79
93 app_->set_ssid("");
94 app_->set_wifi_password("");
95 app_->set_ap_ssid("");
96 app_->set_ap_password("");
97 return this;
98 }
99
126 template <typename ProvisionerConfigT>
127 SensESPAppBuilder* set_ethernet(ProvisionerConfigT config) {
128 disable_wifi();
129 app_->set_network_provisioner_factory(
130 [config]() -> std::shared_ptr<NetworkProvisioner> {
131 return std::make_shared<typename ProvisionerConfigT::ProvisionerType>(
132 config);
133 });
134 return this;
135 }
136
146 SensESPAppBuilder* set_sk_server(String address, uint16_t port) {
147 app_->set_sk_server_address(address);
148 app_->set_sk_server_port(port);
149 return this;
150 }
151
159 SensESPAppBuilder* set_hostname(String hostname) override final {
160 app_->set_hostname(hostname);
161 return this;
162 }
163
167 SensESPAppBuilder* set_admin_user(const char* username,
168 const char* password) {
169 app_->set_admin_user(username, password);
170 return this;
171 }
172
182 std::shared_ptr<SystemStatusLed> system_status_led) {
183 app_->set_system_status_led(system_status_led);
184 return this;
185 }
186
196 String prefix = kDefaultSystemInfoSensorPrefix) {
197 auto sensor = std::make_shared<SystemHz>();
198 auto vproducer = std::static_pointer_cast<ValueProducer<float>>(sensor);
199 // We need to store the sensor in the app so it doesn't get garbage
200 // collected.
201 app_->system_hz_sensor_ = vproducer;
202 connect_system_info_sensor(vproducer, prefix, "systemHz");
203 return this;
204 }
205
212 String prefix = kDefaultSystemInfoSensorPrefix) {
213 auto sensor = std::make_shared<FreeMem>();
214 auto vproducer = std::static_pointer_cast<ValueProducer<uint32_t>>(sensor);
215 // We need to store the sensor in the app so it doesn't get garbage
216 // collected.
217 app_->free_mem_sensor_ = vproducer;
218 connect_system_info_sensor(vproducer, prefix, "freeMemory");
219 return this;
220 }
221
228 String prefix = kDefaultSystemInfoSensorPrefix) {
229 auto sensor = std::make_shared<Uptime>();
230 auto vproducer = std::static_pointer_cast<ValueProducer<float>>(sensor);
231 // We need to store the sensor in the app so it doesn't get garbage
232 // collected.
233 app_->uptime_sensor_ = vproducer;
234 connect_system_info_sensor(vproducer, prefix, "uptime");
235 return this;
236 }
237
244 String prefix = kDefaultSystemInfoSensorPrefix) {
245 auto sensor = std::make_shared<IPAddrDev>();
246 auto vproducer = std::static_pointer_cast<ValueProducer<String>>(sensor);
247 // We need to store the sensor in the app so it doesn't get garbage
248 // collected.
249 app_->ip_address_sensor_ = vproducer;
250 connect_system_info_sensor(vproducer, prefix, "ipAddress");
251 return this;
252 }
253
260 String prefix = kDefaultSystemInfoSensorPrefix) {
261 auto sensor = std::make_shared<WiFiSignal>();
262 auto vproducer = std::static_pointer_cast<ValueProducer<int>>(sensor);
263 // We need to store the sensor in the app so it doesn't get garbage
264 // collected.
265 app_->wifi_signal_sensor_ = vproducer;
266 connect_system_info_sensor(vproducer, prefix, "wifiSignalLevel");
267 return this;
268 }
269
276 app_->set_button_pin(pin);
277 return this;
278 }
279
287 String prefix = kDefaultSystemInfoSensorPrefix) {
288 this->enable_system_hz_sensor(prefix);
289 this->enable_free_mem_sensor(prefix);
290 this->enable_uptime_sensor(prefix);
291 this->enable_ip_address_sensor(prefix);
292 this->enable_wifi_signal_sensor(prefix);
293 return this;
294 }
295
302 SensESPAppBuilder* enable_ota(const char* password) {
303 app_->enable_ota(password);
304 return this;
305 }
306
317 [[deprecated("Use set_wifi_access_point instead")]]
319 app_->set_ap_password(password);
320 return this;
321 }
322
324 // create the wifi disconnect watchdog
325 app_->system_status_controller_
326 ->connect_to(new Debounce<SystemStatus>(
327 3 * 60 * 1000 // 180 s = 180000 ms = 3 minutes
328 ))
329 ->connect_to(new LambdaConsumer<SystemStatus>([](SystemStatus input) {
330 ESP_LOGD(__FILENAME__, "Got system status: %d", (int)input);
331 if (input == SystemStatus::kWifiDisconnected ||
332 input == SystemStatus::kWifiNoAP) {
333 ESP_LOGW(__FILENAME__,
334 "Unable to connect to wifi for too long; restarting.");
335 event_loop()->onDelay(1000, []() { ESP.restart(); });
336 }
337 }));
338
339 return this;
340 }
341
349 std::shared_ptr<SensESPApp> get_app() {
351 app_->setup();
352 return app_;
353 }
354};
355
356} // namespace sensesp
357
358#endif
Implements debounce code for a button or switch.
Definition debounce.h:32
Provides an easy way of calling a function based on the output of any ValueProducer.
const SensESPAppBuilder * enable_wifi_watchdog()
SensESPAppBuilder()
Construct a new SensESPApp Builder object.
SensESPAppBuilder * set_admin_user(const char *username, const char *password)
Set admin username and password for the web interface.
SensESPAppBuilder * set_hostname(String hostname) override final
Set the device hostname.
SensESPAppBuilder * disable_wifi()
Clear the default WiFi STA/AP settings.
SensESPAppBuilder * set_ethernet(ProvisionerConfigT config)
Configure the app to use a non-WiFi NetworkProvisioner.
SensESPAppBuilder * set_system_status_led(std::shared_ptr< SystemStatusLed > system_status_led)
Set the system status led object.
SensESPAppBuilder * set_sk_server(String address, uint16_t port)
Set the Signal K server address and port.
SensESPAppBuilder * set_wifi(String ssid, String password)
std::shared_ptr< SensESPApp > app_
SensESPAppBuilder * set_wifi_client(String ssid, String password)
Set the Wi-Fi network SSID and password.
SensESPAppBuilder * set_wifi_manager_password(const char *password)
Set the wifi manager password.
SensESPAppBuilder * enable_ip_address_sensor(String prefix=kDefaultSystemInfoSensorPrefix)
Report the IP address of the device.
SensESPAppBuilder * enable_free_mem_sensor(String prefix=kDefaultSystemInfoSensorPrefix)
Enable the free memory sensor.
SensESPAppBuilder * set_wifi_access_point(const String &ssid, const String &password)
Set the wifi access point object SSID and password.
SensESPAppBuilder * set_button_pin(int pin)
Set the button GPIO pin.
std::shared_ptr< SensESPApp > get_app()
Get the SensESPApp object.
SensESPAppBuilder * enable_system_hz_sensor(String prefix=kDefaultSystemInfoSensorPrefix)
Enable the System Hz sensor.
SensESPAppBuilder * enable_system_info_sensors(String prefix=kDefaultSystemInfoSensorPrefix)
Enable all built-in system info sensors.
SensESPAppBuilder * enable_uptime_sensor(String prefix=kDefaultSystemInfoSensorPrefix)
Report the system uptime in seconds since the last reboot.
SensESPAppBuilder * enable_wifi_signal_sensor(String prefix=kDefaultSystemInfoSensorPrefix)
Report the Wi-Fi signal strength.
SensESPAppBuilder * enable_ota(const char *password)
Enable over-the-air updates for the device.
static std::shared_ptr< SensESPApp > get()
Get the singleton instance of the SensESPApp.
Definition sensesp_app.h:54
Abstract base class for other SensESP*AppBuilder classes.
std::shared_ptr< reactesp::EventLoop > event_loop()
Definition sensesp.cpp:9
void connect_system_info_sensor(std::shared_ptr< ValueProducer< T > > &sensor, const String &prefix, const String &name)
Connect a system information sensor to SKOutput.
Definition system_info.h:18
constexpr const char * kDefaultSystemInfoSensorPrefix