# Install Rust embedded toolchain for Cortex-M33
rustup target add thumbv8m.main-none-eabihf  # For STM32U585

# Alternative if using FPU extensively
rustup target add thumbv8m.main-none-eabihf

rustup component add llvm-tools-preview

# Install cargo tools
cargo install cargo-binutils
cargo install probe-rs --features cli
cargo install cargo-embed
cargo install cargo-flash
cargo install flip-link  # Stack overflow protection

# Install Claude Code
npm install -g @anthropic-ai/claude-code
# or
pip install claude-code

# Verify installation
claude --version
probe-rs --version

# Option 1: Using ST-Link (recommended)
# probe-rs supports STM32U585

# Option 2: Using built-in DFU bootloader
sudo apt install dfu-util  # Linux
brew install dfu-util      # macOS

# Option 3: Using Black Magic Probe (if you have one)

claude "create a new Rust embedded project for STM32U585 on WeAct Black Pill board. Use stm32u5xx-hal if available, otherwise embassy-stm32. Target is thumbv8m.main-none-eabihf. Include proper memory.x for STM32U585CIU6 with 2MB flash and 786KB SRAM."

claude "what are the key differences between STM32F4 and STM32U5 that affect Rust development?"

claude "analyze the WeAct STM32U585 Black Pill pinout and create a constants file mapping board pins to MCU pins"

# STM32U585-specific prompts
claude "explain the memory map of STM32U585 and how it differs from STM32F4"

claude "show me all the available peripherals on STM32U585 and which pins they're on"

claude "what build optimizations are recommended for Cortex-M33"

# Learn to work with Claude Code iteratively
claude "set up the basic clock configuration for STM32U585 running at 160MHz from HSE"
# Review output
claude "now add power management to optimize for low power consumption"
# Review and test
claude "add voltage scaling configuration for maximum performance"

claude "check if stm32u5xx-hal is production-ready and analyze its completeness"

claude "show me the available examples in stm32u5xx-hal repository"

claude "set up an Embassy-based project for STM32U585 with embassy-stm32 crate"

claude "explain the differences between using embassy vs traditional HAL for STM32U5"

claude "create a minimal project using stm32u5 PAC directly for learning register-level programming"

# Analyze HAL/Embassy structure
claude "analyze the embassy-stm32 implementation for STM32U5 GPIO and explain the async pattern"

claude "show me how to configure GPIOC pin 13 (onboard LED on Black Pill) using embassy"

claude "compare blocking vs async UART implementation in embassy for STM32U585"

claude "create a board support package (BSP) for WeAct STM32U585 Black Pill with these mappings:
- LED: PC13
- User Button: PA0 (if present)
- USB: PA11/PA12
- SWD: PA13/PA14
- Default UART: PA9/PA10 (USART1)
- I2C: PB6/PB7 (I2C1)
- SPI: PA5/PA6/PA7 (SPI1)
Document all available pins"

# Generate custom documentation
claude "create a comprehensive markdown file documenting STM32U585 GPIO capabilities including low-power modes"

claude "make a cheat sheet for STM32U5 clock tree configuration with all possible clock sources"

claude "document the power management modes available on STM32U585 with code examples"

claude "create a guide for using the AES hardware accelerator on STM32U585"

docs/
├── u585-gpio-patterns.md
├── u585-clock-config.md
├── u585-power-modes.md
├── uart-async-examples.md
├── usb-device-guide.md
├── trustzone-basics.md
├── octospi-flash.md
└── low-power-cookbook.md

claude "create a new STM32U585 Embassy project that blinks the LED on PC13 every 500ms using async Timer"

claude "implement async UART echo on USART1 (PA9/PA10) at 115200 baud using embassy-stm32 for STM32U585"

claude "implement USB CDC device on STM32U585 using embassy-usb for serial communication over USB-C"

claude "create a low-power LED blink using STOP mode on STM32U585, waking from RTC alarm"

claude "explain Embassy's executor and how it differs from traditional RTOS"

claude "implement multiple concurrent tasks on STM32U585: LED blink, UART echo, and button monitoring"

claude "create a task that reads a sensor every second using async delays and I2C"

claude "implement OCTOSPI interface for external flash memory on STM32U585"

claude "configure memory-mapped mode for OCTOSPI flash and execute code from it"

claude "implement USB device with embassy-usb supporting multiple interfaces"

claude "create a USB HID device on STM32U585 for custom input device"

claude "use the AES peripheral on STM32U585 to encrypt data with AES-128"

claude "implement secure data storage using AES encryption in flash"

claude "configure LPUART1 to work in STOP mode for low-power serial communication"

claude "implement a state machine that transitions between Run, Sleep, Stop1, Stop2, and Standby modes"

claude "configure SRAM retention in Stop mode and demonstrate preserving data"

claude "set up autonomous peripherals (LPTIM, LPUART) to run while CPU is in Stop mode"

claude "implement battery-powered sensor node that maximizes battery life using STM32U585 power modes"

claude "set up a testing framework for Embassy-based STM32U585 code with mocked HAL"

claude "create integration tests that can run on both host and target"

claude "configure probe-rs for RTT (Real-Time Transfer) logging on STM32U585"

claude "set up defmt for efficient logging with minimal overhead"

