badger-diagnostics

Diagnose Badger 2350 system health, firmware, and hardware via REPL or mpremote.

8|1|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/johnlindquist/badger-2350-plugin --skill badger-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: badger-diagnostics
Source: https://github.com/johnlindquist/badger-2350-plugin/tree/main/badger-2350-dev/skills/badger-diagnostics
Command: npx skills add https://github.com/johnlindquist/badger-2350-plugin --skill badger-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mpremote, picotool.

What problem does it solve?

Troubleshooting embedded systems can be time-consuming and frustrating without proper diagnostic tools. This skill provides a comprehensive suite of checks and recovery procedures to quickly identify and resolve common issues with the Badger 2350, from firmware problems to hardware malfunctions.

Core Features & Use Cases

  • System Health Checks: Verify MicroPython version, memory usage, filesystem space, and core module availability with quick commands.
  • Hardware & Network Diagnostics: Test display, buttons, GPIO, I2C bus, and WiFi connectivity with dedicated functions.
  • Error Diagnosis & Recovery: Provides insights into common MicroPython errors and guides for safe mode boot, factory reset, and firmware reflash.
  • Use Case: When an app crashes with a MemoryError, use this skill to run a memory analysis, identify the problematic module, and then follow the recovery steps if a reflash is needed.

Quick Start

To perform a full system verification, run mpremote exec "import sys, gc; from badgeware import screen; print('=== VERIFICATION ==='); print('✓ MicroPython:', sys.version[:30]); print('✓ Memory:', gc.mem_free(), 'bytes'); print('✓ badgeware: loaded'); print('=== ALL OK ===')".

Frequently Asked Questions about badger-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Badger 2350 firmware and memory issues?

Diagnose Badger 2350 system health by checking MicroPython version, memory usage, filesystem space, and core module availability. Run quick verification commands via mpremote or REPL to identify firmware problems, memory leaks, and missing dependencies before debugging further.

Can I test hardware components like the display and WiFi on a Badger 2350?

Yes. This skill provides dedicated hardware diagnostic functions to test the display, buttons, GPIO pins, I2C bus, and WiFi connectivity on your Badger 2350, helping isolate whether errors stem from software or hardware malfunction.

What should I do when my Badger 2350 app crashes with a MemoryError?

Run a memory analysis using this skill to identify the problematic module consuming excess resources. Then follow the provided recovery steps—safe mode boot, factory reset, or firmware reflash—to resolve the issue and restore stability.

How do I verify my Badger 2350 is correctly configured after a firmware update?

Apply comprehensive system health checks after any firmware update to verify MicroPython environment integrity, confirm library versions, assess hardware status, and generate actionable diagnostics that confirm correct configurations across the device.

What dependencies do I need to run Badger 2350 diagnostics?

You need mpremote and picotool installed. These tools enable remote execution of diagnostic checks and firmware verification on your Badger 2350 without requiring direct console access.

When should I run diagnostics on my Badger 2350?

Run diagnostics during new sessions, after initial setup, before debugging application issues, when errors occur, and after any firmware updates to identify root causes and verify system integrity.