PineVoice

From PINE64
Revision as of 15:27, 24 June 2026 by Gamelaster (talk | contribs) (Update PineVoice documentation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
The PineVoice

The PineVoice is a compact RISC-V based smart speaker based on the Bouffalo Lab BL606P RISC-V SoC. It is designed as a local voice assistant satellite, with Wi-Fi, Bluetooth, a speaker, a dual microphone array, buttons, and a center ring LED.

The factory firmware is open-source and provides Wi-Fi provisioning over Improv, local wake word detection, and voice assistant connectivity through the Wyoming protocol, making PineVoice compatible with assistance platforms such as Home Assistant.

Specifications

SoC and memory

Powered by RISC-V
BL606P block diagram

PineVoice is based on the Bouffalo Lab BL606P.

CPU architecture

T-Head C906 480 MHz 64-bit RISC-V CPU:

  • Supports RISC-V RV64IMAFCV instruction architecture
  • Five-stage single-issue sequentially executed pipeline
  • Level-1 instruction and data cache of Harvard architecture, with a size of 32 KiB and a cache line of 64 bytes
  • Sv39 memory management unit
  • Supports AXI 4.0 128-bit master interface
  • Supports core local interrupt (CLINT) and platform-level interrupt controller (PLIC)
  • Compatible with RISC-V PMP

T-Head E907 320 MHz 32-bit RISC-V CPU:

  • Supports RISC-V RV32IMAFCP instruction set
  • Supports RISC-V 32-bit and 16-bit mixed instruction set
  • Supports RISC-V machine mode and user mode
  • Integer and floating-point pipelines
  • Supports AXI 4.0 main device interface and AHB 5.0 peripheral interface
  • 32 KiB instruction cache
  • 16 KiB data cache

T-Head E902 150 MHz 32-bit RISC-V CPU.

Memory and storage

  • 32 MiB pSRAM
  • 788 KiB SRAM
  • 16 MiB flash storage

Hardware features

Wireless

  • Wi-Fi 802.11 b/g/n
  • Bluetooth 5.2 Dual-mode (BT+BLE)

Audio

  • Built-in speaker tuned for voice applications
  • Dual microphone array

Controls and indicators

PineVoice buttons view
  • Button controls
  • Center LED ring and button
  • Hardware mute button

Power and connectivity

  • USB-C power input and data channel
  • Debug UART exposed on unused USB-C pins

Package contents

  • USB-A to USB-C power cable

Software

The factory PineVoice firmware turns PineVoice into a voice assistant satellite. Firmware uses Alibaba's AliOS, specifically the YoC/YoCop variation.

Supported features

The current factory firmware supports:

  • Wi-Fi provisioning using the Improv protocol over Bluetooth Low Energy
  • Wyoming satellite for compatible assistance applications
  • Wyoming mDNS auto-discovery for compatible assistance applications
  • Local wake word detection using MicroWakeWord

Source code

The PineVoice SmartSpeaker SDK source code is available on Codeberg and GitHub.

Wi-Fi setup

PineVoice implements the open-source Improv Wi-Fi provisioning protocol. Any application supporting this protocol can set up Wi-Fi on PineVoice.

Entering provisioning mode

On first boot, PineVoice automatically enters Wi-Fi provisioning mode. While in this mode, the ring LED blinks yellow.

If the ring LED is not blinking yellow, the speaker is not in provisioning mode. Hold the dot button for 15 seconds to reset Wi-Fi setup and return PineVoice to provisioning mode. After releasing the button, PineVoice should restart and launch provisioning mode.

Provisioning through the web

Web provisioning requires a browser with Web Bluetooth API support. See the Web Bluetooth support table for browser compatibility.

Open the PineVoice documentation website on a PC or phone with Bluetooth 4.0 Low Energy support and use the Improv provisioning button there. If that button does not work, try provisioning from the Improv website.

Provisioning through Home Assistant

Home Assistant supports Improv via BLE. This feature must be configured in Home Assistant and requires working Bluetooth support. See the Home Assistant Bluetooth documentation for details.

Improv card in Home Assistant

After successful Wi-Fi provisioning, continue with assistance setup.

Assistance setup

PineVoice implements the open-source Wyoming protocol for voice assistants. Any assistance application supporting this protocol can communicate with PineVoice.

After PineVoice has joined the Wi-Fi network, the center ring LED should slowly breathe in a dim magenta color. This means PineVoice is connected to Wi-Fi and is waiting for an assistance application to connect through the Wyoming protocol.

Adding PineVoice to Home Assistant

Home Assistant supports Wyoming Protocol devices through the Wyoming Protocol integration. Home Assistant must also have a working Assist voice pipeline. Follow the Home Assistant Assist documentation if Assist has not been configured yet.

Automatic setup

PineVoice supports mDNS auto-discovery. If Home Assistant can see mDNS announcements on the same network, PineVoice should appear automatically as a discovered Wyoming Protocol device.

  1. Open Home Assistant.
  2. Go to Settings -> Devices & services.
  3. Look for a discovered Wyoming Protocol device.
  4. Select Configure.
  5. Follow the on-screen instructions to finish adding PineVoice.

After setup completes, PineVoice should be available as an Assist satellite in Home Assistant.

Manual setup

If PineVoice does not appear automatically, add it manually through the Wyoming Protocol integration.

  1. Find the IP address of PineVoice in the client list of your Wi-Fi router or access point.
  2. Open Home Assistant.
  3. Go to Settings -> Devices & services.
  4. Select Add integration.
  5. Search for and select Wyoming Protocol.
  6. Enter the PineVoice IP address as the host.
  7. Enter 10700 as the port.
  8. Follow the on-screen instructions to finish adding PineVoice.

Troubleshooting

Known issues currently being investigated:

  • If PineVoice is stuck in the listening state or Home Assistant does not react when Assist starts, restart PineVoice.
  • If adding the device fails, press Retry / Try Again, or try to add PineVoice again.

If Home Assistant cannot connect to PineVoice, check the following:

  • PineVoice and Home Assistant are on the same network or VLAN.
  • The center ring LED is breathing in dim magenta.
  • The IP address entered in Home Assistant is the current IP address of PineVoice.
  • TCP port 10700 is reachable from the Home Assistant system.
  • mDNS is allowed on the network if using automatic discovery.

For more information, see the Home Assistant Wyoming Protocol integration documentation.

Testing

After PineVoice is added to an assistance application, Assist can be triggered in the following ways:

  • Say the wake word: "Hey Jarvis"
  • Press the center button in the LED ring

After triggering Assist, say a command supported by the assistance application. The assistance application should reply accordingly.

LED ring lightshows and controls

The center LED ring shows the current state of PineVoice. For most actions and states, light shows are used instead of voice feedback so PineVoice does not unexpectedly disturb the user, for example during the night. Active-state light shows, such as the dim cyan standby light, are intentionally kept dim so they remain visible without being distracting in a dark room.

Startup and setup

Light show Meaning
Dim white fade-in/fade-out, once Boot-up lightshow. PineVoice has started.
Yellow breath, loop PineVoice is in provisioning mode and is ready to connect to Wi-Fi through the Improv protocol.
Green fade-in/fade-out, once Identification signal during provisioning, used to identify the paired PineVoice.
Dim orange breath, loop PineVoice is trying to connect to Wi-Fi.
Dim magenta breath, loop PineVoice is waiting for a Wyoming client to connect.

Action feedback

Light show Meaning
White fade-in, once Volume up.
White fade-out, once Volume down.
Red fade-out, once An error happened or the action failed.

Button controls

PineVoice buttons view

PineVoice has five top buttons for voice control, volume, microphone mute, and provisioning.

  • Center LED ring button - starts a voice command session.
  • + button - increases the volume.
  • - button - decreases the volume.
  • Microphone button - hardware microphone mute. The button shines red while microphone mute is active.
  • Dot / user button - currently used to enter provisioning mode. Hold it for 15 seconds to reset Wi-Fi setup and return PineVoice to provisioning mode.

Voice feedback and wake word detection

PineVoice mostly uses light shows instead of voice feedback. Voice feedback is generally reserved for direct user interaction.

Audio feedback is currently used in the following cases:

  • Wi-Fi provisioning started - played when Wi-Fi provisioning starts, including on first boot.
  • Wi-Fi provisioning succeeded or failed - played when Wi-Fi provisioning finishes successfully or fails.
  • Wyoming satellite is disconnected - played when Assist is attempted, but the Wyoming satellite/client is not connected.
  • Wi-Fi is disconnected - played when Assist is attempted, but PineVoice is not connected to Wi-Fi.

PineVoice uses MicroWakeWord for local wake word detection.

For now, PineVoice uses the "Hey Jarvis" model from the ESPHome MicroWakeWord models project. Wake word recognition may vary depending on the speaker's voice, pronunciation, distance from the device, and background noise.

Future firmware updates are expected to add support for custom MicroWakeWord-compatible models. There are also plans to train a PineVoice-specific wake word model. If you are interested in helping with model training, contact us through the community channels.

Board information, schematics and certifications

Module dimensions:

  • 65 mm x 65 mm x 66 mm

Production version schematics:

Certifications:

Datasheets

Bouffalo BL606P SoC information:

SPI NOR flash information:

Retrieved from "https://wiki.pine64.org/index.php?title=PineVoice&oldid=23253"