claude "create a probe-rs configuration file for STM32U585 with custom memory regions"

claude "optimize the build for minimum binary size using LTO and size optimization for Cortex-M33"

claude "configure link-time optimization specific to STM32U585 with TrustZone consideration"

claude "set up multiple build profiles: debug with defmt, release optimized for size, and release optimized for speed"

claude "create a build script that uses flip-link to detect stack overflows on STM32U585"

[profile.release]
opt-level = "z"  # Optimize for size
lto = "fat"
codegen-units = 1
debug = true  # Keep debug symbols for probe-rs

claude "implement embassy channels for communication between tasks"

claude "use embassy-sync Mutex for sharing resources between async tasks"

claude "create a task pool for dynamic task management"

claude "implement watchdog integration with Embassy executor"

claude "design an async architecture for a battery-powered IoT sensor hub with:
- Multiple I2C sensors
- LoRa communication
- USB configuration interface
- Low-power management
- Data buffering in SRAM"

src/
├── main.rs
├── board/
│   └── blackpill_u585.rs  # BSP
├── drivers/
│   ├── sensor_async.rs
│   ├── lora_sx127x.rs
│   └── flash_storage.rs
├── tasks/
│   ├── sensor_monitor.rs
│   ├── data_transmission.rs
│   └── power_manager.rs
├── protocols/
│   └── lorawan.rs
└── utils/
    ├── async_ringbuffer.rs
    └── power_budget.rs

claude "explain TrustZone implementation on STM32U585 and when to use it"

claude "create a simple TrustZone example with secure and non-secure worlds"

claude "implement secure key storage using STM32U585's secure memory regions"

claude "implement a USB mass storage device that logs sensor data to virtual flash drive using STM32U585"

claude "create a LoRa-based sensor node with STM32U585 that sleeps in Stop2 mode and wakes periodically to transmit"

claude "use SAI peripheral on STM32U585 to capture and process audio with DSP algorithms"

claude "analyze instruction cache effectiveness on STM32U585 and optimize code placement"

claude "implement DMA-based circular buffer for high-speed ADC sampling"

claude "optimize critical loops using ARM Cortex-M33 DSP extensions"

claude "implement USB composite device (CDC + HID) on STM32U585"

claude "create firmware update mechanism over USB DFU"

claude "implement USB power delivery detection and negotiation"

claude "create a secure bootloader for STM32U585 with firmware signature verification"

claude "implement dual-bank firmware update with automatic rollback"

claude "create a bootloader that supports USB DFU and UART update"

claude "create a comprehensive pinout diagram reference for WeAct STM32U585 Black Pill as a markdown table"

claude "implement USB-C power detection and optimize power consumption based on power source"

claude "design a file system for storing configuration and data in internal flash"

claude "implement large data buffers in SRAM for DSP operations"

# STM32U5 has complex clock tree
claude "create a clock configuration calculator for STM32U585 and validate my 160MHz setup"

# STM32U5 requires proper power domain setup
claude "explain STM32U585 power domain initialization sequence and common errors"

# Make informed choice
claude "when should I use Embassy vs stm32u5xx-hal for my STM32U585 project?"

# When encountering Cortex-M33 specific errors
claude "I'm getting this linker error on STM32U585: [paste error]. The target is thumbv8m.main-none-eabihf"

# Setup RTT
claude "configure probe-rs RTT for STM32U585 and show me how to add logging statements"

# Analyze crash
claude "I got a HardFault on STM32U585. Here's the backtrace from probe-rs: [paste]. Help debug."

claude "my STM32U585 is consuming more power than expected in Stop mode. Help me audit the peripheral configurations"

claude "USB device on STM32U585 isn't enumerating. Check my USB peripheral init code and descriptor"

claude "set up defmt logging with different log levels for STM32U585 development"

claude "explain why Embassy is particularly well-suited for STM32U5's low-power capabilities"

claude "configure flip-link to detect stack overflows on STM32U585"

claude "create a power budget spreadsheet for my STM32U585 project with different modes"

claude "document the memory layout of my STM32U585 project including SRAM regions and flash sectors"

# Have Claude help you navigate these
claude "summarize the key points from STM32U585 reference manual chapter on power management"

claude "find relevant examples in embassy-stm32 repository for STM32U5 family"

claude "explain the differences between STM32U575 and STM32U585"

# Use Claude to help find and understand community content
claude "search for STM32U585 Rust projects on GitHub and analyze their architecture"

claude "find Embassy examples using STM32U5 and explain the common patterns"

# Morning: Plan the day
claude "today I want to implement async SPI communication with an external flash chip on STM32U585. Create a step-by-step plan"

# During development: Incremental help
claude "implement the SPI initialization for STM32U585 SPI1 at 10MHz"
# Test, then continue
claude "now add async read/write methods using embassy DMA"
# Test, then continue  
claude "implement sector erase and program operations with proper error handling"

# Evening: Review and document
claude "review my SPI flash driver for safety issues and add documentation comments"

# When stuck
claude "I'm having an issue with [describe problem] on STM32U585. Here's my code: [paste]. Help debug systematically"

# For optimization
claude "this code works but is too slow/large. Optimize it for STM32U585: [paste code]"

# For understanding
claude "explain what this Embassy macro is doing in the context of STM32U585: [paste macro]"