Logo
  • Introduction
    • Who is Thermoquad For?
    • Project Components
    • Project Goals
    • Getting Started
  • Getting Started
    • Quick Start
  • Development
    • Setup
      • Arch Linux
    • Roadmap
      • First Burn
        • Overview
        • Hardware Architecture
        • Project Structure
        • Parameters to Extract
        • Stan Serial Protocol
        • Prometheus Metrics
        • Prioritized Work Order
        • Milestones
        • Success Criteria
        • GitHub Tracking
      • Helios Verification Tests
        • Prerequisites
        • Test Cases
        • Results Template
      • Burn Report Template
        • Test Information
        • Pass/Fail Criteria
        • Observations
    • Research
      • RP2350 Flash Usage
        • Executive Summary
        • Hardware Overview
        • Zephyr Flash Support Status
        • Storage Options
        • MicroPython Comparison
        • OTA Updates and Custom Flash
        • Implementation Plan
        • Factory Reset
        • Risks and Mitigations
        • References
        • Appendix A: Zephyr Version Requirements
        • Appendix B: Flash Partition Macros
      • User Onboarding
        • Executive Summary
        • System Architecture
        • Onboarding Flow
        • Zephyr Implementation
        • PWA Implementation
        • Security Considerations
        • OTA Update Considerations
        • Feasibility Assessment
        • Implementation Roadmap
        • References
        • Appendix A: SSID Generation
        • Appendix B: Captive Portal Response
        • Appendix C: Web Bluetooth GATT Service
      • Roastee Web Stack
        • Executive Summary
        • Constraints
        • Framework Comparison
        • CSS Framework Comparison
        • Internationalization
        • Accessibility
        • State Management
        • Build Tooling
        • Modular Architecture
        • Authentication State
        • Error Handling and Logging
        • Bundle Size Estimates
        • Alternatives Considered
        • Proposed Experiments
        • Implementation Roadmap
        • References
        • Appendix A: Minimum Viable Stack
        • Appendix B: TypeScript Consideration
        • Appendix C: Browser Support
      • Roastee Stack Tests #1
        • Executive Summary
        • Experiment Results
        • Conclusions
        • On-Device Testing: Bucket
        • Proposed Further Experiments
        • Appendix A: Experiment Source Code
        • Appendix B: Measurement Methodology
      • Roastee Stack Tests #2
        • Executive Summary
        • Background
        • CBOR Library Comparison
        • Custom Codec
        • Implementation Results
        • Bundle Impact Analysis
        • Recommendations
        • Conclusion
        • Appendix A: CBOR Format Reference
        • References
      • Fusain OTA Updates
        • Executive Summary
        • Background
        • OTA Scenarios
        • Proposed Message Types
        • Wire Format Examples
        • CDDL Schema
        • Error Handling
        • Multi-Appliance Considerations
        • Implementation Notes
        • Security Considerations
        • Conclusion
        • References
  • Specifications
    • Burn Cycle
      • Ignition
      • Preheating
      • Heating
      • Cooldown
      • Fault Conditions
      • Related Specifications
    • Fuel Profiles
      • Diesel
        • Temperature Thresholds
        • Timing and Settings
    • Fusain Protocol
      • Overview
        • Device Roles
        • Data Types
        • Implementation Notes
      • Packet Format
        • Structure
        • Addressing
        • CRC Calculation
        • Byte Stuffing
        • Data Types
      • Packet Payloads
        • Message Types
        • Configuration Commands
        • Control Commands
        • Telemetry Data
        • Error Messages
      • Message Types
        • Configuration Commands (0x10-0x1F)
        • Control Commands (0x20-0x2F)
        • Telemetry Data (0x30-0x3F)
        • Error Messages (0xE0-0xEF)
      • Communication Patterns
        • Command-Response
        • Periodic Telemetry
        • Event-Driven Updates
        • Heartbeat
        • Timeout Mode
        • Polling Mode
        • Controller Routing
      • Packet Routing
        • Overview
        • Routing Architecture
        • Session Initiation
        • Ping Behavior
        • Command Forwarding
        • Data Subscriptions
        • Data Forwarding
        • Routing Table
        • Subscription Lifecycle
        • Telemetry Management
        • Implementation Requirements
        • Example Scenario
        • Multi-Hop Routing
        • Considerations
      • WebSocket Transport
        • Overview
        • Transport Format
        • Connection Handling
        • Packet Encoding
        • Gateway Implementation
        • Error Handling
      • TCP Transport
        • Overview
        • Transport Format
        • Connection Handling
        • TLS Configuration
        • Gateway Implementation
        • Error Handling
        • Comparison with WebSocket
      • Physical Layer
        • Overview
        • Transceiver Architecture
        • UART Configuration
        • Plain UART
        • RS-485
        • LIN
        • Comparison Summary
        • Recommendations
        • Protocol Configuration Summary
      • Implementation Guide
        • Buffers
        • Timeouts
        • Byte Synchronization
        • Packet Decoder
        • Packet Encoder
        • Transmission Requirements
        • Emergency Stop Behavior
        • Error Handling
        • Broadcast Retry Requirements
        • CBOR Encoding
        • Zephyr Integration
        • Performance Characteristics
  • Firmware
    • Helios ICU
      • Overview
      • Architecture
    • Slate Controller
      • Overview
      • Hardware
    • Architecture
      • Firmware Architecture Overview
        • Platform
        • Design Principles
        • Directory Structure
    • Building Firmware
      • Prerequisites
      • Build Commands
      • Flashing
  • Hardware
    • Platform
    • Board Definitions
    • Components
  • Development Tools
    • Heliostat
      • Overview
      • Usage
      • Building
    • Taskfile Commands
      • Why Taskfile?
      • Common Tasks
    • Debugging
      • Serial Debugging
      • Logging
      • GDB Debugging
  • Reference
    • Language Use & Conventions
      • Requirement Keywords
        • Keyword Definitions
        • Keyword Preference
      • Terminology
        • Silent Ignore
      • Notation Conventions
        • Hexadecimal Values
        • Byte Order
        • Ranges
        • Units
      • References
    • Fusain Protocol Specification
      • Document Status
      • Packet Format
    • Hardware Specification
      • Pin Assignments
        • Helios ICU
      • Electrical Specifications
    • API Reference
      • Fusain Library API
        • Functions
        • Types
    • Glossary
  • Contributing
    • How to Contribute
    • Code Style
    • Git Workflow
    • Commit Messages
    • Documentation
Thermoquad
  • Development

Development

Guides for setting up a development environment for Thermoquad projects.

  • Setup
    • Arch Linux
  • Roadmap
    • First Burn
    • Helios Verification Tests
    • Burn Report Template
  • Research
    • RP2350 Flash Usage
    • User Onboarding
    • Roastee Web Stack
    • Roastee Stack Tests #1
    • Roastee Stack Tests #2
    • Fusain OTA Updates

© Copyright 2026, Kaz Walker & Thermoquad Team.
Built with Sphinx using a theme provided by Read the Docs and the Zephyr Project.