From 301f7661a6dce9a001415368969af9faad27b56e Mon Sep 17 00:00:00 2001 From: Florian Asche Date: Sun, 26 Jul 2026 16:45:07 +0200 Subject: [PATCH 1/2] fix(sat1): update SDK version and clarify readme audio volume description Update the Python SDK download URL to version 0.1.6 in the satellite1 audio driver setup script and refine the README description regarding system audio volume settings. --- 02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh b/02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh index aa4421f..fca854e 100755 --- a/02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh +++ b/02-stage-audiodriver-satellite1-v1.0/01-driver/03-run-chroot.sh @@ -20,5 +20,5 @@ dpkg -i satellite1-rpi-setup_*_arm64.deb # 3. Install the Python SDK #echo "Download and install Python SDK" -wget https://github.com/FutureProofHomes/Satellite1-RPi-SDK/releases/download/develop/satellite1-rpi-sdk_0.1.5_arm64.deb +wget https://github.com/FutureProofHomes/Satellite1-RPi-SDK/releases/download/v0.1.6/satellite1-rpi-sdk_0.1.6_arm64.deb dpkg -i satellite1-rpi-sdk_*_arm64.deb diff --git a/README.md b/README.md index 489467c..005c26e 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ The image is configured to: 2. Start seeed-voicecard service (If you use 2-MicHat) 3. Start Pipewire service 4. Start Keep-Audio-Alive service (If you use Respeaker Lite) -5. Set audio volume to 100% +5. Set system audio volume to 100% 6. Set hostname 7. Search for Docker Compose files in a special directory on the main partition 💡 **Note:** If you use the Linux-Voice-Assistant Image LVA and Snapcast will be included in the project directory. From 797fca07c16c8efb4b07f0e97f35d51e266c0152 Mon Sep 17 00:00:00 2001 From: Florian Asche Date: Sun, 26 Jul 2026 18:37:40 +0200 Subject: [PATCH 2/2] docs(readme): improve installation guide and hardware documentation Refine the README with clearer Raspberry Pi Imager instructions, including macOS support and specific user configuration notes. Update the hardware documentation for Satellite1 to include a detailed parts table and improved ordering options. - Add macOS installation commands for rpi-imager - Clarify Raspberry Pi Imager customization requirements - Fix typos and improve link descriptions in README - Restructure Satellite1 hardware guide with a comprehensive parts list - Add Satellite1 support to the main hardware overview list --- README.md | 20 ++++++++++---- docs/hardware_sattelite1.md | 52 +++++++++++++++++-------------------- 2 files changed, 39 insertions(+), 33 deletions(-) diff --git a/README.md b/README.md index 005c26e..c8ae1de 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ PiCompose uses the official [pi-gen](https://github.com/RPi-Distro/pi-gen) tool The image is configured to: -1. Install needed drivers for the hardware (2-MicHat) +1. Install needed drivers for the hardware (2-MicHat, Satellite1) 2. Start seeed-voicecard service (If you use 2-MicHat) 3. Start Pipewire service 4. Start Keep-Audio-Alive service (If you use Respeaker Lite) @@ -36,7 +36,7 @@ This repository contains fully prepared images for specific voice hardware of Ho ### Hardware -There is a seperated page for the supported hardware. You can find the link to it in the list below, when you click on the Name. +There is a separate page for the supported hardware. You can find the link to it in the list below, when you click on the Name. ### Images overview @@ -53,7 +53,11 @@ Here is a Overview for the specific images of each hardware: ### Installation -You can burn the image to your sd card with the [Raspberry Pi Imager tool](https://www.raspberrypi.com/software/). You can set wifi credentials, ssh public keys and other settings before you burn the image to your sd card. In order to use the feature where you can change the settings in the `Raspberry Pi Imager >=v2.5.0` you need to set a custom image repository. +You can burn the image to your sd card with the [Raspberry Pi Imager tool](https://www.raspberrypi.com/documentation/computers/getting-started.html#imager-install). You can set wifi credentials, ssh public keys and other settings before you burn the image to your sd card. In order to use the feature where you can change the settings in the `Raspberry Pi Imager >= v2.0` you need to set a custom image repository. + +💡 **Note:** If you use the Customisation" (sic) part of the "Raspberry Pi Imager tool", the "User" must be set to "pi". + +Windows, macOS, and Linux are supported. On macOS, you can use the Raspberry Pi Imager application or install it via Homebrew. Windows @@ -67,9 +71,15 @@ Linux rpi-imager --repo https://github.com/florian-asche/PiCompose/releases/download/rpi-imager-json/rpi-imager.json ``` +macOS + +```sh +rpi-imager --repo https://github.com/florian-asche/PiCompose/releases/download/rpi-imager-json/rpi-imager.json +``` + You can also put the [URL](https://github.com/florian-asche/PiCompose/releases/download/rpi-imager-json/rpi-imager.json) in Settings - Image Repository - Use own URL. -If you dont want to use the Raspberry Pi Imager tool you can also [download](https://github.com/florian-asche/PiCompose/releases) the image and configure keyboard, timezone and wifi credentials with the `raspi-config` tool. +If you don't want to use the Raspberry Pi Imager tool you can also [download](https://github.com/florian-asche/PiCompose/releases) the image and configure keyboard, timezone and wifi credentials with the [`raspi-config` tool](https://www.raspberrypi.com/documentation/computers/configuration.html#raspi-config). If you don't use the Raspberry Pi Imager customization, you'll need to connect a monitor, keyboard, and mouse to access the Pi initially to configure SSH and WiFi via `raspi-config`. ### Configuration @@ -124,7 +134,7 @@ The system will automatically reboot and install the audio drivers. After that y You will notice that the hardware is not visible if you run `aplay -L`.
❗ *You need to manually reboot one more time.* -After that `aplay -L` should show the `seeed2micvoicec` or `Lite` soundcard depending on your hardware. +After that `aplay -L` should show the `seeed2micvoicec`, `Lite`, or `Satellite1` soundcard depending on your hardware. piCompose should download and install the containers. You can watch the `/var/log/picompose.log` logfile if you want to monitor the process. diff --git a/docs/hardware_sattelite1.md b/docs/hardware_sattelite1.md index 0142a75..f5bfd0c 100644 --- a/docs/hardware_sattelite1.md +++ b/docs/hardware_sattelite1.md @@ -5,45 +5,41 @@ Features: - Microphone Processing: High-performance microphones with an XMOS audio processing chip. - Audio Output: Supports high-quality Snapcast multi-room music playback via the powerful 25W built-in amplifier or headphone jack. -- Controls: 4 programmable tactile buttons, including hardware mute for privacy. 360 degree addressable LED ring. +- Controls: 4 programmable tactile buttons, including hardware mute for privacy. 360 degree addressable LED ring. - Sensors: Monitors room temperature, humidity, luminosity, and human presence (when paired with a mmWave radar sensor). - Radios: Built-in 2.4 GHz Wi-Fi and Bluetooth® 5 (LE). - Expandable: FX23L expansion connector for future accessories. - Compatible: Works with Home Assistant, Music Assistant - Audio Processor: XMOS XU316, 16-core 32-bit RISC running at 800 MHz with 3200 MIPS, 1024 KB SRAM, and 8 MB Flash. +## Order Options -## Order +### Full Kit -What you need to buy: +Buy the [full kit](https://futureproofhomes.net/products/satellite1-smart-speaker) and add a Raspberry Pi Zero 2 WH. -### Base: +### Individual Parts -- Raspberry Pi Zero 2 WH (currently no link) or if you can solder the pins yourself [Raspberry Pi Zero 2 W](https://amzn.to/3M0G4hC) -- [SD-Card](https://amzn.to/4qfx06l) +💡 **Note:** You will need to buy a Pi Zero 2 board with the pins already attached (WH version) to use a HAT board. You can buy the Pi board with factory-installed pins from authorized resellers, or use a hammer-in kit to install the pins on the board. There are probably a few adventurous souls that want to solder in the pins but I expect that most people won't. -### Satellite1 HAT Board: +| Part | Primary Source | Alternative Sources | +|------|------------------|---------------------| +| Satellite1 HAT Board | [FutureProofHomes](https://futureproofhomes.net/products/satellite1-1-hat-board) | - | +| Raspberry Pi Zero 2 WH or Raspberry Pi Zero 2 W | - | [Amazon](https://amzn.to/3M0G4hC) | +| Charger | [FutureProofHomes](https://futureproofhomes.net/products/30w-usb-c-pd-charger) | [Amazon: Anker Nano Charger](https://www.amazon.com/dp/B0B2MLRF93) | +| Charger Cable (USB-C) | [FutureProofHomes](https://futureproofhomes.net/products/usb-c-cable) | - | +| SD Card | - | [Amazon](https://amzn.to/4qfx06l) | +| Speaker | [FutureProofHomes](https://futureproofhomes.net/products/3-inch-woofer-4ohm-20w) | [Amazon](https://www.amazon.com/dp/B0822XCPT8), [Aliexpress](https://s.click.aliexpress.com/e/_c33mJJNH) | +| Tweeter | [FutureProofHomes](https://futureproofhomes.net/products/tweeter-4ohm-20w) | [Amazon](https://amzn.to/4k9gHXq), [Aliexpress](https://de.aliexpress.com/item/1005008134122115.html) | +| Two Way Speaker Crossover Board | [FutureProofHomes](https://futureproofhomes.net/products/two-way-speaker-crossover) | [Aliexpress](https://de.aliexpress.com/item/1005006342929950.html) | +| Speaker Cable 2x | [FutureProofHomes (Red)](https://futureproofhomes.net/products/4-8mm-spade-cable-red), [FutureProofHomes (Black)](https://futureproofhomes.net/products/2-8mm-spade-cable-black) | - | +| JST Connector | [FutureProofHomes](https://futureproofhomes.net/products/jst-xh-2-54mm-2-pin-male-connector) | [Amazon](https://amzn.to/3TC4Urq) | +| Screws | [FutureProofHomes](https://futureproofhomes.net/products/m3x10mm-hex-socket-head-cap-screws) | [Amazon](https://amzn.to/3RiytxE) | +| Sealing Foam | [FutureProofHomes](https://futureproofhomes.net/products/epdm-sealing-foam-strip) | [Amazon](https://amzn.to/4yHYA1I) | +| OEM 3D Print Design | [FutureProofHomes GitHub](https://github.com/FutureProofHomes/Satellite1-Enclosures/tree/main/OEM%20Enclosures/Satellite1.1%20Smart%20Speaker%20Enclosure%20Kit) | - | -- [Satellite1 HAT Board](https://futureproofhomes.net/products/satellite1-top-microphone-board) -- [9V 3A Power Supply for US](https://amzn.to/49RDELn) - - -## Speaker: - -- [Whole Speaker kit](https://futureproofhomes.net/products/satellite1-smart-speaker-enclosure-kit) - -Or if you want to build and 3D-Print it yourself: - -- [Speaker](https://amzn.to/4k9gkfu) or [Aliexpress](https://de.aliexpress.com/item/1005011560142502.html?spm=a2g0o.productlist.main.3.33c9JJacJJacEB&algo_pvid=64814943-53f2-4063-858b-24b8bff7bd47&algo_exp_id=64814943-53f2-4063-858b-24b8bff7bd47-2&pdp_ext_f=%7B%22order%22%3A%22-1%22%2C%22eval%22%3A%221%22%2C%22fromPage%22%3A%22search%22%7D&pdp_npi=6%40dis%21EUR%217.78%213.89%21%21%2162.89%2131.44%21%402103868817699707030983290ea297%2112000055921741746%21sea%21DE%21797676231%21X%211%210%21n_tag%3A-29919%3Bd%3A64670a7c%3Bm03_new_user%3A-29895&curPageLogUid=uNvseW668v4i&utparam-url=scene%3Asearch%7Cquery_from%3A%7Cx_object_id%3A1005011560142502%7C_p_origin_prod%3A) -- Optional: [Alternative Speaker](https://amzn.to/3ZIgnFA) -- [Cable for Speaker](https://amzn.to/3NQtEJT) -- [Crossover](https://de.aliexpress.com/item/1005006342929950.html?invitationCode=RElGaGNTVnp5aVh0S3dka2VST2FHR2l1eUNRV2NZcThRWmgvWnRFdUtnYWVQemFTZUJrNWVWT0s1MU1hdTAyWg&srcSns=sns_Copy&spreadType=socialShare&social_params=61399346706&bizType=ProductDetail&spreadCode=RElGaGNTVnp5aVh0S3dka2VST2FHR2l1eUNRV2NZcThRWmgvWnRFdUtnYWVQemFTZUJrNWVWT0s1MU1hdTAyWg&aff_fcid=2fae6e0ee0d445b393d87f5cf6411c9f-1769967697975-07738-_EIJyBko&tt=MG&aff_fsk=_EIJyBko&aff_platform=default&sk=_EIJyBko&aff_trace_key=2fae6e0ee0d445b393d87f5cf6411c9f-1769967697975-07738-_EIJyBko&shareId=61399346706&businessType=ProductDetail&platform=AE&terminal_id=29ee5f8658dd4e0898da1a1fba47d83e&afSmartRedirect=y) -- [Tweeter](https://amzn.to/4k9gHXq) or [Aliexpress](https://de.aliexpress.com/item/1005008134122115.html?spm=a2g0o.productlist.main.1.593aGJ4bGJ4bug&algo_pvid=d39a4e60-913d-4c2c-b30e-7b5e0f643b71&algo_exp_id=d39a4e60-913d-4c2c-b30e-7b5e0f643b71-0&pdp_ext_f=%7B%22order%22%3A%225%22%2C%22eval%22%3A%221%22%2C%22fromPage%22%3A%22search%22%7D&pdp_npi=6%40dis%21EUR%218.05%218.05%21%21%219.37%219.37%21%40211b61ae17699713550016574ea8ce%2112000043930964935%21sea%21DE%21797676231%21X%211%210%21n_tag%3A-29919%3Bd%3A64670a7c%3Bm03_new_user%3A-29895&curPageLogUid=QHG13DgSQL42&utparam-url=scene%3Asearch%7Cquery_from%3A%7Cx_object_id%3A1005008134122115%7C_p_origin_prod%3A) -- [Insulation](https://amzn.to/4t7Gtj3) - - -## Additional information: +## Additional Information - [Hardware Documentation](https://docs.futureproofhomes.net/satellite1-assembly/#first-boot-powering-on) -- [Speaker Enclosure](https://docs.futureproofhomes.net/satellite1-smart-speaker-enclosure-kit/) -- [OEM 3D Print Design](https://github.com/FutureProofHomes/Satellite1-Enclosures/tree/main/OEM%20Enclosures/Satellite1%20Smart%20Speaker%20Enclosure%20Kit) +- [How to build the Speaker Enclosure](https://docs.futureproofhomes.net/satellite1-smart-speaker-enclosure-kit/) +- [Alternative 3D Designs](https://docs.futureproofhomes.net/satellite1-squircle-enclosures) - Compatible with [alternative speakers](https://amzn.to/4pGP4rp) \ No newline at end of file