dangernoodle-io / breadboard / 30033172289

97%

push

github

feat: describe /api/sensors/* routes for openapi (schema literals + meta goldens) (#1027)

adds PRODUCER-OWNED static const bb_route_t describe-only routes
(handler=NULL, .rodata/flash) for GET+PATCH /api/sensors/fan, GET
/api/sensors/power, and GET /api/sensors/thermal, mirroring the exact
bb_diag PR-1 pattern (B1-1180): a #define SCHEMA_LITERAL macro shared
between the on-device schema string and the route's static initializer,
registered via bb_http_register_route_descriptor_only() from a new
bb_sensor_http_describe_routes() (components/bb_sensor_http/bb_sensor_http_wire.c,
ESP_PLATFORM-guarded), called once from bb_sensor_http_init() after
bb_http_section_init(). power/thermal are GET-only by construction --
both bindings are gather-only (no apply hook), so no PATCH describe
route is registered for either.

fan's CONFIG_BB_FAN_AUTOFAN compile variant gets its own schema literal +
meta table pair (6 fields vs 2). thermal's 4 sibling nested {present,c}
objects (soc/vr/asic/board) round-trip byte-exact against the meta
engine -- the same one-level-of-nesting shape test_bb_diag_boot_wire_meta_golden.c
already proved (more siblings, not more depth), so no engine gap.

adds co-located BB_SERIALIZE_META_HOST meta tables for all four schemas
(fan response, fan PATCH request, power, thermal) plus byte-comparing
golden tests, and an emit-assertion test proving all three
/api/sensors/* paths (with GET+PATCH on fan) surface in
bb_openapi_emit()'s output.

bb_http added to bb_sensor_http's PRIV_REQUIRES (bb_route_t lives there,
not bb_http_server) -- mirrors bb_diag's own re-added dependency.

verified: host tests 4789/4789 pass, coverage gate PASS (0 new baseline
markers, bb_sensor_http_wire.c 100% line), esp32 smoke SUCCESS. Size vs
PR-1 base (9415c8cd): +64B flash code, +1924B flash data (schema
literals + route tables), +24B DRAM (alignment noise), 0B IRAM/RTC.

refs B1-1180

7457 of 8052 branches covered (92.61%)

Branch coverage included in aggregate %.

12640 of 12802 relevant lines covered (98.73%)

2503.92 hits per line