Skip to content

docs: DC Guardian kit — BOM, wiring diagram, assembly guide, skill config#4

Open
toxfox69 wants to merge 1 commit intoClawland-AI:mainfrom
toxfox69:docs/dc-guardian-kit
Open

docs: DC Guardian kit — BOM, wiring diagram, assembly guide, skill config#4
toxfox69 wants to merge 1 commit intoClawland-AI:mainfrom
toxfox69:docs/dc-guardian-kit

Conversation

@toxfox69
Copy link

@toxfox69 toxfox69 commented Mar 4, 2026

Closes #1

What's included

kits/dc-guardian/BOM.md

  • 12-component parts list with purchase links (Adafruit, Amazon, AliExpress)
  • Per-item and totalled pricing targeting ~$88
  • Cost breakdown table by category
  • Substitution options for each major component

kits/dc-guardian/WIRING.md

  • Full ASCII wiring overview (board → all sensors)
  • Detailed ASCII schematic showing pull-up resistor placement for DHT22
  • Pin reference table: board pin → GPIO label → signal → connected component → suggested wire color
  • Breadboard layout diagram
  • Wiring notes covering pull-up requirement, MQ-2 warm-up, sensitivity pot, sensor placement

kits/dc-guardian/README.md

  • Overview table (board, sensors, cost, ROI)
  • Alert thresholds table for all monitored conditions
  • 7-step assembly instructions: flash → wire → boot → verify → enclose → deploy → configure
  • Maintenance schedule
  • ROI calculation ($47,912 year-1 savings)
  • Troubleshooting table (7 common failure modes)

kits/dc-guardian/skill.yaml

  • PicClaw skill config: GPIO assignments, sensor driver declarations, poll intervals, startup delays
  • Alert thresholds (all overridable via alerts.yaml)
  • Buzzer pattern config for warn vs. alert severity
  • Webhook output with payload template
  • JSON log output with rotation

kits/dc-guardian/alerts.yaml

  • Named alert rules for temp warn/critical, humidity high/low, smoke, water zone 1/2, sensor offline
  • Per-rule severity, message templates, output targets, and cooldown periods

Test plan

  • Verify all pin numbers against LicheeRV-Nano pinout diagram
  • Confirm ASCII diagram renders correctly in GitHub markdown preview
  • Spot-check purchase links are live
  • Verify skill.yaml parses as valid YAML

🤖 Generated with Claude Code


Note

Low Risk
Low risk: this PR only adds new kit documentation and YAML configuration files, with no changes to application/runtime code. Main risk is misconfigured GPIO pins/thresholds or invalid YAML leading to non-functional deployments.

Overview
Adds a new kits/dc-guardian kit with a complete bill of materials, wiring/assembly documentation, and operational guidance for deploying a data-center monitoring node.

Introduces PicClaw configuration via skill.yaml (GPIO mappings, sensor polling/startup delays, buzzer/webhook/log outputs) and alerts.yaml (temperature/humidity/smoke/water/offline rules with cooldowns) to drive alerting behavior.

Written by Cursor Bugbot for commit 3f131bf. This will update automatically on new commits. Configure here.

…l config

Closes Clawland-AI#1

- BOM.md: 12-item parts list with purchase links totaling ~$88, cost
  breakdown by category, substitution table
- WIRING.md: full ASCII schematic + detailed pin reference table for
  LicheeRV-Nano ↔ DHT22 / MQ-2 / water sensors / buzzer
- README.md: overview, step-by-step assembly instructions (7 steps),
  maintenance schedule, ROI calculation, troubleshooting table
- skill.yaml: PicClaw skill config — GPIO assignments, sensor drivers,
  alert thresholds, buzzer patterns, webhook output
- alerts.yaml: named alert rules for all sensors with severity levels
  and cooldown periods

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@toxfox69 toxfox69 requested a review from Tonyfudecai as a code owner March 4, 2026 09:11
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Free Tier Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

pin: ${gpio.buzzer}
pattern:
warn: { on_ms: 100, off_ms: 900, repeat: 5 }
alert: { on_ms: 500, off_ms: 200, repeat: -1 } # -1 = continuous until cleared
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Buzzer pattern key doesn't match alert severity name

High Severity

The buzzer pattern map in skill.yaml defines keys warn and alert, but alerts.yaml uses severity values warn and critical. When a critical-severity alert fires with buzzer as an output, the system would look up a pattern for critical and find no match — the key is alert instead. The buzzer likely won't sound for smoke or water leak events.

Additional Locations (1)

Fix in Cursor Fix in Web

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: create BOM and wiring guide for data center monitoring kit

1 participant