Ehu shubham shaw contribution --> Hardware support (#306)

* feat: add ZeroClaw firmware for ESP32 and Nucleo * Introduced new firmware for ZeroClaw on ESP32 and Nucleo-F401RE, enabling JSON-over-serial communication for GPIO control. * Added `zeroclaw-esp32` with support for commands like `gpio_read` and `gpio_write`, along with capabilities reporting. * Implemented `zeroclaw-nucleo` firmware with similar functionality for STM32, ensuring compatibility with existing ZeroClaw protocols. * Updated `.gitignore` to include new firmware targets and added necessary dependencies in `Cargo.toml` for both platforms. * Created README files for both firmware projects detailing setup, build, and usage instructions. Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> * feat: enhance hardware peripheral support and documentation - Added `Peripheral` trait implementation in `src/peripherals/` to manage hardware boards (STM32, RPi GPIO). - Updated `AGENTS.md` to include new extension points for peripherals and their configuration. - Introduced comprehensive documentation for adding boards and tools, including a quick start guide and supported boards. - Enhanced `Cargo.toml` to include optional dependencies for PDF extraction and peripheral support. - Created new datasheets for Arduino Uno, ESP32, and Nucleo-F401RE, detailing pin aliases and GPIO usage. - Implemented new tools for hardware memory reading and board information retrieval in the agent loop. This update significantly improves the integration and usability of hardware peripherals within the ZeroClaw framework. * feat: add ZeroClaw firmware for ESP32 and Nucleo * Introduced new firmware for ZeroClaw on ESP32 and Nucleo-F401RE, enabling JSON-over-serial communication for GPIO control. * Added `zeroclaw-esp32` with support for commands like `gpio_read` and `gpio_write`, along with capabilities reporting. * Implemented `zeroclaw-nucleo` firmware with similar functionality for STM32, ensuring compatibility with existing ZeroClaw protocols. * Updated `.gitignore` to include new firmware targets and added necessary dependencies in `Cargo.toml` for both platforms. * Created README files for both firmware projects detailing setup, build, and usage instructions. Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> * feat: enhance hardware peripheral support and documentation - Added `Peripheral` trait implementation in `src/peripherals/` to manage hardware boards (STM32, RPi GPIO). - Updated `AGENTS.md` to include new extension points for peripherals and their configuration. - Introduced comprehensive documentation for adding boards and tools, including a quick start guide and supported boards. - Enhanced `Cargo.toml` to include optional dependencies for PDF extraction and peripheral support. - Created new datasheets for Arduino Uno, ESP32, and Nucleo-F401RE, detailing pin aliases and GPIO usage. - Implemented new tools for hardware memory reading and board information retrieval in the agent loop. This update significantly improves the integration and usability of hardware peripherals within the ZeroClaw framework. * feat: Introduce hardware auto-discovery and expanded configuration options for agents, hardware, and security. * chore: update dependencies and improve probe-rs integration - Updated `Cargo.lock` to remove specific version constraints for several dependencies, including `zerocopy`, `syn`, and `strsim`, allowing for more flexibility in version resolution. - Upgraded `bincode` and `bitfield` to their latest versions, enhancing serialization and memory management capabilities. - Updated `Cargo.toml` to reflect the new version of `probe-rs` from `0.24` to `0.30`, improving hardware probing functionality. - Refactored code in `src/hardware` and `src/tools` to utilize the new `SessionConfig` for session management in `probe-rs`, ensuring better compatibility and performance. - Cleaned up documentation in `docs/datasheets/nucleo-f401re.md` by removing unnecessary lines. * fix: apply cargo fmt * docs: add hardware architecture diagram. --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 11:40:10 -05:00 · 2026-02-16 11:40:10 -05:00 · de3ec87d16
commit de3ec87d16
parent b36f23784a
59 changed files with 9607 additions and 1885 deletions
--- a/src/peripherals/capabilities_tool.rs
+++ b/src/peripherals/capabilities_tool.rs
@ -0,0 +1,99 @@
+//! Hardware capabilities tool — Phase C: query device for reported GPIO pins.
+
+use super::serial::SerialTransport;
+use crate::tools::traits::{Tool, ToolResult};
+use async_trait::async_trait;
+use serde_json::json;
+use std::sync::Arc;
+
+/// Tool: query device capabilities (GPIO pins, LED pin) from firmware.
+pub struct HardwareCapabilitiesTool {
+    /// (board_name, transport) for each serial board.
+    boards: Vec<(String, Arc<SerialTransport>)>,
+}
+
+impl HardwareCapabilitiesTool {
+    pub(crate) fn new(boards: Vec<(String, Arc<SerialTransport>)>) -> Self {
+        Self { boards }
+    }
+}
+
+#[async_trait]
+impl Tool for HardwareCapabilitiesTool {
+    fn name(&self) -> &str {
+        "hardware_capabilities"
+    }
+
+    fn description(&self) -> &str {
+        "Query connected hardware for reported GPIO pins and LED pin. Use when: user asks what pins are available."
+    }
+
+    fn parameters_schema(&self) -> serde_json::Value {
+        json!({
+            "type": "object",
+            "properties": {
+                "board": {
+                    "type": "string",
+                    "description": "Optional board name. If omitted, queries all."
+                }
+            }
+        })
+    }
+
+    async fn execute(&self, args: serde_json::Value) -> anyhow::Result<ToolResult> {
+        let filter = args.get("board").and_then(|v| v.as_str());
+        let mut outputs = Vec::new();
+
+        for (board_name, transport) in &self.boards {
+            if let Some(b) = filter {
+                if b != board_name {
+                    continue;
+                }
+            }
+            match transport.capabilities().await {
+                Ok(result) => {
+                    let output = if result.success {
+                        if let Ok(parsed) =
+                            serde_json::from_str::<serde_json::Value>(&result.output)
+                        {
+                            format!(
+                                "{}: gpio {:?}, led_pin {:?}",
+                                board_name,
+                                parsed.get("gpio").unwrap_or(&json!([])),
+                                parsed.get("led_pin").unwrap_or(&json!(null))
+                            )
+                        } else {
+                            format!("{}: {}", board_name, result.output)
+                        }
+                    } else {
+                        format!(
+                            "{}: {}",
+                            board_name,
+                            result.error.as_deref().unwrap_or("unknown")
+                        )
+                    };
+                    outputs.push(output);
+                }
+                Err(e) => {
+                    outputs.push(format!("{}: error - {}", board_name, e));
+                }
+            }
+        }
+
+        let output = if outputs.is_empty() {
+            if filter.is_some() {
+                "No matching board or capabilities not supported.".to_string()
+            } else {
+                "No serial boards configured or capabilities not supported.".to_string()
+            }
+        } else {
+            outputs.join("\n")
+        };
+
+        Ok(ToolResult {
+            success: !outputs.is_empty(),
+            output,
+            error: None,
+        })
+    }
+}