This adds:
- A general folder for documantation configs - A documantation for general esphome devices with functionallity too small for it's own file. - Removed the powersave mode NONE on garage doors.
This commit is contained in:
50
5gModemPower.yaml
Normal file
50
5gModemPower.yaml
Normal file
@@ -0,0 +1,50 @@
|
|||||||
|
esphome:
|
||||||
|
name: modempower
|
||||||
|
|
||||||
|
esp8266:
|
||||||
|
board: sonoff_basic
|
||||||
|
|
||||||
|
wifi:
|
||||||
|
ssid: !secret wifi_ssid
|
||||||
|
password: !secret wifi_password
|
||||||
|
fast_connect: true
|
||||||
|
ap:
|
||||||
|
ssid: modempower_rescue
|
||||||
|
password: !secret rescue_ap_password
|
||||||
|
|
||||||
|
captive_portal:
|
||||||
|
|
||||||
|
api:
|
||||||
|
encryption:
|
||||||
|
key: !secret k5gModem
|
||||||
|
|
||||||
|
ota:
|
||||||
|
- platform: esphome
|
||||||
|
password: !secret p5gModem
|
||||||
|
|
||||||
|
logger:
|
||||||
|
|
||||||
|
binary_sensor:
|
||||||
|
- platform: gpio
|
||||||
|
pin:
|
||||||
|
number: GPIO0
|
||||||
|
mode:
|
||||||
|
input: true
|
||||||
|
pullup: true
|
||||||
|
inverted: true
|
||||||
|
name: "5G Modem Power Button"
|
||||||
|
on_press:
|
||||||
|
- switch.toggle: relay
|
||||||
|
|
||||||
|
switch:
|
||||||
|
- platform: gpio
|
||||||
|
name: "5G Modem Power Relay"
|
||||||
|
pin: GPIO12
|
||||||
|
restore_mode: ALWAYS_ON
|
||||||
|
id: relay
|
||||||
|
|
||||||
|
status_led:
|
||||||
|
pin:
|
||||||
|
number: GPIO13
|
||||||
|
inverted: yes
|
||||||
|
|
49
docs/GENERAL_DEVICE.md
Normal file
49
docs/GENERAL_DEVICE.md
Normal file
@@ -0,0 +1,49 @@
|
|||||||
|
# What is this:
|
||||||
|
This is the general documentation for esphome configs deemed too short to deserve their own documantation. Stuff like the 5gModem, the sonoffStecker or the nbs-light-room are just too short for me to believe it necessary.
|
||||||
|
|
||||||
|
So, let's get through the basics of any esphome config developed by me.
|
||||||
|
|
||||||
|
# General configs
|
||||||
|
Before I start, I should mention what I consider to be general configurations: modules like esphome, esp8266 or esp32, as well as wifi, logger, ota are all part of that. Nearly all of them require all of them (with exception to esp8266 and esp32 as they are mutually exclusive).
|
||||||
|
|
||||||
|
## esphome
|
||||||
|
The `esphome` defines general points, and is required by any esphome config to function. Weirdly, in the last few years this has become a mere holder for `name` and maybe `version`.
|
||||||
|
|
||||||
|
For `name` I recommand something that actually give the device a name that is clear what it does.
|
||||||
|
For `version` when used, I recommand using semantic versioning that makes sense. But if you actually use it or not is up to you.
|
||||||
|
|
||||||
|
## esp8266/esp32
|
||||||
|
The `esp8266` or `esp32` has a special point about only being their to define the actually board being used.
|
||||||
|
Most common boards for esp8266 that we use is the `nodemcuv2`. While for the esp32 it is the `wemos_d1_mini32` also sometimes referenced as `esp32dev`.
|
||||||
|
|
||||||
|
A special note about `esp32` is that they have multiple frameworks that are supported. This is defined as `esp32.framework.type`:
|
||||||
|
- arduino
|
||||||
|
- esp-idf
|
||||||
|
|
||||||
|
## wifi
|
||||||
|
The wifi part is not confusing at all. Normally we use `ssid`, `password` and `fast_connect`. You will see that there is also a captive_portal defined at times should the esp somehow fail to connect to the wifi at all. This captive portal and it's own wifi that it will open in such an event can be used to rescue the device without having to manually flash it again.
|
||||||
|
|
||||||
|
SSID is the wifis name, while password is, well, its password. `fast_connect` just means that the esp will NOT attempt to verify that the network exists by scanning for it. This is important if you need to connect to a hidden wifi.
|
||||||
|
|
||||||
|
## logger
|
||||||
|
We actually keep this empty. Just having it around is enough.
|
||||||
|
|
||||||
|
## api
|
||||||
|
The api just defines the encryption key for the esphome native api used by esphome and home assistant.
|
||||||
|
|
||||||
|
## ota
|
||||||
|
Ahh, the usual over the air update component.
|
||||||
|
The platform used is the normal esphome platform used by the esphome cli as well as the esphome builder in HomeAssistant from there we define a password. Just to be sure.
|
||||||
|
|
||||||
|
## status_led
|
||||||
|
The status led is specific to each esp device. but I use it usually to detect if a device is connected to the wifi or not.
|
||||||
|
|
||||||
|
# More device specific configuration
|
||||||
|
This is the section for more device specific configuration options that might be important
|
||||||
|
|
||||||
|
## 5gModemPower
|
||||||
|
This is a normal sonoff power relay. It has a pin defined for the relay. A pin defined for the actual button should you need to press it directly on the device and that's about it.
|
||||||
|
|
||||||
|
The relay that controls the power is controlled by an gpio pin (Number 12) and starts out as always on.
|
||||||
|
|
||||||
|
There is a binary sensor included for the button on the actual device. This is an inverted pullup pin on gpio 0, pressing it toggles the relay.
|
@@ -1,5 +1,6 @@
|
|||||||
substitutions:
|
substitutions:
|
||||||
garageSide: sy # sy, wo
|
garageSide: sy # sy, wo
|
||||||
|
version: "2.1.3"
|
||||||
|
|
||||||
esphome:
|
esphome:
|
||||||
name: garage${garageSide}
|
name: garage${garageSide}
|
||||||
@@ -28,7 +29,6 @@ api:
|
|||||||
wifi:
|
wifi:
|
||||||
ssid: !secret wifi_ssid
|
ssid: !secret wifi_ssid
|
||||||
password: !secret wifi_password
|
password: !secret wifi_password
|
||||||
power_save_mode: none
|
|
||||||
fast_connect: true
|
fast_connect: true
|
||||||
logger:
|
logger:
|
||||||
#level: VERY_VERBOSE
|
#level: VERY_VERBOSE
|
||||||
|
Reference in New Issue
Block a user