@protoboardai/ext-zephyr 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,13 @@
+Protoboard Stack: @protoboardai/ext-zephyr
+Copyright 2026 Delta Robotics, Inc.
+
+This product includes software developed at Delta Robotics, Inc.
+(https://deltaroboticsinc.com).
+
+Licensed under the Apache License, Version 2.0 (the "License").
+See the LICENSE file in this package for full terms.
+
+"Protoboard", the Protoboard logo and the "0" mark are trademarks of
+Delta Robotics, Inc. The License grants no rights to them (section 6);
+see TRADEMARKS.md in the Protoboard Stack repository
+(https://github.com/Delta-Robotics-Inc/protoboard-stack).

package/README.md

@@ -1,3 +1,162 @@
-# Temporary Holding Version
+# @protoboardai/ext-zephyr
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A provider of the `firmware` capability
+([tool integrations](../../docs/specs/tool-integrations.md)). It turns
+a UHD board whose controller is an nRF52840 module into a
+[Zephyr](https://zephyrproject.org) board definition: devicetree with pin
+assignment, devices on their buses, buttons, display, regulators and Kconfig.
+Every setting line cites the UHD facts it comes from, in a comment for people
+and in `firmware.manifest.json` for tools. Checked against Zephyr **4.2.0**
+(bindings, Kconfig symbols and the nRF52840 devicetree at the `v4.2.0` tag).
+
+A project selects it for one board, in the config next to the board module:
+
+```ts
+// src/boards/mainboard/firmware.config.ts
+import { defineCapabilityConfig } from "@protoboardai/core";
+
+export default defineCapabilityConfig({
+  provider: "@protoboardai/ext-zephyr",
+  constraints: {
+    board_name: "watch_core",
+    wake: ["sw1", "u3"], // the side button and the fuel gauge's alert wake it from System OFF
+    properties: { u5: { "actuator-mode": "LRA" } }, // what a driver binding needs and the model does not say
+  },
+});
+```
+
+```sh
+protoboard run firmware:generate --module mainboard   # src/boards/mainboard/zephyr/
+protoboard run firmware:export   --module mainboard   # out/config/ + out/firmware.manifest.json
+protoboard run firmware:extract  --module mainboard   # artifacts, and the pins the devicetree names
+protoboard check                                      # includes firmware:check for the board
+```
+
+`test/fixtures/watch-core` is a complete example: a Raytac MDBT50Q-1MV2 with a
+heart-rate sensor, fuel gauge and haptic driver on I2C, a round GC9A01
+display on SPI with D/C and reset, a side button, the charger's status line,
+a 32.768 kHz crystal, a GNSS on a UART and USB. Its generated files are the
+golden files in `test/golden/`.
+
+## What it writes
+
+```
+zephyr/
+  boards/<vendor>/<board>/board.yml            board name and SoC (Zephyr hardware model v2)
+  boards/<vendor>/<board>/Kconfig.<board>      selects SOC_NRF52840_QIAA
+  boards/<vendor>/<board>/<board>_defconfig    MPU, GPIO, the 32 kHz clock source
+  boards/<vendor>/<board>/<board>.dts          chosen, buttons, display, zephyr,user, buses and devices, regulators, GPIO ports, UICR, USB
+  boards/<vendor>/<board>/<board>-pinctrl.dtsi pin assignment of every bus (default and sleep states)
+  firmware.conf                                Kconfig fragment: the subsystems the board's drivers live in
+  protoboard.lines.json                        digest and cites of every file (what export turns into the manifest)
+```
+
+Build with the folder holding `boards/` as a board root:
+
+```sh
+west build -b watch_core app -- -DBOARD_ROOT=<path>/zephyr -DEXTRA_CONF_FILE=<path>/zephyr/firmware.conf
+```
+
+Do not edit these files. Settings of your own go in the application's
+`prj.conf` and an application overlay, which Zephyr merges after the board's.
+Export refuses an edited file and check reports it.
+
+## How the board maps to Zephyr
+
+1. **Firmware map** (tool-neutral, in `@protoboardai/core`: `boardFirmware`).
+   The controller is the board's one `microcontroller`. Buses come from the
+   peripherals' I2C, SPI and UART composites: each slot's pin is followed
+   along its net to a controller pin. Single lines between a peripheral and
+   the controller become controls by the peripheral pin's capabilities
+   (interrupt output, `reset`, `enable`, `display_dc`, `charge_status`). A
+   switch between a controller net and ground is an active-low button; a
+   resistor from the net to a supply replaces the internal pull-up. Devices
+   that agree on the lines they share are one bus: the write-only display and
+   a flash on the same SCK/MOSI are one SPI instance, with the flash's MISO,
+   one `cs-gpios` entry per device and each device's `reg` its index there.
+2. **SoC table** (`lib/soc.ts`). The controller's SoC fact
+   (`domains[electrical].metadata.soc`, "Nordic nRF52840 revision 2,
+   aQFN-73") selects the nRF52840: `nordic/nrf52840_qiaa.dtsi`, bus instances
+   (`i2c0`/`i2c1`, `spi3` first for its 32 MHz, then `spi2`; `i2c0`/`spi0`
+   and `i2c1`/`spi1` share hardware), and the pin naming: a module pin named
+   `P0.13` is `NRF_PSEL(…, 0, 13)` and `<&gpio0 13 …>`.
+3. **Driver table** (`lib/drivers.ts`), keyed by part id, each entry checked
+   against its Zephyr 4.2.0 binding:
+
+   | Part | Compatible | Kconfig | Controls the binding takes |
+   | --- | --- | --- | --- |
+   | `adi-max17048g-t10` | `maxim,max17048` | `FUEL_GAUGE` | — (ALRT goes to `zephyr,user`) |
+   | `ti-drv2605ldgs` | `ti,drv2605` (requires `actuator-mode`) | `HAPTICS` | `en-gpios`, `in-trig-gpios` |
+   | `ti-lp5024rsm` | `ti,lp5024` | `LED` | `enable-gpios` (LED child nodes are yours) |
+   | `eastrising-er-tft128-1` | `galaxycore,gc9x01x` on `zephyr,mipi-dbi-spi` | `DISPLAY` | `dc-gpios`, `reset-gpios`; width and height from the part's resolution |
+   | `adafruit-381-ds18b20-probe` | `maxim,ds18b20` on `zephyr,w1-gpio` | `W1`, `SENSOR` | resolution from the part |
+
+   A part with no entry still gets a node on its bus with its address and no
+   compatible (the application finds it by label), and a warning says so. An
+   I2C part that states no address is an error: its node would have no `reg`.
+   A missing mapping is reported to this package; meanwhile the application
+   overlay binds the driver to the node's label. Buttons get `INPUT_KEY_0`…`9`
+   then `INPUT_KEY_A`…`Z`; beyond 36 they get no code and a warning.
+   Controls without a binding property go to `zephyr,user` as
+   `<instance>-<pin name>-gpios`.
+4. **Board facts.** A 32.768 kHz crystal on XL1/XL2 selects
+   `CLOCK_CONTROL_NRF_K32SRC_XTAL`, else the RC oscillator with a warning; the
+   module's "REG1 DC/DC inductor inside" fact turns on `&reg1` DC/DC; NFC pads
+   used as GPIO set `nfct-pins-as-gpios`; USB pins wired to a connector enable
+   `zephyr_udc0: &usbd`. Wake sources (`constraints.wake`) are written as
+   `zephyr,user { wakeup-gpios = … }` for the application to arm before
+   `sys_poweroff()`; any nRF52840 GPIO can wake it from System OFF.
+
+## Constraints
+
+| Key | Meaning |
+| --- | --- |
+| `controller` | instance path of the controller, when the board has more than one microcontroller |
+| `board_name` | Zephyr board name (default: the module id with `_` for `-`) |
+| `vendor` | board vendor folder and compatible prefix (default `protoboard`) |
+| `console` | UART bus id or UART device instance for `zephyr,console` |
+| `i2c_frequency_hz` | 100000 or 400000 (default: 400 kHz when every device allows it) |
+| `uart_baud` | `{ <instance>: baud }` for UART devices that state no `baud_rate` |
+| `wake` | inputs that wake the chip from System OFF: button or device instances, or nets |
+| `properties` | `{ <instance>: { <property>: value } }`: devicetree properties a binding requires that the model cannot state; strings, integers, integer arrays, or `true` for a boolean |
+
+## Checks
+
+`firmware:check` runs the shared rules from `@protoboardai/core` (codes in the
+[provider guide](../../docs/guides/writing-a-capability-provider.md#diagnostic-codes))
+and these:
+
+| Code | Severity | Meaning |
+| --- | --- | --- |
+| `FW_SOC_UNSUPPORTED` | error | The controller's SoC fact names no SoC this provider knows. |
+| `FW_BUS_INSTANCES` | error | More I2C, SPI or UART buses than free nRF52840 instances. |
+| `FW_BUS_SPEED` | error | An I2C clock the TWIM cannot run (100 or 400 kHz). |
+| `FW_PROPERTY_MISSING` | error | A binding's required property (`actuator-mode`, a display's size) that neither the part nor the config states. |
+| `FW_DISPLAY_DC_MISSING` | error | A 4-wire SPI display without a D/C line to the controller. |
+| `FW_UART_BAUD_UNKNOWN`, `FW_CONSOLE_UNKNOWN` | error | No baud rate for a UART device; a console that is no UART. |
+| `FW_DTS_SYNTAX` | error | The generated devicetree is not well formed (a provider defect). |
+
+The devicetree is checked by a structural parser (`lib/dts.ts`): nodes and
+properties closed, values are cells, strings or references, labels defined
+once, and every `&label` defined by the files or the nRF52840 devicetree.
+The tests also compile it with `dtc` after the C preprocessor when `dtc` is
+installed; it is not on every machine, so the structural check is what
+always runs.
+
+## What the output does not establish
+
+A generated board definition agrees with the model and the checked Zephyr
+release. It has not been built or flashed: the first `west build` is the
+real compile check, and the bench (rails, programming, I2C scan at the
+addresses above, each peripheral's smoke test) is where it is proven. The
+release's test plan lists those steps.
+
+## Tests
+
+```sh
+npx vitest run packages/ext-zephyr                     # contract, golden files, cites, devicetree, seeded faults
+UPDATE_GOLDEN=1 npx vitest run packages/ext-zephyr     # after a deliberate change to the output
+```
+
+The test parts in `test/fixtures/parts/` are copies of researched parts; the
+README there says where they came from.

package/evals/haptic-driver-mode/case.json

@@ -0,0 +1,44 @@
+{
+  "schema": "protoboard.eval-case/v0",
+  "title": "Generate the watch board's Zephyr configuration when a driver binding needs a property the model does not state",
+  "skills": ["firmware-config-zephyr"],
+  "tags": ["firmware", "zephyr", "judgement"],
+  "fixture": {
+    "from": "../../../../examples/wearable-watch",
+    "exclude": ["release"],
+    "steps": [
+      { "note": "the config without the haptic driver's actuator-mode property", "write": { "file": "src/boards/watch-main/firmware.config.ts", "from": "seed-firmware.config.ts.txt" } },
+      { "note": "the firmware configuration has not been generated in this copy", "remove": "src/boards/watch-main/zephyr" },
+      { "remove": "src/boards/watch-main/out/config" },
+      { "remove": "src/boards/watch-main/out/firmware.manifest.json" }
+    ]
+  },
+  "instruction": "The wearable watch's main board (module watch-main-board, src/boards/watch-main) needs its Zephyr board definition generated and exported; this copy has none yet. Produce fresh firmware outputs so that `npx protoboard check` reports no errors and no firmware finding left open. Do not change the board module, the parts or the circuit outputs, and do not edit generated files. Tell me what you generated and every value you had to decide that the model did not state, with where it came from.",
+  "tools": { "read": true, "edit": true, "commands": ["npx protoboard *"] },
+  "budget": { "turns": 30, "seconds": 900, "usd": 4 },
+  "graders": [
+    { "id": "property-supplied-and-named", "kind": "fault", "code": "FW_PROPERTY_MISSING", "caught": "actuator.?mode[\\s\\S]*LRA|LRA[\\s\\S]*actuator.?mode", "description": "the binding's actuator-mode is set and the answer names it" },
+    {
+      "id": "check-clean",
+      "kind": "check",
+      "maxErrors": 0,
+      "absent": ["FW_NOT_GENERATED", "FW_NATIVE_STALE", "FW_NATIVE_EDITED", "FW_PIN_DRIFT", "PB_OUTPUT_NOT_EXPORTED"],
+      "ran": ["ext:@protoboardai/ext-zephyr/firmware:check", "protoboard/standard-outputs"]
+    },
+    { "id": "outputs-valid", "kind": "outputs", "module": "watch-main-board" },
+    { "id": "dts-lra", "kind": "text", "file": "src/boards/watch-main/out/config/boards/protoboard/wearable_watch/wearable_watch.dts", "matches": ["actuator-mode = \"LRA\""], "notMatches": ["actuator-mode = \"ERM\""], "description": "the DRV2605L drives the VG0832012, a linear resonant actuator" },
+    { "id": "config-kept", "kind": "text", "file": "src/boards/watch-main/firmware.config.ts", "matches": ["wake: \\[\"sw1\", \"sw2\", \"u2\"\\]", "board_name: \"wearable_watch\""], "description": "the wake sources and board name are not changed to get past the check" },
+    { "id": "manifest-cites", "kind": "facts", "file": "src/boards/watch-main/out/firmware.manifest.json", "facts": [{ "path": "provider", "equals": "@protoboardai/ext-zephyr" }, { "path": "controller.part", "equals": "raytac-mdbt50q-1mv2" }] },
+    { "id": "board-untouched", "kind": "digest", "file": "src/boards/watch-main/watch-main.uhd.ts", "changed": false },
+    { "id": "driver-part-untouched", "kind": "digest", "file": "parts/catalog/ti-drv2605ldgs.json", "changed": false },
+    { "id": "circuit-outputs-untouched", "kind": "digest", "file": "src/boards/watch-main/out/netlist.json", "changed": false }
+  ],
+  "solution": [
+    { "protoboard": ["check"], "expect": { "exit": 1 } },
+    { "write": { "file": "src/boards/watch-main/firmware.config.ts", "from": "solution-firmware.config.ts.txt" } },
+    { "protoboard": ["run", "firmware:generate", "--module", "watch-main-board"], "expect": { "status": "succeeded" } },
+    { "protoboard": ["run", "firmware:export", "--module", "watch-main-board"], "expect": { "status": "succeeded" } },
+    { "protoboard": ["check"] },
+    { "say": "firmware:check refused generate with FW_PROPERTY_MISSING: the ti,drv2605 binding requires actuator-mode, which no part states. The DRV2605L (u4) drives the VG0832012 on J4 through the LRA leads, a linear resonant actuator, so I set properties: { u4: { \"actuator-mode\": \"LRA\" } } in firmware.config.ts with a comment, then generated and exported the Zephyr board definition (wearable_watch: devicetree, pinctrl, Kconfig, firmware.conf) and out/firmware.manifest.json. check reports no errors." }
+  ]
+}

package/evals/haptic-driver-mode/seed-firmware.config.ts.txt

@@ -0,0 +1,13 @@
+import { defineCapabilityConfig } from "@protoboardai/core";
+
+// Zephyr 4.2 for the watch main board (@protoboardai/ext-zephyr): the board definition and Kconfig
+// fragment, every line citing the board's nets and parts. Only what the model cannot state is here.
+export default defineCapabilityConfig({
+  provider: "@protoboardai/ext-zephyr",
+  module: "watch-main-board",
+  constraints: {
+    board_name: "wearable_watch",
+    // System OFF wake sources (brief F2, F8): both buttons, and the IMU's wrist-raise interrupt
+    wake: ["sw1", "sw2", "u2"],
+  },
+});

package/evals/haptic-driver-mode/solution-firmware.config.ts.txt

@@ -0,0 +1,15 @@
+import { defineCapabilityConfig } from "@protoboardai/core";
+
+// Zephyr 4.2 for the watch main board (@protoboardai/ext-zephyr): the board definition and Kconfig
+// fragment, every line citing the board's nets and parts. Only what the model cannot state is here.
+export default defineCapabilityConfig({
+  provider: "@protoboardai/ext-zephyr",
+  module: "watch-main-board",
+  constraints: {
+    board_name: "wearable_watch",
+    // System OFF wake sources (brief F2, F8): both buttons, and the IMU's wrist-raise interrupt
+    wake: ["sw1", "sw2", "u2"],
+    // the DRV2605L drives the Vybronics VG0832012 LRA (an LRA, not an ERM); its binding requires the mode
+    properties: { u4: { "actuator-mode": "LRA" } },
+  },
+});