mirror of
https://github.com/esphome/esphome.git
synced 2026-11-18 11:06:02 +00:00
Compare commits
394
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6c28ef21d9 | ||
|
|
ab6e3d9bf0 | ||
|
|
10ef6e371b | ||
|
|
c84cd04cf7 | ||
|
|
fb6d7bf265 | ||
|
|
3ad8e35be8 | ||
|
|
11f9f20b61 | ||
|
|
b6d0961f25 | ||
|
|
6046d067aa | ||
|
|
690c5f2fb6 | ||
|
|
654954f684 | ||
|
|
e27614fda3 | ||
|
|
8426d04138 | ||
|
|
4a39ca1b71 | ||
|
|
4a218fdbd8 | ||
|
|
d8fc1cd214 | ||
|
|
1e030b7371 | ||
|
|
3b113f2c39 | ||
|
|
73468592a9 | ||
|
|
a1b456150d | ||
|
|
865a883abb | ||
|
|
357a6717c8 | ||
|
|
bcb434e05e | ||
|
|
fb65fcc5f6 | ||
|
|
b5e379a9d4 | ||
|
|
05286dfd5d | ||
|
|
36184f09aa | ||
|
|
449933891e | ||
|
|
a5bfa6dac3 | ||
|
|
5aaa5b0552 | ||
|
|
9ab090a818 | ||
|
|
84079c07e2 | ||
|
|
b7dbf17469 | ||
|
|
b91750c325 | ||
|
|
92d2a457fa | ||
|
|
a1fecebb09 | ||
|
|
32b9d4cbe7 | ||
|
|
c53401a28d | ||
|
|
6b7d17c762 | ||
|
|
93a3306d82 | ||
|
|
54d3477240 | ||
|
|
5f9d83d293 | ||
|
|
43864283b4 | ||
|
|
4efbb38b86 | ||
|
|
045374965f | ||
|
|
39a939720f | ||
|
|
a79e51e784 | ||
|
|
517f0d6d48 | ||
|
|
1327d0ddc5 | ||
|
|
2adb544e7a | ||
|
|
48905beb96 | ||
|
|
ed401814bf | ||
|
|
0245db6285 | ||
|
|
07ee0f9f04 | ||
|
|
3d34ad572b | ||
|
|
b03870b551 | ||
|
|
4a965b8b32 | ||
|
|
d826a19eb1 | ||
|
|
fb54ec51c1 | ||
|
|
04b6c0d4ca | ||
|
|
abf282dd08 | ||
|
|
e097958ad9 | ||
|
|
8a8ad4d8da | ||
|
|
09b82388c9 | ||
|
|
ea5407925a | ||
|
|
97732df3a5 | ||
|
|
04482ae0d4 | ||
|
|
ca0dd8e292 | ||
|
|
e75ac64cc9 | ||
|
|
212c0c1ea4 | ||
|
|
3e2f9bf296 | ||
|
|
b997866e86 | ||
|
|
ae89db98e4 | ||
|
|
e9bb102c1f | ||
|
|
26c4f8d40e | ||
|
|
c097fe388e | ||
|
|
21267d7421 | ||
|
|
582adc950a | ||
|
|
613319f984 | ||
|
|
4ad3cc7c0e | ||
|
|
a033260639 | ||
|
|
24f23ba3db | ||
|
|
674d593f75 | ||
|
|
c1771e002b | ||
|
|
5529e87a40 | ||
|
|
54cae78a42 | ||
|
|
e77a3bc54d | ||
|
|
af7f95a01b | ||
|
|
daf48ce4f2 | ||
|
|
3cfe8231c7 | ||
|
|
59c3dd35c0 | ||
|
|
1ff084be84 | ||
|
|
041da28d53 | ||
|
|
27a724c157 | ||
|
|
5f62432ef0 | ||
|
|
21fb3c4791 | ||
|
|
ebeb3774d3 | ||
|
|
3bb0bc104b | ||
|
|
a9e3e32382 | ||
|
|
e3816ac4bb | ||
|
|
e8415cdd87 | ||
|
|
b8e1699137 | ||
|
|
b5fbd12b00 | ||
|
|
0acba6cc48 | ||
|
|
485b7cc4a2 | ||
|
|
9a357ca9f3 | ||
|
|
b9f598ff71 | ||
|
|
183065c351 | ||
|
|
49ee4914ce | ||
|
|
d9dca1adf8 | ||
|
|
fb4c241bf4 | ||
|
|
bfb9ca984c | ||
|
|
8d6fb44dd6 | ||
|
|
ca12f6e3f3 | ||
|
|
0721604da4 | ||
|
|
849aef0c10 | ||
|
|
8ea8cacd95 | ||
|
|
5e15fef5a8 | ||
|
|
0164f1a431 | ||
|
|
8ad61941f8 | ||
|
|
bff389208f | ||
|
|
3ae0a0174b | ||
|
|
4f0b216b55 | ||
|
|
49f3133c4f | ||
|
|
6c8c105449 | ||
|
|
9a5a8f9822 | ||
|
|
9dea935499 | ||
|
|
2d73971fcc | ||
|
|
5d511a1bd1 | ||
|
|
14b190ab8f | ||
|
|
c50a5a0879 | ||
|
|
75b9f8de1c | ||
|
|
7637cdc162 | ||
|
|
891ebdaaaa | ||
|
|
a01b213ab4 | ||
|
|
a21268f641 | ||
|
|
7813ea1c7f | ||
|
|
82a375907d | ||
|
|
9591e34722 | ||
|
|
408bd8820a | ||
|
|
07a175692a | ||
|
|
94d0113f66 | ||
|
|
09d3b645a3 | ||
|
|
940f87056d | ||
|
|
6f284d171a | ||
|
|
a7a4473b32 | ||
|
|
8092a23553 | ||
|
|
1a260e4c57 | ||
|
|
8a30af4ad1 | ||
|
|
cad297866f | ||
|
|
ff254ae9d8 | ||
|
|
f5ab5febb4 | ||
|
|
3d95a0ba33 | ||
|
|
d8bfae306f | ||
|
|
78d2fdbfc0 | ||
|
|
4af8e50dca | ||
|
|
93d00b5920 | ||
|
|
3d4e20f574 | ||
|
|
be3113e7d5 | ||
|
|
e236c741db | ||
|
|
ed4db4b20e | ||
|
|
51db039f59 | ||
|
|
a24b994a5e | ||
|
|
912e9dedae | ||
|
|
47a526d35c | ||
|
|
389e782e78 | ||
|
|
9a78022ded | ||
|
|
c11c788d25 | ||
|
|
d516fd5c92 | ||
|
|
8e87cfc17e | ||
|
|
f0c4dc67e7 | ||
|
|
863cb54982 | ||
|
|
64b621f8f1 | ||
|
|
7d29bdf177 | ||
|
|
86a0cdfb7a | ||
|
|
cf5519615a | ||
|
|
741310ef30 | ||
|
|
f96c0c7d0e | ||
|
|
b18b7fe7a1 | ||
|
|
6ea4ed0868 | ||
|
|
a78a80c0d1 | ||
|
|
4206de5ed0 | ||
|
|
ae54e8b696 | ||
|
|
b252c90a5b | ||
|
|
d68674597e | ||
|
|
57a5e54118 | ||
|
|
69d96a4707 | ||
|
|
52fedcbe97 | ||
|
|
d2b635cd92 | ||
|
|
6d5305f1fe | ||
|
|
354660cafc | ||
|
|
e5f6dbe6bf | ||
|
|
ab95d504fa | ||
|
|
2c5cb6b063 | ||
|
|
23e66187a0 | ||
|
|
acaf582bf6 | ||
|
|
2019ebb49f | ||
|
|
dddacfa239 | ||
|
|
174016df57 | ||
|
|
4d50e1ba22 | ||
|
|
956a633c48 | ||
|
|
8a62328276 | ||
|
|
041979d406 | ||
|
|
956fff4b44 | ||
|
|
415eb22a2c | ||
|
|
eec1a0a690 | ||
|
|
a4ed37bd79 | ||
|
|
9317c021f5 | ||
|
|
84b4ffeddb | ||
|
|
3ac882b097 | ||
|
|
4027857ab2 | ||
|
|
c16f6d21ef | ||
|
|
730dda3d54 | ||
|
|
7ed387b660 | ||
|
|
ae0850f159 | ||
|
|
bfb4ad7b02 | ||
|
|
b76f491eef | ||
|
|
0ac52f42ad | ||
|
|
481b39787f | ||
|
|
fd0ca9316a | ||
|
|
f60abbf84f | ||
|
|
e4715443b0 | ||
|
|
5ebf08d70e | ||
|
|
3a5cbb423c | ||
|
|
87b7205397 | ||
|
|
d85b41be44 | ||
|
|
efe7a5a7de | ||
|
|
12ae7a2487 | ||
|
|
2bf52e72ec | ||
|
|
df519ca14c | ||
|
|
c22f1d64c5 | ||
|
|
f3c828b71f | ||
|
|
506cafd7ef | ||
|
|
5c780ed5f5 | ||
|
|
19ea009546 | ||
|
|
4219a48408 | ||
|
|
2cdcdd82f8 | ||
|
|
45116a8f3e | ||
|
|
3bd76e1176 | ||
|
|
dc324dd2cb | ||
|
|
e5e068ff20 | ||
|
|
0548ad7a72 | ||
|
|
27aa91bb9d | ||
|
|
7ae4ff99ce | ||
|
|
36c666c8a9 | ||
|
|
bf86c11e44 | ||
|
|
e5f2060262 | ||
|
|
107a573ffb | ||
|
|
d902d1e84f | ||
|
|
da6ab5ec1e | ||
|
|
e8fe6984b7 | ||
|
|
d4d3df819c | ||
|
|
fc921d0a96 | ||
|
|
910c42a8bc | ||
|
|
fea23e7dec | ||
|
|
76912c3a9b | ||
|
|
195749fb02 | ||
|
|
cc65a82a1e | ||
|
|
4a16cf1783 | ||
|
|
9dd043160a | ||
|
|
62264c9695 | ||
|
|
90e3f57adb | ||
|
|
c81754be78 | ||
|
|
ccf437271e | ||
|
|
63d2800aae | ||
|
|
942ca93b6d | ||
|
|
bb05854474 | ||
|
|
5f5a81434d | ||
|
|
b576063d15 | ||
|
|
c1a068220f | ||
|
|
9aceee001e | ||
|
|
176ab8433e | ||
|
|
b6460a1904 | ||
|
|
05949b7e3a | ||
|
|
1f70f86b47 | ||
|
|
c50d09ee1d | ||
|
|
e87e7abbcd | ||
|
|
f60408208e | ||
|
|
1d94b351ff | ||
|
|
563ba82a95 | ||
|
|
7995cecca9 | ||
|
|
d47582b0c9 | ||
|
|
3a0520245d | ||
|
|
ea40fba54e | ||
|
|
2563605fe7 | ||
|
|
96dc1fbaf3 | ||
|
|
7ee82fbc90 | ||
|
|
c82e275eee | ||
|
|
f999c4ed1b | ||
|
|
867b51941c | ||
|
|
1297771d5b | ||
|
|
fe0e67bdd7 | ||
|
|
0af702a0af | ||
|
|
09d8477557 | ||
|
|
bb458503c9 | ||
|
|
c01bc17bc8 | ||
|
|
135943911b | ||
|
|
3870ca0031 | ||
|
|
e5871655b2 | ||
|
|
a5b6c69201 | ||
|
|
c08aff9300 | ||
|
|
f6fc942c4c | ||
|
|
7d750279ef | ||
|
|
2b0bcf646e | ||
|
|
2913537baf | ||
|
|
ba25efc791 | ||
|
|
0f1192feb2 | ||
|
|
02c4512749 | ||
|
|
ad7d246a45 | ||
|
|
89360efb38 | ||
|
|
c2a2ddb490 | ||
|
|
471b67079f | ||
|
|
844dd58b03 | ||
|
|
8b35e2ad16 | ||
|
|
918488c8d6 | ||
|
|
ae85d85bc4 | ||
|
|
96836eab3d | ||
|
|
02e4d6d8b1 | ||
|
|
4b79dc5c99 | ||
|
|
67456e9dd6 | ||
|
|
7ac9a86861 | ||
|
|
2589cc6aea | ||
|
|
801e36f666 | ||
|
|
8a4d76be32 | ||
|
|
5f916e3d49 | ||
|
|
81b8e36e96 | ||
|
|
6e5d9c1ad7 | ||
|
|
7d2a039696 | ||
|
|
c79e0b8f95 | ||
|
|
e3888e2fa1 | ||
|
|
f35a0c4fef | ||
|
|
bf8ae4e306 | ||
|
|
07a3f39760 | ||
|
|
9b2fcced64 | ||
|
|
a897f55e36 | ||
|
|
2f84fd81a0 | ||
|
|
044fd267b6 | ||
|
|
a178954b11 | ||
|
|
00c15ddda2 | ||
|
|
b4048bfb6f | ||
|
|
848231f59e | ||
|
|
5d2961e96b | ||
|
|
08e41587ae | ||
|
|
129b3f248a | ||
|
|
1a325304ed | ||
|
|
957fe02ebc | ||
|
|
96d6627daf | ||
|
|
349945225c | ||
|
|
be857de642 | ||
|
|
ee9ea7e62f | ||
|
|
b155e4ba0b | ||
|
|
68b01ba754 | ||
|
|
95973f0d38 | ||
|
|
2d41bd5cea | ||
|
|
5d2772c216 | ||
|
|
2ce14405ec | ||
|
|
8fd654e295 | ||
|
|
fa28726789 | ||
|
|
8401d59ca1 | ||
|
|
f838978a70 | ||
|
|
f5a97e61bf | ||
|
|
d8eec3c460 | ||
|
|
dedccca940 | ||
|
|
7cde8beb0d | ||
|
|
b59018147e | ||
|
|
807dfa3abb | ||
|
|
9aa035a01e | ||
|
|
f3cb6039f2 | ||
|
|
d7e6051489 | ||
|
|
ce7b2506bb | ||
|
|
585cc99331 | ||
|
|
4cfa8780ee | ||
|
|
a0e317d9f9 | ||
|
|
a8aa4e6497 | ||
|
|
4e725ea6d3 | ||
|
|
5071968eb9 | ||
|
|
e6bebc298f | ||
|
|
8831c0dc0d | ||
|
|
9166980740 | ||
|
|
7e575ef16d | ||
|
|
6d9f4421a8 | ||
|
|
8854e1eb94 | ||
|
|
d597be77ac | ||
|
|
f56a4db60f | ||
|
|
362e73313c | ||
|
|
6e92bb301d | ||
|
|
644bd8995a | ||
|
|
3caff2b80b | ||
|
|
4814377805 | ||
|
|
d0bafef28c | ||
|
|
e8cf0cfd06 | ||
|
|
88f6135171 | ||
|
|
055faab7e3 | ||
|
|
f74d8b3ca2 |
No files matched your search
@@ -70,6 +70,21 @@ await automation.build_callback_automation(
|
||||
`build_parent_callback_automation`, `build_trigger_callback`, `build_callback_automations` and
|
||||
`build_trigger_automations` cover the other shapes; see their docstrings in `esphome/automation.py`.
|
||||
|
||||
When every action in a callback automation is inline (see Actions below), no `Automation` or action objects
|
||||
are generated: the callback calls one generated function, at the same RAM cost as a hand-written lambda. A
|
||||
custom forwarder blocks this unless its filter is also given as `params`, `forward` and `when`, so always pass
|
||||
them together:
|
||||
```python
|
||||
automation.CallbackAutomation(
|
||||
CONF_ON_IDLE,
|
||||
"add_on_state_callback",
|
||||
forwarder=StateEnterForwarder.template(State.IDLE),
|
||||
params=[(State, "state")],
|
||||
forward=[],
|
||||
when=f"state == {State.IDLE}",
|
||||
)
|
||||
```
|
||||
|
||||
**C++: no trigger class needed.** The callback registration method must be templatized to accept both
|
||||
`std::function` and lightweight forwarder structs (which avoid heap allocation):
|
||||
```cpp
|
||||
@@ -101,6 +116,8 @@ void add_on_state_callback(std::function<void(bool)> &&callback) {
|
||||
|------|----------------------|-------------|
|
||||
| `CallbackManager<void(Ts...)>` | 12 bytes (empty `std::vector`) | Callbacks are always or almost always registered |
|
||||
| `LazyCallbackManager<void(Ts...)>` | 4 bytes (`nullptr`) | Callbacks are often not registered (common case) |
|
||||
| `AutomationList<N, Ts...>` + `build_automation_lists` | 4 bytes per automation + count, none when unused | A hub fires its own `on_*` automations with no filter (4 B per automation vs 8 B per `Callback`) |
|
||||
| `automation.new_automation(args, conf)` + the parent's own fixed table | the table entry (pointer plus its own data) | Like `AutomationList`, but each automation needs a stored value of its own, e.g. a threshold the parent compares against |
|
||||
|
||||
Both live in `esphome/core/helpers.h` and accept `std::function`, lambdas and forwarder structs through
|
||||
their templatized `add()` method. `LazyCallbackManager` is a drop-in replacement for `CallbackManager` that defers allocation until the first
|
||||
@@ -187,6 +204,15 @@ payload passes `automation.ApplyBytes(CONF_DATA, "send({})")` in the same call;
|
||||
flash and a lambda's vector is forwarded as data and size. `TEMPLATABLE_VALUE` with `cg.templatable` stays
|
||||
for actions whose `play()` has real logic beyond forwarding values.
|
||||
|
||||
Adjacent `register_apply_action` and `lambda:` actions in a list merge into one generated function and one
|
||||
object, which saves 12 to 16 bytes of RAM per merged action. An action with its own C++ class ends the merged
|
||||
run, so prefer `register_apply_action` wherever the action allows it. Because of this, `build_action_list` can
|
||||
return fewer objects than the config has entries. A builder that wraps `apply_action_builder` may do other work
|
||||
first, but must return its result unchanged and not use it. A builder that must generate its own statements, and
|
||||
is registered with `automation.ApplyAction`, can call `apply_statements_action` and still merge; `script.execute`
|
||||
is an example. `if`, `choose`, `while` and `repeat` whose bodies are all inline become C++ control flow in the
|
||||
same function, and `register_apply_condition` and `lambda:` conditions become plain expressions there.
|
||||
|
||||
## Conditions
|
||||
|
||||
```cpp
|
||||
|
||||
@@ -69,6 +69,27 @@ performance nit, because it fragments a small shared heap. Flag:
|
||||
typed as `std::function`, so lightweight forwarders avoid a heap allocation.
|
||||
- Two-space indent, `using` over `typedef`, wrap at 120 columns.
|
||||
|
||||
## Use the existing helper
|
||||
|
||||
New components often hand-write code a helper already covers. Ask for the
|
||||
helper; `AGENTS.md` section 4 and the `component-codegen` skill have the detail.
|
||||
|
||||
| Seen in the PR | Ask for |
|
||||
| --- | --- |
|
||||
| `if (this->x_sensor_ != nullptr) this->x_sensor_->publish_state(v);` | `PUBLISH_STATE(this->x_sensor_, v);` (`esphome/core/entity_base.h`) |
|
||||
| set warning / `return` / clear warning around a bus result | `if (!this->status_comm_result(ok)) return;` |
|
||||
| hand-written `set_x_sensor()` plus `x_sensor_` member | `SUB_SENSOR(x)`, `SUB_BINARY_SENSOR`, `SUB_TEXT_SENSOR`, `SUB_SWITCH`, ... |
|
||||
| `if CONF_X in config: s = await sensor.new_sensor(config[CONF_X])` plus setter | `sensors = sensor.sub_sensors(config)` then `await sensors(CONF_X, hub.set_x_sensor)` |
|
||||
| hand-written `{"a": MyEnum.MY_ENUM_A, ...}` dict | `MyEnum.options("a", "b", prefix="MY_ENUM_")` |
|
||||
| loops on `available()` / `read_byte()` | UART `read_available(on_byte)`, `discard_available()`, `LineReader<N>`, `FrameReader<N, HEADER...>` |
|
||||
| hand-rolled CRC, checksum or bit loop | `crc8`, `crc16`, `xor_bytes`, `sum16_bytes`, `encode_uint16`, ... (`esphome/core/helpers.h`) |
|
||||
| integer split into buffer bytes by hand (`buf[0] = v >> 8; buf[1] = v;`) | `put_be16`/`24`/`32`, `put_le16`, `put_le32` (`esphome/core/helpers.h`) |
|
||||
| bare `mark_failed()`, or `ESP_LOGE` then `mark_failed()` | `this->mark_failed(LOG_STR("reason"))` or `LOG_STR(ESP_LOG_MSG_COMM_FAIL)` |
|
||||
| button/switch/number/select C++ class that only calls the hub | `ApplyButton`, `ApplySwitch`, `ApplyNumber`, `ApplySelect` with `apply=` |
|
||||
| action or condition class that only forwards to the parent | `register_apply_action` / `register_apply_condition` |
|
||||
| enum-to-string `switch` returning literals | `PROGMEM_STRING_TABLE` with `get_log_str` / `get_progmem_str` |
|
||||
| `if (x := config.get(CONF_X)) is not None: cg.add(var.set_x(x))` | `cg.add_optional(var.set_x, config.get(CONF_X))`, when the setter takes the value unchanged |
|
||||
|
||||
## Python conventions
|
||||
|
||||
- Type-annotate every new function signature (params and return), new dataclass
|
||||
|
||||
@@ -201,6 +201,9 @@ virtual listener base (a second vptr per entity).
|
||||
- `uart.new_uart_component(config, *ctor_args)` (and `i2c.new_i2c_component`, `spi.new_spi_component`,
|
||||
`modbus.new_modbus_client_component`, `ble_client.new_ble_node_component`) constructs, registers and
|
||||
attaches in one call.
|
||||
- A fixed buffer sized from the config is a file-scope static (BSS, not heap):
|
||||
`buf = cg.static_buffer(config[CONF_ID], cg.uint8, size)`, named after its owner so `esphome analyze-memory`
|
||||
counts it there; pass `buf` to the constructor.
|
||||
- `display.add_writer(var, config)` sets the lambda.
|
||||
- `MyEnum.options("on", prefix="MY_ENUM_")` builds an enum dict.
|
||||
- `button.restart_button_schema(cls)` (and `factory_reset_`, `query_`) are button presets.
|
||||
|
||||
@@ -42,6 +42,8 @@ APIs.
|
||||
// Or if size is constant:
|
||||
std::array<uint8_t, 256> buffer;
|
||||
```
|
||||
When the size comes from the config, declare it with `cg.static_buffer()` in `to_code` and pass the pointer
|
||||
to the constructor, so it lands in BSS (see the `component-codegen` skill).
|
||||
|
||||
2. **Compile-time-known fixed sizes with vector-like API:** use `StaticVector` from
|
||||
`esphome/core/helpers.h` for compile-time fixed size with a `push_back()` interface (no dynamic
|
||||
|
||||
@@ -88,6 +88,7 @@ driven, what the logs show, and the same flow on a `dev` build when a quirk coul
|
||||
| ESP32-S3, C3, C6, H2 native USB | `esphome upload --device /dev/cu.usbmodem*` | `logger: hardware_uart: USB_SERIAL_JTAG`. The USB console can wedge when the app takes over the console (0 bytes, esptool `No serial data received`); replug, or watch through `esphome logs --device <name>.local` |
|
||||
| Pico W / Pico 2 W | `esphome upload --device <port>` (1200 baud touch); first flash ever via BOOTSEL and `--device /Volumes/RPI-RP2` or `RP2350` | port re-enumerates after upload: `ports.py --wait 2e8a` then capture |
|
||||
| BW15 kit (RTL8720CF, rtl87xx) | `~/.platformio/penv/.libretiny/bin/python $SKILL/scripts/flash_rtl87xx_kit.py flash write -d <port> <build>/.pioenvs/<name>/*.uf2`. Plain `esphome upload` and plain ltchiptool time out because opening the port asserts DTR/RTS and holds the chip in reset | `serial_capture.py --released`, never `esphome logs` |
|
||||
| BW12 and other AmebaZ modules (RTL8710BX, rtl87xx) on a plain USB-UART | `~/.platformio/penv/.libretiny/bin/python -m ltchiptool flash write -B 115200 -b 115200 -t 120 -d <port> <uf2>`, started first, then strap by hand: CEN to GND, TX2 to GND, release CEN, release TX2. Without `-B 115200` the system data read at 1.5 Mbaud fails on CH340s (`Data read error at 0x9000`) and nothing is written. A 1 MB image takes about 80 s. A development board with DTR and RTS wired to CEN and the download pin needs no strap | `serial_capture.py`; a reset pulse does not reach CEN on a plain adapter, so a capture starts mid-run |
|
||||
| BK7238 / CB3S (bk72xx, RTS on CEN) | `~/.platformio/penv/.libretiny/bin/python $SKILL/scripts/flash_bk72xx.py flash write -d <port> <uf2>` (about 75 s) | logs are on UART2 by default; `logger: hardware_uart: UART1` puts them on the flashing adapter. `serial_capture.py --reset` gives a chip-enable reset; a plain open may or may not reset it, check for the bootloader banner |
|
||||
| LN882H | ltchiptool forces 1 Mbaud for writes; weak adapters need `LN882H_YM_BAUDRATE` patched to 115200 in the penv's `ln882htool.py`; short BOOT to GND while the tool connects | OTA after the first flash |
|
||||
| nRF52840 Dongle (PCA10059) | Nordic `nrfutil nrf5sdk-tools dfu usb-serial` on the bootloader port, or `dfu: true` in the config so the 1200 baud touch pin-resets into the bootloader; adafruit-nrfutil is refused | app has two CDC ports, ESPHome log on the second |
|
||||
@@ -122,8 +123,8 @@ Per-topic scripts, each described in the matching `reference/recipes/<component>
|
||||
(server with prefixed misbehaviour cases, PNG, JPEG, BMP and QOI generators, API drivers, first pass timer), `zwave_proxy/` (checksum verifier, device info), `usb_cdc_acm/`
|
||||
(host driver, Zephyr driver probe), `rtsp_server/` (protocol client, raw rate reader, measurement set,
|
||||
API image grab), `cse7766/` (API observer with ping), `zephyr_coredump/` (reader flow, decode with the
|
||||
Zephyr tools), `libretiny_prefs/` (rtc preference harness header), `libretiny_crash/` (BK72xx crash probe header and
|
||||
capture decoder), `api_outgoing/` (wake cycle and Wi-Fi drop timing readers), `ld2450/` (zone number driver, loopback harness driver with number and binary sensor states and TX frame summarizer), `api/` (raw plaintext native API client for user defined actions, store_yaml recovery client over Noise or plaintext), `http_request/` (update manifest server, update state driver, request test server, action case driver, concurrency, reboot, update check and OTA drivers, `ota_auth/` OTA request cases with basic auth), `modem/` (button and sensor driver over the plaintext API, also used for the BLE MIDI boards), `dfrobot_sen0395/` (API driver and case runner), `homeassistant_light/` (direct bulb driver, held-report case driver), `usb_audio/` (URL player), `speaker_media_player/` (API player driver, pipeline task case runner), `web_server/` (SSE client, request mix, SSE and HTTPD case runners), `mqtt/` (broker config with TLS, client-certificate and WebSocket listeners, test CA with server and client certificates, transport case runner, flash-and-drive runner, CLI TLS check without a board, MAC suffix runner with per-variant configs for two boards, `shutdown/` shutdown message runner and matcher), `udp/` (datagram recorder, `udp.write` payload checker and case driver), `entity_icons/` (icon and device class readback over the API, MQTT discovery, web_server and dump_config, with a comparer), `uart_sim/` (API driver and flash, capture and drive runner for the simulated UART sensors), `remote_base/` (loopback runner and API log decoder per sent frame), `xiaomi_ble/` (frame and header generator with the expected counts, injecting, advertising and receiving configs, counter and runner), `ble_terminate/` (proxy and peer configs, connect and disconnect driver, peer disconnect matcher, runner), `i2c_slave/` (D1 mini slave and BK7238 master configs), `wpa3_ap/` (PMF AP with join and leave logging, BK7238 and CB3S DUTs, runner and summary), `wisp_ap/` (WISP upstream with AP buttons, WISP and ALWAYS_ON DUTs, client, runner and per phase summary), `wifi_restart/` (WPA3 mixed WISP upstream, static IP DUTs with syslog, runner and summary), `ota_timing/` (OTA upload timer with deflate, raw and TCP modes, API build check, A/B runner and median summary, `inflate_bench/` on-device inflate benchmark with stream generator, configs and syslog runner).
|
||||
Zephyr tools), `libretiny_prefs/` (rtc preference harness header), `libretiny_crash/` (BK72xx crash probe header,
|
||||
capture decoder, RTL8720C ROM dump versus report matcher), `api_outgoing/` (wake cycle and Wi-Fi drop timing readers), `ld2450/` (zone number driver, loopback harness driver with number and binary sensor states and TX frame summarizer, frame stream harness with presence hold and link loss drivers, BT MAC driver), `api/` (raw plaintext native API client for user defined actions, store_yaml recovery client over Noise or plaintext), `http_request/` (update manifest server, update state driver, request test server, action case driver, concurrency, reboot, update check and OTA drivers, `ota_auth/` OTA request cases with basic auth), `modem/` (button and sensor driver over the plaintext API, also used for the BLE MIDI boards), `dfrobot_sen0395/` (API driver and case runner), `homeassistant_light/` (direct bulb driver, held-report case driver), `usb_audio/` (URL player), `speaker_media_player/` (API player driver, pipeline task case runner), `web_server/` (SSE client, request mix, SSE and HTTPD case runners), `mqtt/` (broker config with TLS, client-certificate and WebSocket listeners, test CA with server and client certificates, transport case runner, flash-and-drive runner, CLI TLS check without a board, MAC suffix runner with per-variant configs for two boards, `shutdown/` shutdown message runner and matcher), `udp/` (datagram recorder, `udp.write` payload checker and case driver), `entity_icons/` (icon and device class readback over the API, MQTT discovery, web_server and dump_config, with a comparer), `uart_sim/` (API driver and flash, capture and drive runner for the simulated UART sensors), `remote_base/` (loopback runner and API log decoder per sent frame), `xiaomi_ble/` (frame and header generator with the expected counts, injecting, advertising and receiving configs, counter and runner), `ble_terminate/` (proxy and peer configs, connect and disconnect driver, peer disconnect matcher, runner), `i2c_slave/` (D1 mini slave and BK7238 master configs), `wpa3_ap/` (PMF AP with join and leave logging, BK7238 and CB3S DUTs, runner and summary), `wisp_ap/` (WISP upstream with AP buttons, WISP and ALWAYS_ON DUTs, client, runner and per phase summary), `wifi_restart/` (WPA3 mixed WISP upstream, static IP DUTs with syslog, runner and summary), `ota_timing/` (OTA upload timer with deflate, raw and TCP modes, API build check, A/B runner and median summary, `inflate_bench/` on-device inflate benchmark with stream generator, configs and syslog runner), `gpio_hold/` (ISR pin hold self test with ESP32 and S3 configs), `ble_event_inject/` (GAP and GATTC event injector header and proxy package), `light_sleep_wake/` (LEDC wave and edge timer for light sleep wakeup on a C3), `manual_ip/` (station and AP manual IP configs, DNS probe and runners), `web_handlers/` (late handler, web_server, captive_portal and prometheus variants, web OTA runner), `bk72xx_flash/` (flash readback with retries, per partition diff of two dumps), `ble_server_security/` (secure GATT server and pairing client configs, driver, summary and runner), `prometheus/` (datetime metrics configs and driver), `zephyr_ble_server/` (nRF52 server, looping ESP32 client and UF2 flash and count runner).
|
||||
|
||||
## Templates in `$SKILL/templates`
|
||||
|
||||
@@ -174,6 +175,10 @@ comment quotes the exact commits. Fetch `origin dev` before computing a merge ba
|
||||
- The merge base comes from a freshly fetched `origin/dev`; a stale local `dev` puts dependency bumps into the
|
||||
PR diff and builds the control from the wrong commit.
|
||||
- A `.local` name can stop resolving in the middle of a run; keep the address from the boot log and drive by it.
|
||||
- Never point `framework: source:` at a local `file://` copy of LibreTiny to try a patch: PlatformIO installs it over
|
||||
the shared `~/.platformio/platforms/libretiny`, so every later build on the machine uses the patched copy. Patch
|
||||
through the ESPHome side (a linker `-Wl,-wrap,<symbol>` or a define) instead, and if it happened, restore the
|
||||
directory from a clean copy of the same release.
|
||||
- `wc -l` pads its count on macOS, so `tail -n +$n0` needs `$((n0+0))` or an arithmetic expansion.
|
||||
- `api:` reboots a board after 15 min without a client: `reboot_timeout: 0s` on `api:` and `mqtt:` for
|
||||
soak tests.
|
||||
|
||||
@@ -88,6 +88,12 @@ Ports are not listed on purpose: they follow the USB hub port and change on ever
|
||||
- The AmebaZ2 SDK sets `LWIP_TCPIP_CORE_LOCKING 0`.
|
||||
- The `rtw_is_adapter_up` bus fault after `Disabling AP` happens on LibreTiny 1.13.0 and 1.14.0 alike
|
||||
(2 of 4 and 3 of 3 runs in #21531); run at least four rounds per build before blaming a PR for it.
|
||||
- On a fault the ROM handler (ram_vector_table entries 3 to 7) prints a dump of about 4 KB in 0.4 s and
|
||||
then spins; only the watchdog resets the chip (10 s after `arch_init`, 1 s once the ESPHome crash
|
||||
handler re-arms it). `.ram.bss.noinit*` (`.system_restore_data`) survives that reset. The core has no
|
||||
FPU. For a crash that fires once, guard an `interval` lambda with
|
||||
`!libretiny::crash_handler_has_data()`. For a handler mode (MSP) fault, point vector 16+11 (SDIOD,
|
||||
unused) at a trapping function and set bit 11 in NVIC ISER and ISPR (0xE000E100, 0xE000E200).
|
||||
|
||||
## BK7238, WB3S, CB3S (BK7231N) (LibreTiny bk72xx, CH340, RTS on CEN)
|
||||
|
||||
@@ -133,6 +139,46 @@ Ports are not listed on purpose: they follow the USB hub port and change on ever
|
||||
- Callbacks run on the `async_tcp` task and log lines can lose a byte. Wi-Fi connect takes tens of ms;
|
||||
radio enable 160 to 278 ms, disable about 200 ms.
|
||||
|
||||
## BW12 and other AmebaZ boards (RTL8710BX, LibreTiny rtl87xx)
|
||||
|
||||
- On a bare module wired to a plain USB-UART (the bench's BW12), download mode is a hand strap: CEN to
|
||||
GND, TX2 to GND, release CEN, release TX2. Such an adapter does not drive CEN, so neither ltchiptool nor
|
||||
`serial_capture.py --reset` can reset the chip. A development board that wires DTR and RTS to CEN and the
|
||||
download pin enters download mode from the tools, like the BW15 kit; the notes below on baud rates still apply.
|
||||
- ltchiptool links at 1.5 Mbaud and reads the system data at 0x9000 at that rate before it writes at
|
||||
115200. A CH340 drops bytes there (`Data read error at 0x9000`, `Timed out waiting for Quiet-Handshake`)
|
||||
and the run gives up without writing. `-B 115200 -b 115200` moves the link to 115200 first and works.
|
||||
Start the command with `-t 120` so it is already polling while the board is strapped.
|
||||
- After a failed run the ROM may sit at another baud rate and no longer link; strap again.
|
||||
- The device builder frontend's AmebaZ flasher follows ltchiptool (link and system read at 1.5 Mbaud),
|
||||
so it can hit the same read failure on the same adapters.
|
||||
- Power the module from the adapter's 5 V pin into its own regulator; the adapter's 3.3 V pin cannot
|
||||
carry the Wi-Fi transmit peaks.
|
||||
- Capture with `serial_capture.py --released`. With DTR and RTS asserted on the open port, a software
|
||||
reboot (`App.safe_reboot()`, the restart button) lands in the ROM downloader (`UARTIMG_Download 2`)
|
||||
and stays there until CEN is pulsed. After a flash the chip also waits in the ROM until CEN is pulsed.
|
||||
- A full flash takes 50 to 220 s at 115200. While the board is on Wi-Fi, OTA (port 8892) saves the strap,
|
||||
but the board's Wi-Fi latency (one to two seconds a ping) can make the upload time out.
|
||||
- `sdk_silent: none` under `framework:` keeps the Wi-Fi driver's join log (`start auth to`, `auth success,
|
||||
start assoc`, `association success`, `sta recv deauth reason code(N)`); LibreTiny mutes it during the
|
||||
connect otherwise. `wifi_get_last_error()` after a failed `WiFi.begin()` gives the SDK's reason
|
||||
(1 no network, 2 connect failed, 3 handshake failed, 6 auth failed); LibreTiny only logs `ret=-1`.
|
||||
- Some modules ship with no RF calibration in efuse, only the chip ID and MAC. Dump the logical map with
|
||||
the ROM's `EFUSE_LogicalMap_Read(buf)` (512 bytes): TX power indexes are at 0x10 to 0x1A, crystal trim
|
||||
at 0xC9, MAC at 0x11A; 0xFF means the driver uses its default (trim 0x20). Linking with
|
||||
`-Wl,-wrap,EFUSE_LogicalMap_Read_ACUT` lets a wrapper rewrite blank bytes before the driver parses
|
||||
the map on each radio start. See `recipes/libretiny.md` for the per-boot trial harness used to A/B them.
|
||||
- Scan results report WPA2-AES access points as `WPA PSK`: LibreTiny truncates `rtw_security_t` to
|
||||
`uint8_t` before mapping it. Cosmetic. Open networks come out as `WIFI_AUTH_INVALID` (255) on both
|
||||
AmebaZ and AmebaZ2, so `auth != WIFI_AUTH_OPEN` marks them encrypted.
|
||||
- After a BSSID plus channel join, LibreTiny's `set_pscan_channel(ch, false)` leaves the driver with no
|
||||
channel to scan, so the next SSID only join fails at once (no `start auth`). Calling
|
||||
`wifi_set_pscan_chan` with channels 1 to 13 and `PSCAN_ENABLE` each before such a join fixes it and
|
||||
keeps the BSSID fast path (BW15 BSSID join median 3.05 s with it, 4.68 s when joining with channel 0).
|
||||
- A 4-way handshake that never finishes after association is reported as `RTW_WRONG_PASSWORD` on AmebaZ
|
||||
even with the right password; AmebaZ2 reports a real wrong password as a 4-way handshake timeout.
|
||||
- The driver also posts a SCAN_DONE (number 0) inside every join, on AmebaZ2 too.
|
||||
|
||||
## BW16 kit (RTL8720DN, AmebaD)
|
||||
|
||||
- The kit's own USB-C (CH340) is on LOG_UART and flashes fine. Its two-transistor circuit resets while
|
||||
|
||||
@@ -11,15 +11,15 @@ One file per component, named after it:
|
||||
- [`espnow.md`](espnow.md): ESP8266 broadcast receive
|
||||
- [`hdmi_cec.md`](hdmi_cec.md): two-board wire
|
||||
- [`http_request.md`](http_request.md): update manifest URL changed at run time, every setter shape, a swap under a running check, non-blocking request actions with loop gap, queue, cancel and reboot checks, OTA request cases with basic auth and MD5 sources
|
||||
- [`ld2450.md`](ld2450.md): polygon zones, zone number round trip through the radar's readback, ESP8266 loopback harness without a radar
|
||||
- [`ld2450.md`](ld2450.md): polygon zones, zone number round trip through the radar's readback, ESP8266 loopback harness without a radar, presence hold and link loss on a frame stream, BT MAC readback
|
||||
- [`ld2412.md`](ld2412.md): output pin level through the basic configuration command, held back writes
|
||||
- [`libretiny.md`](libretiny.md): rtc preference emulation, BK72xx and RTL8720C crash report on the next boot
|
||||
- [`libretiny.md`](libretiny.md): rtc preference emulation, BK72xx and RTL8720C crash report on the next boot with a ROM dump matcher, BK7238 BLE bond store safety with a full flash backup and per partition diff, BK7238 OTA versus the board layout and bootloader
|
||||
- [`modem.md`](modem.md): PPPoS modem component boot check with no modem attached, loop blocking and disable timing
|
||||
- [`mqtt.md`](mqtt.md): broker bench, QoS, reconnect, crash log over MQTT, WebSocket transports with a local and a public broker, TLS trust sources (own CA, client certificate, certificate bundle, no verification) with the CLI check, MAC suffix topics and will messages on two boards, shutdown message delivery on restart, disable and deep sleep
|
||||
- [`nrf52.md`](nrf52.md): dongle board support
|
||||
- [`nrf52.md`](nrf52.md): dongle board support, zephyr_ble_server connection slot under reordered callbacks
|
||||
- [`online_image.md`](online_image.md): stalled and malformed downloads, PNG, JPEG, BMP and QOI decode time per loop pass with large images and small buffers
|
||||
- [`openthread.md`](openthread.md): border router on the S3 host plus H2 RCP
|
||||
- [`ota.md`](ota.md): overlap and lock, timeouts, deflate, upload timing A/B per build and board with deflate and raw, on-device inflate benchmark
|
||||
- [`ota.md`](ota.md): upload without a configuration and the refusal checks, overlap and lock, timeouts, deflate, upload timing A/B per build and board with deflate and raw, on-device inflate benchmark
|
||||
- [`rtsp_server.md`](rtsp_server.md): camera streaming on the Waveshare ESP32-S3-ETH
|
||||
- [`scheduler.md`](scheduler.md): loop wake A/B
|
||||
- [`udp.md`](udp.md): datagrams, multicast, sockets, `udp.write` payload shapes
|
||||
@@ -41,3 +41,9 @@ One file per component, named after it:
|
||||
- [`xiaomi_ble.md`](xiaomi_ble.md): Xiaomi, ATC and PVVX parsing by injecting scan results into the ESP32 tracker or advertising them from a second ESP32, real AES-CCM frames, duplicate filter model
|
||||
- [`ble_terminate.md`](ble_terminate.md): proxy disconnect against a peer with peripheral latency
|
||||
- [`i2c_slave.md`](i2c_slave.md): fake I2C slave on a D1 mini, ESP32 hardware master as the control
|
||||
- [`gpio_hold.md`](gpio_hold.md): GPIO hold through the ISR pin API, pad read back with no wiring, per chip pin notes
|
||||
- [`ble_event_inject.md`](ble_event_inject.md): made up GAP and GATTC events fed into the ESP32 BLE handlers from a button
|
||||
- [`light_sleep_gpio_wake.md`](light_sleep_gpio_wake.md): GPIO wakeup from auto light sleep with an LEDC wave that keeps running in sleep
|
||||
- [`manual_ip_and_web_handlers.md`](manual_ip_and_web_handlers.md): station, AP and Ethernet manual IP, web handlers added late and web OTA with web_server, captive_portal or prometheus
|
||||
- [`ble_server_security.md`](ble_server_security.md): esp32_ble_server pairing, encrypted and MITM characteristics, subscription before and after pairing, bond reuse per ESP-IDF version
|
||||
- [`prometheus.md`](prometheus.md): date, time and datetime metrics in UTC and another time zone
|
||||
@@ -0,0 +1,20 @@
|
||||
# Injecting BLE GAP and GATTC events (#21698)
|
||||
|
||||
Some BLE paths (repeated connection parameter update failures, a disconnect in the middle of them) are hard to get
|
||||
from a real peer on demand. `scripts/ble_event_inject` feeds made up events straight into the ESP32 BLE handlers.
|
||||
|
||||
- `ESP32BLE::gap_event_handler` and `gattc_event_handler` are protected statics and the class is `final`.
|
||||
`cp_inject.hpp` reaches them through explicit template instantiation, where access checks do not apply. Its
|
||||
`cpinject::run()` sends six labelled steps (`STEP1` to `STEP6`): four peers failing five times each, a success
|
||||
followed by more failures, and disconnects between failures.
|
||||
- `cp-inject.yaml` is a package for a copy of a proxy config: it adds the include, a VERBOSE logger with the busy
|
||||
tags back at DEBUG, and an `Inject conn param events` button. Press it with `scripts/api_button.py` while a
|
||||
log capture (`esphome logs ... --device <ip>` under `timeout`) runs, then count the warning and verbose lines per
|
||||
step on the PR and on dev.
|
||||
- The handlers push into a queue and event pool that take a single writer, normally the Bluetooth task. Injecting
|
||||
from the main task while real events arrive can corrupt them, so the button stops the scan, waits for it to end,
|
||||
injects and starts it again. Run it with no active proxy connections (no Home Assistant BLE client holding one).
|
||||
- Fake disconnects use `gattc_if` 0xFE: every client and proxy connection filters on its own `gattc_if_`, so the
|
||||
queued event reaches only the shared handler. Do not use 0xFF (`ESP_GATT_IF_NONE`), which every client accepts.
|
||||
- The fake peers (`C0:FF:EE:00:00:0n`) are never connected, so a live proxy keeps serving its real connections;
|
||||
put it back on its own config afterwards.
|
||||
@@ -0,0 +1,26 @@
|
||||
# esp32_ble_server pairing and encrypted characteristics (#17562)
|
||||
|
||||
`scripts/ble_server_security`: a classic ESP32 devkit runs the secure GATT server (`server.yaml`) and a second ESP32
|
||||
(an S3 here) runs `ble_client` as the central (`client.yaml`). The server has a `read_encrypt` battery level
|
||||
(`99.9`), a plain characteristic, a `write_encrypt` characteristic that logs what it receives, a `read_encrypt_mitm`
|
||||
characteristic and a `read_encrypt` characteristic that notifies every 2 s. `run.sh TAG IO AUTH` builds both with the
|
||||
pairing mode as substitutions, pairs once, reconnects twice, and `summary.py` prints PASS or FAIL. The server needs
|
||||
`esp32_ble_server` security from #17562 or later: point `SERVER_TREE` at that checkout (the client builds from
|
||||
`TREE`, dev is fine). `summary.py` needs each refused read to show an `Error reading char` reply, so a run where the
|
||||
client never connected fails instead of passing.
|
||||
|
||||
- `ble_client` never starts pairing on its own (a phone does, after an `insufficient authentication` reply); the
|
||||
client's `Pair` button calls `BLEClientBase::pair()`. Read errors show as `Error reading char at handle N, status=5`
|
||||
(not authenticated: no bond) or `status=15` (not encrypted: bond known, link not encrypted yet).
|
||||
- The `ble_client` text sensor subscribes once, at connect, before any pairing, so a protected characteristic refuses
|
||||
it. The `Subscribe` button writes the CCCD again after pairing; `ble_client` drops its service list after discovery,
|
||||
so it writes the characteristic handle + 1 (where ESP-IDF's GATT server puts the CCCD).
|
||||
- Numeric comparison (`display_yes_no` with `sc_mitm_bond`) tells a fresh pairing from a bond reuse: the
|
||||
`numeric comparison` line only appears on a fresh pairing. Just Works cannot show it.
|
||||
- ESP-IDF 5.5.6 drops the bond on the second disconnect on both roles (`Deleting unpaired device`), so that reconnect
|
||||
pairs from scratch; 5.5.5 keeps it (`-s idf 5.5.5`).
|
||||
- The server keeps its bonds in NVS. One holding an authenticated bond for the client refuses a Just Works re-pairing
|
||||
silently; erase the devkit's flash before switching from nc to jw.
|
||||
- `summary.py` failed both modes at 58636914ab: `read_encrypt_mitm` was readable with no pairing, because
|
||||
`BLEService::create_characteristic()` took an 8 bit `esp_gatt_char_prop_t` and dropped the MITM bits (1 << 8 and
|
||||
1 << 9). Check the generated `create_characteristic` call and the property type when a flag above bit 7 is added.
|
||||
@@ -15,3 +15,13 @@ API reply and says nothing. On dev the S3 lost 6 of 12; the PR lost 0 of 16.
|
||||
and `an.py`, which prints PASS only when every round completed, every peer disconnect came within 3 s and the last
|
||||
parameter update the proxy logged before each disconnect had latency=10 (a round without it did not test peripheral
|
||||
latency and counts as inconclusive).
|
||||
|
||||
Controller build check: ESP-IDF 5.5.6 ships `libbtdm_app.a` byte for byte the same as 5.5.5 for esp32c3 and esp32s3
|
||||
(build 51d9dfd). Without hardware:
|
||||
|
||||
```bash
|
||||
strings -a <idf>/components/bt/controller/lib_esp32c3_family/<chip>/libbtdm_app.a | grep -E '^[0-9a-f]{7}$'
|
||||
```
|
||||
|
||||
On a board: a button lambda logging `btdm_controller_get_compile_version()` (declared `extern "C"`) over the API,
|
||||
since the ESP-IDF init line only reaches the UART.
|
||||
@@ -0,0 +1,17 @@
|
||||
# ESP32 GPIO hold through the ISR pin API (#21576)
|
||||
|
||||
`scripts/gpio_hold/hold_test.hpp` builds `ESP32InternalGPIOPin`s by hand, calls `to_isr()` and reads each pad back
|
||||
with `gpio_get_level`: 20 ISR writes, a raw `gpio_set_level` control (a held pad must not change, an unheld one must)
|
||||
and ISR `pin_mode` pulls (input must drop to `NONE` between pull changes, because the ISR path only applies pulls when
|
||||
`FLAG_INPUT` toggles). It needs no wiring: unconnected pins read the pulls. Each pin runs held and unheld, then the
|
||||
round logs `ROUND n PASS failures=0` or `FAIL`.
|
||||
|
||||
- `USE_GPIO_HOLD` comes from any pin with `hold_state: true`, so the configs add a `gpio` output on a spare pin.
|
||||
- `gpio-hold-esp32.yaml` (classic devkit) runs three rounds 5 s after boot and has a `rerun` button;
|
||||
`gpio-hold-esp32s3.yaml` (Waveshare ESP32-S3-ETH, where most pins go to the W5500, TF card, camera, WS2812 or
|
||||
USB) runs a round every 15 s.
|
||||
- C3: ESP-IDF 5.5 has `SOC_RTCIO_PIN_COUNT` 0, so `rtc_gpio_is_valid_gpio()` is false on every pin and only the
|
||||
digital hold path runs.
|
||||
- C6 (Waveshare ESP32-C6-GEEK, native USB): LP pads GPIO0 to 7 are RTC IO with hold. GPIO1, 2, 7, 20, 23 read high
|
||||
and GPIO6 low whatever the pull (LCD, TF card or resistors); clean pins are 0, 3, 4, 5, 18, 19, 21, 22. Dev
|
||||
already holds LP pads through `gpio_hal_hold_en`, so the PR and dev look the same there. H2 is untested.
|
||||
@@ -40,3 +40,29 @@ least 24 selects per build and read the raw bytes with `uart: debug: direction:
|
||||
id) before blaming the parser; the API log stream drops lines under that dump volume, so some misses stay
|
||||
unclassified.
|
||||
Results: https://github.com/esphome/esphome/pull/21357#issuecomment-6333244886
|
||||
|
||||
## Frame stream harness: presence hold and link loss (#21733, #21734)
|
||||
|
||||
`scripts/ld2450/stream-harness.yaml` is a loopback harness that feeds the hub one periodic frame every 100 ms from a
|
||||
mode global set by API buttons: no target, target 1 approaching, silent, or 12 garbage bytes per tick (what a radar
|
||||
at another baud rate looks like). `has_target` has `filters: []` so the hub's own hold is what gets timed, and every
|
||||
change logs `presence raw ON|OFF at <millis>`. Add `stream-connected.yaml` as a second package on builds whose ld2450
|
||||
has the link watchdog (`connected` binary sensor).
|
||||
|
||||
- `holddrive.py HOST OUT`: for `presence_timeout` 5 and 0, three seconds of target frames, then empty frames; prints
|
||||
the ms from the press to the off line, then sets 0 and 20 and reads the number back after a restart. On dev 0
|
||||
still held 5 s and snapped back to 5; with #21733 it clears on the next empty frame (under 200 ms) and stays 0.
|
||||
- `linkdrive.py HOST OUT`: steps through target frames, 10 s of silence, empty frames, 10 s of garbage, target
|
||||
frames, then the hub's radar restart followed by 3.5 s and by 15 s of silence; prints every state change and link
|
||||
log line with its time. Dev freezes every entity through silence and garbage. Run against a real radar too: a
|
||||
radar restart and a Bluetooth toggle must not report a loss (the Apollo R PRO-1 ETH did not).
|
||||
- A freshly booted ESP8266 delays API commands sent in its first seconds and then runs them back to back; the
|
||||
drivers wait 8 s after connecting before timed presses.
|
||||
|
||||
## BT MAC sensors (#21731)
|
||||
|
||||
`scripts/ld2450/macdrive.py HOST OUT` reads every LD24xx BT MAC, Bluetooth and firmware entity, turns each Bluetooth
|
||||
switch off, then on, and prints the values after each step. The MAC sensors are often `disabled_by_default` in
|
||||
vendor configs but still publish over the API. On the Apollo R PRO-1 ETH both radars (LD2450 fw 2.04, LD2412 fw
|
||||
1.26) have the multicast bit set in the first MAC byte, which dev showed as `unknown`. A radar MAC identifies a
|
||||
device: quote only its first byte in PR text.
|
||||
@@ -71,3 +71,92 @@ The `restart` after the first crash checks the report shows only once. Time each
|
||||
(the ROM fault dump to the next `ROM Version` line), not from the API port: the board is back before an API client
|
||||
notices it went away. Compare the reported PC with the `PC =` line of the ROM dump, and check the decoded lines in the
|
||||
`caseN-*.txt` files. Pass the UF2 by name (`firmware.uf2`): the build directory holds a second identically sized copy.
|
||||
|
||||
Regression rerun of the same flow (#21728): `scripts/libretiny_crash/rtl_rom_vs_report.py CAPTURE` lists, for each ROM
|
||||
fault dump in a `--ms` capture, the ROM's CFSR and PC, the ms to the next `ROM Version` banner and the Reason, CFSR, PC
|
||||
and SP the next boot reported, so two builds compare line by line. The ROM lines start with a bare CR; split the
|
||||
capture on newlines only. The imprecise bus fault's PC moves between builds (it is wherever the core was when the
|
||||
fault was raised); compare it with that run's ROM dump, not with another build. SP stays the same per fault (8 word
|
||||
frame, no FPU). On the BK7238 time the reboot from the button press to the next `BK7238_1.0.14` banner (0.6 to 0.7 s).
|
||||
|
||||
## BK7238 BLE and flash sector safety (#21735)
|
||||
|
||||
The Beken BLE bond store reads its partition at boot and erases that sector when the CRC does not match; before
|
||||
LibreTiny 1.14 the partition was unmapped and pointed at sector 0, erasing the bootloader (#18646). To prove a change
|
||||
like this safe on a board that cannot be recovered without a dump:
|
||||
|
||||
1. Take a full backup first: `scripts/bk72xx_flash/readback.sh full-before` (ltchiptool family `beken-7238`, about
|
||||
190 s for 2 MB). Keep it until the board is back on a known build.
|
||||
2. Serial flash a build without the feature, then deliver the feature build by OTA (the path users take). Use
|
||||
`bk72xx: framework: sdk_silent: none` with `logger: hardware_uart: UART1`, so the SDK's own lines (bootloader
|
||||
banner, `CRC fail, remove bonded info`) show up in the capture.
|
||||
3. Soak with Wi-Fi up, OTA again from the new build, pulse CEN a few times (`serial_capture.py --reset`), and check
|
||||
each boot comes back through the bootloader.
|
||||
4. Read the whole chip again and run `scripts/bk72xx_flash/partdiff.py full-before.bin full-after.bin
|
||||
<libretiny>/boards/_base/beken-72xx.json`: bootloader, calibration and userdata must be unchanged; app, download
|
||||
and one KVS sector change normally.
|
||||
|
||||
Check what already sits in the target partition before the first boot: on an XH-WB3S that shipped with Tuya firmware,
|
||||
0x1E1000 (the `ble_bonding` partition of the generic Beken layout) held the Tuya `diff2ya` record (magic `ba dc cd
|
||||
ab`), which the bond store erased on its first boot. Nothing depended on it there, but say so in the results.
|
||||
|
||||
## BK7238 OTA and the board layout (issue #18222)
|
||||
|
||||
A BK7238 has one of two bootloaders, and the board in the YAML must match it: Beken OEM (`BK7238_1.0.14` in the
|
||||
boot banner, `generic-bk7238`, OTA as RBL to `download` at 0x132000) or Tuya T1 2.0.0 (`generic-bk7238-tuya`,
|
||||
`t1-*`, `download` at 0x12C000 plus a `diff2ya` record at 0x1E1000). `ltchiptool uf2 info` on `firmware.uf2` shows
|
||||
the layout an image targets (`FAL_PTABLE`, `OTA_PART_INFO`). Measured on the OEM bootloader (2026-10-27):
|
||||
|
||||
| Running | Uploaded | Result |
|
||||
|---|---|---|
|
||||
| Tuya layout | Tuya layout | upload succeeds, bootloader prints `App verify failed! Need to recovery factory firmware.`, old build stays |
|
||||
| Tuya layout | OEM layout | applied |
|
||||
| OEM layout | Tuya layout | `End error: 9` (`UPDATE_ERROR_ACTIVATE`: no `RBL` at the running download offset), old build stays |
|
||||
| OEM layout | OEM layout | applied |
|
||||
|
||||
Run it with a full backup first (`scripts/bk72xx_flash/readback.sh`), `sdk_silent: none` so the bootloader's lines
|
||||
show, and each result checked against `build_info.json` over the API. A Tuya-layout build on an OEM-layout module
|
||||
reads the RF calibration from 0x1E3000: copy the 0x1E0000 sector there for the test and erase it afterwards. The
|
||||
Tuya OTA writes up to about 0x1EF000 and its own settings at 0x1E4000, so write those sectors back from the backup
|
||||
and check with `partdiff.py`.
|
||||
|
||||
## RTL8710B Wi-Fi join diagnosis (issue #21742)
|
||||
|
||||
For a board that joins rarely: build `dev` with `sdk_silent: none`, log `wifi_get_last_error()` and
|
||||
`rtw_join_status` after each failed `WiFi.begin()`, and dump the efuse map once (see the AmebaZ section in
|
||||
`boards.md`). The driver log tells the stages apart: `start auth to` with nothing after it is the AP not answering,
|
||||
`auth success, start assoc` then `association success` then error 3 is a failed 4-way handshake, and
|
||||
`sta recv deauth reason code(6)` is the AP dropping the session mid-handshake. Tally per BSSID: if the share of
|
||||
auth frames answered falls with distance while receive stays strong, the board's transmit path is weak.
|
||||
|
||||
A/B a value one boot at a time so time of day and AP state hit both sides equally. Keep the trial counter in a
|
||||
`restore_value` global, set the value in an `on_boot` lambda at priority 600 (before Wi-Fi starts), and reboot
|
||||
after a fixed window:
|
||||
|
||||
```yaml
|
||||
esphome:
|
||||
on_boot:
|
||||
priority: 600
|
||||
then:
|
||||
- lambda: |-
|
||||
// value under test, read by the code being measured
|
||||
wifi::diag_value = (id(trial_idx) % 2) ? 0x3A : 0;
|
||||
ESP_LOGW("trial", "TRIAL %d start value=0x%02X", id(trial_idx), wifi::diag_value);
|
||||
- delay: 75s
|
||||
- lambda: |-
|
||||
bool ok = wifi::global_wifi_component->is_connected();
|
||||
ESP_LOGW("trial", "TRIAL %d value=0x%02X result=%s", id(trial_idx), wifi::diag_value,
|
||||
ok ? "JOINED" : "FAILED");
|
||||
id(trial_idx)++;
|
||||
App.safe_reboot();
|
||||
```
|
||||
|
||||
Turn off `api:` and `wifi:` `reboot_timeout`, and leave out `ap:` unless the AP is the variable under test.
|
||||
Do not cycle trials with `wifi.disable` and `wifi.enable`: doing that while connected reset the RTL8710B on the next
|
||||
scan. Results from 2026-10-27, on one BW12 with blank efuse calibration: crystal trim `0x20`, `0x30` and `0x38`
|
||||
all joined 20 of 20 trials, and boosted TX power indexes changed nothing against an AP that answered 0 of 43
|
||||
auth frames.
|
||||
|
||||
Known LibreTiny behaviour seen here: after a join with a BSSID and channel, LibreTiny's partial-scan reset leaves
|
||||
the next SSID-only join with nothing to scan (`RTW_NONE_NETWORK` in about 18 ms). That is a firmware bug, not
|
||||
the board; passing channel 0 avoids it.
|
||||
@@ -0,0 +1,16 @@
|
||||
# GPIO wakeup from auto light sleep (#21074)
|
||||
|
||||
`scripts/light_sleep_wake` needs no wiring. LEDC on `LEDC_USE_RC_FAST_CLK` with
|
||||
`sleep_mode = LEDC_SLEEP_MODE_KEEP_ALIVE` keeps toggling GPIO10 at 2 Hz through light sleep, and an
|
||||
`ESP32InternalGPIOPin` interrupt (`ANY_EDGE`) on the same pad timestamps every edge in an IRAM handler.
|
||||
`wakeprobe::report()` logs every 30 s: edges seen and expected, the shortest and longest gap, how many edges came
|
||||
more than 20 ms off the half period, and the SLEEP share from `esp_pm_dump_locks()` (needs `profiling: true`).
|
||||
|
||||
- Native ESP-IDF builds need `include_builtin_idf_components: [esp_driver_ledc]`.
|
||||
- After `ledc_channel_config` call `gpio_input_enable(pin)`, never `gpio_set_direction(INPUT_OUTPUT)`: that routes the
|
||||
pad back to a plain GPIO output, the wave stops and the pad reads a constant 1.
|
||||
- The C3 shares one LEDC clock across timers, so a board whose own config drives LEDs through `ledc` needs a test
|
||||
config without them. Logging over the API works with `logger: baud_rate: 0`.
|
||||
- Read the reports over the API with `esphome logs ... --device <ip>` under `timeout`. Run PR, dev, then the PR
|
||||
again. On a C3 bulb dev caught every edge but handled 8 of 845 more than 20 ms late
|
||||
(up to 45 ms), the PR none; both slept 57 to 58% of the time.
|
||||
@@ -0,0 +1,31 @@
|
||||
# Manual IP and web handler flows (#21708, #21709, #21711, #21712)
|
||||
|
||||
## Station manual IP (`scripts/manual_ip/run-sta.sh`)
|
||||
|
||||
Set `static_ip` to the board's own DHCP lease so nothing collides, and DNS2 to a server DHCP does not hand out
|
||||
(9.9.9.9), so the dump and `dns_getserver()` prove the manual values are in use. A missing SSID with its own
|
||||
`manual_ip` comes first, so the real network is a later table row and inherits the top level `manual_ip`. The probe
|
||||
logs both DNS servers and resolves a name every 20 s; `ipaddr_ntoa` uses one static buffer, so it uses
|
||||
`ipaddr_ntoa_r` to log two addresses in one line. PASS needs the address, both DNS servers, a lookup and a ping.
|
||||
|
||||
## AP manual IP (`scripts/manual_ip/run-ap.sh`)
|
||||
|
||||
The DUT has only a missing SSID, `ap_timeout: 10s` and `captive_portal:`, so its AP comes up on 10.42.7.1; the other
|
||||
board joins as a client and fetches `http://10.42.7.1/` every 10 s. A D1 mini AP drops some client requests on dev
|
||||
too, so compare failure counts with a dev run and do not expect zero.
|
||||
|
||||
## Ethernet manual IP
|
||||
|
||||
Same idea on an Ethernet board: its lease as `manual_ip` plus an outside DNS2 and the DNS probe from
|
||||
`scripts/manual_ip/dnsprobe.hpp`; restart it over the API and check again.
|
||||
|
||||
## Web handlers (`scripts/web_handlers/run.sh`)
|
||||
|
||||
`webbase.yaml` adds a GET /probe handler from `on_boot` at priority -100 (the shape of an external component adding
|
||||
a handler late) and takes a variant: `ws` (web_server), `cp` (captive_portal only, started on the station network by
|
||||
a button calling `global_captive_portal->start()`) or `prom` (captive_portal and prometheus). The runner fetches
|
||||
/probe and /, then uploads the same image through web OTA (`curl -F update=@<bin> http://ip/update`; ESP-IDF
|
||||
`build/<name>.bin`, not `firmware.ota.bin`; ESP8266 `.pioenvs/<name>/firmware.bin`) and checks over the API that the
|
||||
board is back on that build. On dev too, prometheus GET / gets no answer on ESP32 and 404 on ESP8266.
|
||||
|
||||
A background `(cd dir && cmd) &` does not change the parent shell's directory: give capture scripts absolute paths.
|
||||
@@ -11,3 +11,20 @@ Serial DFU to the ItsyBitsy nRF52840 fails about half the time ("Target is not i
|
||||
1200 baud touch on the app port, wait for the `ITSY840BOOT` volume, convert `zephyr/zephyr.hex` with the SDK's
|
||||
`zephyr/scripts/build/uf2conv.py -f 0xADA52840 -c` and copy the .uf2 to the volume (the copy ends in an I/O error
|
||||
when the board reboots, which is normal). macOS BLE scans give UUIDs, not MAC addresses.
|
||||
|
||||
## zephyr_ble_server connection slot under reordered callbacks (#21723)
|
||||
|
||||
`scripts/zephyr_ble_server`: the ItsyBitsy runs `server.yaml` (one connection slot) and an ESP32 runs `client.yaml`,
|
||||
which connects, drops the link 300 ms later and reconnects as soon as the server advertises again. `run.sh NAME 90`
|
||||
flashes the UF2, counts the server's `Connected`/`Disconnected`/`Advertising` lines and the client's connects,
|
||||
and ends with PASS (more than one server connection) or FAIL; an empty capture or a silent client fails the setup.
|
||||
|
||||
- The connect and disconnect callbacks each `defer()` to the main loop and the bug needs the disconnect handled
|
||||
first, which cannot be forced over the air. Force it with a test-only patch on both trees: replace the connect
|
||||
callback's `defer(...)` with `set_timeout(5000, ...)`. A leaked reference then shows as one connection and nothing
|
||||
after it (the dump still lists the closed link); a fixed build keeps cycling (17 in 90 s on #21723).
|
||||
- `dfu: true` makes the next flash a 1200 baud touch; an app built without it needs a double tap on RESET. The
|
||||
Zephyr app enumerates as `2fe3:0100`, the bootloader as `239a:0051`, so find the board by its USB serial number.
|
||||
- macOS is a poor central here: it keeps old bonds with a board (`Peer removed pairing information` on connect)
|
||||
and clearing them is a system setting. Use an ESP32 `ble_client`; the server's random static address comes from
|
||||
its own log.
|
||||
@@ -54,3 +54,16 @@ over syslog and fails when a case did not reach the end of its stream.
|
||||
to `dest`); after that lands, remove the `dest_limit` line.
|
||||
|
||||
Results: https://github.com/esphome/esphome/issues/21639#issuecomment-6409786224
|
||||
|
||||
## Upload without a configuration (#21738)
|
||||
|
||||
`esphome upload --file IMAGE --device IP` with no YAML picks the OTA port from the image header and takes the password
|
||||
from `--ota-password` or `ESPHOME_OTA_PASSWORD` and the key from `ESPHOME_OTA_KEY`. Test each chip family with its own
|
||||
current image (`build/firmware.ota.bin` for ESP-IDF, `.pioenvs/<name>/firmware.bin` for ESP8266, `firmware.uf2` for
|
||||
LibreTiny) and check the build over the API; switch one board between two builds to show a new image lands.
|
||||
|
||||
Point every case that should be refused before connecting at an unroutable address (192.0.2.1), never at a board: a
|
||||
refusal prints no `Connecting to` line, and an image that slips through cannot reach a device. An ESP32-S3
|
||||
`firmware.factory.bin` slipped through on 2026-10-27 (its bootloader header at offset 0 looks like an app), the device
|
||||
reported `OTA successful` and its bootloader rejected the slot at boot; send the board its proper app image afterwards.
|
||||
A factory image has the partition table magic `AA 50` at 0x8000 and the app at 0x10000.
|
||||
@@ -0,0 +1,10 @@
|
||||
# prometheus
|
||||
|
||||
## Date, time and datetime metrics (#9941)
|
||||
|
||||
`scripts/prometheus/prom-datetime.yaml` is a D1 mini with `web_server`, `prometheus` and three optimistic template
|
||||
datetime entities; `prom-datetime-tz.yaml` adds an sntp time component with `HST10` (the zone applies without a sync).
|
||||
`datetime_metrics.py HOST` prints the rows of `/metrics`, sets the entities over the API to 2040 values (past 2038 on
|
||||
purpose) and prints them again with their UTC reading. Dates are local midnight in ms, times ms since midnight,
|
||||
datetimes ms since the epoch, so a datetime set as an instant reads the same in both zones. It exits 1 when a time
|
||||
or datetime row does not hold the value it set (dates depend on the zone and are only printed).
|
||||
@@ -0,0 +1,64 @@
|
||||
"""Compare two full flash dumps of a BK72xx board per partition of its LibreTiny board layout.
|
||||
|
||||
usage: partdiff.py BEFORE.bin AFTER.bin LAYOUT.json
|
||||
LAYOUT.json is a board base file from the LibreTiny platform (for example boards/_base/beken-72xx.json); its
|
||||
"flash" map ("name": "0xSTART+0xLENGTH") names the partitions. Prints the 4 KB sectors that changed in each one,
|
||||
plus any changed sector outside the map (a WARN, to check by hand). Exits 1 when the bootloader, calibration or
|
||||
userdata partition changed.
|
||||
"""
|
||||
|
||||
import json
|
||||
import pathlib
|
||||
import sys
|
||||
|
||||
before, after = (pathlib.Path(p).read_bytes() for p in sys.argv[1:3])
|
||||
if len(before) != len(after):
|
||||
sys.exit(
|
||||
f"dump sizes differ: {len(before)} and {len(after)} bytes; compare two whole chip reads"
|
||||
)
|
||||
parts = []
|
||||
for name, span in json.loads(pathlib.Path(sys.argv[3]).read_text(encoding="utf-8"))[
|
||||
"flash"
|
||||
].items():
|
||||
start, length = (int(x, 16) for x in span.split("+"))
|
||||
parts.append((start, start + length, name))
|
||||
parts.sort()
|
||||
PROTECTED = ("bootloader", "calibration", "userdata")
|
||||
if missing := [n for n in PROTECTED if n not in {name for _, _, name in parts}]:
|
||||
sys.exit(
|
||||
f"the layout has no {', '.join(missing)} partition; use the Beken board base file"
|
||||
)
|
||||
if (end := max(e for _, e, _ in parts)) > len(before):
|
||||
sys.exit(
|
||||
f"the layout reaches {end:#x} but the dumps are {len(before):#x} bytes; read the whole chip"
|
||||
)
|
||||
SECTOR = 0x1000
|
||||
covered = set()
|
||||
protected = []
|
||||
for start, end, name in parts:
|
||||
changed = [
|
||||
a
|
||||
for a in range(start, end, SECTOR)
|
||||
if before[a : a + SECTOR] != after[a : a + SECTOR]
|
||||
]
|
||||
covered.update(range(start, end, SECTOR))
|
||||
if changed and name in PROTECTED:
|
||||
protected.append(name)
|
||||
listed = " ".join(hex(a) for a in changed[:4]) if 0 < len(changed) <= 4 else ""
|
||||
print(
|
||||
f"{name:12} {len(changed):4} of {(end - start) // SECTOR:4} sectors changed {listed}"
|
||||
)
|
||||
other = [
|
||||
a
|
||||
for a in range(0, len(before), SECTOR)
|
||||
if a not in covered and before[a : a + SECTOR] != after[a : a + SECTOR]
|
||||
]
|
||||
print(
|
||||
f"{'unmapped':12} {len(other):4} sectors changed {' '.join(hex(a) for a in other[:8])}"
|
||||
)
|
||||
if other:
|
||||
print(
|
||||
"WARN: sectors outside the layout changed; check what they held in the backup"
|
||||
)
|
||||
if protected:
|
||||
sys.exit(f"FAIL: {', '.join(protected)} changed")
|
||||
@@ -0,0 +1,19 @@
|
||||
#!/bin/bash
|
||||
# usage: readback.sh TAG [START LENGTH] read flash from a BK72xx over its adapter into TAG.bin (whole chip by default)
|
||||
# env: PORT (adapter), FAMILY (ltchiptool family, default beken-7238), FLASH_BK (path to flash_bk72xx.py),
|
||||
# LT (LibreTiny penv python, default ~/.platformio/penv/.libretiny/bin/python), SIZE (whole chip bytes, default
|
||||
# 2097152). A whole 2 MB chip takes about 190 s. The read must come back at the expected size.
|
||||
T=${1:?tag}; P=${PORT:?set PORT}; FB=${FLASH_BK:?set FLASH_BK}; LT=${LT:-$HOME/.platformio/penv/.libretiny/bin/python}
|
||||
ARGS=(); [ -n "$2" ] && ARGS=(-s "$2" -l "${3:?length}")
|
||||
WANT=$(( ${3:-${SIZE:-2097152}} ))
|
||||
: > "$T.log"
|
||||
ok=
|
||||
for i in 1 2 3; do
|
||||
echo "### try $i" >> "$T.log"
|
||||
rm -f "$T.bin"
|
||||
timeout 900 "$LT" "$FB" flash read -d "$P" "${ARGS[@]}" "${FAMILY:-beken-7238}" "$T.bin" >> "$T.log" 2>&1 &&
|
||||
[ "$(wc -c < "$T.bin" | tr -d ' ')" = "$WANT" ] && ok=1 && break
|
||||
sleep 3
|
||||
done
|
||||
[ -n "$ok" ] || { echo "FAIL: read $T (expected $WANT bytes, see $T.log)"; exit 1; }
|
||||
shasum -a 256 "$T.bin"
|
||||
@@ -0,0 +1,39 @@
|
||||
# Add to a copy of a bluetooth_proxy config: packages: {cp_inject: !include cp-inject.yaml}
|
||||
esphome:
|
||||
includes:
|
||||
- cp_inject.hpp
|
||||
|
||||
logger:
|
||||
level: VERBOSE
|
||||
logs:
|
||||
esp32_ble_tracker: DEBUG
|
||||
bluetooth_proxy: DEBUG
|
||||
bluetooth_connection: DEBUG
|
||||
api: DEBUG
|
||||
api.service: DEBUG
|
||||
api.connection: DEBUG
|
||||
api.socket: DEBUG
|
||||
scheduler: DEBUG
|
||||
sensor: DEBUG
|
||||
component: DEBUG
|
||||
|
||||
button:
|
||||
- platform: template
|
||||
name: Inject conn param events
|
||||
# The handlers push into a queue that takes one writer only, the Bluetooth task. Stop the scan (and keep the
|
||||
# proxy free of real connections) so nothing else writes while the button does.
|
||||
on_press:
|
||||
- esp32_ble_tracker.stop_scan:
|
||||
- wait_until:
|
||||
condition:
|
||||
lambda: return !esp32_ble_tracker::global_esp32_ble_tracker->scan_running();
|
||||
timeout: 5s
|
||||
- delay: 1s
|
||||
- lambda: |-
|
||||
if (esp32_ble_tracker::global_esp32_ble_tracker->scan_running()) {
|
||||
ESP_LOGE("cpinject", "scan still running after 5 s, nothing injected");
|
||||
return;
|
||||
}
|
||||
cpinject::run();
|
||||
- esp32_ble_tracker.start_scan:
|
||||
continuous: true
|
||||
@@ -0,0 +1,68 @@
|
||||
#pragma once
|
||||
// Feeds fabricated conn param update and disconnect events into ESP32BLE's static handlers.
|
||||
// The event queue takes a single writer: call run() only while scanning is stopped and no connection is active.
|
||||
#include <cstring>
|
||||
#include "esphome/components/esp32_ble/ble.h"
|
||||
#include "esphome/core/log.h"
|
||||
|
||||
namespace cpinject {
|
||||
using GapFn = void (*)(esp_gap_ble_cb_event_t, esp_ble_gap_cb_param_t *);
|
||||
using GattcFn = void (*)(esp_gattc_cb_event_t, esp_gatt_if_t, esp_ble_gattc_cb_param_t *);
|
||||
GapFn steal_gap();
|
||||
GattcFn steal_gattc();
|
||||
// Explicit instantiation ignores access checks, which exposes the protected static handlers.
|
||||
template<GapFn F> struct GapThief {
|
||||
friend GapFn steal_gap() { return F; }
|
||||
};
|
||||
template<GattcFn F> struct GattcThief {
|
||||
friend GattcFn steal_gattc() { return F; }
|
||||
};
|
||||
template struct GapThief<&esphome::esp32_ble::ESP32BLE::gap_event_handler>;
|
||||
template struct GattcThief<&esphome::esp32_ble::ESP32BLE::gattc_event_handler>;
|
||||
|
||||
static const char *const TAG = "cpinject";
|
||||
|
||||
inline void peer(uint8_t n, uint8_t *bda) {
|
||||
const uint8_t base[6] = {0xC0, 0xFF, 0xEE, 0x00, 0x00, 0x00};
|
||||
memcpy(bda, base, 6);
|
||||
bda[5] = n;
|
||||
}
|
||||
|
||||
inline void update(uint8_t n, int status, int times) {
|
||||
for (int i = 0; i < times; i++) {
|
||||
esp_ble_gap_cb_param_t p{};
|
||||
peer(n, p.update_conn_params.bda);
|
||||
p.update_conn_params.status = (esp_bt_status_t) status;
|
||||
p.update_conn_params.conn_int = 24;
|
||||
p.update_conn_params.timeout = 400;
|
||||
steal_gap()(ESP_GAP_BLE_UPDATE_CONN_PARAMS_EVT, &p);
|
||||
}
|
||||
}
|
||||
|
||||
inline void disconnect(uint8_t n) {
|
||||
esp_ble_gattc_cb_param_t p{};
|
||||
peer(n, p.disconnect.remote_bda);
|
||||
p.disconnect.reason = ESP_GATT_CONN_TERMINATE_PEER_USER;
|
||||
p.disconnect.conn_id = 0xEE;
|
||||
// 0xFE matches no registered client, so the queued event is ignored by every connection.
|
||||
steal_gattc()(ESP_GATTC_DISCONNECT_EVT, 0xFE, &p);
|
||||
}
|
||||
|
||||
inline void run() {
|
||||
ESP_LOGI(TAG, "STEP1 peers 1-4 fail 5x each (3 slots)");
|
||||
for (uint8_t n = 1; n <= 4; n++)
|
||||
update(n, 6, 5);
|
||||
ESP_LOGI(TAG, "STEP2 peer 1 succeeds, then fails 3x");
|
||||
update(1, 0, 1);
|
||||
update(1, 6, 3);
|
||||
ESP_LOGI(TAG, "STEP3 peer 2 disconnects, then fails 3x");
|
||||
disconnect(2);
|
||||
update(2, 6, 3);
|
||||
ESP_LOGI(TAG, "STEP4 peer 4 fails 3x, slots still full");
|
||||
update(4, 6, 3);
|
||||
ESP_LOGI(TAG, "STEP5 peer 3 disconnects, peer 4 fails 3x");
|
||||
disconnect(3);
|
||||
update(4, 6, 3);
|
||||
ESP_LOGI(TAG, "STEP6 done");
|
||||
}
|
||||
} // namespace cpinject
|
||||
@@ -0,0 +1,156 @@
|
||||
# Waveshare ESP32-S3 (any ESP32 with BLE) as the central. run.sh passes name, io, auth, idf and server (the
|
||||
# server's BLE MAC from its esp32_ble dump) with -s. ble_client never pairs by itself: the Pair button calls pair().
|
||||
esphome:
|
||||
name: ${name}
|
||||
|
||||
esp32:
|
||||
board: esp32-s3-devkitc-1
|
||||
variant: esp32s3
|
||||
flash_size: 16MB
|
||||
framework:
|
||||
type: esp-idf
|
||||
version: ${idf}
|
||||
|
||||
logger:
|
||||
hardware_uart: USB_SERIAL_JTAG
|
||||
level: VERBOSE
|
||||
logs:
|
||||
esp32_ble_tracker: DEBUG
|
||||
api: DEBUG
|
||||
api.connection: DEBUG
|
||||
api.service: DEBUG
|
||||
api.socket: DEBUG
|
||||
scheduler: DEBUG
|
||||
component: DEBUG
|
||||
wifi: DEBUG
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
esp32_ble:
|
||||
io_capability: ${io}
|
||||
auth_req_mode: ${auth}
|
||||
|
||||
esp32_ble_tracker:
|
||||
|
||||
ble_client:
|
||||
- mac_address: ${server}
|
||||
id: cli
|
||||
on_connect:
|
||||
- logger.log: "CLI connected"
|
||||
on_disconnect:
|
||||
- logger.log: "CLI disconnected"
|
||||
on_numeric_comparison_request:
|
||||
- logger.log:
|
||||
format: "CLI numeric comparison %06u"
|
||||
args: ["(unsigned) passkey"]
|
||||
- ble_client.numeric_comparison_reply:
|
||||
id: cli
|
||||
accept: true
|
||||
|
||||
text_sensor:
|
||||
- platform: ble_client
|
||||
ble_client_id: cli
|
||||
id: secure_value
|
||||
name: Secure value
|
||||
service_uuid: "180F"
|
||||
characteristic_uuid: "2A19"
|
||||
update_interval: never
|
||||
on_value:
|
||||
- logger.log:
|
||||
format: "CLI secure read: %s"
|
||||
args: ["x.c_str()"]
|
||||
- platform: ble_client
|
||||
ble_client_id: cli
|
||||
id: open_value
|
||||
name: Open value
|
||||
service_uuid: 5ec50000-0000-4000-8000-00000000f000
|
||||
characteristic_uuid: 5ec50000-0000-4000-8000-00000000f001
|
||||
update_interval: never
|
||||
on_value:
|
||||
- logger.log:
|
||||
format: "CLI open read: %s"
|
||||
args: ["x.c_str()"]
|
||||
|
||||
- platform: ble_client
|
||||
ble_client_id: cli
|
||||
id: mitm_value
|
||||
name: Mitm value
|
||||
service_uuid: 5ec50000-0000-4000-8000-00000000f000
|
||||
characteristic_uuid: 5ec50000-0000-4000-8000-00000000f004
|
||||
update_interval: never
|
||||
on_value:
|
||||
- logger.log:
|
||||
format: "CLI mitm read: %s"
|
||||
args: ["x.c_str()"]
|
||||
- platform: ble_client
|
||||
ble_client_id: cli
|
||||
id: notify_value
|
||||
name: Notify value
|
||||
service_uuid: 5ec50000-0000-4000-8000-00000000f000
|
||||
characteristic_uuid: 5ec50000-0000-4000-8000-00000000f003
|
||||
notify: true
|
||||
on_value:
|
||||
- logger.log:
|
||||
format: "CLI notification: %s"
|
||||
args: ["x.c_str()"]
|
||||
|
||||
button:
|
||||
- platform: template
|
||||
name: Subscribe
|
||||
on_press:
|
||||
- lambda: |-
|
||||
// ble_client drops its service list after discovery; ESP-IDF's GATT server puts the CCCD right after
|
||||
// the characteristic value, so write handle + 1
|
||||
uint16_t chr = id(notify_value)->handle;
|
||||
if (chr == 0) { ESP_LOGW("CLI", "notify characteristic handle unknown"); return; }
|
||||
auto reg = esp_ble_gattc_register_for_notify(id(cli)->get_gattc_if(), id(cli)->get_remote_bda(), chr);
|
||||
if (reg != ESP_OK) { ESP_LOGW("CLI", "register_for_notify failed: %d", reg); return; }
|
||||
uint8_t on[2] = {1, 0};
|
||||
auto err = esp_ble_gattc_write_char_descr(id(cli)->get_gattc_if(), id(cli)->get_conn_id(), chr + 1, 2, on,
|
||||
ESP_GATT_WRITE_TYPE_RSP, ESP_GATT_AUTH_REQ_NONE);
|
||||
ESP_LOGI("CLI", "CCCD write to handle %u (char %u) sent, err %d", chr + 1, chr, err);
|
||||
- platform: template
|
||||
name: Pair
|
||||
on_press:
|
||||
- lambda: 'ESP_LOGI("CLI", "pair() returned %d", (int) id(cli)->pair());'
|
||||
- platform: template
|
||||
name: Read secure
|
||||
on_press:
|
||||
- component.update: secure_value
|
||||
- platform: template
|
||||
name: Read mitm
|
||||
on_press:
|
||||
- component.update: mitm_value
|
||||
- platform: template
|
||||
name: Read open
|
||||
on_press:
|
||||
- component.update: open_value
|
||||
- platform: template
|
||||
name: Write secure
|
||||
on_press:
|
||||
- ble_client.ble_write:
|
||||
id: cli
|
||||
service_uuid: 5ec50000-0000-4000-8000-00000000f000
|
||||
characteristic_uuid: 5ec50000-0000-4000-8000-00000000f002
|
||||
value: [0x68, 0x65, 0x6C, 0x6C, 0x6F]
|
||||
- platform: template
|
||||
name: Disconnect
|
||||
on_press:
|
||||
- ble_client.disconnect: cli
|
||||
- platform: template
|
||||
name: Connect
|
||||
on_press:
|
||||
- ble_client.connect: cli
|
||||
- platform: template
|
||||
name: Remove bond
|
||||
on_press:
|
||||
- ble_client.remove_bond:
|
||||
id: cli
|
||||
@@ -0,0 +1,60 @@
|
||||
"""Press the client's buttons in order and log every client line about BLE security.
|
||||
|
||||
usage: drive.py CLIENT_HOST OUT STEP... STEP: a button name, or wait:SECONDS env: API_KEY
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
import os
|
||||
import pathlib
|
||||
import re
|
||||
import sys
|
||||
import time
|
||||
|
||||
from aioesphomeapi import APIClient, ButtonInfo, LogLevel
|
||||
|
||||
HOST, OUT, STEPS = sys.argv[1], sys.argv[2], sys.argv[3:]
|
||||
LOG = pathlib.Path(OUT).open("w", encoding="utf-8") # noqa: SIM115 open for the whole run
|
||||
PATTERN = re.compile(
|
||||
r"CLI|ble_client|ble_text_sensor|esp32_ble_client|[Aa]uth|[Ee]ncrypt|[Bb]ond|Error|status=|pair"
|
||||
)
|
||||
|
||||
|
||||
def note(s: str) -> None:
|
||||
line = f"{time.strftime('%H:%M:%S')} {s}"
|
||||
print(line)
|
||||
LOG.write(line + "\n")
|
||||
LOG.flush()
|
||||
|
||||
|
||||
async def main() -> None:
|
||||
c = APIClient(HOST, 6053, None, noise_psk=os.environ.get("API_KEY"))
|
||||
for attempt in range(40):
|
||||
try:
|
||||
await c.connect(login=True)
|
||||
break
|
||||
except Exception as err: # noqa: BLE001
|
||||
last_err = err
|
||||
note(f"connect attempt {attempt + 1} failed: {err!r}")
|
||||
await asyncio.sleep(2)
|
||||
else:
|
||||
raise last_err
|
||||
ents, _ = await c.list_entities_services()
|
||||
btn = {e.name: e.key for e in ents if isinstance(e, ButtonInfo)}
|
||||
|
||||
def on_log(m) -> None:
|
||||
t = re.sub(r"\x1b\[[0-9;]*m", "", m.message.decode(errors="replace"))
|
||||
if PATTERN.search(t):
|
||||
note("LOG " + t.strip().replace("\n", " | "))
|
||||
|
||||
c.subscribe_logs(on_log, log_level=LogLevel.LOG_LEVEL_DEBUG)
|
||||
for step in STEPS:
|
||||
if step.startswith("wait:"):
|
||||
await asyncio.sleep(float(step[5:]))
|
||||
continue
|
||||
note(f"PRESS {step}")
|
||||
c.button_command(btn[step])
|
||||
await asyncio.sleep(4)
|
||||
await c.disconnect()
|
||||
|
||||
|
||||
asyncio.run(main())
|
||||
@@ -0,0 +1,33 @@
|
||||
#!/bin/bash
|
||||
# usage: run.sh TAG IO AUTH build and flash the server (serial) and the client (OTA), then pair once and reconnect twice
|
||||
# Copy this directory into a scratch directory with a secrets.yaml (wifi_ssid, wifi_password) and run it there.
|
||||
# IO/AUTH: none bond (Just Works) or display_yes_no sc_mitm_bond (numeric comparison, MITM).
|
||||
# env: TREE (esphome checkout for the client), SERVER_TREE (checkout with esp32_ble_server security, #17562 or
|
||||
# later; default TREE), SERVER_PORT (devkit serial port), CLIENT_HOST (client address), SERVER_BLE_MAC (from the
|
||||
# server's esp32_ble dump), SC (path to serial_capture.py), IDF (default recommended), PY (default $TREE/venv/bin/python)
|
||||
# A server keeps its bonds in NVS and refuses a weaker re-pairing: erase its flash before switching from nc to jw.
|
||||
D=$(cd "$(dirname "$0")" && pwd); G=${1:?tag}; IO=${2:?io}; AUTH=${3:?auth}; T=${TREE:?set TREE}; PY=${PY:-$T/venv/bin/python}
|
||||
P=${SERVER_PORT:?set SERVER_PORT}; C=${CLIENT_HOST:?set CLIENT_HOST}; MAC=${SERVER_BLE_MAC:?set SERVER_BLE_MAC}; SC=${SC:?set SC}
|
||||
E=(-s io "$IO" -s auth "$AUTH" -s idf "${IDF:-recommended}")
|
||||
ST=${SERVER_TREE:-$T}
|
||||
build() { local t=$1; shift; (cd "$t" && PYTHONUNBUFFERED=1 timeout 1800 $PY -m esphome "$@"); }
|
||||
ok=
|
||||
for i in 1 2 3; do
|
||||
build "$ST" -s name "bss-$G" "${E[@]}" run --no-logs "$D/server.yaml" --device "$P" > "$D/server-$G-upload.log" 2>&1 && ok=1 && break
|
||||
sleep 5
|
||||
done
|
||||
[ -n "$ok" ] || { echo "FAIL: server build or flash (does SERVER_TREE have #17562?)"; exit 1; }
|
||||
build "$T" -s name "bsc-$G" "${E[@]}" -s server "$MAC" run --no-logs "$D/client.yaml" --device "$C" > "$D/client-$G-upload.log" 2>&1 ||
|
||||
{ echo "FAIL: client build or upload"; exit 1; }
|
||||
rm -f "$D/server-$G.txt"
|
||||
$PY "$SC" "$P" 330 "$D/server-$G.txt" --reset > /dev/null 2>&1 & CAP=$!
|
||||
trap 'kill $CAP 2>/dev/null' EXIT
|
||||
sleep 25
|
||||
R=("Disconnect" "wait:3" "Connect" "wait:10" "Pair" "wait:5" "Read secure" "Read mitm")
|
||||
$PY "$D/drive.py" "$C" "$D/client-$G.txt" "wait:6" "Remove bond" "Disconnect" "wait:3" "Connect" "wait:10" \
|
||||
"Read secure" "Read mitm" "Write secure" "Subscribe" "wait:8" "Pair" "wait:6" "Read secure" "Read mitm" "Write secure" \
|
||||
"Subscribe" "wait:10" "${R[@]}" "${R[@]}" > /dev/null || { echo "FAIL: driver"; exit 1; }
|
||||
wait $CAP; CAPRC=$?; trap - EXIT
|
||||
[ "$CAPRC" = 0 ] && [ -s "$D/server-$G.txt" ] || { echo "FAIL: server capture failed or empty (rc $CAPRC)"; exit 1; }
|
||||
MODE=jw; [ "$IO" = none ] || MODE=nc
|
||||
$PY "$D/summary.py" "$MODE" "$D/client-$G.txt" "$D/server-$G.txt"
|
||||
@@ -0,0 +1,85 @@
|
||||
# Classic ESP32 devkit as the secure GATT server. run.sh passes name, io (none or display_yes_no),
|
||||
# auth (bond or sc_mitm_bond) and idf (recommended, or a version such as 5.5.5) with -s.
|
||||
# Needs esp32_ble_server security from #17562 (read_encrypt, numeric comparison); build it with SERVER_TREE.
|
||||
esphome:
|
||||
name: ${name}
|
||||
|
||||
esp32:
|
||||
board: esp32dev
|
||||
framework:
|
||||
type: esp-idf
|
||||
version: ${idf}
|
||||
|
||||
logger:
|
||||
level: DEBUG
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
esp32_ble:
|
||||
io_capability: ${io}
|
||||
auth_req_mode: ${auth}
|
||||
|
||||
esp32_ble_server:
|
||||
id: srv
|
||||
on_connect:
|
||||
- logger.log: "SRV client connected"
|
||||
on_disconnect:
|
||||
- logger.log: "SRV client disconnected"
|
||||
on_numeric_comparison_request:
|
||||
- logger.log:
|
||||
format: "SRV numeric comparison %06u"
|
||||
args: ["(unsigned) passkey"]
|
||||
- ble_server.numeric_comparison_reply:
|
||||
id: srv
|
||||
address: !lambda return address;
|
||||
accept: true
|
||||
services:
|
||||
- uuid: "180F"
|
||||
characteristics:
|
||||
- uuid: "2A19"
|
||||
read: true
|
||||
read_encrypt: true
|
||||
value:
|
||||
data: "99.9"
|
||||
- uuid: 5ec50000-0000-4000-8000-00000000f000
|
||||
characteristics:
|
||||
- uuid: 5ec50000-0000-4000-8000-00000000f001
|
||||
read: true
|
||||
value:
|
||||
data: "open"
|
||||
- uuid: 5ec50000-0000-4000-8000-00000000f002
|
||||
write: true
|
||||
write_encrypt: true
|
||||
on_write:
|
||||
- lambda: 'ESP_LOGI("SRV", "secure write received: %s", std::string(x.begin(), x.end()).c_str());'
|
||||
- uuid: 5ec50000-0000-4000-8000-00000000f004
|
||||
read: true
|
||||
read_encrypt_mitm: true
|
||||
value:
|
||||
data: "mitm"
|
||||
- uuid: 5ec50000-0000-4000-8000-00000000f003
|
||||
id: secure_notify
|
||||
read: true
|
||||
read_encrypt: true
|
||||
notify: true
|
||||
value:
|
||||
data: "n0"
|
||||
|
||||
interval:
|
||||
- interval: 2s
|
||||
then:
|
||||
- lambda: |-
|
||||
static int n = 0;
|
||||
char buf[12];
|
||||
snprintf(buf, sizeof(buf), "n%d", ++n);
|
||||
id(secure_notify)->set_value((const uint8_t *) buf, strlen(buf));
|
||||
- ble_server.characteristic.notify:
|
||||
id: secure_notify
|
||||
@@ -0,0 +1,80 @@
|
||||
"""Judge one run.sh run from the client log (drive.py output) and the server's serial capture.
|
||||
|
||||
usage: summary.py MODE CLIENT_LOG SERVER_CAPTURE MODE: jw (Just Works) or nc (numeric comparison, MITM)
|
||||
Before the first Pair: the encrypted and MITM reads must each be tried and refused (an `Error reading char` reply),
|
||||
no notification may arrive and no encrypted write may reach the server. After it: the encrypted read returns 99.9,
|
||||
exactly one write (the paired one) reaches the server, the second Subscribe brings notifications, and the MITM-only
|
||||
characteristic is readable only after an nc pairing. Prints the reconnect pattern and PASS or FAIL.
|
||||
"""
|
||||
|
||||
import pathlib
|
||||
import re
|
||||
import sys
|
||||
|
||||
MODE = sys.argv[1]
|
||||
cli = pathlib.Path(sys.argv[2]).read_text(encoding="utf-8").splitlines()
|
||||
srv = re.sub(
|
||||
r"\x1b\[[0-9;]*m",
|
||||
"",
|
||||
pathlib.Path(sys.argv[3]).read_bytes().decode(errors="replace"),
|
||||
)
|
||||
pair_at = next((i for i, line in enumerate(cli) if "PRESS Pair" in line), None)
|
||||
if pair_at is None:
|
||||
sys.exit("FAIL: no Pair step in the client log")
|
||||
before, after = cli[:pair_at], cli[pair_at:]
|
||||
subs = [i for i, line in enumerate(after) if "PRESS Subscribe" in line]
|
||||
after_sub = after[subs[0] :] if subs else []
|
||||
|
||||
|
||||
def count(lines: list[str], pat: str) -> int:
|
||||
return sum(1 for line in lines if re.search(pat, line))
|
||||
|
||||
|
||||
def outcome(lines: list[str], button: str, ok_pat: str) -> str:
|
||||
"""'ok', 'refused' or 'none' for the first press of BUTTON.
|
||||
|
||||
The window runs to the next read, pair or connection step, since a reply can come after a write press. A value
|
||||
wins over an error line: the error can belong to another characteristic read in the same window.
|
||||
"""
|
||||
start = next((i for i, line in enumerate(lines) if f"PRESS {button}" in line), None)
|
||||
if start is None:
|
||||
return "none"
|
||||
window = []
|
||||
for line in lines[start + 1 :]:
|
||||
if re.search(r"PRESS (Read|Pair|Disconnect|Connect|Subscribe|Remove)", line):
|
||||
break
|
||||
window.append(line)
|
||||
if any(re.search(ok_pat, line) for line in window):
|
||||
return "ok"
|
||||
return "refused" if any("Error reading char" in line for line in window) else "none"
|
||||
|
||||
|
||||
secure_before = outcome(before, "Read secure", r"secure read: 9")
|
||||
mitm_before = outcome(before, "Read mitm", r"mitm read: m")
|
||||
mitm_after = outcome(after, "Read mitm", r"mitm read: m")
|
||||
writes = srv.count("secure write received")
|
||||
checks = {
|
||||
f"encrypted read refused before pairing ({secure_before})": secure_before
|
||||
== "refused",
|
||||
f"MITM read refused before pairing ({mitm_before})": mitm_before == "refused",
|
||||
"no notifications before pairing": count(before, r"notification: n") == 0,
|
||||
"encrypted read after pairing": outcome(after, "Read secure", r"secure read: 99\.9")
|
||||
== "ok",
|
||||
# one Write secure press before Pair (must be refused) and one after it
|
||||
f"only the paired write reached the server ({writes})": writes == 1,
|
||||
"notifications after subscribing paired": count(after_sub, r"notification: n") > 0,
|
||||
}
|
||||
if MODE == "nc":
|
||||
checks[f"MITM read after nc pairing ({mitm_after})"] = mitm_after == "ok"
|
||||
else:
|
||||
checks[f"MITM read still refused after Just Works ({mitm_after})"] = (
|
||||
mitm_after == "refused"
|
||||
)
|
||||
for name, ok in checks.items():
|
||||
print(f"{'ok ' if ok else 'FAIL'} {name}")
|
||||
print(
|
||||
f"server: {srv.count('Authentication complete')} authentications, {srv.count('SRV numeric comparison')} numeric "
|
||||
f"comparisons, {srv.count('Deleting unpaired device')} bonds dropped by the stack"
|
||||
)
|
||||
print("PASS" if all(checks.values()) else "FAIL")
|
||||
sys.exit(0 if all(checks.values()) else 1)
|
||||
@@ -0,0 +1,45 @@
|
||||
# Classic ESP32 devkit: RTC pins 25 26 27 32 33 and digital pins 19 21 22 23, three rounds 5 s after boot.
|
||||
esphome:
|
||||
name: gpio-hold-esp32
|
||||
includes:
|
||||
- hold_test.hpp
|
||||
on_boot:
|
||||
priority: -100
|
||||
then:
|
||||
- delay: 5s
|
||||
- lambda: |-
|
||||
static const int pins[] = {25, 26, 27, 32, 33, 19, 21, 22, 23};
|
||||
for (int r = 1; r <= 3; r++) holdtest::run(pins, sizeof(pins) / sizeof(pins[0]), r);
|
||||
|
||||
esp32:
|
||||
board: esp32dev
|
||||
framework:
|
||||
type: esp-idf
|
||||
|
||||
logger:
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
# Turns on USE_GPIO_HOLD.
|
||||
output:
|
||||
- platform: gpio
|
||||
id: held_out
|
||||
pin:
|
||||
number: GPIO4
|
||||
hold_state: true
|
||||
|
||||
button:
|
||||
- platform: template
|
||||
name: rerun
|
||||
on_press:
|
||||
- lambda: |-
|
||||
static const int pins[] = {25, 26, 27, 32, 33, 19, 21, 22, 23};
|
||||
holdtest::run(pins, sizeof(pins) / sizeof(pins[0]), 9);
|
||||
@@ -0,0 +1,41 @@
|
||||
# Waveshare ESP32-S3-ETH: RTC pins 16 17 and digital pin 43 are free; a round every 15 s.
|
||||
esphome:
|
||||
name: gpio-hold-esp32s3
|
||||
includes:
|
||||
- hold_test.hpp
|
||||
|
||||
esp32:
|
||||
board: esp32-s3-devkitc-1
|
||||
variant: esp32s3
|
||||
flash_size: 16MB
|
||||
framework:
|
||||
type: esp-idf
|
||||
|
||||
logger:
|
||||
hardware_uart: USB_SERIAL_JTAG
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
# Turns on USE_GPIO_HOLD.
|
||||
output:
|
||||
- platform: gpio
|
||||
id: held_out
|
||||
pin:
|
||||
number: GPIO44
|
||||
hold_state: true
|
||||
|
||||
interval:
|
||||
- interval: 15s
|
||||
then:
|
||||
- lambda: |-
|
||||
static int round = 0;
|
||||
static const int pins[] = {16, 17, 43};
|
||||
holdtest::run(pins, sizeof(pins) / sizeof(pins[0]), ++round);
|
||||
@@ -0,0 +1,93 @@
|
||||
#pragma once
|
||||
#include "esphome/components/esp32/gpio.h"
|
||||
#include "esphome/core/log.h"
|
||||
#include <driver/gpio.h>
|
||||
#include <driver/rtc_io.h>
|
||||
|
||||
// Drives held pads through the ISR pin API and reads the pad back.
|
||||
namespace holdtest {
|
||||
using esphome::esp32::ESP32InternalGPIOPin;
|
||||
namespace gpio = esphome::gpio;
|
||||
static const char *const TAG = "holdtest";
|
||||
|
||||
// One pin and one ISR argument block per GPIO and hold setting, made on first use and reused by later rounds,
|
||||
// so a test that repeats forever does not use up the heap.
|
||||
struct PinPair {
|
||||
ESP32InternalGPIOPin *pin{nullptr};
|
||||
esphome::ISRInternalGPIOPin isr;
|
||||
};
|
||||
static PinPair pairs[2][GPIO_NUM_MAX];
|
||||
|
||||
static PinPair &get(int num, bool hold) {
|
||||
PinPair &pp = pairs[hold][num];
|
||||
if (pp.pin == nullptr) {
|
||||
pp.pin = new ESP32InternalGPIOPin(); // NOLINT
|
||||
pp.pin->set_pin(static_cast<gpio_num_t>(num));
|
||||
pp.pin->set_flags(gpio::FLAG_INPUT | gpio::FLAG_OUTPUT | (hold ? gpio::FLAG_HOLD : gpio::FLAG_NONE));
|
||||
pp.isr = pp.pin->to_isr();
|
||||
}
|
||||
pp.pin->setup(); // the previous round left the pad unheld with no mode
|
||||
return pp;
|
||||
}
|
||||
|
||||
static int lvl(int num) {
|
||||
esphome::delayMicroseconds(50);
|
||||
return gpio_get_level(static_cast<gpio_num_t>(num));
|
||||
}
|
||||
|
||||
// Returns failures for one pin.
|
||||
static int run_pin(int num, bool hold) {
|
||||
int fail = 0;
|
||||
auto &isr = get(num, hold).isr;
|
||||
isr.pin_mode(gpio::FLAG_INPUT | gpio::FLAG_OUTPUT);
|
||||
int wr_ok = 0;
|
||||
for (int i = 0; i < 20; i++) {
|
||||
bool v = i & 1;
|
||||
isr.digital_write(v);
|
||||
if (lvl(num) == (int) v) {
|
||||
wr_ok++;
|
||||
} else {
|
||||
fail++;
|
||||
}
|
||||
}
|
||||
// Control: a raw register write without a hold refresh must not reach a held pad.
|
||||
int before = lvl(num);
|
||||
gpio_set_level(static_cast<gpio_num_t>(num), !before);
|
||||
int ctrl = lvl(num);
|
||||
bool ctrl_ok = hold ? (ctrl == before) : (ctrl != before);
|
||||
if (!ctrl_ok)
|
||||
fail++;
|
||||
isr.digital_write(before); // back in sync
|
||||
|
||||
// Pulls through the ISR pin_mode: input must toggle in the flags diff to apply them.
|
||||
int pd1, pu, pd2;
|
||||
isr.pin_mode(gpio::FLAG_NONE);
|
||||
isr.pin_mode(gpio::FLAG_INPUT | gpio::FLAG_PULLDOWN);
|
||||
pd1 = lvl(num);
|
||||
isr.pin_mode(gpio::FLAG_NONE);
|
||||
isr.pin_mode(gpio::FLAG_INPUT | gpio::FLAG_PULLUP);
|
||||
pu = lvl(num);
|
||||
isr.pin_mode(gpio::FLAG_NONE);
|
||||
isr.pin_mode(gpio::FLAG_INPUT | gpio::FLAG_PULLDOWN);
|
||||
pd2 = lvl(num);
|
||||
if (pd1 != 0 || pu != 1 || pd2 != 0)
|
||||
fail++;
|
||||
ESP_LOGI(TAG, "GPIO%d hold=%d rtc=%d write %d/20 control %s pulls pd=%d pu=%d pd=%d -> %s", num, hold,
|
||||
(int) rtc_gpio_is_valid_gpio(static_cast<gpio_num_t>(num)), wr_ok, ctrl_ok ? "ok" : "BAD", pd1, pu, pd2,
|
||||
fail ? "FAIL" : "PASS");
|
||||
// Leave the pad free for the next run.
|
||||
if (hold)
|
||||
gpio_hold_dis(static_cast<gpio_num_t>(num));
|
||||
isr.pin_mode(gpio::FLAG_NONE);
|
||||
return fail;
|
||||
}
|
||||
|
||||
static void run(const int *pins, int n, int round) {
|
||||
int fail = 0;
|
||||
for (int i = 0; i < n; i++) {
|
||||
fail += run_pin(pins[i], true);
|
||||
fail += run_pin(pins[i], false);
|
||||
}
|
||||
ESP_LOGI(TAG, "ROUND %d %s failures=%d", round, fail ? "FAIL" : "PASS", fail);
|
||||
}
|
||||
} // namespace holdtest
|
||||
@@ -0,0 +1,127 @@
|
||||
"""Time the presence hold on stream-harness.yaml and check presence_timeout survives a restart.
|
||||
|
||||
usage: holddrive.py HOST OUT env: API_KEY (when the harness has one)
|
||||
For timeouts 5 and 0: target frames for 3 s, then empty frames; prints the ms from the "mode none" press to the
|
||||
has_target off line (up to one 100 ms frame of that is the harness). Then sets 0 and 20, restarts, reads the number.
|
||||
A missing press line, off line or number state prints NO-DATA and the run exits 1.
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
import os
|
||||
import pathlib
|
||||
import re
|
||||
import sys
|
||||
|
||||
from aioesphomeapi import APIClient, ButtonInfo, LogLevel, NumberInfo, NumberState
|
||||
|
||||
HOST, OUT = sys.argv[1], sys.argv[2]
|
||||
LOG = pathlib.Path(OUT).open("w", encoding="utf-8") # noqa: SIM115 open for the whole run
|
||||
MISSING = []
|
||||
|
||||
|
||||
def note(s: str) -> None:
|
||||
print(s)
|
||||
LOG.write(s + "\n")
|
||||
LOG.flush()
|
||||
|
||||
|
||||
async def session():
|
||||
c = APIClient(HOST, 6053, None, noise_psk=os.environ.get("API_KEY"))
|
||||
for attempt in range(60):
|
||||
try:
|
||||
await c.connect(login=True)
|
||||
break
|
||||
except Exception as err: # noqa: BLE001
|
||||
last_err = err
|
||||
note(f"connect attempt {attempt + 1} failed: {err!r}")
|
||||
await asyncio.sleep(2)
|
||||
else:
|
||||
raise last_err
|
||||
ents, _ = await c.list_entities_services()
|
||||
btn = {e.name: e.key for e in ents if isinstance(e, ButtonInfo)}
|
||||
num = next(
|
||||
e.key
|
||||
for e in ents
|
||||
if isinstance(e, NumberInfo) and e.name == "Presence Timeout"
|
||||
)
|
||||
st, lines = {}, []
|
||||
|
||||
def on_state(s) -> None:
|
||||
if isinstance(s, NumberState) and s.key == num:
|
||||
st["t"] = s.state
|
||||
|
||||
def on_log(m) -> None:
|
||||
t = re.sub(r"\x1b\[[0-9;]*m", "", m.message.decode(errors="replace"))
|
||||
if "harness" in t:
|
||||
lines.append(t)
|
||||
LOG.write("LOG " + t + "\n")
|
||||
|
||||
c.subscribe_states(on_state)
|
||||
c.subscribe_logs(on_log, log_level=LogLevel.LOG_LEVEL_DEBUG)
|
||||
for _ in range(20):
|
||||
await asyncio.sleep(1)
|
||||
if "t" in st:
|
||||
break
|
||||
# a freshly booted ESP8266 delays API commands that arrive too early
|
||||
await asyncio.sleep(8)
|
||||
return c, btn, num, st, lines
|
||||
|
||||
|
||||
def first_ms(lines: list[str], pat: str) -> int | None:
|
||||
for line in lines:
|
||||
if m := re.search(pat + r" at (\d+)", line):
|
||||
return int(m.group(1))
|
||||
return None
|
||||
|
||||
|
||||
def number(st: dict, what: str) -> str:
|
||||
if "t" not in st:
|
||||
MISSING.append(what)
|
||||
return "NO-DATA"
|
||||
return f"{st['t']:g}"
|
||||
|
||||
|
||||
async def hold(c, btn, num, st, lines, timeout: int) -> None:
|
||||
c.number_command(num, timeout)
|
||||
await asyncio.sleep(2)
|
||||
if st.get("t") != timeout:
|
||||
# dev snaps 0 back to the saved value; the hold is then timed with what the number reads
|
||||
note(f"HOLD timeout={timeout}: the number reads {st.get('t')}, timing that")
|
||||
c.button_command(btn["Mode target"])
|
||||
await asyncio.sleep(3)
|
||||
lines.clear() # only this run's press and off lines count
|
||||
c.button_command(btn["Mode none"])
|
||||
await asyncio.sleep(timeout + 8)
|
||||
start, off = first_ms(lines, "mode none"), first_ms(lines, "presence raw OFF")
|
||||
if start is None or off is None or off < start:
|
||||
MISSING.append(f"hold {timeout}")
|
||||
note(f"HOLD timeout={timeout}: NO-DATA (press line {start}, off line {off})")
|
||||
else:
|
||||
note(
|
||||
f"HOLD timeout={timeout}: off {off - start} ms after the last target frame"
|
||||
)
|
||||
|
||||
|
||||
async def main() -> None:
|
||||
c, btn, num, st, lines = await session()
|
||||
note(f"START number {number(st, 'start')}")
|
||||
for t in (5, 0):
|
||||
await hold(c, btn, num, st, lines, t)
|
||||
for t in (0, 20):
|
||||
st.pop("t", None)
|
||||
c.number_command(num, t)
|
||||
await asyncio.sleep(2)
|
||||
note(f"SET {t}, number reads {number(st, f'set {t}')}")
|
||||
c.button_command(btn["Restart"])
|
||||
await asyncio.sleep(1)
|
||||
await c.disconnect()
|
||||
await asyncio.sleep(15)
|
||||
c, btn, num, st, lines = await session()
|
||||
note(f"AFTER RESTART number reads {number(st, f'restart {t}')}")
|
||||
await c.disconnect()
|
||||
if MISSING:
|
||||
note(f"NO-DATA for: {', '.join(MISSING)}")
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
asyncio.run(main())
|
||||
@@ -0,0 +1,82 @@
|
||||
"""Step stream-harness.yaml through frames, silence, garbage and radar restarts; print every state change.
|
||||
|
||||
usage: linkdrive.py HOST OUT env: API_KEY (when the harness has one)
|
||||
Lines are seconds since start: PRESS steps, STATE changes of the ld2450 entities (unknown when missing), and LOG lines
|
||||
about the link or ld2450 warnings.
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
import math
|
||||
import os
|
||||
import pathlib
|
||||
import re
|
||||
import sys
|
||||
import time
|
||||
|
||||
from aioesphomeapi import APIClient, ButtonInfo, LogLevel
|
||||
|
||||
HOST, OUT = sys.argv[1], sys.argv[2]
|
||||
LOG = pathlib.Path(OUT).open("w", encoding="utf-8") # noqa: SIM115 open for the whole run
|
||||
T0 = time.time()
|
||||
STEPS = [
|
||||
("Mode none", 8), ("Mode target", 6), ("Mode silent", 10), ("Mode none", 4), ("Mode target", 4),
|
||||
("Mode garbage", 10), ("Mode target", 5),
|
||||
("Radar Restart", 0.3), ("Mode silent", 3.5), ("Mode target", 6),
|
||||
("Radar Restart", 0.3), ("Mode silent", 15), ("Mode none", 4),
|
||||
] # fmt: skip
|
||||
|
||||
|
||||
def note(s: str) -> None:
|
||||
line = f"{time.time() - T0:7.2f} {s}"
|
||||
print(line)
|
||||
LOG.write(line + "\n")
|
||||
LOG.flush()
|
||||
|
||||
|
||||
async def main() -> None:
|
||||
c = APIClient(HOST, 6053, None, noise_psk=os.environ.get("API_KEY"))
|
||||
await c.connect(login=True)
|
||||
ents, _ = await c.list_entities_services()
|
||||
names = {e.key: e.name for e in ents}
|
||||
btn = {e.name: e.key for e in ents if isinstance(e, ButtonInfo)}
|
||||
last = {}
|
||||
# state changes after the first step; the burst at connect does not count
|
||||
stepped, changes = [False], [0]
|
||||
|
||||
def on_state(s) -> None:
|
||||
n = names.get(s.key)
|
||||
if n is None or n in btn:
|
||||
return
|
||||
v = (
|
||||
"unknown"
|
||||
if getattr(s, "missing_state", False)
|
||||
else getattr(s, "state", None)
|
||||
)
|
||||
if isinstance(v, float):
|
||||
v = "unknown (nan)" if math.isnan(v) else round(v, 1)
|
||||
if last.get(n) != v:
|
||||
last[n] = v
|
||||
changes[0] += stepped[0]
|
||||
note(f"STATE {n} = {v}")
|
||||
|
||||
def on_log(m) -> None:
|
||||
t = re.sub(r"\x1b\[[0-9;]*m", "", m.message.decode(errors="replace"))
|
||||
if re.search(r"[Ll]ink|\[W\]\[ld2450", t):
|
||||
note("LOG " + t.strip())
|
||||
|
||||
c.subscribe_states(on_state)
|
||||
c.subscribe_logs(on_log, log_level=LogLevel.LOG_LEVEL_DEBUG)
|
||||
await asyncio.sleep(3)
|
||||
stepped[0] = True
|
||||
for name, wait in STEPS:
|
||||
note(f"PRESS {name}")
|
||||
c.button_command(btn[name])
|
||||
await asyncio.sleep(wait)
|
||||
await c.disconnect()
|
||||
# dev freezes entities during silence but still updates them on target frames; nothing at all is a dead stream
|
||||
if not changes[0]:
|
||||
note("NO-DATA: no entity changed state after the first step")
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
asyncio.run(main())
|
||||
@@ -0,0 +1,82 @@
|
||||
"""Read the LD24xx BT MAC text sensors, turn every LD24xx Bluetooth switch off, then on again.
|
||||
|
||||
usage: macdrive.py HOST OUT env: API_KEY (when the device has one)
|
||||
Works on any device whose MAC, Bluetooth and firmware entities have those words in their names (the BT MAC sensors
|
||||
may be disabled by default; they still publish over the API). Quote at most the first MAC byte in a PR.
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
import os
|
||||
import pathlib
|
||||
import sys
|
||||
import time
|
||||
|
||||
from aioesphomeapi import APIClient, SwitchInfo, TextSensorInfo
|
||||
|
||||
HOST, OUT = sys.argv[1], sys.argv[2]
|
||||
LOG = pathlib.Path(OUT).open("w", encoding="utf-8") # noqa: SIM115 open for the whole run
|
||||
|
||||
|
||||
def note(s: str) -> None:
|
||||
line = f"{time.strftime('%H:%M:%S')} {s}"
|
||||
print(line)
|
||||
LOG.write(line + "\n")
|
||||
LOG.flush()
|
||||
|
||||
|
||||
async def main() -> None:
|
||||
c = APIClient(HOST, 6053, None, noise_psk=os.environ.get("API_KEY"))
|
||||
await c.connect(login=True)
|
||||
ents, _ = await c.list_entities_services()
|
||||
keys = {
|
||||
e.key: e.name
|
||||
for e in ents
|
||||
if isinstance(e, (SwitchInfo, TextSensorInfo))
|
||||
and any(w in e.name for w in ("MAC", "Bluetooth", "Firmware"))
|
||||
}
|
||||
states = {}
|
||||
|
||||
def on_state(s) -> None:
|
||||
if s.key in keys and states.get(keys[s.key]) != getattr(s, "state", None):
|
||||
states[keys[s.key]] = s.state
|
||||
note(f"STATE {keys[s.key]} = {s.state}")
|
||||
|
||||
c.subscribe_states(on_state)
|
||||
await asyncio.sleep(8)
|
||||
switches = {
|
||||
e.name: e.key
|
||||
for e in ents
|
||||
if isinstance(e, SwitchInfo) and "Bluetooth" in e.name
|
||||
}
|
||||
macs = [n for n in keys.values() if "MAC" in n]
|
||||
if not macs or not switches:
|
||||
note(
|
||||
f"FAIL: need a MAC text sensor and a Bluetooth switch, found {sorted(keys.values())}"
|
||||
)
|
||||
sys.exit(1)
|
||||
missing = []
|
||||
if silent := [n for n in sorted(keys.values()) if n not in states]:
|
||||
note(f"NO-DATA after 8 s: {', '.join(silent)}")
|
||||
missing += silent
|
||||
note(
|
||||
"SNAP start: "
|
||||
+ "; ".join(f"{n}={states.get(n)}" for n in sorted(keys.values()))
|
||||
)
|
||||
for phase, on in (("off", False), ("on", True)):
|
||||
for name, key in switches.items():
|
||||
note(f"SET {name} {phase}")
|
||||
c.switch_command(key, on)
|
||||
await asyncio.sleep(1)
|
||||
await asyncio.sleep(20)
|
||||
note(
|
||||
f"SNAP bluetooth {phase}: "
|
||||
+ "; ".join(f"{n}={states.get(n)}" for n in sorted(keys.values()))
|
||||
)
|
||||
missing += [n for n in switches if states.get(n) is not True]
|
||||
await c.disconnect()
|
||||
if missing:
|
||||
note(f"NO-DATA for: {', '.join(sorted(set(missing)))}")
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
asyncio.run(main())
|
||||
@@ -0,0 +1,5 @@
|
||||
binary_sensor:
|
||||
- platform: ld2450
|
||||
ld2450_id: radar
|
||||
connected:
|
||||
name: Connected
|
||||
@@ -0,0 +1,128 @@
|
||||
# D1 mini, ld2450 on UART0 looped back onto itself, fed one periodic frame every 100 ms from a mode global:
|
||||
# 0 no target, 1 target 1 approaching, 2 silent, 3 garbage bytes (what a radar at another baud rate looks like).
|
||||
# Add `connected: !include stream-connected.yaml` under packages on builds whose ld2450 has the link watchdog.
|
||||
substitutions:
|
||||
name: ld2450-stream
|
||||
|
||||
esphome:
|
||||
name: ${name}
|
||||
on_boot:
|
||||
priority: -100
|
||||
then:
|
||||
- lambda: |-
|
||||
// UART0 TX looped back into its own RX so injected frames reach the hub
|
||||
USC0(0) |= (1 << UCLBE);
|
||||
ESP_LOGI("harness", "UART0 loopback on");
|
||||
|
||||
esp8266:
|
||||
board: d1_mini
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
logger:
|
||||
baud_rate: 0
|
||||
level: DEBUG
|
||||
|
||||
uart:
|
||||
id: radar_uart
|
||||
tx_pin: GPIO1
|
||||
rx_pin: GPIO3
|
||||
baud_rate: 256000
|
||||
|
||||
ld2450:
|
||||
id: radar
|
||||
uart_id: radar_uart
|
||||
|
||||
globals:
|
||||
- id: mode
|
||||
type: int
|
||||
initial_value: "0"
|
||||
|
||||
interval:
|
||||
- interval: 100ms
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: return id(mode) == 1;
|
||||
then:
|
||||
- uart.write:
|
||||
id: radar_uart
|
||||
data: [0xAA, 0xFF, 0x03, 0x00, 0x00, 0x00, 0xE8, 0x83, 0x14, 0x00, 0x64, 0x00,
|
||||
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
||||
0x00, 0x00, 0x00, 0x00, 0x55, 0xCC]
|
||||
- if:
|
||||
condition:
|
||||
lambda: return id(mode) == 0;
|
||||
then:
|
||||
- uart.write:
|
||||
id: radar_uart
|
||||
data: [0xAA, 0xFF, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
||||
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
|
||||
0x00, 0x00, 0x00, 0x00, 0x55, 0xCC]
|
||||
- if:
|
||||
condition:
|
||||
lambda: return id(mode) == 3;
|
||||
then:
|
||||
- uart.write:
|
||||
id: radar_uart
|
||||
data: [0x3F, 0x80, 0xF8, 0x00, 0x7E, 0x07, 0xC0, 0x1F, 0xE0, 0x03, 0xF0, 0x0F]
|
||||
|
||||
binary_sensor:
|
||||
- platform: ld2450
|
||||
has_target:
|
||||
name: Has Target
|
||||
# no settle filter, so the hub's own presence hold is what gets timed
|
||||
filters: []
|
||||
on_state:
|
||||
- lambda: 'ESP_LOGI("harness", "presence raw %s at %u", x ? "ON" : "OFF", (unsigned) millis());'
|
||||
|
||||
sensor:
|
||||
- platform: ld2450
|
||||
target_count:
|
||||
name: Target Count
|
||||
target_1:
|
||||
x:
|
||||
name: T1 X
|
||||
|
||||
text_sensor:
|
||||
- platform: ld2450
|
||||
target_1:
|
||||
direction:
|
||||
name: T1 Direction
|
||||
|
||||
number:
|
||||
- platform: ld2450
|
||||
presence_timeout:
|
||||
name: Presence Timeout
|
||||
|
||||
button:
|
||||
- platform: template
|
||||
name: Mode none
|
||||
on_press:
|
||||
- lambda: 'id(mode) = 0; ESP_LOGI("harness", "mode none at %u", (unsigned) millis());'
|
||||
- platform: template
|
||||
name: Mode target
|
||||
on_press:
|
||||
- lambda: 'id(mode) = 1; ESP_LOGI("harness", "mode target at %u", (unsigned) millis());'
|
||||
- platform: template
|
||||
name: Mode silent
|
||||
on_press:
|
||||
- lambda: 'id(mode) = 2; ESP_LOGI("harness", "mode silent at %u", (unsigned) millis());'
|
||||
- platform: template
|
||||
name: Mode garbage
|
||||
on_press:
|
||||
- lambda: 'id(mode) = 3; ESP_LOGI("harness", "mode garbage at %u", (unsigned) millis());'
|
||||
- platform: ld2450
|
||||
ld2450_id: radar
|
||||
restart:
|
||||
name: Radar Restart
|
||||
- platform: restart
|
||||
name: Restart
|
||||
@@ -0,0 +1,81 @@
|
||||
"""Match each RTL8720C ROM fault dump in a serial capture with the report on the next boot.
|
||||
|
||||
usage: rtl_rom_vs_report.py SERIAL_CAPTURE (taken with serial_capture.py --ms)
|
||||
Per ROM dump: the ROM's CFSR and PC, ms from the dump to the next `ROM Version` banner, and the Reason, CFSR, PC and SP
|
||||
the next boot reported. The ROM lines start with a bare CR, so the capture is split on newlines only.
|
||||
"""
|
||||
|
||||
import pathlib
|
||||
import re
|
||||
import sys
|
||||
|
||||
RAW = pathlib.Path(sys.argv[1]).read_bytes().decode(errors="replace")
|
||||
LINES = [
|
||||
re.sub(r"\x1b\[[0-9;]*m", "", line) for line in RAW.replace("\r", "").split("\n")
|
||||
]
|
||||
|
||||
|
||||
def stamp(line: str) -> float | None:
|
||||
"""Seconds since midnight from a serial_capture.py --ms timestamp."""
|
||||
m = re.search(r"\[(\d\d):(\d\d):(\d\d\.\d{3})\]", line)
|
||||
return (
|
||||
int(m.group(1)) * 3600 + int(m.group(2)) * 60 + float(m.group(3)) if m else None
|
||||
)
|
||||
|
||||
|
||||
if not any(stamp(line) is not None for line in LINES):
|
||||
sys.exit(
|
||||
"NO-DATA: no [HH:MM:SS.mmm] timestamps; take the capture with serial_capture.py --ms"
|
||||
)
|
||||
dumps = bad = 0
|
||||
i = 0
|
||||
while i < len(LINES):
|
||||
if "Fault Handler:" not in LINES[i]:
|
||||
i += 1
|
||||
continue
|
||||
t0 = stamp(LINES[i])
|
||||
kind = LINES[i + 2].split("]", 1)[-1].strip() if i + 2 < len(LINES) else "?"
|
||||
cfsr = pc = None
|
||||
j = i
|
||||
while j < len(LINES) and "ROM Version" not in LINES[j]:
|
||||
if cfsr is None and "Configurable Fault Status Reg" in LINES[j]:
|
||||
cfsr = LINES[j].split("=")[1].strip()
|
||||
if pc is None and "PC =" in LINES[j]:
|
||||
pc = LINES[j].split("=")[1].strip()
|
||||
j += 1
|
||||
tj = next(
|
||||
(
|
||||
stamp(LINES[x])
|
||||
for x in range(j, min(j + 5, len(LINES)))
|
||||
if stamp(LINES[x]) is not None
|
||||
),
|
||||
None,
|
||||
)
|
||||
reset = (
|
||||
f"{(tj - t0) * 1000:.0f} ms"
|
||||
if tj is not None and t0 is not None
|
||||
else "no reset seen"
|
||||
)
|
||||
report = {}
|
||||
k = j + 1
|
||||
while (
|
||||
k < len(LINES)
|
||||
and "Fault Handler:" not in LINES[k]
|
||||
and "boot reason" not in LINES[k]
|
||||
):
|
||||
m = re.search(r"(Reason|CFSR|PC|SP):\s+(.*)", LINES[k])
|
||||
if m and "libretiny.crash" in LINES[k]:
|
||||
report.setdefault(m.group(1), m.group(2).split(" (")[0].strip())
|
||||
k += 1
|
||||
dumps += 1
|
||||
missing = [
|
||||
n for n, v in (("ROM CFSR", cfsr), ("ROM PC", pc), ("reset", tj)) if v is None
|
||||
]
|
||||
missing += [k for k in ("Reason", "CFSR", "PC", "SP") if k not in report]
|
||||
bad += bool(missing)
|
||||
flag = f" | MISSING {', '.join(missing)}" if missing else ""
|
||||
print(f"{kind:18} ROM CFSR {cfsr} PC {pc} | reset {reset} | report {report}{flag}")
|
||||
i = j
|
||||
if not dumps:
|
||||
sys.exit("NO-DATA: no ROM fault dump in the capture")
|
||||
sys.exit(1 if bad else 0)
|
||||
@@ -0,0 +1,40 @@
|
||||
# Any ESP32-C3 with GPIO10 free; drop ESPHome ledc outputs, the C3 shares one LEDC clock across timers.
|
||||
esphome:
|
||||
name: wake-probe-esp32c3
|
||||
includes:
|
||||
- wake_probe.hpp
|
||||
on_boot:
|
||||
priority: -100
|
||||
then:
|
||||
- lambda: wakeprobe::start();
|
||||
|
||||
esp32:
|
||||
board: esp32-c3-devkitm-1
|
||||
variant: esp32c3
|
||||
framework:
|
||||
type: esp-idf
|
||||
advanced:
|
||||
include_builtin_idf_components:
|
||||
- esp_driver_ledc
|
||||
|
||||
logger:
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
power_management:
|
||||
- platform: esp32_power_management
|
||||
enable_light_sleep: true
|
||||
profiling: true
|
||||
|
||||
interval:
|
||||
- interval: 30s
|
||||
then:
|
||||
- lambda: wakeprobe::report();
|
||||
@@ -0,0 +1,110 @@
|
||||
#pragma once
|
||||
// LEDC on an RC_FAST clock keeps toggling GPIO10 in light sleep; an ESP32InternalGPIOPin interrupt on the same pad
|
||||
// timestamps every edge.
|
||||
#include <cstdio>
|
||||
#include "driver/ledc.h"
|
||||
#include "driver/gpio.h"
|
||||
#include "esp_pm.h"
|
||||
#include "esp_timer.h"
|
||||
#include "esphome/components/esp32/gpio.h"
|
||||
#include "esphome/core/log.h"
|
||||
|
||||
namespace wakeprobe {
|
||||
static const char *const TAG = "wakeprobe";
|
||||
static constexpr gpio_num_t PIN = GPIO_NUM_10;
|
||||
static volatile uint32_t edges = 0;
|
||||
static volatile int64_t last_us = 0;
|
||||
static volatile int64_t gap_min = INT64_MAX, gap_max = 0;
|
||||
static volatile uint32_t late_edges = 0; // gap more than 20 ms off the half period
|
||||
static int64_t start_us = 0;
|
||||
static uint32_t half_period_us = 0;
|
||||
static uint32_t freq = 0;
|
||||
static esp_err_t err_timer = ESP_OK, err_channel = ESP_OK;
|
||||
|
||||
static void IRAM_ATTR on_edge(void *) {
|
||||
int64_t now = esp_timer_get_time();
|
||||
if (last_us != 0) {
|
||||
int64_t gap = now - last_us;
|
||||
if (gap < gap_min)
|
||||
gap_min = gap;
|
||||
if (gap > gap_max)
|
||||
gap_max = gap;
|
||||
int64_t off = gap - (int64_t) half_period_us;
|
||||
if (off > 20000 || off < -20000)
|
||||
late_edges = late_edges + 1;
|
||||
}
|
||||
last_us = now;
|
||||
edges = edges + 1;
|
||||
}
|
||||
|
||||
inline void start() {
|
||||
auto *pin = new esphome::esp32::ESP32InternalGPIOPin(); // NOLINT
|
||||
pin->set_pin(PIN);
|
||||
pin->set_flags(esphome::gpio::FLAG_INPUT);
|
||||
pin->setup();
|
||||
pin->attach_interrupt(on_edge, (void *) nullptr, esphome::gpio::INTERRUPT_ANY_EDGE);
|
||||
ledc_timer_config_t t{};
|
||||
t.speed_mode = LEDC_LOW_SPEED_MODE;
|
||||
t.duty_resolution = LEDC_TIMER_14_BIT;
|
||||
t.timer_num = LEDC_TIMER_0;
|
||||
t.freq_hz = 2;
|
||||
t.clk_cfg = LEDC_USE_RC_FAST_CLK;
|
||||
esp_err_t e1 = err_timer = ledc_timer_config(&t);
|
||||
ledc_channel_config_t c{};
|
||||
c.gpio_num = PIN;
|
||||
c.speed_mode = LEDC_LOW_SPEED_MODE;
|
||||
c.channel = LEDC_CHANNEL_0;
|
||||
c.timer_sel = LEDC_TIMER_0;
|
||||
c.duty = 1 << 13;
|
||||
c.sleep_mode = LEDC_SLEEP_MODE_KEEP_ALIVE;
|
||||
esp_err_t e2 = err_channel = ledc_channel_config(&c);
|
||||
// ledc_channel_config makes the pad output only; turn its input back on so the interrupt sees the wave.
|
||||
gpio_input_enable(PIN);
|
||||
freq = ledc_get_freq(LEDC_LOW_SPEED_MODE, LEDC_TIMER_0);
|
||||
half_period_us = freq ? 500000 / freq : 0;
|
||||
start_us = esp_timer_get_time();
|
||||
ESP_LOGI(TAG, "LEDC timer=%s channel=%s freq=%u Hz half period %u us", esp_err_to_name(e1), esp_err_to_name(e2),
|
||||
(unsigned) freq, (unsigned) half_period_us);
|
||||
}
|
||||
|
||||
inline void report() {
|
||||
if (start_us == 0)
|
||||
return;
|
||||
char lv[21];
|
||||
for (int i = 0; i < 20; i++) {
|
||||
lv[i] = gpio_get_level(PIN) ? '1' : '0';
|
||||
vTaskDelay(pdMS_TO_TICKS(50));
|
||||
}
|
||||
lv[20] = 0;
|
||||
// Elapsed time and edge count are read together, after the 1 s level loop, so they describe the same interval.
|
||||
float secs = (esp_timer_get_time() - start_us) / 1e6f;
|
||||
uint32_t seen = edges;
|
||||
ESP_LOGI(TAG, "LEDC timer=%s channel=%s freq=%u, level over 1 s: %s", esp_err_to_name(err_timer),
|
||||
esp_err_to_name(err_channel), (unsigned) freq, lv);
|
||||
ESP_LOGI(TAG, "%.0f s: edges=%u expected=%.0f gap min=%lld max=%lld us, off by >20 ms: %u", secs, (unsigned) seen,
|
||||
secs * 2 * freq, (long long) gap_min, (long long) gap_max, (unsigned) late_edges);
|
||||
#ifdef CONFIG_PM_PROFILING
|
||||
static char buf[1024];
|
||||
FILE *f = fmemopen(buf, sizeof(buf) - 1, "w");
|
||||
if (f == nullptr) {
|
||||
ESP_LOGW(TAG, "pm dump failed: fmemopen");
|
||||
return;
|
||||
}
|
||||
esp_pm_dump_locks(f);
|
||||
long n = ftell(f);
|
||||
fclose(f);
|
||||
buf[n < 0 ? 0 : n] = 0;
|
||||
bool sleep_seen = false;
|
||||
for (char *line = strtok(buf, "\n"); line != nullptr; line = strtok(nullptr, "\n")) {
|
||||
if (strstr(line, "SLEEP") || strstr(line, "CPU_MAX") || strstr(line, "APB_MAX") || strstr(line, "APB_MIN")) {
|
||||
sleep_seen = sleep_seen || strstr(line, "SLEEP") != nullptr;
|
||||
ESP_LOGI(TAG, "pm %s", line);
|
||||
}
|
||||
}
|
||||
if (!sleep_seen)
|
||||
ESP_LOGW(TAG, "pm dump has no SLEEP line (%ld bytes, buffer %u)", n, (unsigned) sizeof(buf));
|
||||
#else
|
||||
ESP_LOGW(TAG, "pm profiling unavailable: set power_management profiling: true");
|
||||
#endif
|
||||
}
|
||||
} // namespace wakeprobe
|
||||
@@ -0,0 +1,36 @@
|
||||
# AP manual IP: the only network is missing, so the fallback AP starts after 10 s on 10.42.7.1.
|
||||
substitutions:
|
||||
name: mip-ap
|
||||
plat: esp32
|
||||
|
||||
esphome:
|
||||
name: ${name}
|
||||
|
||||
packages:
|
||||
plat: !include plat-${plat}.yaml
|
||||
|
||||
logger:
|
||||
level: VERBOSE
|
||||
logs:
|
||||
scheduler: DEBUG
|
||||
component: DEBUG
|
||||
|
||||
wifi:
|
||||
networks:
|
||||
- ssid: mip-nowhere
|
||||
password: nowhere123
|
||||
manual_ip:
|
||||
static_ip: 10.9.9.9
|
||||
gateway: 10.9.9.1
|
||||
subnet: 255.255.255.0
|
||||
dns1: 10.9.9.1
|
||||
ap:
|
||||
ssid: mip-ap-test
|
||||
password: mipaptest1
|
||||
ap_timeout: 10s
|
||||
manual_ip:
|
||||
static_ip: 10.42.7.1
|
||||
gateway: 10.42.7.1
|
||||
subnet: 255.255.255.0
|
||||
|
||||
captive_portal:
|
||||
@@ -0,0 +1,36 @@
|
||||
# Joins the DUT's AP and fetches its page every 10 s.
|
||||
substitutions:
|
||||
name: mip-client
|
||||
plat: esp32
|
||||
|
||||
esphome:
|
||||
name: ${name}
|
||||
|
||||
packages:
|
||||
plat: !include plat-${plat}.yaml
|
||||
|
||||
logger:
|
||||
|
||||
wifi:
|
||||
ssid: mip-ap-test
|
||||
password: mipaptest1
|
||||
reboot_timeout: 0s
|
||||
|
||||
http_request:
|
||||
verify_ssl: false
|
||||
|
||||
interval:
|
||||
- interval: 10s
|
||||
then:
|
||||
- if:
|
||||
condition: wifi.connected
|
||||
then:
|
||||
- http_request.get:
|
||||
url: http://10.42.7.1/
|
||||
capture_response: false
|
||||
on_response:
|
||||
then:
|
||||
- lambda: ESP_LOGI("client", "GET http://10.42.7.1/ status=%d", response->status_code);
|
||||
on_error:
|
||||
then:
|
||||
- logger.log: "GET http://10.42.7.1/ failed"
|
||||
@@ -0,0 +1,32 @@
|
||||
#pragma once
|
||||
#include "esphome/core/log.h"
|
||||
#include "lwip/dns.h"
|
||||
#include "lwip/ip_addr.h"
|
||||
#ifdef USE_ESP8266
|
||||
#include <ESP8266WiFi.h>
|
||||
#else
|
||||
#include "lwip/netdb.h"
|
||||
#include "lwip/inet.h"
|
||||
#endif
|
||||
inline void dns_probe() {
|
||||
char b0[IPADDR_STRLEN_MAX], b1[IPADDR_STRLEN_MAX], res[16] = "-";
|
||||
ipaddr_ntoa_r(dns_getserver(0), b0, sizeof(b0));
|
||||
ipaddr_ntoa_r(dns_getserver(1), b1, sizeof(b1));
|
||||
int ok;
|
||||
#ifdef USE_ESP8266
|
||||
IPAddress ip;
|
||||
ok = WiFi.hostByName("pool.ntp.org", ip);
|
||||
if (ok)
|
||||
strncpy(res, ip.toString().c_str(), sizeof(res) - 1);
|
||||
#else
|
||||
struct addrinfo hints{};
|
||||
hints.ai_family = AF_INET;
|
||||
struct addrinfo *r = nullptr;
|
||||
ok = lwip_getaddrinfo("pool.ntp.org", nullptr, &hints, &r) == 0 && r != nullptr;
|
||||
if (ok) {
|
||||
inet_ntoa_r(((struct sockaddr_in *) r->ai_addr)->sin_addr, res, sizeof(res));
|
||||
lwip_freeaddrinfo(r);
|
||||
}
|
||||
#endif
|
||||
ESP_LOGI("dnsprobe", "dns0=%s dns1=%s lookup=%s %s", b0, b1, ok ? "ok" : "FAIL", res);
|
||||
}
|
||||
@@ -0,0 +1,4 @@
|
||||
esp32:
|
||||
board: esp32dev
|
||||
framework:
|
||||
type: esp-idf
|
||||
@@ -0,0 +1,2 @@
|
||||
esp8266:
|
||||
board: d1_mini
|
||||
@@ -0,0 +1,30 @@
|
||||
#!/bin/bash
|
||||
# usage: run-ap.sh LABEL the DUT runs the fallback AP on 10.42.7.1, the other board joins it and fetches its page
|
||||
# Copy this directory into a scratch directory and run it there; no secrets are needed.
|
||||
# env: TREE (esphome checkout for the DUT), CLIENT_TREE (checkout for the client, default TREE), DUT_PORT, DUT_PLAT,
|
||||
# CLIENT_PORT, CLIENT_PLAT (esp32 or esp8266), SC (path to serial_capture.py), PY (default $TREE/venv/bin/python)
|
||||
D=$(cd "$(dirname "$0")" && pwd); L=${1:?label}; T=${TREE:?set TREE}; CT=${CLIENT_TREE:-$T}
|
||||
PY=${PY:-$T/venv/bin/python}; SC=${SC:?set SC}; DP=${DUT_PORT:?set DUT_PORT}; CP=${CLIENT_PORT:?set CLIENT_PORT}
|
||||
N=mip-ap-$L; CN=mip-client
|
||||
up() { (cd "$1" && PYTHONUNBUFFERED=1 timeout 1500 $PY -m esphome -s name "$2" -s plat "$3" run --no-logs "$D/$4" \
|
||||
--device "$5" > "$D/$2-upload.log" 2>&1) || { echo "FAIL: $2 build or upload"; exit 1; }; }
|
||||
up "$T" "$N" "${DUT_PLAT:-esp32}" ap.yaml "$DP"
|
||||
up "$CT" "$CN" "${CLIENT_PLAT:-esp8266}" client.yaml "$CP"
|
||||
rm -f "$D/$N-serial.txt" "$D/$CN-$N-serial.txt"
|
||||
$PY "$SC" "$DP" 120 "$D/$N-serial.txt" --reset > /dev/null 2>&1 & C1=$!
|
||||
$PY "$SC" "$CP" 120 "$D/$CN-$N-serial.txt" --reset > /dev/null 2>&1 & C2=$!
|
||||
wait $C1; R1=$?; wait $C2; R2=$?
|
||||
strip() { LC_ALL=C sed 's/\x1b\[[0-9;]*m//g' | sort -u -k2; }
|
||||
echo "--- DUT"; LC_ALL=C grep -a -E "Manual IP|Starting fallback|IP Address|Setting up AP|rst cause|Guru|abort|panic" \
|
||||
"$D/$N-serial.txt" | strip | head -8
|
||||
echo "--- client"; LC_ALL=C grep -a -E "IP Address:|Gateway:|Subnet:" "$D/$CN-$N-serial.txt" | strip | head -4
|
||||
ok=$(grep -a -c 'status=200' "$D/$CN-$N-serial.txt"); bad=$(grep -a -c 'GET http://10.42.7.1/ failed' "$D/$CN-$N-serial.txt")
|
||||
echo "client GET ok=$ok failed=$bad"
|
||||
fail=0
|
||||
[ "$R1" = 0 ] && [ -s "$D/$N-serial.txt" ] || { echo "FAIL: DUT capture failed or empty (rc $R1)"; fail=1; }
|
||||
[ "$R2" = 0 ] && [ -s "$D/$CN-$N-serial.txt" ] || { echo "FAIL: client capture failed or empty (rc $R2)"; fail=1; }
|
||||
grep -a -q -E "IP Address: +10\.42\.7\.1\b" "$D/$N-serial.txt" || { echo "FAIL: AP address is not 10.42.7.1"; fail=1; }
|
||||
grep -a -q -E "IP Address: +10\.42\.7\." "$D/$CN-$N-serial.txt" || { echo "FAIL: client never joined"; fail=1; }
|
||||
[ "$ok" -gt 0 ] || { echo "FAIL: no page fetched"; fail=1; }
|
||||
grep -a -q -E "Guru|abort\(\)|panic|[eE]xception \(|Soft WDT reset|wdt reset" "$D/$N-serial.txt" && { echo "FAIL: DUT crash"; fail=1; }
|
||||
[ $fail = 0 ] && echo PASS; exit $fail
|
||||
@@ -0,0 +1,24 @@
|
||||
#!/bin/bash
|
||||
# usage: run-sta.sh LABEL flash sta.yaml, capture 75 s, ping the manual address, check the dump and the DNS probe
|
||||
# Copy this directory into a scratch directory with a secrets.yaml (wifi_ssid, wifi_password) and run it there.
|
||||
# env: TREE (esphome checkout), PORT (board serial port), PLAT (esp32 or esp8266), IP (the board's own DHCP lease),
|
||||
# GATEWAY, SUBNET, DNS1 (the network's values), SC (path to serial_capture.py), PY (default $TREE/venv/bin/python)
|
||||
D=$(cd "$(dirname "$0")" && pwd); L=${1:?label}; T=${TREE:?set TREE}; PY=${PY:-$T/venv/bin/python}
|
||||
P=${PORT:?set PORT}; IP=${IP:?set IP}; SC=${SC:?set SC}; N=mip-sta-$L; C=$D/$N-serial.txt
|
||||
(cd "$T" && PYTHONUNBUFFERED=1 timeout 1500 $PY -m esphome -s name "$N" -s plat "${PLAT:-esp32}" -s ip "$IP" \
|
||||
-s gateway "${GATEWAY:?set GATEWAY}" -s subnet "${SUBNET:?set SUBNET}" -s dns1 "${DNS1:?set DNS1}" \
|
||||
run --no-logs "$D/sta.yaml" --device "$P" > "$D/$N-upload.log" 2>&1) || { echo "FAIL: build or upload"; exit 1; }
|
||||
rm -f "$C"
|
||||
$PY "$SC" "$P" 75 "$C" --reset > /dev/null 2>&1 & CAP=$!
|
||||
# ping exits 0 when at least one reply came back, on macOS and Linux alike.
|
||||
sleep 50; PING=$(ping -c 10 -i 0.3 "$IP" 2>&1); PING_RC=$?; wait $CAP; CAPRC=$?
|
||||
LC_ALL=C grep -a -E "Manual IP|IP Address:|Gateway:|Subnet:|DNS1:|DNS2:|dnsprobe|rst cause|Guru|abort|panic" "$C" \
|
||||
| LC_ALL=C sed 's/\x1b\[[0-9;]*m//g' | sort -u -k2 | head -14
|
||||
echo "ping: $(echo "$PING" | grep -E 'transmitted')"
|
||||
fail=0
|
||||
[ "$CAPRC" = 0 ] && [ -s "$C" ] || { echo "FAIL: serial capture failed or empty (rc $CAPRC)"; fail=1; }
|
||||
grep -a -q -E "dns0=$DNS1 dns1=9\.9\.9\.9 lookup=ok" "$C" || { echo "FAIL: DNS servers or lookup"; fail=1; }
|
||||
grep -a -q -E "IP Address: +$IP\b" "$C" || { echo "FAIL: address is not $IP"; fail=1; }
|
||||
[ $PING_RC = 0 ] || { echo "FAIL: no ping reply"; fail=1; }
|
||||
grep -a -q -E "Guru|abort\(\)|panic|[eE]xception \(|Soft WDT reset|wdt reset" "$C" && { echo "FAIL: crash"; fail=1; }
|
||||
[ $fail = 0 ] && echo PASS; exit $fail
|
||||
@@ -0,0 +1,62 @@
|
||||
# Station manual IP. The real network is the second table row and inherits the top level manual_ip; set ip to the
|
||||
# board's own DHCP lease and dns2 to a server DHCP does not hand out, so the logs prove the manual values are used.
|
||||
# run-sta.sh passes name, plat, ip, gateway, subnet and dns1 with -s; dns2 stays 9.9.9.9, which it checks for.
|
||||
substitutions:
|
||||
name: mip-sta
|
||||
plat: esp32
|
||||
ip: 192.168.1.50
|
||||
gateway: 192.168.1.1
|
||||
subnet: 255.255.255.0
|
||||
dns1: 192.168.1.1
|
||||
dns2: 9.9.9.9
|
||||
|
||||
esphome:
|
||||
name: ${name}
|
||||
includes:
|
||||
- dnsprobe.hpp
|
||||
|
||||
packages:
|
||||
plat: !include plat-${plat}.yaml
|
||||
|
||||
logger:
|
||||
level: VERBOSE
|
||||
logs:
|
||||
scheduler: DEBUG
|
||||
component: DEBUG
|
||||
api.service: DEBUG
|
||||
api.connection: DEBUG
|
||||
api.socket: DEBUG
|
||||
socket: DEBUG
|
||||
mdns: DEBUG
|
||||
|
||||
wifi:
|
||||
manual_ip:
|
||||
static_ip: ${ip}
|
||||
gateway: ${gateway}
|
||||
subnet: ${subnet}
|
||||
dns1: ${dns1}
|
||||
dns2: ${dns2}
|
||||
networks:
|
||||
- ssid: mip-nowhere
|
||||
password: nowhere123
|
||||
manual_ip:
|
||||
static_ip: 10.9.9.9
|
||||
gateway: 10.9.9.1
|
||||
subnet: 255.255.255.0
|
||||
dns1: 10.9.9.1
|
||||
- ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
interval:
|
||||
- interval: 20s
|
||||
then:
|
||||
- if:
|
||||
condition: wifi.connected
|
||||
then:
|
||||
- lambda: dns_probe();
|
||||
@@ -0,0 +1,90 @@
|
||||
"""Print the date, time and datetime rows of /metrics, set new values over the API, print them again.
|
||||
|
||||
usage: datetime_metrics.py HOST env: API_KEY
|
||||
Sets every date to 2040-03-04, every time to 23:59:59 and every datetime to 2040-03-04 05:06:07 UTC (past 2038 on
|
||||
purpose). Values are printed with their UTC reading: dates are local midnight, times are ms since midnight and
|
||||
datetimes are ms since the epoch. Exits 1 when a time or datetime row does not hold the value that was set.
|
||||
"""
|
||||
|
||||
import asyncio
|
||||
from datetime import UTC, datetime
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
import urllib.request
|
||||
|
||||
from aioesphomeapi import APIClient, DateInfo, DateTimeInfo, TimeInfo
|
||||
|
||||
HOST = sys.argv[1]
|
||||
|
||||
|
||||
def metrics(tag: str) -> dict[tuple[str, str], int]:
|
||||
with urllib.request.urlopen(f"http://{HOST}/metrics", timeout=10) as resp: # noqa: S310
|
||||
body = resp.read().decode()
|
||||
rows = [
|
||||
line
|
||||
for line in body.splitlines()
|
||||
if re.match(r"esphome_(date|time|datetime)_", line)
|
||||
]
|
||||
print(f"--- {tag}: {len(rows)} rows")
|
||||
parsed: dict[tuple[str, str], int] = {}
|
||||
for line in rows:
|
||||
m = re.match(r'(esphome_\w+)\{.*name="([^"]+)"\} (-?\d+)$', line)
|
||||
if not m:
|
||||
print(f" UNPARSED {line}")
|
||||
continue
|
||||
metric, name, value = m.group(1), m.group(2), int(m.group(3))
|
||||
parsed[(metric, name)] = value
|
||||
utc = ""
|
||||
if metric in ("esphome_date_value", "esphome_datetime_value"):
|
||||
utc = " = " + datetime.fromtimestamp(value / 1000, UTC).isoformat()
|
||||
print(f" {metric} {name} {value}{utc}")
|
||||
return parsed
|
||||
|
||||
|
||||
async def main() -> None:
|
||||
if not metrics("initial"):
|
||||
sys.exit(
|
||||
"NO-DATA: no date, time or datetime rows (a build without them, or no such entities)"
|
||||
)
|
||||
c = APIClient(HOST, 6053, None, noise_psk=os.environ.get("API_KEY"))
|
||||
await c.connect(login=True)
|
||||
ents, _ = await c.list_entities_services()
|
||||
sent = 0
|
||||
sent_per_metric = {"esphome_time_value": 0, "esphome_datetime_value": 0}
|
||||
for e in ents:
|
||||
sent += isinstance(e, (DateInfo, TimeInfo, DateTimeInfo))
|
||||
if isinstance(e, DateInfo):
|
||||
c.date_command(e.key, 2040, 3, 4)
|
||||
elif isinstance(e, TimeInfo):
|
||||
sent_per_metric["esphome_time_value"] += 1
|
||||
c.time_command(e.key, 23, 59, 59)
|
||||
elif isinstance(e, DateTimeInfo):
|
||||
sent_per_metric["esphome_datetime_value"] += 1
|
||||
c.datetime_command(
|
||||
e.key, int(datetime(2040, 3, 4, 5, 6, 7, tzinfo=UTC).timestamp())
|
||||
)
|
||||
await asyncio.sleep(2)
|
||||
await c.disconnect()
|
||||
if not sent:
|
||||
sys.exit("NO-DATA: the device lists no date, time or datetime entities")
|
||||
after = metrics("after setting 2040-03-04, 23:59:59 and 2040-03-04 05:06:07 UTC")
|
||||
if not after:
|
||||
sys.exit("NO-DATA: no rows after setting the values")
|
||||
# dates are local midnight, so their value depends on the device's time zone and is only printed
|
||||
want = {"esphome_time_value": 86399000, "esphome_datetime_value": 2214450367000}
|
||||
wrong = [
|
||||
f"{metric} {name} {value} (want {want[metric]})"
|
||||
for (metric, name), value in after.items()
|
||||
if metric in want and value != want[metric]
|
||||
]
|
||||
# a time or datetime row that is missing or UNPARSED after the set is a failure too
|
||||
for metric, n in sent_per_metric.items():
|
||||
if (got := sum(m == metric for m, _ in after)) < n:
|
||||
wrong.append(f"{metric}: {got} parsed rows for {n} entities set")
|
||||
for line in wrong:
|
||||
print(f" WRONG {line}")
|
||||
sys.exit(1 if wrong else 0)
|
||||
|
||||
|
||||
asyncio.run(main())
|
||||
@@ -0,0 +1,10 @@
|
||||
# Adds a device time zone (UTC-10, no DST) to prom-datetime.yaml; the zone applies without a time sync.
|
||||
substitutions:
|
||||
name: prom-datetime-tz
|
||||
|
||||
packages:
|
||||
base: !include prom-datetime.yaml
|
||||
|
||||
time:
|
||||
- platform: sntp
|
||||
timezone: HST10
|
||||
@@ -0,0 +1,46 @@
|
||||
# D1 mini with three optimistic template datetime entities. -s name NAME; build prom-datetime-tz.yaml for a time zone.
|
||||
substitutions:
|
||||
name: prom-datetime
|
||||
|
||||
esphome:
|
||||
name: ${name}
|
||||
|
||||
esp8266:
|
||||
board: d1_mini
|
||||
|
||||
logger:
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
web_server:
|
||||
port: 80
|
||||
|
||||
datetime:
|
||||
- platform: template
|
||||
name: Date
|
||||
id: test_date
|
||||
type: date
|
||||
optimistic: true
|
||||
initial_value: "2000-1-2"
|
||||
- platform: template
|
||||
name: Time
|
||||
id: test_time
|
||||
type: time
|
||||
optimistic: true
|
||||
initial_value: "12:34:56am"
|
||||
- platform: template
|
||||
name: DateTime
|
||||
id: test_datetime
|
||||
type: datetime
|
||||
optimistic: true
|
||||
initial_value: "2000-1-2 12:34:56"
|
||||
|
||||
prometheus:
|
||||
@@ -0,0 +1,6 @@
|
||||
captive_portal:
|
||||
button:
|
||||
- platform: template
|
||||
name: Start portal
|
||||
on_press:
|
||||
- lambda: captive_portal::global_captive_portal->start();
|
||||
@@ -0,0 +1,4 @@
|
||||
esp32:
|
||||
board: esp32dev
|
||||
framework:
|
||||
type: esp-idf
|
||||
@@ -0,0 +1,2 @@
|
||||
esp8266:
|
||||
board: d1_mini
|
||||
@@ -0,0 +1,18 @@
|
||||
#pragma once
|
||||
// A handler registered after setup(), the way an external component would; answers GET /probe.
|
||||
#include "esphome/components/web_server_base/web_server_base.h"
|
||||
class ProbeHandler : public AsyncWebHandler {
|
||||
public:
|
||||
bool canHandle(AsyncWebServerRequest *request) const override {
|
||||
if (request->method() != HTTP_GET)
|
||||
return false;
|
||||
#ifdef USE_ESP32
|
||||
char url_buf[AsyncWebServerRequest::URL_BUF_SIZE];
|
||||
return request->url_to(url_buf) == "/probe";
|
||||
#else
|
||||
return request->url() == ESPHOME_F("/probe");
|
||||
#endif
|
||||
}
|
||||
void handleRequest(AsyncWebServerRequest *request) override { request->send(200, "text/plain", "probe-ok"); }
|
||||
};
|
||||
inline ProbeHandler probe_handler;
|
||||
@@ -0,0 +1,2 @@
|
||||
captive_portal:
|
||||
prometheus:
|
||||
@@ -0,0 +1,65 @@
|
||||
#!/bin/bash
|
||||
# usage: run.sh LABEL VARIANT flash webbase.yaml, fetch /probe and /, then a web OTA of the same image
|
||||
# Copy this directory into a scratch directory with a secrets.yaml (wifi_ssid, wifi_password) and run it there.
|
||||
# VARIANT is ws, cp or prom (see webbase.yaml). The cp variant presses "Start portal" over the API first.
|
||||
# env: TREE (esphome checkout), PORT (board serial port), PLAT (esp32 or esp8266), IP (the board's address),
|
||||
# SC (path to serial_capture.py), PY (default $TREE/venv/bin/python), SKILL_SCRIPTS (the skill's scripts directory)
|
||||
D=$(cd "$(dirname "$0")" && pwd); L=${1:?label}; V=${2:?variant}; T=${TREE:?set TREE}; PY=${PY:-$T/venv/bin/python}
|
||||
P=${PORT:?set PORT}; IP=${IP:?set IP}; SC=${SC:?set SC}; PL=${PLAT:-esp32}; N=web-$V-$PL-$L; C=$D/$N-serial.txt
|
||||
# api_button.py and ota_timing/apiinfo.py live in the skill's scripts directory; set SKILL_SCRIPTS when this
|
||||
# directory was copied elsewhere.
|
||||
S=${SKILL_SCRIPTS:-$(cd "$D/.." && pwd)}
|
||||
[ -f "$S/api_button.py" ] && [ -f "$S/ota_timing/apiinfo.py" ] || { echo "FAIL: set SKILL_SCRIPTS to the skill's scripts directory"; exit 1; }
|
||||
if [ "$PL" = esp32 ]; then BIN=$D/.esphome/build/$N/build/$N.bin; else BIN=$D/.esphome/build/$N/.pioenvs/$N/firmware.bin; fi
|
||||
(cd "$T" && PYTHONUNBUFFERED=1 timeout 1500 $PY -m esphome -s name "$N" -s plat "$PL" -s variant "$V" \
|
||||
run --no-logs "$D/webbase.yaml" --device "$P" > "$D/$N-upload.log" 2>&1) || { echo "FAIL: build or upload"; exit 1; }
|
||||
rm -f "$C"
|
||||
# Longer than the worst case below: 80 s to come up, 120 s of OTA, 80 s to come back.
|
||||
$PY "$SC" "$P" 300 "$C" --reset > /dev/null 2>&1 & CAP=$!
|
||||
# Wait on the API port: in the cp variant the HTTP server only starts when the portal does, also after the OTA reboot.
|
||||
up() {
|
||||
for _ in $(seq 1 40); do
|
||||
$PY -c 'import socket, sys; socket.create_connection((sys.argv[1], 6053), 1).close()' "$IP" 2> /dev/null && return 0
|
||||
sleep 2
|
||||
done
|
||||
return 1
|
||||
}
|
||||
up || { echo "FAIL: board not reachable"; kill $CAP; exit 1; }; sleep 8
|
||||
fail=0
|
||||
if [ "$V" = cp ]; then
|
||||
$PY "$S/api_button.py" "$IP" - press "Start portal" || { echo "FAIL: Start portal press"; fail=1; }
|
||||
sleep 2
|
||||
# The captive portal only answers /config.json while it is active.
|
||||
CFG=$(curl -s -m 10 -o /dev/null -w '%{http_code}' "http://$IP/config.json")
|
||||
echo "GET /config.json: $CFG"; [ "$CFG" = 200 ] || { echo "FAIL: captive portal not active"; fail=1; }
|
||||
fi
|
||||
PROBE=$(curl -s -m 10 -w ' %{http_code}' "http://$IP/probe")
|
||||
echo "GET /probe: $PROBE"
|
||||
ROOT=$(curl -s -m 10 -o /dev/null -w '%{http_code}' "http://$IP/")
|
||||
echo "GET /: $ROOT"
|
||||
# prometheus has no page at / (no answer on ESP32, 404 on ESP8266, on dev too)
|
||||
[ "$V" = prom ] || [ "$ROOT" = 200 ] || { echo "FAIL: GET /"; fail=1; }
|
||||
if [ "$V" = prom ]; then
|
||||
MET=$(curl -s -m 10 -o /dev/null -w '%{http_code}' "http://$IP/metrics")
|
||||
echo "GET /metrics: $MET"; [ "$MET" = 200 ] || { echo "FAIL: /metrics"; fail=1; }
|
||||
fi
|
||||
# A failed update also answers 200, with "Update Failed!" in the body.
|
||||
OTA=$(curl -s -m 120 -F "update=@$BIN" -w ' %{http_code}' "http://$IP/update" | tr -d '\r\n')
|
||||
echo "POST /update ($(wc -c < "$BIN" | tr -d ' ') B): $OTA"
|
||||
sleep 5
|
||||
if up; then
|
||||
sleep 6
|
||||
$PY "$S/ota_timing/apiinfo.py" "$IP=$D/.esphome/build/$N/build_info.json" 2>&1 | tail -1; API=${PIPESTATUS[0]}
|
||||
else
|
||||
echo "FAIL: board not back after the web OTA"; fail=1; API=1
|
||||
fi
|
||||
wait $CAP; CAPRC=$?
|
||||
[ "$CAPRC" = 0 ] && [ -s "$C" ] || { echo "FAIL: serial capture failed or empty (rc $CAPRC)"; fail=1; }
|
||||
[ "$PROBE" = "probe-ok 200" ] || { echo "FAIL: /probe"; fail=1; }
|
||||
case "$OTA" in *"Update Successful!"*" 200") ;; *) echo "FAIL: web OTA"; fail=1;; esac
|
||||
[ "$API" = 0 ] || { echo "FAIL: board not on the uploaded build after the web OTA"; fail=1; }
|
||||
# The image is the same build, so prove the reboot from the log: setup finishes again after the OTA reboot line.
|
||||
grep -a -q "Performing OTA reboot now" "$C" || { echo "FAIL: no OTA reboot in the serial log"; fail=1; }
|
||||
sed -n '/Performing OTA reboot now/,$p' "$C" | grep -a -q 'setup() finished' || { echo "FAIL: no boot after the OTA"; fail=1; }
|
||||
grep -a -q -E "Guru|abort\(\)|panic|[eE]xception \(|Soft WDT reset|wdt reset" "$C" && { echo "FAIL: crash"; fail=1; }
|
||||
[ $fail = 0 ] && echo PASS; exit $fail
|
||||
@@ -0,0 +1,36 @@
|
||||
# variant: ws (web_server), cp (captive_portal only, started from a button) or prom (captive_portal and prometheus).
|
||||
# A GET /probe handler is added after setup, the way an external component would.
|
||||
substitutions:
|
||||
name: web-handlers
|
||||
plat: esp32
|
||||
variant: ws
|
||||
|
||||
esphome:
|
||||
name: ${name}
|
||||
includes:
|
||||
- probehandler.hpp
|
||||
on_boot:
|
||||
priority: -100
|
||||
then:
|
||||
- lambda: |-
|
||||
web_server_base::global_web_server_base->add_handler(&probe_handler);
|
||||
ESP_LOGI("probe", "probe handler added after setup");
|
||||
|
||||
packages:
|
||||
plat: !include plat-${plat}.yaml
|
||||
variant: !include ${variant}.yaml
|
||||
|
||||
logger:
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
ap:
|
||||
password: webtest123
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
- platform: web_server
|
||||
@@ -0,0 +1,2 @@
|
||||
web_server:
|
||||
port: 80
|
||||
@@ -0,0 +1,50 @@
|
||||
# ESP32 (an S3 here) central: -s server <the address server.yaml logs>. Connects, drops the link 300 ms later,
|
||||
# and auto_connect reconnects as soon as the server advertises again.
|
||||
substitutions:
|
||||
# placeholder so `esphome logs` validates; build and upload with -s server <address>
|
||||
server: 00:00:00:00:00:00
|
||||
|
||||
esphome:
|
||||
name: zbsloop
|
||||
|
||||
esp32:
|
||||
board: esp32-s3-devkitc-1
|
||||
variant: esp32s3
|
||||
flash_size: 16MB
|
||||
framework:
|
||||
type: esp-idf
|
||||
|
||||
logger:
|
||||
hardware_uart: USB_SERIAL_JTAG
|
||||
|
||||
wifi:
|
||||
ssid: !secret wifi_ssid
|
||||
password: !secret wifi_password
|
||||
|
||||
api:
|
||||
reboot_timeout: 0s
|
||||
|
||||
ota:
|
||||
- platform: esphome
|
||||
|
||||
esp32_ble_tracker:
|
||||
|
||||
globals:
|
||||
- id: connects
|
||||
type: int
|
||||
initial_value: "0"
|
||||
|
||||
ble_client:
|
||||
- mac_address: ${server}
|
||||
id: cli
|
||||
on_connect:
|
||||
- lambda: 'id(connects)++; ESP_LOGI("loop", "CONNECT %d", id(connects));'
|
||||
- delay: 300ms
|
||||
- ble_client.disconnect: cli
|
||||
on_disconnect:
|
||||
- logger.log: "DISCONNECT"
|
||||
|
||||
interval:
|
||||
- interval: 10s
|
||||
then:
|
||||
- lambda: 'ESP_LOGI("loop", "connects so far %d", id(connects));'
|
||||
@@ -0,0 +1,39 @@
|
||||
#!/bin/bash
|
||||
# usage: run.sh NAME [SECONDS] flash NAME's UF2 (built from server.yaml) to the nRF52 board, then count connections
|
||||
# for SECONDS (default 90) while the client from client.yaml loops connect and disconnect against it.
|
||||
# Copy this directory into a scratch directory, build server.yaml there with -s name NAME, build and upload client.yaml
|
||||
# once with -s server <address>, and run it there.
|
||||
# env: NRF_SERIAL (the board's USB serial number, as ports.py prints it), TREE (esphome checkout for the client log),
|
||||
# CLIENT_HOST (client address), SC (path to serial_capture.py), PORTS (path to ports.py),
|
||||
# PY (default $TREE/venv/bin/python). Exits 0 PASS, 1 setup or capture failure, 2 no client, 3 FAIL.
|
||||
D=$(cd "$(dirname "$0")" && pwd); N=${1:?name}; T=${2:-90}; TR=${TREE:?set TREE}; PY=${PY:-$TR/venv/bin/python}
|
||||
SER=${NRF_SERIAL:?set NRF_SERIAL}; C=${CLIENT_HOST:?set CLIENT_HOST}; SC=${SC:?set SC}; PO=${PORTS:?set PORTS}
|
||||
UF2=$D/.esphome/build/$N/.pioenvs/$N/zephyr/zephyr.uf2
|
||||
[ -f "$UF2" ] || { echo "FAIL: build $N first (no $UF2)"; exit 1; }
|
||||
port() { $PY "$PO" | awk -v s="$SER" '$0 ~ s && !/239a:0051/ {print $1}' | head -1; }
|
||||
VOL=$(ls -d /Volumes/*BOOT 2>/dev/null | head -1)
|
||||
if [ -z "$VOL" ]; then
|
||||
# 1200 baud touch: only an app built with dfu: true answers it
|
||||
$PY -c "import serial,sys; s=serial.Serial(sys.argv[1], 1200); s.close()" "$(port)" 2>/dev/null
|
||||
for _ in $(seq 30); do VOL=$(ls -d /Volumes/*BOOT 2>/dev/null | head -1); [ -n "$VOL" ] && break; sleep 1; done
|
||||
fi
|
||||
[ -n "$VOL" ] || { echo "FAIL: no UF2 boot drive; double tap RESET on the board"; exit 1; }
|
||||
# the drive may belong to another board: this board's app port must be gone while it sits in its bootloader
|
||||
[ -z "$(port)" ] || { echo "FAIL: the board's app port is still up; is $VOL another board's bootloader?"; exit 1; }
|
||||
sleep 1
|
||||
cp "$UF2" "$VOL/" 2>/dev/null # the copy reports an I/O error when the board reboots, which is normal
|
||||
for _ in $(seq 30); do P=$(port); [ -n "$P" ] && break; sleep 1; done
|
||||
[ -n "$P" ] || { echo "FAIL: the app's USB port did not come back"; exit 1; }
|
||||
$PY "$SC" "$P" $((T + 10)) "$D/$N-server.txt" --ms > /dev/null 2>&1 & CAP=$!
|
||||
(cd "$TR" && timeout "$T" env PYTHONPATH="$TR" $PY -m esphome logs "$D/client.yaml" --device "$C" \
|
||||
> "$D/$N-client.txt" 2>&1)
|
||||
wait $CAP; CAPRC=$?
|
||||
[ "$CAPRC" = 0 ] && [ -s "$D/$N-server.txt" ] || { echo "FAIL: server capture failed or empty (rc $CAPRC)"; exit 1; }
|
||||
cnt() { LC_ALL=C grep -a -c "$1" "$2"; }
|
||||
CC=$(cnt 'CONNECT [0-9]' "$D/$N-client.txt"); SV=$(cnt 'zephyr_ble_server.*Connected' "$D/$N-server.txt")
|
||||
[ "$CC" -gt 0 ] || { echo "INVALID: the client log has no CONNECT line (client not running or not reachable)"; exit 2; }
|
||||
F=$D/$N-server.txt
|
||||
echo "$N: server connected $SV, disconnected $(cnt 'Disconnected from' "$F"), advertising started" \
|
||||
"$(cnt 'Advertising successfully' "$F"), advertising failed $(cnt 'Advertising failed' "$F"); client connects $CC"
|
||||
# a leaked connection slot shows as one connection and nothing after it
|
||||
if [ "$SV" -gt 1 ]; then echo PASS; else echo "FAIL: $SV server connections"; exit 3; fi
|
||||
@@ -0,0 +1,27 @@
|
||||
# Adafruit ItsyBitsy nRF52840 running zephyr_ble_server (one connection slot). -s name NAME.
|
||||
# dfu: true lets the 1200 baud touch enter the UF2 bootloader for the next flash; an app without it needs a
|
||||
# double tap on RESET. Logs its own BLE address every 10 s for the client config.
|
||||
esphome:
|
||||
name: ${name}
|
||||
|
||||
nrf52:
|
||||
board: adafruit_itsybitsy_nrf52840
|
||||
bootloader: adafruit_nrf52_sd140_v6
|
||||
dfu: true
|
||||
|
||||
logger:
|
||||
level: DEBUG
|
||||
|
||||
zephyr_ble_server:
|
||||
|
||||
interval:
|
||||
- interval: 10s
|
||||
then:
|
||||
- lambda: |-
|
||||
bt_addr_le_t addrs[1];
|
||||
size_t count = 1;
|
||||
bt_id_get(addrs, &count);
|
||||
char addr[BT_ADDR_LE_STR_LEN] = "?";
|
||||
if (count > 0)
|
||||
bt_addr_le_to_str(&addrs[0], addr, sizeof(addr));
|
||||
ESP_LOGI("alive", "up %u s, own address %s", (unsigned) (millis() / 1000), addr);
|
||||
@@ -1,4 +1,4 @@
|
||||
ARG BUILD_BASE_VERSION=2026.06.1
|
||||
ARG BUILD_BASE_VERSION=2026.11.0
|
||||
|
||||
|
||||
FROM ghcr.io/esphome/docker-base:debian-${BUILD_BASE_VERSION} AS base
|
||||
|
||||
@@ -45,7 +45,7 @@ runs:
|
||||
id: apt
|
||||
# Pinned on purpose and not watched by Dependabot: the step above relies on how this
|
||||
# release calls apt-fast and where it writes install.log.
|
||||
uses: awalsh128/cache-apt-pkgs-action@553a35bb8ebd9fcabcb1c9451aa4c98e1b4ca8a9 # v1.6.3
|
||||
uses: awalsh128/cache-apt-pkgs-action@v1.6.3
|
||||
with:
|
||||
packages: libsdl2-dev libmbedtls-dev ccache
|
||||
# 1.3 drops the empty caches saved before the step above existed
|
||||
|
||||
@@ -42,7 +42,7 @@ runs:
|
||||
|
||||
- name: Build and push to ghcr by digest
|
||||
id: build-ghcr
|
||||
uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
|
||||
uses: docker/build-push-action@v7.4.0
|
||||
env:
|
||||
DOCKER_BUILD_SUMMARY: false
|
||||
DOCKER_BUILD_RECORD_UPLOAD: false
|
||||
@@ -67,7 +67,7 @@ runs:
|
||||
|
||||
- name: Build and push to dockerhub by digest
|
||||
id: build-dockerhub
|
||||
uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7.4.0
|
||||
uses: docker/build-push-action@v7.4.0
|
||||
env:
|
||||
DOCKER_BUILD_SUMMARY: false
|
||||
DOCKER_BUILD_RECORD_UPLOAD: false
|
||||
|
||||
@@ -27,13 +27,13 @@ runs:
|
||||
echo "key=$key" >> "$GITHUB_OUTPUT"
|
||||
- name: Cache the native toolchain (write on dev)
|
||||
if: github.ref == 'refs/heads/dev'
|
||||
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache@v6.1.0
|
||||
with:
|
||||
path: ${{ env.ESPHOME_ARDUINO8266_PREFIX }}
|
||||
key: ${{ runner.os }}-esp8266-native-${{ steps.version.outputs.key }}
|
||||
- name: Restore the native toolchain (off dev)
|
||||
if: github.ref != 'refs/heads/dev'
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.ESPHOME_ARDUINO8266_PREFIX }}
|
||||
key: ${{ runner.os }}-esp8266-native-${{ steps.version.outputs.key }}
|
||||
@@ -38,13 +38,13 @@ runs:
|
||||
# Extend the extension list if a component ships extensionless headers.
|
||||
- name: Cache clang-tidy idedata (write on dev)
|
||||
if: (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write')) && steps.key.outputs.skip != 'true'
|
||||
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache@v6.1.0
|
||||
with:
|
||||
path: ${{ steps.key.outputs.path }}
|
||||
key: ${{ steps.key.outputs.key }}
|
||||
- name: Cache clang-tidy idedata (restore-only off dev)
|
||||
if: github.ref != 'refs/heads/dev' && !contains(github.event.pull_request.labels.*.name, 'ci-cache-write') && steps.key.outputs.skip != 'true'
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ steps.key.outputs.path }}
|
||||
key: ${{ steps.key.outputs.key }}
|
||||
@@ -49,13 +49,13 @@ runs:
|
||||
# -slim: bump when prune-esp-idf changes what it removes; a key is never overwritten.
|
||||
- name: Cache ESP-IDF install (write on dev)
|
||||
if: (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write')) && inputs.restore-only != 'true'
|
||||
uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
|
||||
uses: actions/cache@v5.0.5
|
||||
with:
|
||||
path: ~/.esphome-idf
|
||||
key: ${{ runner.os }}-esphome-idf-${{ steps.version.outputs.version }}-py${{ steps.version.outputs.python-version }}-slim
|
||||
- name: Cache ESP-IDF install (restore-only off dev)
|
||||
if: github.ref != 'refs/heads/dev' && !contains(github.event.pull_request.labels.*.name, 'ci-cache-write') || inputs.restore-only == 'true'
|
||||
uses: actions/cache/restore@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
|
||||
uses: actions/cache/restore@v5.0.5
|
||||
with:
|
||||
path: ~/.esphome-idf
|
||||
key: ${{ runner.os }}-esphome-idf-${{ steps.version.outputs.version }}-py${{ steps.version.outputs.python-version }}-slim
|
||||
@@ -67,4 +67,4 @@ runs:
|
||||
. venv/bin/activate
|
||||
python -c 'from esphome.espidf.framework import check_esp_idf_install; check_esp_idf_install("${{ steps.version.outputs.version }}")'
|
||||
- name: Prune ESP-IDF install
|
||||
uses: ./.github/actions/prune-esp-idf
|
||||
uses: $/.github/actions/prune-esp-idf
|
||||
@@ -35,14 +35,14 @@ runs:
|
||||
# restore-only and never push multi-GB artifacts into their own scope.
|
||||
- name: Cache nRF Connect SDK install (write on dev)
|
||||
if: github.ref == 'refs/heads/dev' && inputs.restore-only != 'true'
|
||||
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache@v6.1.0
|
||||
with:
|
||||
path: ~/.esphome-sdk-nrf
|
||||
# yamllint disable-line rule:line-length
|
||||
key: ${{ runner.os }}-esphome-sdk-nrf-${{ steps.version.outputs.version }}-${{ hashFiles('esphome/components/nrf52/requirements.txt') }}
|
||||
- name: Cache nRF Connect SDK install (restore-only off dev)
|
||||
if: github.ref != 'refs/heads/dev' || inputs.restore-only == 'true'
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ~/.esphome-sdk-nrf
|
||||
# yamllint disable-line rule:line-length
|
||||
|
||||
@@ -17,12 +17,12 @@ runs:
|
||||
steps:
|
||||
- name: Set up Python ${{ inputs.python-version }}
|
||||
id: python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: ${{ inputs.python-version }}
|
||||
- name: Restore Python virtual environment
|
||||
id: cache-venv
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: venv
|
||||
# yamllint disable-line rule:line-length
|
||||
@@ -32,7 +32,7 @@ runs:
|
||||
# detects the activated venv via ``VIRTUAL_ENV`` so the venv layout
|
||||
# downstream jobs rely on is preserved.
|
||||
if: steps.cache-venv.outputs.cache-hit != 'true'
|
||||
uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
|
||||
uses: astral-sh/setup-uv@v10.3.3
|
||||
with:
|
||||
enable-cache: true
|
||||
# Pull request saves land in per-PR scopes nothing else can
|
||||
|
||||
@@ -0,0 +1,232 @@
|
||||
# This file is machine-generated by `gh actions-lock`.
|
||||
# Do not edit by hand; run `gh actions-lock` to update.
|
||||
# Docs: https://gh.io/actions-lockfile
|
||||
version: 'v0.0.3'
|
||||
workflows:
|
||||
'.github/workflows/auto-label-pr.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/ci-api-proto.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'actions/upload-artifact@v7.0.2'
|
||||
- 'astral-sh/setup-uv@v10.3.3'
|
||||
'.github/workflows/ci-docker.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/download-artifact@v8.0.2'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'actions/upload-artifact@v7.0.2'
|
||||
- 'docker/login-action@v4.7.0'
|
||||
- 'docker/setup-buildx-action@v4.4.1'
|
||||
'.github/workflows/ci-github-scripts.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
'.github/workflows/ci-memory-impact-comment.yml':
|
||||
- 'actions/cache@v6.1.0'
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'astral-sh/setup-uv@v10.3.3'
|
||||
'.github/workflows/ci.yml':
|
||||
- 'actions/cache@v5.0.5'
|
||||
- 'actions/cache@v6.1.0'
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/download-artifact@v8.0.2'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'actions/upload-artifact@v7.0.2'
|
||||
- 'astral-sh/setup-uv@v10.3.3'
|
||||
- 'awalsh128/cache-apt-pkgs-action@v1.6.3'
|
||||
- 'codecov/codecov-action@v7.1.1'
|
||||
- 'codspeedhq/action@v5.6.1'
|
||||
- 'j178/prek-action@v3.1.0'
|
||||
- 'pre-commit-ci/lite-action@v1.2.0'
|
||||
'.github/workflows/close-pr-from-fork-default-branch.yml':
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/codeowner-approved-label-update.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/codeowner-review-request.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/codeql.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'github/codeql-action@v4.39.1'
|
||||
'.github/workflows/external-component-bot.yml':
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/issue-codeowner-notify.yml':
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/lock.yml': []
|
||||
'.github/workflows/pr-title-check.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/release-nightly.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
'.github/workflows/release.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/download-artifact@v8.0.2'
|
||||
- 'actions/github-script@v9.0.0'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'actions/upload-artifact@v7.0.2'
|
||||
- 'docker/build-push-action@v7.4.0'
|
||||
- 'docker/login-action@v4.7.0'
|
||||
- 'docker/setup-buildx-action@v4.4.1'
|
||||
- 'pypa/gh-action-pypi-publish@v1.14.3'
|
||||
'.github/workflows/stale.yml': []
|
||||
'.github/workflows/status-check-labels.yml':
|
||||
- 'actions/github-script@v9.0.0'
|
||||
'.github/workflows/sync-dependency-versions.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
'.github/workflows/sync-device-classes.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'astral-sh/setup-uv@v10.3.3'
|
||||
- 'peter-evans/create-pull-request@v8.1.1'
|
||||
'.github/workflows/sync-integration-durations.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
- 'actions/create-github-app-token@v3.3.0'
|
||||
- 'actions/setup-python@v7.1.0'
|
||||
- 'peter-evans/create-pull-request@v8.1.1'
|
||||
'.github/workflows/verify-lockfile.yml':
|
||||
- 'actions/checkout@v7.0.1'
|
||||
dependencies:
|
||||
'actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9':
|
||||
ref: 'v6.1.0'
|
||||
commit: 'sha1-55cc8345863c7cc4c66a329aec7e433d2d1c52a9'
|
||||
owner_id: 44036562
|
||||
repo_id: 215566462
|
||||
'actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7':
|
||||
ref: 'v5.0.4'
|
||||
commit: 'sha1-668228422ae6a00e4ad889ee87cd7109ec5666a7'
|
||||
owner_id: 44036562
|
||||
repo_id: 215566462
|
||||
'actions/cache@v5.0.5':
|
||||
ref: 'v5.0.5'
|
||||
commit: 'sha1-27d5ce7f107fe9357f9df03efb73ab90386fccae'
|
||||
owner_id: 44036562
|
||||
repo_id: 215566462
|
||||
'actions/cache@v6.1.0':
|
||||
ref: 'v6.1.0'
|
||||
commit: 'sha1-55cc8345863c7cc4c66a329aec7e433d2d1c52a9'
|
||||
owner_id: 44036562
|
||||
repo_id: 215566462
|
||||
'actions/checkout@v7.0.1':
|
||||
ref: 'v7.0.1'
|
||||
commit: 'sha1-3d3c42e5aac5ba805825da76410c181273ba90b1'
|
||||
owner_id: 44036562
|
||||
repo_id: 197814629
|
||||
'actions/create-github-app-token@v3.3.0':
|
||||
ref: 'v3.3.0'
|
||||
commit: 'sha1-64ab729a6294000f5aa4a4bc0b73d1f32bc45510'
|
||||
owner_id: 44036562
|
||||
repo_id: 642580244
|
||||
'actions/download-artifact@v8.0.2':
|
||||
ref: 'v8.0.2'
|
||||
commit: 'sha1-9000827ccba6bdab643e8b6fd33ac0654aef8333'
|
||||
owner_id: 44036562
|
||||
repo_id: 192626254
|
||||
'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd':
|
||||
ref: 'v8.0.0'
|
||||
commit: 'sha1-ed597411d8f924073f98dfc5c65a23a2325f34cd'
|
||||
owner_id: 44036562
|
||||
repo_id: 205262760
|
||||
'actions/github-script@v9.0.0':
|
||||
ref: 'v9.0.0'
|
||||
commit: 'sha1-3a2844b7e9c422d3c10d287c895573f7108da1b3'
|
||||
owner_id: 44036562
|
||||
repo_id: 205262760
|
||||
'actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405':
|
||||
ref: 'v6.2.0'
|
||||
commit: 'sha1-a309ff8b426b58ec0e2a45f0f869d46889d02405'
|
||||
owner_id: 44036562
|
||||
repo_id: 192625525
|
||||
'actions/setup-python@v7.1.0':
|
||||
ref: 'v7.1.0'
|
||||
commit: 'sha1-6d4fd22b20465ccc0f7354476588e8df7c9ca0e0'
|
||||
owner_id: 44036562
|
||||
repo_id: 192625525
|
||||
'actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f':
|
||||
ref: 'v7.0.0'
|
||||
commit: 'sha1-bbbca2ddaa5d8feaa63e36b76fdaad77386f024f'
|
||||
owner_id: 44036562
|
||||
repo_id: 192625955
|
||||
'actions/upload-artifact@v7.0.2':
|
||||
ref: 'v7.0.2'
|
||||
commit: 'sha1-cf430e030ddbb5b0abf93d22962f4752f3646cd9'
|
||||
owner_id: 44036562
|
||||
repo_id: 192625955
|
||||
'astral-sh/setup-uv@v10.3.3':
|
||||
ref: 'v10.3.3'
|
||||
commit: 'sha1-68559e99cc807c1eb7e9238fd43a15bba460eec2'
|
||||
owner_id: 115962839
|
||||
repo_id: 846733598
|
||||
'awalsh128/cache-apt-pkgs-action@v1.6.3':
|
||||
ref: 'v1.6.3'
|
||||
commit: 'sha1-553a35bb8ebd9fcabcb1c9451aa4c98e1b4ca8a9'
|
||||
owner_id: 2087466
|
||||
repo_id: 408212054
|
||||
uses:
|
||||
- 'actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9'
|
||||
- 'actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f'
|
||||
'codecov/codecov-action@v7.1.1':
|
||||
ref: 'v7.1.1'
|
||||
commit: 'sha1-303a32d7a59b442fa8d48b6a1cc6825c09c847a5'
|
||||
owner_id: 8226205
|
||||
repo_id: 200299178
|
||||
uses:
|
||||
- 'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd'
|
||||
'codspeedhq/action@v5.6.1':
|
||||
ref: 'v5.6.1'
|
||||
commit: 'sha1-61efe07e57e55bedeab750c434504de272a56e8c'
|
||||
owner_id: 116658140
|
||||
repo_id: 561699778
|
||||
uses:
|
||||
- 'actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7'
|
||||
- 'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd'
|
||||
'docker/build-push-action@v7.4.0':
|
||||
ref: 'v7.4.0'
|
||||
commit: 'sha1-c3c9e263c25d99ce0380d002d59b67737d91b0dc'
|
||||
owner_id: 5429470
|
||||
repo_id: 241092383
|
||||
'docker/login-action@v4.7.0':
|
||||
ref: 'v4.7.0'
|
||||
commit: 'sha1-81c6f93d4bc991e510b342a00b419b3bb4efc5c6'
|
||||
owner_id: 5429470
|
||||
repo_id: 287743349
|
||||
'docker/setup-buildx-action@v4.4.1':
|
||||
ref: 'v4.4.1'
|
||||
commit: 'sha1-f87e5991a6d7451dcb8d9637bfbc97413f497069'
|
||||
owner_id: 5429470
|
||||
repo_id: 288485773
|
||||
'github/codeql-action@v4.39.1':
|
||||
ref: 'v4.39.1'
|
||||
commit: 'sha1-9b3254085494b55a0f7c4c2b3d2d52cc712ce370'
|
||||
owner_id: 9919
|
||||
repo_id: 259445878
|
||||
'j178/prek-action@v3.1.0':
|
||||
ref: 'v3.1.0'
|
||||
commit: 'sha1-44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d'
|
||||
owner_id: 10510431
|
||||
repo_id: 1052387486
|
||||
'peter-evans/create-pull-request@v8.1.1':
|
||||
ref: 'v8.1.1'
|
||||
commit: 'sha1-5f6978faf089d4d20b00c7766989d076bb2fc7f1'
|
||||
owner_id: 18365890
|
||||
repo_id: 197176365
|
||||
'pre-commit-ci/lite-action@v1.2.0':
|
||||
ref: 'v1.2.0'
|
||||
commit: 'sha1-062bca0919bc9d6e66755cc05074b70c77e111fc'
|
||||
owner_id: 64617429
|
||||
repo_id: 560608915
|
||||
'pypa/gh-action-pypi-publish@v1.14.3':
|
||||
ref: 'v1.14.3'
|
||||
commit: 'sha1-7245906fb61fa33a13554f9d5fb856fe61758086'
|
||||
owner_id: 647025
|
||||
repo_id: 178055147
|
||||
uses:
|
||||
- 'actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405'
|
||||
@@ -24,11 +24,11 @@ jobs:
|
||||
if: github.event.pull_request.state == 'open' && (github.event.action != 'labeled' || github.event.sender.type != 'Bot')
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -38,7 +38,7 @@ jobs:
|
||||
permission-pull-requests: write # pulls.get, pulls.listFiles, list/create/update/dismissReview
|
||||
|
||||
- name: Auto Label PR
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
github-token: ${{ steps.generate-token.outputs.token }}
|
||||
script: |
|
||||
|
||||
@@ -21,15 +21,15 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.12"
|
||||
- name: Set up uv
|
||||
# ``--system`` (below) installs into the setup-python interpreter;
|
||||
# no venv is created or restored by this workflow.
|
||||
uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
|
||||
uses: astral-sh/setup-uv@v10.3.3
|
||||
with:
|
||||
enable-cache: true
|
||||
# Pull-request-only workflow: a save could never be shared and
|
||||
@@ -82,7 +82,7 @@ jobs:
|
||||
fi
|
||||
- if: failure()
|
||||
name: Review PR
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
script: |
|
||||
await github.rest.pulls.createReview({
|
||||
@@ -97,7 +97,7 @@ jobs:
|
||||
run: git diff
|
||||
- if: failure()
|
||||
name: Archive artifacts
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: generated-proto-files
|
||||
path: |
|
||||
@@ -105,7 +105,7 @@ jobs:
|
||||
esphome/components/api/api_pb2_service.*
|
||||
- if: success()
|
||||
name: Dismiss review
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
script: |
|
||||
let reviews = await github.rest.pulls.listReviews({
|
||||
|
||||
@@ -60,13 +60,13 @@ jobs:
|
||||
tag: ${{ steps.tag.outputs.tag }}
|
||||
push: ${{ steps.tag.outputs.push }}
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.12"
|
||||
- name: Set up Docker Buildx
|
||||
uses: docker/setup-buildx-action@594f3bf4285d9ea8dc53c9a0c9c4092420091003 # v4.4.0
|
||||
uses: docker/setup-buildx-action@v4.4.1
|
||||
|
||||
- name: Determine tag and whether to push
|
||||
id: tag
|
||||
@@ -97,7 +97,7 @@ jobs:
|
||||
|
||||
- name: Log in to the GitHub container registry
|
||||
if: steps.tag.outputs.push == 'true'
|
||||
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
|
||||
uses: docker/login-action@v4.7.0
|
||||
with:
|
||||
registry: ghcr.io
|
||||
username: ${{ github.actor }}
|
||||
@@ -128,7 +128,7 @@ jobs:
|
||||
|
||||
- name: Upload compile-test image artifact
|
||||
if: matrix.os == 'ubuntu-24.04' && matrix.build_type == 'docker'
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
# The tar is already compressed, so upload it as-is. archive: false
|
||||
# skips the redundant zip and makes the file name the artifact name
|
||||
@@ -152,16 +152,16 @@ jobs:
|
||||
- "ha-addon"
|
||||
- "docker"
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.12"
|
||||
- name: Set up Docker Buildx
|
||||
uses: docker/setup-buildx-action@594f3bf4285d9ea8dc53c9a0c9c4092420091003 # v4.4.0
|
||||
uses: docker/setup-buildx-action@v4.4.1
|
||||
|
||||
- name: Log in to the GitHub container registry
|
||||
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
|
||||
uses: docker/login-action@v4.7.0
|
||||
with:
|
||||
registry: ghcr.io
|
||||
username: ${{ github.actor }}
|
||||
@@ -208,9 +208,9 @@ jobs:
|
||||
- nrf52
|
||||
- host
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
- name: Download image artifact
|
||||
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
||||
uses: actions/download-artifact@v8.0.2
|
||||
with:
|
||||
name: compile-test-image.tar.zst
|
||||
- name: Load image
|
||||
|
||||
@@ -20,7 +20,7 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Run tests
|
||||
working-directory: .github/scripts/auto-label-pr
|
||||
|
||||
@@ -49,7 +49,7 @@ jobs:
|
||||
|
||||
- name: Check out code from base repository
|
||||
if: steps.pr.outputs.skip != 'true'
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
# Always check out from the base repository (esphome/esphome), never from forks
|
||||
# Use the PR's target branch to ensure we run trusted code from the main repo
|
||||
@@ -58,7 +58,7 @@ jobs:
|
||||
|
||||
- name: Restore Python
|
||||
if: steps.pr.outputs.skip != 'true'
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: "3.12"
|
||||
cache-key: ${{ hashFiles('.cache-key') }}
|
||||
|
||||
+181
-119
@@ -28,18 +28,18 @@ jobs:
|
||||
cache-key: ${{ steps.cache-key.outputs.key }}
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Generate cache-key
|
||||
id: cache-key
|
||||
run: echo key="${{ hashFiles('requirements.txt', 'requirements_dev.txt', 'requirements_test.txt', '.pre-commit-config.yaml') }}" >> $GITHUB_OUTPUT
|
||||
- name: Set up Python ${{ env.DEFAULT_PYTHON }}
|
||||
id: python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
- name: Restore Python virtual environment
|
||||
id: cache-venv
|
||||
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache@v6.1.0
|
||||
with:
|
||||
path: venv
|
||||
# yamllint disable-line rule:line-length
|
||||
@@ -49,7 +49,7 @@ jobs:
|
||||
# detects the activated venv via ``VIRTUAL_ENV`` so downstream jobs
|
||||
# that ``. venv/bin/activate`` see an identical layout.
|
||||
if: steps.cache-venv.outputs.cache-hit != 'true'
|
||||
uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
|
||||
uses: astral-sh/setup-uv@v10.3.3
|
||||
with:
|
||||
enable-cache: true
|
||||
# Pull request saves land in per-PR scopes nothing else can
|
||||
@@ -79,11 +79,11 @@ jobs:
|
||||
timeout-minutes: 10
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
sparse-checkout: .github
|
||||
- name: Install apt packages (cached)
|
||||
uses: ./.github/actions/apt-packages
|
||||
uses: $/.github/actions/apt-packages
|
||||
|
||||
determine-jobs:
|
||||
name: Determine which jobs to run
|
||||
@@ -105,6 +105,7 @@ jobs:
|
||||
esp32-platformio-components: ${{ steps.determine.outputs.esp32-platformio-components }}
|
||||
esp8266-native: ${{ steps.determine.outputs.esp8266-native }}
|
||||
esp8266-native-components: ${{ steps.determine.outputs.esp8266-native-components }}
|
||||
windows-build-matrix: ${{ steps.determine.outputs.windows-build-matrix }}
|
||||
changed-components: ${{ steps.determine.outputs.changed-components }}
|
||||
changed-components-with-tests: ${{ steps.determine.outputs.changed-components-with-tests }}
|
||||
directly-changed-components-with-tests: ${{ steps.determine.outputs.directly-changed-components-with-tests }}
|
||||
@@ -124,17 +125,17 @@ jobs:
|
||||
release-pr: ${{ github.base_ref == 'beta' || github.base_ref == 'release' }}
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
# Fetch enough history to find the merge base
|
||||
fetch-depth: 2
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
- name: Restore components graph cache
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: .temp/components_graph.json
|
||||
key: components-graph-${{ hashFiles('esphome/components/**/*.py') }}
|
||||
@@ -170,6 +171,7 @@ jobs:
|
||||
echo "esp32-platformio-components=$(echo "$output" | jq -r '.esp32_platformio_components')" >> $GITHUB_OUTPUT
|
||||
echo "esp8266-native=$(echo "$output" | jq -r '.esp8266_native')" >> $GITHUB_OUTPUT
|
||||
echo "esp8266-native-components=$(echo "$output" | jq -r '.esp8266_native_components')" >> $GITHUB_OUTPUT
|
||||
echo "windows-build-matrix=$(echo "$output" | jq -c '.windows_build_matrix')" >> $GITHUB_OUTPUT
|
||||
echo "changed-components=$(echo "$output" | jq -c '.changed_components')" >> $GITHUB_OUTPUT
|
||||
echo "changed-components-with-tests=$(echo "$output" | jq -c '.changed_components_with_tests')" >> $GITHUB_OUTPUT
|
||||
echo "directly-changed-components-with-tests=$(echo "$output" | jq -c '.directly_changed_components_with_tests')" >> $GITHUB_OUTPUT
|
||||
@@ -183,7 +185,7 @@ jobs:
|
||||
echo "benchmarks=$(echo "$output" | jq -r '.benchmarks')" >> $GITHUB_OUTPUT
|
||||
- name: Save components graph cache
|
||||
if: github.ref == 'refs/heads/dev'
|
||||
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/save@v6.1.0
|
||||
with:
|
||||
path: .temp/components_graph.json
|
||||
key: components-graph-${{ hashFiles('esphome/components/**/*.py') }}
|
||||
@@ -202,14 +204,14 @@ jobs:
|
||||
timeout-minutes: 15
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
- name: Cache the native toolchain
|
||||
uses: ./.github/actions/cache-arduino8266
|
||||
uses: $/.github/actions/cache-arduino8266
|
||||
- name: Install the native toolchain
|
||||
run: |
|
||||
. venv/bin/activate
|
||||
@@ -224,9 +226,9 @@ jobs:
|
||||
if: needs.determine-jobs.outputs.core-ci == 'true'
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -253,9 +255,9 @@ jobs:
|
||||
if: needs.determine-jobs.outputs.python-linters == 'true'
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -275,7 +277,7 @@ jobs:
|
||||
if: github.event_name == 'pull_request' && needs.determine-jobs.outputs.release-pr == 'false' && needs.determine-jobs.outputs.core-ci == 'true'
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Read prek version from requirements_test.txt
|
||||
id: prek
|
||||
# requirements_test.txt is the only place the version is pinned, so a
|
||||
@@ -287,7 +289,7 @@ jobs:
|
||||
fi
|
||||
echo "version=$version" >> "$GITHUB_OUTPUT"
|
||||
- name: Run prek
|
||||
uses: j178/prek-action@44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d # v3.1.0
|
||||
uses: j178/prek-action@v3.1.0
|
||||
with:
|
||||
prek-version: ${{ steps.prek.outputs.version }}
|
||||
# This job only runs on pull requests, so nothing ever populates
|
||||
@@ -300,7 +302,7 @@ jobs:
|
||||
# Pushes any fixes the hooks made back to the pull request. This step
|
||||
# must keep its default name: the GitHub App that performs the push
|
||||
# locates the workflow run by that name.
|
||||
- uses: pre-commit-ci/lite-action@062bca0919bc9d6e66755cc05074b70c77e111fc # v1.2.0
|
||||
- uses: pre-commit-ci/lite-action@v1.2.0
|
||||
if: always()
|
||||
with:
|
||||
msg: apply automatic formatting fixes
|
||||
@@ -334,10 +336,10 @@ jobs:
|
||||
if: needs.determine-jobs.outputs.core-ci == 'true'
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
id: restore-python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ matrix.python-version }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -354,10 +356,10 @@ jobs:
|
||||
. venv/bin/activate
|
||||
pytest -vv --cov-report=xml --tb=native --durations=30 -n auto tests --ignore=tests/integration/
|
||||
- name: Upload coverage to Codecov
|
||||
uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
|
||||
uses: codecov/codecov-action@v7.1.1
|
||||
- name: Save Python virtual environment cache
|
||||
if: github.ref == 'refs/heads/dev'
|
||||
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/save@v6.1.0
|
||||
with:
|
||||
path: venv
|
||||
key: ${{ runner.os }}-${{ steps.restore-python.outputs.python-version }}-venv-${{ needs.common.outputs.cache-key }}
|
||||
@@ -381,9 +383,9 @@ jobs:
|
||||
if: needs.determine-jobs.outputs.core-ci == 'false'
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Report empty upload to Codecov
|
||||
uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
|
||||
uses: codecov/codecov-action@v7.1.1
|
||||
with:
|
||||
run_command: empty-upload
|
||||
force: true
|
||||
@@ -414,23 +416,23 @@ jobs:
|
||||
INTEGRATION_CCACHE_SAVE: ${{ needs.determine-jobs.outputs.integration-run-all == 'true' && (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write')) }}
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Install apt packages (cached)
|
||||
# ccache speeds up the host compiles. A cache hit never touches apt
|
||||
# (mirror outages cannot hang the job); the timeout bounds the cold
|
||||
# path. libsdl2-dev is needed by the headless display tests, which
|
||||
# capture screenshots.
|
||||
timeout-minutes: 10
|
||||
uses: ./.github/actions/apt-packages
|
||||
uses: $/.github/actions/apt-packages
|
||||
- name: Set up Python 3.13
|
||||
id: python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.13"
|
||||
- name: Restore integration library cache
|
||||
# A miss or a changed pin self-heals with a download, so no restore-keys
|
||||
id: library-cache
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_LIBRARY_CACHE_PATH }}
|
||||
key: integration-libraries-v1-${{ runner.os }}-${{ hashFiles('esphome/components/json/__init__.py', 'esphome/components/noise/__init__.py', 'esphome/components/lvgl/__init__.py', 'esphome/components/improv_base/__init__.py') }}
|
||||
@@ -439,35 +441,35 @@ jobs:
|
||||
# per slice of INTEGRATION_TESTS_SPLIT_BUCKETS in script/determine-jobs.py.
|
||||
- name: Restore integration ccache (slice 1/5)
|
||||
if: needs.determine-jobs.outputs.integration-run-all != 'true' || strategy.job-index == 0
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_CCACHE_PATH }}
|
||||
key: integration-ccache-v1-0-${{ github.run_id }}
|
||||
restore-keys: integration-ccache-v1-0-
|
||||
- name: Restore integration ccache (slice 2/5)
|
||||
if: needs.determine-jobs.outputs.integration-run-all != 'true' || strategy.job-index == 1
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_CCACHE_PATH }}
|
||||
key: integration-ccache-v1-1-${{ github.run_id }}
|
||||
restore-keys: integration-ccache-v1-1-
|
||||
- name: Restore integration ccache (slice 3/5)
|
||||
if: needs.determine-jobs.outputs.integration-run-all != 'true' || strategy.job-index == 2
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_CCACHE_PATH }}
|
||||
key: integration-ccache-v1-2-${{ github.run_id }}
|
||||
restore-keys: integration-ccache-v1-2-
|
||||
- name: Restore integration ccache (slice 4/5)
|
||||
if: needs.determine-jobs.outputs.integration-run-all != 'true' || strategy.job-index == 3
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_CCACHE_PATH }}
|
||||
key: integration-ccache-v1-3-${{ github.run_id }}
|
||||
restore-keys: integration-ccache-v1-3-
|
||||
- name: Restore integration ccache (slice 5/5)
|
||||
if: needs.determine-jobs.outputs.integration-run-all != 'true' || strategy.job-index == 4
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_CCACHE_PATH }}
|
||||
key: integration-ccache-v1-4-${{ github.run_id }}
|
||||
@@ -484,14 +486,14 @@ jobs:
|
||||
CCACHE_DIR="$dir" ccache -z
|
||||
- name: Restore Python virtual environment
|
||||
id: cache-venv
|
||||
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache@v6.1.0
|
||||
with:
|
||||
path: venv
|
||||
key: ${{ runner.os }}-${{ steps.python.outputs.python-version }}-venv-${{ needs.common.outputs.cache-key }}
|
||||
- name: Set up uv
|
||||
# Only needed on cache miss to populate the venv.
|
||||
if: steps.cache-venv.outputs.cache-hit != 'true'
|
||||
uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
|
||||
uses: astral-sh/setup-uv@v10.3.3
|
||||
with:
|
||||
enable-cache: true
|
||||
# Pull request saves land in per-PR scopes nothing else can
|
||||
@@ -558,7 +560,7 @@ jobs:
|
||||
# Tests that compare rendered output write the image they actually got here, so a
|
||||
# failure can be looked at without reproducing the whole build locally.
|
||||
if: failure()
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: integration-test-artifacts-${{ matrix.bucket.name }}
|
||||
path: test_artifacts/
|
||||
@@ -569,7 +571,7 @@ jobs:
|
||||
# script/update_integration_test_durations.py; only full matrix dev
|
||||
# runs produce usable data.
|
||||
if: github.ref == 'refs/heads/dev' && needs.determine-jobs.outputs.integration-run-all == 'true'
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: junit-integration-${{ strategy.job-index }}
|
||||
path: junit-integration.xml
|
||||
@@ -585,14 +587,14 @@ jobs:
|
||||
run: ccache -s
|
||||
- name: Save integration ccache slice
|
||||
if: success() && env.INTEGRATION_CCACHE_SAVE == 'true'
|
||||
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/save@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_CCACHE_PATH }}
|
||||
key: integration-ccache-v1-${{ strategy.job-index }}-${{ github.run_id }}
|
||||
- name: Save integration library cache
|
||||
# Bucket 0 only; the others would race the same immutable key.
|
||||
if: success() && (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write')) && strategy.job-index == 0 && steps.library-cache.outputs.cache-hit != 'true'
|
||||
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/save@v6.1.0
|
||||
with:
|
||||
path: ${{ env.INTEGRATION_LIBRARY_CACHE_PATH }}
|
||||
key: ${{ steps.library-cache.outputs.cache-primary-key }}
|
||||
@@ -641,9 +643,9 @@ jobs:
|
||||
if: needs.determine-jobs.outputs.import-time == 'true'
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -653,7 +655,7 @@ jobs:
|
||||
script/check_import_time.py --check --har importtime.har
|
||||
- name: Upload waterfall HAR
|
||||
if: always()
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: import-time-waterfall
|
||||
path: importtime.har
|
||||
@@ -687,10 +689,10 @@ jobs:
|
||||
# have already been benchmarked on their original dev pull requests.
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -751,7 +753,7 @@ jobs:
|
||||
apt-get install -y libc6-dbg
|
||||
|
||||
- name: Run CodSpeed benchmarks
|
||||
uses: CodSpeedHQ/action@78102a468f96d8e0ccb92d0ec49425753fc42062 # v5.6.0
|
||||
uses: CodSpeedHQ/action@v5.6.1
|
||||
with:
|
||||
run: |
|
||||
. venv/bin/activate
|
||||
@@ -768,10 +770,10 @@ jobs:
|
||||
if: github.event_name == 'pull_request' && (needs.determine-jobs.outputs.cpp-unit-tests-run-all == 'true' || needs.determine-jobs.outputs.cpp-unit-tests-components != '[]')
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -832,7 +834,7 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
# Need history for HEAD~1 to work for checking changed files
|
||||
fetch-depth: 2
|
||||
@@ -841,11 +843,11 @@ jobs:
|
||||
# libsdl2-dev is needed by the sdl component on the host, libmbedtls-dev
|
||||
# by dsmr and dlms_meter.
|
||||
timeout-minutes: 10
|
||||
uses: ./.github/actions/apt-packages
|
||||
uses: $/.github/actions/apt-packages
|
||||
|
||||
- name: Restore Python
|
||||
id: restore-python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -856,33 +858,33 @@ jobs:
|
||||
# a new image ships a newer patch release and drops the old interpreter.
|
||||
- name: Cache platformio
|
||||
if: github.ref == 'refs/heads/dev' && matrix.pio_cache_key
|
||||
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache@v6.1.0
|
||||
with:
|
||||
path: ~/.platformio
|
||||
key: platformio-${{ matrix.pio_cache_key }}-${{ steps.restore-python.outputs.python-version }}-${{ hashFiles('platformio.ini') }}
|
||||
|
||||
- name: Cache platformio
|
||||
if: github.ref != 'refs/heads/dev' && matrix.pio_cache_key
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: ~/.platformio
|
||||
key: platformio-${{ matrix.pio_cache_key }}-${{ steps.restore-python.outputs.python-version }}-${{ hashFiles('platformio.ini') }}
|
||||
|
||||
- name: Cache ESP-IDF install
|
||||
if: matrix.cache_idf
|
||||
uses: ./.github/actions/cache-esp-idf
|
||||
uses: $/.github/actions/cache-esp-idf
|
||||
with:
|
||||
framework: arduino
|
||||
|
||||
- name: Cache clang-tidy idedata
|
||||
if: matrix.cache_idf
|
||||
uses: ./.github/actions/cache-clang-tidy-idedata
|
||||
uses: $/.github/actions/cache-clang-tidy-idedata
|
||||
with:
|
||||
environment: esp32-arduino-tidy
|
||||
|
||||
- name: Cache nRF Connect SDK install
|
||||
if: matrix.cache_sdk_nrf
|
||||
uses: ./.github/actions/cache-sdk-nrf
|
||||
uses: $/.github/actions/cache-sdk-nrf
|
||||
|
||||
- name: Register problem matchers
|
||||
run: |
|
||||
@@ -931,7 +933,7 @@ jobs:
|
||||
|
||||
- name: Prune ESP-IDF install before cache save
|
||||
if: matrix.cache_idf && (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write'))
|
||||
uses: ./.github/actions/prune-esp-idf
|
||||
uses: $/.github/actions/prune-esp-idf
|
||||
|
||||
- name: Suggested changes
|
||||
run: script/ci-suggest-changes ${{ matrix.ignore_errors && '|| true' || '' }}
|
||||
@@ -951,22 +953,22 @@ jobs:
|
||||
ESPHOME_ESP_IDF_PREFIX: ~/.esphome-idf
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
# Need history for HEAD~1 to work for checking changed files
|
||||
fetch-depth: 2
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
|
||||
- name: Cache ESP-IDF install
|
||||
uses: ./.github/actions/cache-esp-idf
|
||||
uses: $/.github/actions/cache-esp-idf
|
||||
|
||||
- name: Cache clang-tidy idedata
|
||||
uses: ./.github/actions/cache-clang-tidy-idedata
|
||||
uses: $/.github/actions/cache-clang-tidy-idedata
|
||||
with:
|
||||
environment: esp32-idf-tidy
|
||||
|
||||
@@ -1006,7 +1008,7 @@ jobs:
|
||||
|
||||
- name: Prune ESP-IDF install before cache save
|
||||
if: (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write'))
|
||||
uses: ./.github/actions/prune-esp-idf
|
||||
uses: $/.github/actions/prune-esp-idf
|
||||
|
||||
- name: Suggested changes
|
||||
run: script/ci-suggest-changes
|
||||
@@ -1045,22 +1047,22 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
# Need history for HEAD~1 to work for checking changed files
|
||||
fetch-depth: 2
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
|
||||
- name: Cache ESP-IDF install
|
||||
uses: ./.github/actions/cache-esp-idf
|
||||
uses: $/.github/actions/cache-esp-idf
|
||||
|
||||
- name: Cache clang-tidy idedata
|
||||
uses: ./.github/actions/cache-clang-tidy-idedata
|
||||
uses: $/.github/actions/cache-clang-tidy-idedata
|
||||
with:
|
||||
environment: esp32-idf-tidy
|
||||
|
||||
@@ -1100,7 +1102,7 @@ jobs:
|
||||
|
||||
- name: Prune ESP-IDF install before cache save
|
||||
if: (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write'))
|
||||
uses: ./.github/actions/prune-esp-idf
|
||||
uses: $/.github/actions/prune-esp-idf
|
||||
|
||||
- name: Suggested changes
|
||||
run: script/ci-suggest-changes
|
||||
@@ -1141,22 +1143,22 @@ jobs:
|
||||
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
# Need history for HEAD~1 to work for checking changed files
|
||||
fetch-depth: 2
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
|
||||
- name: Cache ESP-IDF install
|
||||
uses: ./.github/actions/cache-esp-idf
|
||||
uses: $/.github/actions/cache-esp-idf
|
||||
|
||||
- name: Cache clang-tidy idedata
|
||||
uses: ./.github/actions/cache-clang-tidy-idedata
|
||||
uses: $/.github/actions/cache-clang-tidy-idedata
|
||||
with:
|
||||
environment: ${{ matrix.tidy_environment }}
|
||||
|
||||
@@ -1195,7 +1197,7 @@ jobs:
|
||||
|
||||
- name: Prune ESP-IDF install before cache save
|
||||
if: (github.ref == 'refs/heads/dev' || contains(github.event.pull_request.labels.*.name, 'ci-cache-write'))
|
||||
uses: ./.github/actions/prune-esp-idf
|
||||
uses: $/.github/actions/prune-esp-idf
|
||||
|
||||
- name: Suggested changes
|
||||
run: script/ci-suggest-changes
|
||||
@@ -1229,7 +1231,7 @@ jobs:
|
||||
run: echo ${{ matrix.batch.components }}
|
||||
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Install apt packages (cached)
|
||||
# A cache hit (seeded on dev by seed-apt-cache) never touches apt,
|
||||
@@ -1237,9 +1239,9 @@ jobs:
|
||||
# the cold path. The action has no --no-install-recommends; same
|
||||
# package set this job used before #17463.
|
||||
timeout-minutes: 10
|
||||
uses: ./.github/actions/apt-packages
|
||||
uses: $/.github/actions/apt-packages
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -1248,7 +1250,7 @@ jobs:
|
||||
# ESP-IDF install; never save -- just reuse the shared install the
|
||||
# dev tidy jobs already cached when present.
|
||||
if: matrix.batch.needs_idf
|
||||
uses: ./.github/actions/cache-esp-idf
|
||||
uses: $/.github/actions/cache-esp-idf
|
||||
with:
|
||||
restore-only: true
|
||||
- name: Cache nRF Connect SDK install (restore-only)
|
||||
@@ -1256,14 +1258,14 @@ jobs:
|
||||
# sdk-nrf install; never save -- just reuse the shared install the
|
||||
# dev nrf52 tidy job cached when present.
|
||||
if: matrix.batch.needs_nrf
|
||||
uses: ./.github/actions/cache-sdk-nrf
|
||||
uses: $/.github/actions/cache-sdk-nrf
|
||||
with:
|
||||
restore-only: true
|
||||
- name: Cache the native ESP8266 toolchain
|
||||
# Only batches whose test platforms include esp8266; never saves
|
||||
# here, it reuses the install the dev seed job cached.
|
||||
if: matrix.batch.needs_arduino8266
|
||||
uses: ./.github/actions/cache-arduino8266
|
||||
uses: $/.github/actions/cache-arduino8266
|
||||
- name: Validate and compile components with intelligent grouping
|
||||
run: |
|
||||
. venv/bin/activate
|
||||
@@ -1406,10 +1408,10 @@ jobs:
|
||||
TEST_COMPONENTS: ${{ needs.determine-jobs.outputs.esp32-platformio-components }}
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -1444,16 +1446,16 @@ jobs:
|
||||
TEST_COMPONENTS: ${{ needs.determine-jobs.outputs.esp8266-native-components }}
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
|
||||
- name: Cache the native toolchain
|
||||
uses: ./.github/actions/cache-arduino8266
|
||||
uses: $/.github/actions/cache-arduino8266
|
||||
|
||||
- name: Run native toolchain compile test
|
||||
run: |
|
||||
@@ -1466,23 +1468,26 @@ jobs:
|
||||
# config first, so a separate config pass is redundant.
|
||||
python3 script/test_build_components.py -e compile -t esp8266-ard -c "$TEST_COMPONENTS" -f --toolchain arduino --fail-on-no-tests
|
||||
|
||||
test-esp8266-native-windows:
|
||||
name: Compile esp8266 with the native toolchain on Windows (ccache ${{ matrix.ccache }})
|
||||
test-windows:
|
||||
name: Compile ${{ matrix.target }} with ${{ matrix.toolchain }} on Windows (ccache ${{ matrix.ccache }})
|
||||
runs-on: windows-latest
|
||||
needs:
|
||||
- common
|
||||
- determine-jobs
|
||||
if: github.event_name == 'pull_request' && needs.determine-jobs.outputs.esp8266-native == 'true'
|
||||
if: github.event_name == 'pull_request' && needs.determine-jobs.outputs.windows-build-matrix != '[]'
|
||||
# A hung compiler must fail the job, not hold the runner for six hours.
|
||||
timeout-minutes: 40
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
# Both ways the build runs on Windows: ESPHome Desktop bundles
|
||||
# ccache and puts it on PATH, a pip install has none.
|
||||
ccache: ["1", "0"]
|
||||
# One leg per build path ESPHome ships on Windows; the list comes from
|
||||
# script/determine-jobs.py (WINDOWS_BUILD_LEGS), which also decides
|
||||
# which legs a change needs. No toolchain is cached: every leg installs
|
||||
# its own from scratch, as a fresh Windows machine does.
|
||||
include: ${{ fromJson(needs.determine-jobs.outputs.windows-build-matrix) }}
|
||||
env:
|
||||
ESPHOME_CCACHE_ENABLE: ${{ matrix.ccache }}
|
||||
# ESPHOME_CCACHE_ENABLE stays unset: the build must detect ccache on
|
||||
# PATH by itself, as it does for ESPHome Desktop and a pip install
|
||||
# The test script prints characters the cp1252 console cannot encode
|
||||
PYTHONUTF8: "1"
|
||||
# The exact static build ESPHome Desktop ships
|
||||
@@ -1490,10 +1495,10 @@ jobs:
|
||||
CCACHE_SHA256: 2568347a697e103ca1b073981c704ad76fb2507d066c38dba038dd73399d968f
|
||||
steps:
|
||||
- name: Check out code from GitHub
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
@@ -1516,24 +1521,56 @@ jobs:
|
||||
Add-Content -Path $env:GITHUB_PATH -Value $bin.DirectoryName
|
||||
& $bin.FullName --version
|
||||
|
||||
- name: Take any ccache off PATH
|
||||
if: matrix.ccache == '0'
|
||||
shell: pwsh
|
||||
# The runner image ships one with Strawberry Perl; this leg is the build of a machine without
|
||||
run: |
|
||||
$path = $env:PATH
|
||||
for ($i = 0; $i -lt 5; $i++) {
|
||||
$found = Get-Command ccache -ErrorAction SilentlyContinue
|
||||
if (-not $found) { break }
|
||||
$dir = Split-Path $found.Source
|
||||
Write-Host "Taking $dir off PATH for $($found.Source)"
|
||||
$path = ($path -split ';' | Where-Object { $_ -ne $dir }) -join ';'
|
||||
$env:PATH = $path
|
||||
}
|
||||
if (Get-Command ccache -ErrorAction SilentlyContinue) {
|
||||
Write-Host "::error::a ccache is still on PATH"
|
||||
exit 1
|
||||
}
|
||||
"PATH=$path" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8
|
||||
|
||||
- name: Show disk space
|
||||
shell: pwsh
|
||||
run: Get-PSDrive -PSProvider FileSystem | Format-Table Name, @{n='FreeGB';e={[math]::Round($_.Free/1GB,1)}}, @{n='UsedGB';e={[math]::Round($_.Used/1GB,1)}}
|
||||
|
||||
- name: Compile
|
||||
shell: pwsh
|
||||
# One component test: web_server brings wifi, api and the async web
|
||||
# server libraries, the shape of a typical ESP8266 device
|
||||
# One base config per leg; the toolchain install is part of the timed
|
||||
# run, and the slowest leg (sdk-nrf from scratch) takes about 7 minutes
|
||||
run: |
|
||||
if ("${{ matrix.ccache }}" -eq "0" -and (Get-Command ccache -ErrorAction SilentlyContinue)) {
|
||||
Write-Host "::error::a ccache is on PATH; this leg builds without one"
|
||||
exit 1
|
||||
}
|
||||
. .\venv\Scripts\Activate.ps1
|
||||
$arguments = "script/test_build_components.py", "-e", "compile", "-t", "esp8266-ard", "-c", "web_server", "--base-only", "--toolchain", "arduino", "--fail-on-no-tests"
|
||||
if ("${{ matrix.idf_target }}") {
|
||||
# Only the chip this leg builds; CI otherwise installs every toolchain
|
||||
$env:ESPHOME_IDF_DEFAULT_TARGETS = "${{ matrix.idf_target }}"
|
||||
}
|
||||
$arguments = "script/test_build_components.py", "-e", "compile", "-t", "${{ matrix.target }}", "-c", "${{ matrix.component }}", "--base-only", "--toolchain", "${{ matrix.toolchain }}", "--fail-on-no-tests"
|
||||
$p = Start-Process -FilePath python -ArgumentList $arguments -NoNewWindow -PassThru
|
||||
# Reading the handle keeps ExitCode available after the process exits
|
||||
$null = $p.Handle
|
||||
if (-not $p.WaitForExit(25 * 60 * 1000)) {
|
||||
Write-Host "::error::The compile did not finish in 25 minutes; processes still running:"
|
||||
Get-CimInstance Win32_Process |
|
||||
Where-Object { $_.CommandLine -match 'xtensa|ccache|ninja|esphome' } |
|
||||
Where-Object { $_.CommandLine -match 'xtensa|riscv|arm-|ccache|ninja|cmake|west|platformio|pio|esphome' } |
|
||||
Select-Object ProcessId, ParentProcessId, CreationDate, CommandLine |
|
||||
Format-List | Out-String -Width 4096 | Write-Host
|
||||
Get-Process |
|
||||
Where-Object { $_.Name -match 'cc1|ccache|ninja|xtensa|python' } |
|
||||
Where-Object { $_.Name -match 'cc1|ccache|ninja|cmake|xtensa|riscv|arm-|python' } |
|
||||
Select-Object Id, Name, CPU, WorkingSet64 |
|
||||
Format-Table | Out-String | Write-Host
|
||||
taskkill /PID $p.Id /T /F
|
||||
@@ -1546,10 +1583,35 @@ jobs:
|
||||
# ccache was ever reached
|
||||
if: always() && matrix.ccache == '1'
|
||||
shell: pwsh
|
||||
# The build keeps its store under the esphome tools cache
|
||||
# The stores live under ESPHome's tools cache (tools_cache_path() in
|
||||
# build_helpers/tools_cache.py), each native build's next to its
|
||||
# install. A passing compile that never called ccache is a bug in the
|
||||
# build's ccache wiring, not a pass.
|
||||
run: |
|
||||
$env:CCACHE_DIR = Join-Path $env:LOCALAPPDATA "esphome\Cache\arduino8266\ccache"
|
||||
$cache = Join-Path $env:LOCALAPPDATA "esphome\Cache"
|
||||
$env:CCACHE_DIR = switch ("${{ matrix.toolchain }}") {
|
||||
"arduino" { Join-Path $cache "arduino8266\ccache" }
|
||||
"esp-idf" { Join-Path $cache "idf\ccache" }
|
||||
"sdk-nrf" { Join-Path $cache "sdk-nrf\ccache" }
|
||||
"platformio" { Join-Path $cache "platformio-ccache" }
|
||||
default {
|
||||
Write-Host "::error::No ccache store known for toolchain ${{ matrix.toolchain }}"
|
||||
exit 1
|
||||
}
|
||||
}
|
||||
ccache -s
|
||||
# Cacheable calls = hits + misses; the tab-separated keys do not change between locales
|
||||
$calls = 0
|
||||
foreach ($line in (ccache --print-stats)) {
|
||||
$key, $value = $line -split "`t"
|
||||
if ($key -in "direct_cache_hit", "preprocessed_cache_hit", "cache_miss") {
|
||||
$calls += [int]$value
|
||||
}
|
||||
}
|
||||
if ($calls -eq 0) {
|
||||
Write-Host "::error::ccache was never called by the compile"
|
||||
exit 1
|
||||
}
|
||||
|
||||
device-builder:
|
||||
name: Test downstream esphome/device-builder
|
||||
@@ -1560,17 +1622,17 @@ jobs:
|
||||
if: needs.determine-jobs.outputs.device-builder == 'true'
|
||||
steps:
|
||||
- name: Check out esphome (this PR)
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
path: esphome
|
||||
- name: Check out esphome/device-builder
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
repository: esphome/device-builder
|
||||
ref: main
|
||||
path: device-builder
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.13"
|
||||
- name: Set up uv
|
||||
@@ -1579,7 +1641,7 @@ jobs:
|
||||
# install step (order-of-magnitude faster on cold boots,
|
||||
# with its own wheel cache). actions/setup-python still
|
||||
# provides the interpreter.
|
||||
uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
|
||||
uses: astral-sh/setup-uv@v10.3.3
|
||||
with:
|
||||
enable-cache: true
|
||||
# Pull request saves land in per-PR scopes nothing else can
|
||||
@@ -1622,7 +1684,7 @@ jobs:
|
||||
skip: ${{ steps.check-script.outputs.skip || steps.check-tests.outputs.skip }}
|
||||
steps:
|
||||
- name: Check out target branch
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
ref: ${{ github.base_ref }}
|
||||
|
||||
@@ -1694,7 +1756,7 @@ jobs:
|
||||
- name: Restore cached memory analysis
|
||||
id: cache-memory-analysis
|
||||
if: steps.check-script.outputs.skip != 'true' && steps.check-tests.outputs.skip != 'true'
|
||||
uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/restore@v6.1.0
|
||||
with:
|
||||
path: memory-analysis-target.json
|
||||
key: ${{ steps.cache-key.outputs.cache-key }}
|
||||
@@ -1711,14 +1773,14 @@ jobs:
|
||||
|
||||
- name: Restore Python
|
||||
if: steps.check-script.outputs.skip != 'true' && steps.check-tests.outputs.skip != 'true' && steps.cache-memory-analysis.outputs.cache-hit != 'true'
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
|
||||
- name: Cache the native ESP8266 toolchain
|
||||
if: steps.check-script.outputs.skip != 'true' && steps.check-tests.outputs.skip != 'true' && steps.cache-memory-analysis.outputs.cache-hit != 'true' && fromJSON(needs.determine-jobs.outputs.memory_impact).needs_arduino8266
|
||||
uses: ./.github/actions/cache-arduino8266
|
||||
uses: $/.github/actions/cache-arduino8266
|
||||
|
||||
- name: Build, compile, and analyze memory
|
||||
if: steps.check-script.outputs.skip != 'true' && steps.check-tests.outputs.skip != 'true' && steps.cache-memory-analysis.outputs.cache-hit != 'true'
|
||||
@@ -1757,7 +1819,7 @@ jobs:
|
||||
|
||||
- name: Save memory analysis to cache
|
||||
if: steps.check-script.outputs.skip != 'true' && steps.check-tests.outputs.skip != 'true' && steps.cache-memory-analysis.outputs.cache-hit != 'true' && steps.build.outcome == 'success'
|
||||
uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
|
||||
uses: actions/cache/save@v6.1.0
|
||||
with:
|
||||
path: memory-analysis-target.json
|
||||
key: ${{ steps.cache-key.outputs.cache-key }}
|
||||
@@ -1778,7 +1840,7 @@ jobs:
|
||||
fi
|
||||
|
||||
- name: Upload memory analysis JSON
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: memory-analysis-target
|
||||
path: memory-analysis-target.json
|
||||
@@ -1797,15 +1859,15 @@ jobs:
|
||||
flash_usage: ${{ steps.extract.outputs.flash_usage }}
|
||||
steps:
|
||||
- name: Check out PR branch
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
- name: Cache the native ESP8266 toolchain
|
||||
if: fromJSON(needs.determine-jobs.outputs.memory_impact).needs_arduino8266
|
||||
uses: ./.github/actions/cache-arduino8266
|
||||
uses: $/.github/actions/cache-arduino8266
|
||||
- name: Build, compile, and analyze memory
|
||||
id: extract
|
||||
run: |
|
||||
@@ -1841,7 +1903,7 @@ jobs:
|
||||
--platform "$platform"
|
||||
|
||||
- name: Upload memory analysis JSON
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: memory-analysis-pr
|
||||
path: memory-analysis-pr.json
|
||||
@@ -1864,20 +1926,20 @@ jobs:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
steps:
|
||||
- name: Check out code
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
- name: Restore Python
|
||||
uses: ./.github/actions/restore-python
|
||||
uses: $/.github/actions/restore-python
|
||||
with:
|
||||
python-version: ${{ env.DEFAULT_PYTHON }}
|
||||
cache-key: ${{ needs.common.outputs.cache-key }}
|
||||
- name: Download target analysis JSON
|
||||
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
||||
uses: actions/download-artifact@v8.0.2
|
||||
with:
|
||||
name: memory-analysis-target
|
||||
path: ./memory-analysis
|
||||
continue-on-error: true
|
||||
- name: Download PR analysis JSON
|
||||
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
||||
uses: actions/download-artifact@v8.0.2
|
||||
with:
|
||||
name: memory-analysis-pr
|
||||
path: ./memory-analysis
|
||||
@@ -1922,7 +1984,7 @@ jobs:
|
||||
- test-build-components-split
|
||||
- test-esp32-platformio
|
||||
- test-esp8266-native
|
||||
- test-esp8266-native-windows
|
||||
- test-windows
|
||||
- device-builder
|
||||
- memory-impact-target-branch
|
||||
- memory-impact-pr-branch
|
||||
|
||||
@@ -17,7 +17,7 @@ jobs:
|
||||
github.event.pull_request.head.repo.full_name != github.event.pull_request.base.repo.full_name
|
||||
&& github.event.pull_request.head.ref == github.event.repository.default_branch
|
||||
steps:
|
||||
- uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
- uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
script: |
|
||||
const { owner, repo } = context.repo;
|
||||
|
||||
@@ -26,7 +26,7 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout base branch
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.base.sha }}
|
||||
sparse-checkout: |
|
||||
@@ -34,7 +34,7 @@ jobs:
|
||||
CODEOWNERS
|
||||
|
||||
- name: Check codeowner approval and update label
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
env:
|
||||
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||
with:
|
||||
|
||||
@@ -29,13 +29,13 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout base branch
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.base.sha }}
|
||||
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -44,7 +44,7 @@ jobs:
|
||||
permission-issues: write # issues.listComments and issues.createComment (PR comments use the issues API)
|
||||
|
||||
- name: Request reviews from component codeowners
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
github-token: ${{ steps.generate-token.outputs.token }}
|
||||
script: |
|
||||
|
||||
@@ -52,11 +52,11 @@ jobs:
|
||||
# your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
|
||||
steps:
|
||||
- name: Checkout repository
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
# Initializes the CodeQL tools for scanning.
|
||||
- name: Initialize CodeQL
|
||||
uses: github/codeql-action/init@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
|
||||
uses: github/codeql-action/init@v4.39.1
|
||||
with:
|
||||
languages: ${{ matrix.language }}
|
||||
build-mode: ${{ matrix.build-mode }}
|
||||
@@ -84,6 +84,6 @@ jobs:
|
||||
exit 1
|
||||
|
||||
- name: Perform CodeQL Analysis
|
||||
uses: github/codeql-action/analyze@9b3254085494b55a0f7c4c2b3d2d52cc712ce370 # v4.39.1
|
||||
uses: github/codeql-action/analyze@v4.39.1
|
||||
with:
|
||||
category: "/language:${{matrix.language}}"
|
||||
@@ -15,7 +15,7 @@ jobs:
|
||||
steps:
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -24,7 +24,7 @@ jobs:
|
||||
permission-pull-requests: write
|
||||
|
||||
- name: Add external component comment
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
github-token: ${{ steps.generate-token.outputs.token }}
|
||||
script: |
|
||||
|
||||
@@ -19,7 +19,7 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Notify codeowners for component issues
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
script: |
|
||||
const owner = context.repo.owner;
|
||||
|
||||
@@ -14,4 +14,4 @@ jobs:
|
||||
permissions:
|
||||
issues: write # issues.lock on closed issues
|
||||
pull-requests: write # issues.lock on closed pull requests
|
||||
uses: esphome/workflows/.github/workflows/lock.yml@31d160e5f0ffa0ee65d5b27cb55c153d415f2abe # 2026.10.2
|
||||
uses: esphome/workflows/.github/workflows/lock.yml@e1432c7b31fec7d24a13dc192953ebac836ed98a # 2026.10.3
|
||||
@@ -16,9 +16,9 @@ jobs:
|
||||
name: Validate PR title
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
|
||||
- uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
- uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
script: |
|
||||
const {
|
||||
|
||||
@@ -22,7 +22,7 @@ jobs:
|
||||
actions: write # gh workflow run starts release.yml
|
||||
steps:
|
||||
- name: Check out the repository
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Start the release workflow
|
||||
env:
|
||||
|
||||
@@ -31,7 +31,7 @@ jobs:
|
||||
branch_build: ${{ steps.tag.outputs.branch_build }}
|
||||
deploy_env: ${{ steps.tag.outputs.deploy_env }}
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
- name: Get tag
|
||||
id: tag
|
||||
env:
|
||||
@@ -84,9 +84,9 @@ jobs:
|
||||
contents: read # actions/checkout to build the sdist/wheel
|
||||
id-token: write # OIDC token for PyPI Trusted Publishing (pypa/gh-action-pypi-publish)
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.x"
|
||||
- name: Build
|
||||
@@ -94,7 +94,7 @@ jobs:
|
||||
pip3 install build
|
||||
python3 -m build
|
||||
- name: Publish
|
||||
uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
|
||||
uses: pypa/gh-action-pypi-publish@v1.14.3
|
||||
with:
|
||||
skip-existing: true
|
||||
|
||||
@@ -116,29 +116,29 @@ jobs:
|
||||
os: "ubuntu-24.04-arm"
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.12"
|
||||
|
||||
- name: Set up Docker Buildx
|
||||
uses: docker/setup-buildx-action@594f3bf4285d9ea8dc53c9a0c9c4092420091003 # v4.4.0
|
||||
uses: docker/setup-buildx-action@v4.4.1
|
||||
|
||||
- name: Log in to docker hub
|
||||
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
|
||||
uses: docker/login-action@v4.7.0
|
||||
with:
|
||||
username: ${{ secrets.DOCKER_USER }}
|
||||
password: ${{ secrets.DOCKER_PASSWORD }}
|
||||
- name: Log in to the GitHub container registry
|
||||
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
|
||||
uses: docker/login-action@v4.7.0
|
||||
with:
|
||||
registry: ghcr.io
|
||||
username: ${{ github.actor }}
|
||||
password: ${{ secrets.GITHUB_TOKEN }}
|
||||
|
||||
- name: Build docker
|
||||
uses: ./.github/actions/build-image
|
||||
uses: $/.github/actions/build-image
|
||||
with:
|
||||
target: final
|
||||
build_type: docker
|
||||
@@ -146,7 +146,7 @@ jobs:
|
||||
version: ${{ needs.init.outputs.tag }}
|
||||
|
||||
- name: Build ha-addon
|
||||
uses: ./.github/actions/build-image
|
||||
uses: $/.github/actions/build-image
|
||||
with:
|
||||
target: final
|
||||
build_type: ha-addon
|
||||
@@ -162,7 +162,7 @@ jobs:
|
||||
# version: ${{ needs.init.outputs.tag }}
|
||||
|
||||
- name: Upload digests
|
||||
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
||||
uses: actions/upload-artifact@v7.0.2
|
||||
with:
|
||||
name: digests-${{ matrix.platform.arch }}
|
||||
path: /tmp/digests
|
||||
@@ -192,27 +192,27 @@ jobs:
|
||||
- ghcr
|
||||
- dockerhub
|
||||
steps:
|
||||
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
- uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Download digests
|
||||
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
||||
uses: actions/download-artifact@v8.0.2
|
||||
with:
|
||||
pattern: digests-*
|
||||
path: /tmp/digests
|
||||
merge-multiple: true
|
||||
|
||||
- name: Set up Docker Buildx
|
||||
uses: docker/setup-buildx-action@594f3bf4285d9ea8dc53c9a0c9c4092420091003 # v4.4.0
|
||||
uses: docker/setup-buildx-action@v4.4.1
|
||||
|
||||
- name: Log in to docker hub
|
||||
if: matrix.registry == 'dockerhub'
|
||||
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
|
||||
uses: docker/login-action@v4.7.0
|
||||
with:
|
||||
username: ${{ secrets.DOCKER_USER }}
|
||||
password: ${{ secrets.DOCKER_PASSWORD }}
|
||||
- name: Log in to the GitHub container registry
|
||||
if: matrix.registry == 'ghcr'
|
||||
uses: docker/login-action@81c6f93d4bc991e510b342a00b419b3bb4efc5c6 # v4.7.0
|
||||
uses: docker/login-action@v4.7.0
|
||||
with:
|
||||
registry: ghcr.io
|
||||
username: ${{ github.actor }}
|
||||
@@ -245,7 +245,7 @@ jobs:
|
||||
steps:
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -254,7 +254,7 @@ jobs:
|
||||
permission-actions: write # actions.createWorkflowDispatch on the target repo (only API call made with this token)
|
||||
|
||||
- name: Trigger Workflow
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
github-token: ${{ steps.generate-token.outputs.token }}
|
||||
script: |
|
||||
|
||||
@@ -16,7 +16,7 @@ jobs:
|
||||
# No GITHUB_TOKEN permissions: the reusable workflow mints an ESPHome
|
||||
# GitHub App token so the labels, comments and closures come from
|
||||
# esphome[bot] instead of github-actions[bot].
|
||||
uses: esphome/workflows/.github/workflows/stale.yml@31d160e5f0ffa0ee65d5b27cb55c153d415f2abe # main
|
||||
uses: esphome/workflows/.github/workflows/stale.yml@e1432c7b31fec7d24a13dc192953ebac836ed98a # main
|
||||
secrets:
|
||||
ESPHOME_GITHUB_APP_PRIVATE_KEY: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
with:
|
||||
|
||||
@@ -13,7 +13,7 @@ jobs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check for blocking labels
|
||||
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
|
||||
uses: actions/github-script@v9.0.0
|
||||
with:
|
||||
script: |
|
||||
const blockingLabels = ['needs-docs', 'needs-developer-docs', 'merge-after-release', 'chained-pr'];
|
||||
|
||||
@@ -43,7 +43,7 @@ jobs:
|
||||
steps:
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -54,7 +54,7 @@ jobs:
|
||||
- name: Check out base branch
|
||||
# Provides the script that runs below. Deliberately the base branch
|
||||
# so the pull request cannot change what executes here.
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.base.sha }}
|
||||
persist-credentials: false
|
||||
@@ -64,14 +64,14 @@ jobs:
|
||||
# refuses heads that live in a different repository, and the job
|
||||
# condition above already limits runs to same-repository branches.
|
||||
# Leaving it off keeps that refusal as a backstop for fork heads.
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
ref: ${{ github.event.pull_request.head.ref }}
|
||||
path: pull-request
|
||||
token: ${{ steps.generate-token.outputs.token }}
|
||||
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.12"
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ jobs:
|
||||
steps:
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -28,16 +28,16 @@ jobs:
|
||||
permission-pull-requests: write # pulls.create / pulls.update to open or refresh the sync PR
|
||||
|
||||
- name: Checkout
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Checkout Home Assistant
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
repository: home-assistant/core
|
||||
path: lib/home-assistant
|
||||
|
||||
- name: Setup Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.14"
|
||||
|
||||
@@ -47,7 +47,7 @@ jobs:
|
||||
# setup-python interpreter so subsequent ``prek`` /
|
||||
# ``script/run-in-env.py`` steps find the deps without a
|
||||
# ``uv run`` prefix.
|
||||
uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
|
||||
uses: astral-sh/setup-uv@v10.3.3
|
||||
with:
|
||||
enable-cache: true
|
||||
# Pin uv version so the action does not have to fetch the
|
||||
@@ -93,7 +93,7 @@ jobs:
|
||||
run: python script/run-in-env.py prek run --all-files
|
||||
|
||||
- name: Commit changes
|
||||
uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
|
||||
uses: peter-evans/create-pull-request@v8.1.1
|
||||
with:
|
||||
commit-message: "Synchronise Device Classes from Home Assistant"
|
||||
committer: esphome[bot] <115708604+esphome[bot]@users.noreply.github.com>
|
||||
|
||||
@@ -20,7 +20,7 @@ jobs:
|
||||
steps:
|
||||
- name: Generate a token
|
||||
id: generate-token
|
||||
uses: actions/create-github-app-token@64ab729a6294000f5aa4a4bc0b73d1f32bc45510 # v3.3.0
|
||||
uses: actions/create-github-app-token@v3.3.0
|
||||
with:
|
||||
client-id: ${{ vars.ESPHOME_GITHUB_APP_CLIENT_ID }}
|
||||
private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}
|
||||
@@ -28,10 +28,10 @@ jobs:
|
||||
permission-pull-requests: write # open or refresh the sync PR
|
||||
|
||||
- name: Checkout
|
||||
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
||||
uses: actions/checkout@v7.0.1
|
||||
|
||||
- name: Setup Python
|
||||
uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
|
||||
uses: actions/setup-python@v7.1.0
|
||||
with:
|
||||
python-version: "3.13"
|
||||
|
||||
@@ -86,7 +86,7 @@ jobs:
|
||||
exit 1
|
||||
|
||||
- name: Commit changes
|
||||
uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
|
||||
uses: peter-evans/create-pull-request@v8.1.1
|
||||
with:
|
||||
commit-message: "[ci] Refresh integration test durations"
|
||||
committer: esphome[bot] <115708604+esphome[bot]@users.noreply.github.com>
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
name: verify-lockfile
|
||||
|
||||
on:
|
||||
pull_request:
|
||||
push:
|
||||
branches:
|
||||
- dev
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
verify:
|
||||
name: Verify actions lockfile
|
||||
runs-on: ubuntu-latest
|
||||
env:
|
||||
GH_TOKEN: ${{ github.token }}
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v7.0.1
|
||||
with:
|
||||
persist-credentials: false
|
||||
- name: Install gh-actions-lock
|
||||
run: gh extension install github/gh-actions-lock --pin v0.4.0
|
||||
- name: Verify lockfile
|
||||
run: gh actions-lock --verify
|
||||
@@ -10,7 +10,7 @@ ci:
|
||||
repos:
|
||||
- repo: https://github.com/astral-sh/ruff-pre-commit
|
||||
# Ruff version.
|
||||
rev: v0.17.2
|
||||
rev: v0.17.3
|
||||
hooks:
|
||||
# Run the linter.
|
||||
- id: ruff
|
||||
|
||||
@@ -227,16 +227,20 @@ file does, and it is the authority when they disagree. The most useful starting
|
||||
A `dump_config` helper that picks a name returns `const LogString *` from `LOG_STR(...)`.
|
||||
* **CRCs and bit tricks** come from `esphome/core/helpers.h` (`crc8`, `crc16`, `xor_bytes`, `sum16_bytes`,
|
||||
`reverse_bits`, `encode_uint16`, `encode_value_le`, `sign_extend<BITS>`, `bcd_to_uint8`, `assign_bits`); pick
|
||||
the helper's arguments instead of writing a loop. 7-byte BCD RTC calendars use `time::decode_bcd_calendar<LAYOUT>`
|
||||
and `encode_bcd_calendar<LAYOUT>` with `EPSON_BCD_CALENDAR`, `DS_BCD_CALENDAR` or `PCF_BCD_CALENDAR`.
|
||||
the helper's arguments instead of writing a loop. `put_be16`/`24`/`32`, `put_le16` and `put_le32` write an
|
||||
integer into a byte buffer and return the pointer past it. 7-byte BCD RTC calendars use
|
||||
`time::decode_bcd_calendar<LAYOUT>` and `encode_bcd_calendar<LAYOUT>` with `EPSON_BCD_CALENDAR`,
|
||||
`DS_BCD_CALENDAR` or `PCF_BCD_CALENDAR`.
|
||||
* **Bus helpers:** UART drains with `read_available(on_byte)` and `discard_available()`, text lines with
|
||||
`LineReader<N>`, fixed-length binary frames with `FrameReader<N, HEADER...>`; I2C has `update_register`,
|
||||
`write_registers` (PROGMEM `I2CRegValue` table), `check_chip_id` and `read_bytes_16_le`.
|
||||
`if (!this->status_comm_result(ok)) return;` sets or clears the warning.
|
||||
`if (!this->status_comm_result(ok)) return;` sets or clears the warning; in `setup()`,
|
||||
`if (!this->setup_check(ok)) return;` marks the component failed on error.
|
||||
* **A hub's pointer to a child entity** comes from `SUB_SENSOR(name)`, `SUB_BINARY_SENSOR`, `SUB_TEXT_SENSOR`,
|
||||
`SUB_SWITCH`, `SUB_NUMBER`, `SUB_SELECT` or `SUB_BUTTON`, which declare the `set_<name>_<type>()` setter and
|
||||
the `<name>_<type>_` member (`SUB_SWITCH(turbo)` gives `set_turbo_switch()`); do not write the pair by hand.
|
||||
A child sensor that skips repeated values is `SUB_SENSOR_WITH_DEDUP(name, type)`.
|
||||
Publish to an optional child with `PUBLISH_STATE(this->x_sensor_, value);`, not a hand-written null check.
|
||||
* **An unset float is `NAN`**, not `optional<float>`; the optional costs 4 to 8 bytes of padding per member.
|
||||
* **`PollingComponent` first runs `update()`** after a random share of the interval; call `this->update()` at the
|
||||
end of `setup()` when the entities need a state at boot.
|
||||
|
||||
+7
-9
@@ -33,8 +33,7 @@ esphome/components/airthings_wave_base/* @jeromelaban @ncareau
|
||||
esphome/components/airthings_wave_mini/* @ncareau
|
||||
esphome/components/airthings_wave_plus/* @jeromelaban @precurse
|
||||
esphome/components/airton/* @Procsiab
|
||||
esphome/components/airton/select/* @Procsiab
|
||||
esphome/components/airton/switch/* @Procsiab
|
||||
esphome/components/airton_serial/* @guiguid
|
||||
esphome/components/alarm_control_panel/* @grahambrown11 @hwstar
|
||||
esphome/components/alpha3/* @jan-hofmeier
|
||||
esphome/components/am2315c/* @swoboda1337
|
||||
@@ -155,6 +154,7 @@ esphome/components/d01/* @ch604
|
||||
esphome/components/dac7678/* @NickB1
|
||||
esphome/components/daikin_arc/* @MagicBear
|
||||
esphome/components/daikin_brc/* @hagak
|
||||
esphome/components/daikin_madoka/* @Petapton
|
||||
esphome/components/dallas_temp/* @ssieb
|
||||
esphome/components/daly_bms/* @s1lvi0
|
||||
esphome/components/dashboard_import/* @esphome/core
|
||||
@@ -261,14 +261,7 @@ esphome/components/growatt_solar/* @leeuwte
|
||||
esphome/components/gsl3670/* @clydebarrow
|
||||
esphome/components/gt911/* @clydebarrow @jesserockz
|
||||
esphome/components/haier/* @paveldn
|
||||
esphome/components/haier/binary_sensor/* @paveldn
|
||||
esphome/components/haier/button/* @paveldn
|
||||
esphome/components/haier/select/* @paveldn
|
||||
esphome/components/haier/sensor/* @paveldn
|
||||
esphome/components/haier/switch/* @paveldn
|
||||
esphome/components/haier/text_sensor/* @paveldn
|
||||
esphome/components/haier_tundra/* @fauxpark
|
||||
esphome/components/haier_tundra/button/* @fauxpark
|
||||
esphome/components/haier_tundra/switch/* @fauxpark
|
||||
esphome/components/haier_water_heater/* @TheLexus
|
||||
esphome/components/havells_solar/* @sourabhjaiswal
|
||||
@@ -302,6 +295,7 @@ esphome/components/honeywellabp2_i2c/* @jpfaff
|
||||
esphome/components/host/* @clydebarrow @esphome/core
|
||||
esphome/components/host/time/* @clydebarrow
|
||||
esphome/components/hrxl_maxsonar_wr/* @netmikey
|
||||
esphome/components/ht16k33_char/* @ilikecake
|
||||
esphome/components/hte501/* @Stock-M
|
||||
esphome/components/http_request/ota/* @oarcher
|
||||
esphome/components/http_request/update/* @jesserockz
|
||||
@@ -354,6 +348,8 @@ esphome/components/ld2450/* @hareeshmu
|
||||
esphome/components/ld2460/* @jesusvallejo
|
||||
esphome/components/ld24xx/* @kbx81
|
||||
esphome/components/ld6002b/* @hepter
|
||||
esphome/components/ld6004/* @wolph
|
||||
esphome/components/ld600x/* @hepter @wolph
|
||||
esphome/components/ledc/* @OttoWinter
|
||||
esphome/components/libretiny/* @kuba2k2
|
||||
esphome/components/libretiny_pwm/* @kuba2k2
|
||||
@@ -381,6 +377,7 @@ esphome/components/ltr_als_ps/* @latonita
|
||||
esphome/components/lvgl/* @clydebarrow
|
||||
esphome/components/m5stack_4relay/* @KoenBreeman
|
||||
esphome/components/m5stack_8angle/* @rnauber
|
||||
esphome/components/m5stack_unit_bldc/* @lboue
|
||||
esphome/components/mapping/* @clydebarrow
|
||||
esphome/components/matrix_keypad/* @ssieb
|
||||
esphome/components/max17043/* @blacknell
|
||||
@@ -478,6 +475,7 @@ esphome/components/output/* @esphome/core
|
||||
esphome/components/packet_interface/* @clydebarrow
|
||||
esphome/components/packet_interface/packet_transport/* @clydebarrow
|
||||
esphome/components/packet_transport/* @clydebarrow
|
||||
esphome/components/panasonic_ir/* @duckle29
|
||||
esphome/components/pca6416a/* @Mat931
|
||||
esphome/components/pca9505/* @ajfriesen @ssieb
|
||||
esphome/components/pca9554/* @bdraco @clydebarrow @hwstar
|
||||
|
||||
@@ -48,7 +48,7 @@ PROJECT_NAME = ESPHome
|
||||
# could be handy for archiving the generated documentation or if some version
|
||||
# control system is used.
|
||||
|
||||
PROJECT_NUMBER = 2026.11.0-dev
|
||||
PROJECT_NUMBER = 2026.11.0b7
|
||||
|
||||
# Using the PROJECT_BRIEF tag one can provide an optional one line description
|
||||
# for a project that appears at the top of each page and should give viewer a
|
||||
|
||||
+9
-8
@@ -94,23 +94,24 @@ without a password leaves OTA open. The API is documented and is meant to be
|
||||
called by other devices, scripts, and pages.
|
||||
|
||||
As defense-in-depth, the web server checks the `Origin` header on browser requests
|
||||
to its entity control and state endpoints: a request whose `Origin` does not match
|
||||
the address the device is served on is rejected, and the `allowed_origins` option
|
||||
to every endpoint served through it, including the web OTA `/update` endpoint
|
||||
(the captive portal pages are open by design): a request whose `Origin` does not match
|
||||
the `Host` header of the same request is rejected, and the `allowed_origins` option
|
||||
widens that list. This blocks the common "confused deputy" (CSRF) case where a page
|
||||
the operator visits drives the device through their browser. It is **not** an
|
||||
authentication boundary: it only constrains browsers. Any client that omits the
|
||||
`Origin` header — `curl`, scripts, or other non-browser callers on the same
|
||||
network — reaches every endpoint exactly as before. The check also does not cover
|
||||
the web OTA `/update` endpoint. The device performs no CSRF-token or `Referer`
|
||||
network — reaches every endpoint exactly as before. The device performs no CSRF-token or `Referer`
|
||||
validation. The following are therefore **not** vulnerabilities in this repository:
|
||||
|
||||
- Requests without an `Origin` header (for example `curl`) reaching the control
|
||||
endpoints, whether or not `web_server` `auth:` is set.
|
||||
- Requests from an origin the operator added to `allowed_origins`.
|
||||
- Cross-origin or CSRF firmware upload through the web OTA endpoint (`/update`) when
|
||||
web OTA is enabled without `web_server` `auth:`. The `/update` endpoint is not
|
||||
covered by the `Origin` check; this is the same exposure as running OTA without a
|
||||
password.
|
||||
- DNS rebinding: a page whose host name resolves to the device sends a matching
|
||||
`Origin` and `Host`, so the check lets it through.
|
||||
- Firmware upload through the web OTA endpoint (`/update`) by a client that sends no
|
||||
`Origin` header when web OTA is enabled without `web_server` `auth:`; this is the
|
||||
same exposure as running OTA without a password.
|
||||
|
||||
The supported defenses are `web_server` `auth:`, protecting OTA (a web password or
|
||||
a native OTA password), and keeping devices on a trusted, segmented network. See
|
||||
|
||||
+2
-2
@@ -1,5 +1,5 @@
|
||||
ARG BUILD_VERSION=dev
|
||||
ARG BUILD_BASE_VERSION=2026.06.1
|
||||
ARG BUILD_BASE_VERSION=2026.11.0
|
||||
ARG BUILD_TYPE=docker
|
||||
|
||||
FROM ghcr.io/esphome/docker-base:debian-${BUILD_BASE_VERSION} AS base-source-docker
|
||||
@@ -22,7 +22,7 @@ RUN \
|
||||
-r /requirements.txt
|
||||
|
||||
# Install the ESPHome Device Builder dashboard.
|
||||
RUN uv pip install --no-cache-dir esphome-device-builder==1.26.0
|
||||
RUN uv pip install --no-cache-dir esphome-device-builder==1.28.1
|
||||
|
||||
RUN \
|
||||
platformio settings set enable_telemetry No \
|
||||
|
||||
+13
-6
@@ -477,13 +477,20 @@ def has_api() -> bool:
|
||||
def has_ota() -> bool:
|
||||
"""Check if any network OTA upload is available.
|
||||
|
||||
True if the config exposes either ``platform: esphome`` (native API
|
||||
OTA) or ``platform: web_server`` (HTTP OTA). Both reach the device
|
||||
over the same network stack, so the OTA discovery path treats them
|
||||
interchangeably; ``upload_program`` picks the actual transport based
|
||||
on ``--ota-platform`` and what's configured.
|
||||
True if the config exposes ``platform: esphome`` (native API OTA),
|
||||
``platform: web_server`` (HTTP OTA), or a network OTA that the target
|
||||
platform uploads to itself (nRF52 SMP over UDP). The OTA discovery path
|
||||
treats them interchangeably; ``upload_program`` picks the actual transport.
|
||||
"""
|
||||
return has_native_ota() or has_web_server_ota()
|
||||
return has_native_ota() or has_web_server_ota() or has_platform_network_ota()
|
||||
|
||||
|
||||
def has_platform_network_ota() -> bool:
|
||||
"""Check if the target platform's ``has_network_ota`` hook reports a network OTA."""
|
||||
if (target := CORE.target_platform) is None:
|
||||
return False
|
||||
hook = platform_hooks.get_platform_hook(target, "has_network_ota")
|
||||
return hook is not None and hook(CORE.config)
|
||||
|
||||
|
||||
def has_native_ota() -> bool:
|
||||
|
||||
@@ -49,9 +49,9 @@ class FrameworkRelease(NamedTuple):
|
||||
# Arduino core version -> its build in esphome-libs/arduino-esp8266
|
||||
FRAMEWORK_RELEASES: dict[Version, FrameworkRelease] = {
|
||||
Version(3, 1, 2): FrameworkRelease(
|
||||
"3.1.2-esphome.3",
|
||||
"3af533a85163804e164500a5b254dc23b922080e25ecb7dc37b3dd8ac84651db",
|
||||
37185650,
|
||||
"3.1.2-esphome.4",
|
||||
"d215e439e5592ca6ecac283825d08044b2bfce9cf592e03cf33dcbcec69365e2",
|
||||
37192995,
|
||||
),
|
||||
}
|
||||
|
||||
|
||||
+706
-118
File diff suppressed because it is too large.
Load diff
Loaded 100 of 1838 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user