Light ring and buttons
What each colour and animation of the light ring means, and what the four buttons do.
The device has no screen. The light ring shows what it is doing, and the four buttons on top control it. This page describes both.
Light ring
While the device starts
| What you see | Meaning |
|---|---|
| A blue arc that grows clockwise from the Action button | Pinna is starting. The arc grows with each step: the storage, the root filesystem, the system, USB, the Wi-Fi driver, pinnad |
| The whole ring fills, then fades out | Pinna started and passed its health check |
| Green, slowly getting brighter and dimmer, or steady | Pinna is in rescue mode: it couldn’t start. See Rescue mode |
| White, flashing a few times, then a pause, repeating | A start-up step didn’t finish in time. Count the flashes: 4 is USB, 5 the Wi-Fi driver, 6 pinnad; 1 to 3 belong to rescue mode, where the page names them. The flashes stay while the device is idle, until the next restart |
If a step flashes, the device keeps running — nothing restarts itself. The number says what to look at first; Troubleshooting has the next steps.
Once Pinna runs
The ring shows one state at a time. When two states apply, the higher one in this table wins:
| What you see | Meaning |
|---|---|
| A white light that circles slowly, one turn every 3 seconds | The dashboard asks you to confirm a change at the device. Press the Action button to confirm; see Confirm a change at the device. It shows above every other state, the red of the muted microphones included, for up to 60 seconds |
| A blue light that circles slowly, one turn every 3 seconds | The dashboard asks to record what the satellite hears. Press the Action button to start the recording, only if you asked for it. It shows like the white light, for up to 60 seconds |
| Solid red | The microphones are off |
| Amber, pulsing twice a second | A timer has finished. Say the wake word or press the Action button to stop it |
| Blue, with a brighter part pointing at you | The device is listening to you. When it can’t tell where you are, for example before you speak or in a noisy room, the whole ring slowly gets brighter and dimmer instead. You can turn the pointing off with the Listening direction switch, on the dashboard under Voice & sound > Ring or in Home Assistant |
| A violet light that runs around the ring | Your request is being answered: by Home Assistant, or in standalone mode by your services |
| Cyan, brighter as the voice gets louder | The device is speaking a reply or an announcement |
| A green arc | Wake word calibration runs. The arc shows the sensitivity, and the volume buttons tune it. It shows in place of a running timer’s arc, a notification, the light and the music. See Calibrate at the device |
| Two blue lights that turn slowly around the ring | The Bluetooth pairing window is open: a phone nearby can pair now. It shows in place of a running timer’s arc, a notification, the light and the music. See Pair a phone |
| An amber arc | A timer is running. The arc shows how much time is left |
| Yellow, the whole ring slowly getting brighter and dimmer | A notification is waiting. See Notifications |
| Coloured lights that move with the music, the same on the left and the right: bass at the front, treble at the back | The media player is playing |
| Off | The device is idle |
Short signals appear on top of these states:
| What you see | Meaning |
|---|---|
| Red, flashing three times | Something went wrong: Home Assistant isn’t connected, refused the request or didn’t answer it; in standalone mode, a service failed or the device heard no speech; the microphones are off when you press the Action button; or a calibration +/− press changed nothing. See The ring flashes red three times |
| Green, one flash | The wake word was heard while calibration runs. No request starts |
| A light blue arc, for 1.5 seconds | The volume changed. The arc shows the new level |
Use the ring as a light
The ring is also a light: Light, under Voice & sound > Ring on the dashboard, and LED ring in Home Assistant. You can set its colour, its brightness and one of three effects. On the dashboard, Colour, Light brightness and Effect appear once Light is on:
- Solid: steady light.
- Pulse: slowly getting brighter and dimmer.
- Flash: on and off, every half second.
The light shows only while the device is idle. When the device listens, works on a request or speaks, the ring shows that state, and the light comes back afterwards. While a timer runs or a notification is waiting, the ring shows that instead of the light. The light takes the place of the music lights. It goes off when the device restarts.
Brightness on the dashboard, LED brightness in Home Assistant, sets the brightness of the whole ring, including the states above. The light’s own brightness works within it.
Notifications
The ring can tell you that something happened. While a notification is waiting and the device is idle, the whole ring slowly gets brighter and dimmer in yellow.
Notifications need Home Assistant, in either mode: the Notification switch in Home Assistant controls them. Turn it on from an automation, for example when the washing machine finishes. The notification stays until one of these clears it:
- You press the Action button while the ring shows the notification. This
press doesn’t start a request: the ring flashes once and goes out. If you
set up the read-out in step 4 below, the device reads the message. Press
again after it finishes to talk. The Action button’s
pressevent still fires. - You select Clear on the dashboard.
- Home Assistant turns the switch off.
When you clear it with the Action button or on the dashboard, the
Notification event fires with the type cleared, so an automation can
tell you what the notification was. When Home Assistant turns the switch off,
the event doesn’t fire.
The notification doesn’t show while the microphones are off, while a timer alarm rings, while the device listens, works on a request or speaks, or while a timer runs. It comes back afterwards. While the ring shows something else, the Action button does what it normally does. A waiting notification survives a restart of the device.
Hear what the notification was
The switch only says that something happened. To keep the message, store it in a Home Assistant helper.
The examples use the entity IDs of a device named Echo Dot, such as
switch.echo_dot_notification. To find your device’s entity IDs, go to
Settings > Devices & services > ESPHome and select the device. To add an
automation, go to Settings > Automations & scenes > Create automation >
Create new automation, open the menu, select Edit in YAML, and paste it.
-
Go to Settings > Devices & services > Helpers > Create helper > Text. Name it
Pinna notification. Under More options, set Maximum length to 255. -
Add these two actions to the
actions:of the automation that tells you the washing machine is done. They add the message to the helper, or start a new message if no notification is waiting, and turn the switch on:- action: input_text.set_value target: entity_id: input_text.pinna_notification data: value: >- {% set old = states('input_text.pinna_notification') if is_state('switch.echo_dot_notification', 'on') and has_value('input_text.pinna_notification') else '' %} {% set max = state_attr('input_text.pinna_notification', 'max') | int(100) %} {{ ((old ~ ' The washing machine is done.') | trim)[-max:] }} - action: switch.turn_on target: entity_id: switch.echo_dot_notification -
Add an automation that answers “Alexa, what are my notifications?” and clears them:
alias: Read Pinna notifications triggers: - trigger: conversation command: - "what are my notifications" - "read my notifications" actions: - variables: message: >- {{ states('input_text.pinna_notification') if is_state('switch.echo_dot_notification', 'on') and has_value('input_text.pinna_notification') else '' }} - set_conversation_response: "{{ message or 'You have no notifications.' }}" - action: switch.turn_off target: entity_id: switch.echo_dot_notification - action: input_text.set_value target: entity_id: input_text.pinna_notification data: value: ""Home Assistant matches these sentences itself. If your voice assistant uses an AI conversation agent, turn on Prefer handling commands locally for it.
-
Add an automation that reads the message when you clear the notification with the Action button or on the dashboard:
alias: Read a Pinna notification when it's cleared triggers: - trigger: state entity_id: event.echo_dot_notification not_from: unavailable not_to: unavailable conditions: - condition: template value_template: >- {{ trigger.to_state.attributes.event_type == 'cleared' and has_value('input_text.pinna_notification') and states('input_text.pinna_notification') != '' }} actions: - action: assist_satellite.announce target: entity_id: assist_satellite.echo_dot_assist_satellite data: message: "{{ states('input_text.pinna_notification') }}" - action: input_text.set_value target: entity_id: input_text.pinna_notification data: value: ""
If Home Assistant isn’t connected when you clear a notification on the device,
Home Assistant sees the switch turn off but gets no cleared event, and
nothing is read out. The next notification starts a new message.
With more than one device, change the automations so that clearing the notification on one device clears it on all of them:
-
In steps 2 and 3, list every device’s switch under
entity_id. -
Replace step 4 with this version. It listens to every device’s event, reads the message on the device that was cleared, and turns every switch off. The example has two devices, named Echo Dot and Kitchen Dot:
alias: Read a Pinna notification when it's cleared triggers: - trigger: state entity_id: - event.echo_dot_notification - event.kitchen_dot_notification not_from: unavailable not_to: unavailable conditions: - condition: template value_template: >- {{ trigger.to_state.attributes.event_type == 'cleared' and has_value('input_text.pinna_notification') and states('input_text.pinna_notification') != '' }} actions: - action: assist_satellite.announce target: entity_id: >- {{ device_entities(device_id(trigger.entity_id)) | select('match', 'assist_satellite') | first }} data: message: "{{ states('input_text.pinna_notification') }}" - action: switch.turn_off target: entity_id: - switch.echo_dot_notification - switch.kitchen_dot_notification - action: input_text.set_value target: entity_id: input_text.pinna_notification data: value: ""
Buttons
Seen from above, with the front of the device towards you, the buttons are:
- Action (a dot), at the back
- Volume down (−), on the right
- Microphone off (a crossed-out microphone), at the front
- Volume up (+), on the left
| Button | Press | Hold |
|---|---|---|
| Action | Starts a request without the wake word. While the device listens or answers, cancels the request. While it speaks an announcement, stops it. While a timer rings, stops it. While calibration runs, ends it. While the ring shows a notification, clears it. While the ring circles white or blue, confirms a change at the device or a recording and does nothing else | Sends a long_press event to Home Assistant after 2 seconds |
| Volume up | Raises the volume by 5. While calibration runs, raises the wake word sensitivity to catch the strongest near miss heard in the last 15 seconds instead | Keeps raising the volume |
| Volume down | Lowers the volume by 5. While calibration runs, lowers the wake word sensitivity to ignore the last wake instead | Keeps lowering the volume |
| Microphone off | Turns the microphones off or on | Nothing |
If you use Home Assistant, every press also sends it an event, so you can use the buttons in automations. While calibration runs, the volume buttons tune the sensitivity instead and don’t send theirs. See Home Assistant entities.
Confirm a change at the device
Some changes to the dashboard password need someone at the device: setting the first password, and setting or removing it without the current one. The dashboard then says “Press the Action button (the one with the dot) on the satellite”, and for up to 60 seconds the ring shows a white light that circles slowly, one turn every 3 seconds. It shows above the red of the muted microphones, and the press works while they are off.
While the white light circles, the Action button only confirms. It doesn’t start a request, stop a timer alarm, clear a notification or send an event to Home Assistant. Press it only if you started the change yourself: anyone on your network can make the ring circle, and a press from you is what lets their change through. If nobody presses it, the light goes out after 60 seconds and nothing changes. The ring also stops at once when the confirmation is canceled: with Cancel in the dashboard that asked, or with Stop it on Overview in any signed-in browser. A new confirmation can start a minute after the last one was pressed or ran out, and 10 seconds after one was canceled.
Microphone off
When the microphones are off, the ring is solid red and Pinna ignores all audio from the microphones: it doesn’t listen for the wake word, and a request that is running stops.
The Echo Dot (2nd gen) and the Echo (2nd gen) have a hardware switch behind the Microphone off button. It turns the microphones off, and Pinna follows it. You can also turn the microphones off with the Microphones switch on the dashboard, under Voice & sound or on Overview, or with the Microphone mute switch in Home Assistant. The microphones are off when either the button or the software setting says so.
In standalone mode, when you ask by voice to mute the microphones, or an agent mutes them through Pinna’s MCP address, Pinna turns them off the way the Microphone off button does. One press of the button turns them back on; the dashboard and Home Assistant can’t. In Home Assistant mode, a mute through Home Assistant uses its Microphone mute switch, as the dashboard does.
If you turned the microphones off on the dashboard or in Home Assistant, press Microphone off until the ring is no longer red. That takes one or two presses, and the press that turns them on also clears that mute.
What’s next
- Change the volume and the wake words on the dashboard, under Voice & sound, and the ring brightness under Voice & sound > Ring.
- See all entities in Home Assistant entities.