how are you
Welcome to Flux
Treat Flux like your intern. Tell it what you'd like to build and it'll get to work. You can also ask it questions, brainstorm ideas, and teach it your preferences. Learn More
Explain project
Write a project description
Find schematic issues
Create a test plan
Simulate a circuit
Prepare for Manufacturing
Component Selection Workflow
New Subsystem Wizard
Write I2C initialization code
Generate firmware skeleton
Refine this doc
Ask about this doc
Connectivity and Onboarding Specification
Purpose
Define how the radio connects to networks and user devices, and how the initial setup experience should work.
Product Context
- Retro-inspired IoT radio with wood-look cabinet
- Approximate width: 220 mm
- Two front knobs
- Small center display
- WiFi enabled
- Bluetooth enabled
- Streaming-ready audio product
- Rechargeable battery operation supported
Connectivity Goals
- Simple first-time setup
- Reliable WiFi reconnection after power cycles
- Easy Bluetooth pairing and reconnect behavior
- Clear source switching between network streaming and Bluetooth audio
- Minimal user friction despite small-display interface constraints
Wireless Features
WiFi
- Product should support network connection for streaming functionality
- Product should provide clear status during scan, connect, failure, and reconnect states
- Product should handle power-up reconnection gracefully
Bluetooth
- Product should support Bluetooth audio playback from a phone or similar device
- Pairing state and connection state should be clearly shown on the display
- Reconnect behavior should be predictable and user-friendly
Onboarding UX Direction
First Boot
- Device should guide the user through an initial setup path
- If no WiFi is configured, the product should present a clear setup state rather than a generic error
- The display and knobs should allow the user to understand what mode the radio is in at all times
Setup States to Support
- Unconfigured device
- WiFi setup in progress
- WiFi connected
- Bluetooth pairing mode
- Bluetooth connected
- Streaming source selected
- Playback active
- Error or reconnect state
User Interface Implications
- Small center display must present concise but readable connectivity feedback
- Two-knob interaction model must be sufficient for source selection, navigation, and confirmation
- Critical indicators include:
- WiFi connection state
- Bluetooth state
- Active source
- Battery and charging state
- Playback state
Control Model Expectations
- One knob likely serves browsing/navigation
- One knob likely serves volume and/or context actions
- Source changes should be accessible with minimal steps
- Pairing and setup should not require hidden or unintuitive gestures where avoidable
System Behavior Requirements
- Product should restore last known source and user settings when practical
- Product should indicate failed network reconnection clearly
- Product should remain usable in Bluetooth mode even if WiFi is unavailable
- Battery mode should not make onboarding confusing or fragile
Security and Reliability Direction
- Network onboarding should avoid exposing unnecessary technical complexity to the user
- Credentials handling and reconnect behavior should be robust
- Firmware architecture should support future enhancement of streaming services and connection flows
Open Decisions
- Exact onboarding method for WiFi setup
- Whether mobile-assisted onboarding is required
- Which streaming ecosystem(s) are primary
- Whether guest/recovery/reset flow is surfaced on the display or via hidden button sequence
- Whether BLE-assisted setup is part of the final experience
Downstream Impact
This document informs:
- Display and UX specification
- System requirements
- Main processor selection
- Firmware partitioning
- Schematic interface requirements for user controls and indicators
Purpose
Product Context
Connectivity Goals
Wireless Features
WiFi
Bluetooth
Onboarding UX Direction
First Boot
Setup States to Support
User Interface Implications
Control Model Expectations
System Behavior Requirements
Security and Reliability Direction
Open Decisions
Downstream Impact