Skip to content

Commit 3ec9b84

Browse files
Bunton33claude
andcommitted
docs: fold CAST PRO-1 Line In into Zach's pages, announcement sliders
Zach's CAST PRO-1 section (#1207) covers Line In and the boot button, so the separate Line In and status check pages are gone. What they had that his pages didn't now lives on the Analog In page: the one-time Turn on audio input step, the optical-only output while it streams, the exact Line In Streaming labels, the requirements, and troubleshooting. - Name the jack Analog In (Line In), and add the rule to the style guide - TTS and sensor definitions: Announcement Ducking and Announcement LED Brightness from firmware 26.11.3.3 - Getting Started: the Music Assistant 2.10.7 note, and Static playback delay (ms) for a room that plays late (also in the FAQ) - LED strip: firmware 26.11.3.2, Music Mode follows Analog In, US spelling, menu arrows Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 435f118 commit 3ec9b84

11 files changed

Lines changed: 94 additions & 152 deletions

File tree

‎STYLE_GUIDE.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,11 @@ The same literal forms keep their own spelling:
127127
- The device name Home Assistant and Music Assistant show: **Apollo CAST_PRO-1**
128128
- The setup hotspot: **Apollo CAST_PRO-1 Hotspot**
129129

130+
Call the CAST PRO-1's audio input jack **Analog In (Line In)** in titles,
131+
nav labels, headings, and its first mention on a page, then **Analog In**.
132+
Readers know it by either name. The firmware setting keeps its own label,
133+
**Line In Streaming**.
134+
130135
### First mention per page
131136

132137
On the first mention of a product in body copy, use the full brand name:
Lines changed: 52 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
---
2-
title: Play a source through CAST PRO-1 Analog In
3-
description: Connect a turntable, TV, or other audio source to the CAST PRO-1 Analog In jack and play it through Music Assistant as a Sendspin Source.
2+
title: Play a source through CAST PRO-1 Analog In (Line In)
3+
description: Connect a turntable, TV, or other audio source to the CAST PRO-1 Analog In (Line In) jack and play it on any speaker through Music Assistant as a Sendspin Source.
44
---
5-
# Play a source through Analog In
5+
# Play a source through Analog In (Line In)
66

7-
The **Analog In** jack on your CAST PRO-1 turns any line-level source into something Music Assistant can play. Plug in a turntable, TV, or CD player, and it shows up in Music Assistant as a **Sendspin Source**. Play it on the speakers connected to your CAST PRO-1, or on any other Music Assistant player in your home.
7+
The **Analog In (Line In)** jack on your CAST PRO-1 turns any line-level source into something Music Assistant can play. Plug in a turntable, TV, or CD player, and it shows up in Music Assistant as a **Sendspin Source**. Play it on the speakers connected to your CAST PRO-1, or on any other Music Assistant player in your home.
88

99
!!! note "Before you start"
1010

11-
Finish the [Getting Started guide](../setup/getting-started.md) first, so your CAST PRO-1 is in Home Assistant and Music Assistant is running.
11+
- Finish the [Getting Started guide](../setup/getting-started.md) first, so your CAST PRO-1 is in Home Assistant and Music Assistant is running.
12+
- Your CAST PRO-1 needs firmware 26.11.3.2 or newer, and Music Assistant 2.10.7 or newer.
1213

1314
## What you'll need
1415

@@ -21,28 +22,67 @@ The **Analog In** jack on your CAST PRO-1 turns any line-level source into somet
2122

2223
![Plugging a USB-C power cable into the CAST PRO-1, then a 3.5mm cable into the Analog In jack](/assets/cast-pro-1-plug-in-audio-in.webp)
2324

25+
## Turn on the audio input
26+
27+
Do this once, so Music Assistant can use your CAST PRO-1's Analog In.
28+
29+
1\. In Music Assistant, go to **Settings → Players** and open your CAST PRO-1.
30+
31+
2\. Select **Turn on audio input**.
32+
33+
If your CAST PRO-1 shows **Setup required** instead, finish its setup and choose **Connect unpaired with audio input** (or **Pair device**).
34+
2435
## Play it in Music Assistant
2536

26-
1\. Open **Music Assistant** from the Home Assistant sidebar and select **Browse**.
37+
!!! warning "Your CAST PRO-1 plays through Optical while its Analog In streams"
2738

28-
2\. Select **Sendspin Source (Apollo CAST_PRO-1 xxxxxx)**, where `xxxxxx` matches the end of your device's name. (1)
39+
While its Analog In streams, your CAST PRO-1 plays through its optical output, even with **Audio Output** set to **Analog**. That's because Analog In and the analog output share one audio connection inside the device. It goes back to Analog when the stream stops, and this applies to anything else it plays in the meantime.
40+
41+
Speakers on the analog output? Play the source on another player, or connect this CAST PRO-1 to your receiver or soundbar with an optical cable.
42+
43+
1\. Open **Music Assistant** from the Home Assistant sidebar and select the player to hear it on: your CAST PRO-1, or any other player in another room.
44+
45+
2\. Select **Browse**, then **Sendspin Source (Apollo CAST_PRO-1 xxxxxx)**, where `xxxxxx` matches the end of your device's name. If you have more than one CAST PRO-1, open **Sendspin Source** first and pick yours there. (1)
2946
{ .annotate }
3047

31-
1. Your device's name is at the top of its device page in Home Assistant, for example **Apollo CAST_PRO-1 04c6d0**.
48+
1. Your device's name is at the top of its device page in Home Assistant, for example **Apollo CAST_PRO-1 04c6d0**. If you renamed the player in Music Assistant, the source uses that name instead.
3249

33-
3\. Pick the player to hear it on. Choose your CAST PRO-1 to play the source through its own speakers, or any other player to hear it in another room.
50+
3\. Select **Play**.
3451

3552
<!-- TODO image: /assets/cast-pro-1-sendspin-source.webp | alt: Music Assistant Browse page showing the Sendspin Source for the CAST PRO-1 -->
3653

54+
Your source now plays until you stop it in Music Assistant. It plays on one player at a time, so picking it on another player moves it there. The jack can't tell when your source starts or stops, so start and stop it from Music Assistant each time. On your CAST PRO-1's own player, it's also in the **Select source** menu.
55+
56+
!!! tip "See a Line In switch?"
57+
58+
Firmware 26.11.3.2 has a **Line In** switch on the device page. You don't need it, so leave it off. Firmware 26.11.3.3 removes it.
59+
3760
## Choose the streaming quality
3861

39-
The **Line In Streaming** setting on your CAST PRO-1's device page sets how it sends your source over the network:
62+
The **Line In Streaming** setting, under **Configuration** on your CAST PRO-1's device page, sets how it sends your source over the network:
4063

4164
| Option | When to use it |
4265
| --- | --- |
43-
| **Compressed** | The default. Best for a weaker Wi-Fi connection, since it uses less bandwidth. |
44-
| **Lossless** | Full quality. Pick it when your CAST PRO-1 is on Ethernet or a strong Wi-Fi signal. |
66+
| **Compressed (best for WiFi)** | The default. Uses about 128 kbps, so audio stays smooth on a weaker Wi-Fi connection. |
67+
| **Lossless (Ethernet or strong WiFi)** | Full quality, about 1.5 Mbps. Pick it when your CAST PRO-1 is on Ethernet or a strong Wi-Fi signal. |
68+
69+
Changing it restarts your CAST PRO-1, which stops anything playing on it.
4570

4671
[![Open your Home Assistant instance and show an integration.](https://my.home-assistant.io/badges/integration.svg)](https://my.home-assistant.io/redirect/integration/?domain=esphome)
4772

73+
## Troubleshooting
74+
75+
**The Sendspin Source isn't in Music Assistant**
76+
77+
- Check your CAST PRO-1 is on firmware 26.11.3.2 or newer, and Music Assistant on 2.10.7 or newer.
78+
- Turn on the audio input. See [Turn on the audio input](#turn-on-the-audio-input).
79+
80+
**No sound from the speakers on your CAST PRO-1**
81+
82+
- While its Analog In streams, the CAST PRO-1 only plays through its optical output. See [Play it in Music Assistant](#play-it-in-music-assistant).
83+
84+
**Choppy audio**
85+
86+
- Set **Line In Streaming** to **Compressed (best for WiFi)**, or connect an Ethernet cable.
87+
4888
[Join our Discord if you need more help! :simple-discord:](https://link.apolloautomation.com/discord){ .md-button }

‎docs/products/castpro1/examples/led-strip.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Your CAST PRO-1 has LED strip terminals, **5V**, **GND** and **IO1**, for an add
88

99
!!! note "Update your firmware first"
1010

11-
If you don't see any **LED Strip** entities on your CAST PRO-1's device page, update it from the **Firmware Update** entity first.
11+
LED strip support needs firmware 26.11.3.2 or newer. If you don't see any **LED Strip** entities on your CAST PRO-1's device page, update it from the **Firmware Update** entity first.
1212

1313
## What you'll need
1414

@@ -34,7 +34,7 @@ You'll connect the strip's power, ground and data wires to the matching terminal
3434

3535
1\. Unplug your CAST PRO-1 from power.
3636

37-
2\. Find the input end of the strip. Its pads are labelled **DIN** or **DI**, and the arrows printed on the strip point away from it. (1)
37+
2\. Find the input end of the strip. Its pads are labeled **DIN** or **DI**, and the arrows printed on the strip point away from it. (1)
3838
{ .annotate }
3939

4040
1. Data only travels one way along the strip. Wired to the **DOUT** end, the strip stays dark.
@@ -53,7 +53,7 @@ You'll connect the strip's power, ground and data wires to the matching terminal
5353

5454
The LED strip controls are hidden until you turn them on, so a CAST PRO-1 without a strip doesn't show extra controls.
5555

56-
1\. In Home Assistant, go to **Settings** > **Devices & services** > **ESPHome** and open your CAST PRO-1.
56+
1\. In Home Assistant, go to **Settings → Devices & services → ESPHome** and open your CAST PRO-1.
5757

5858
[![Open your Home Assistant instance and show an integration.](https://my.home-assistant.io/badges/integration.svg)](https://my.home-assistant.io/redirect/integration/?domain=esphome)
5959

@@ -79,7 +79,7 @@ If the colors come out in the wrong order (for example, green when the test show
7979
| **LED Strip Chipset** | The type of LED on your strip. Leave it on **WS2812** unless the strip flickers or shows random colors. |
8080
| **LED Strip Effect A Pattern** and **LED Strip Effect A Speed** | The pattern **Effect A** runs, and how fast. |
8181
| **LED Strip Effect B Pattern** and **LED Strip Effect B Speed** | The pattern **Effect B** runs, and how fast. |
82-
| **LED Strip Music Mode** | Turns the strip on with the **Music Effect** whenever music is playing, and off about 3 seconds after it stops. |
82+
| **LED Strip Music Mode** | Turns the strip on with the **Music Effect** whenever music or the [Analog In (Line In)](../additional-info/analog-in.md) source is playing, and off about 3 seconds after it stops. |
8383
| **LED Strip Music Effect** | The effect Music Mode uses. |
8484
| **LED Strip Test** | Runs the color test from the steps above. Under **Diagnostic**. |
8585

‎docs/products/castpro1/examples/line-in.md‎

Lines changed: 0 additions & 77 deletions
This file was deleted.

‎docs/products/castpro1/examples/tts-announcements.md‎

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,13 +41,24 @@ data:
4141
4242
## What happens during an announcement
4343
44-
The CAST PRO-1 ducks the music by 40 dB the instant an announcement starts, so speech stays clear without the music stopping. The onboard LEDs turn cyan while it's talking. When the message finishes, the music fades back over a second and the LEDs go out.
44+
The CAST PRO-1 ducks the music the instant an announcement starts, so speech stays clear without the music stopping. The onboard LEDs turn cyan while it's talking. When the message finishes, the music fades back over a second and the LEDs go out.
45+
46+
Two settings under **Configuration** on the device page change this:
47+
48+
| Setting | What it does |
49+
| --- | --- |
50+
| **Announcement Ducking** | How far the music drops, from -80 dB to 0 dB. Defaults to -40 dB. Set it to 0 to keep the music at full volume. |
51+
| **Announcement LED Brightness** | How bright the cyan LEDs glow, from 0% to 100%. Defaults to 100%. Set it to 0% to keep them off. |
52+
53+
!!! note "Firmware 26.11.3.3 or newer"
54+
55+
These settings arrived in firmware 26.11.3.3. Older firmware ducks the music by 40 dB and lights the LEDs at 50%. Until 26.11.3.3 reaches the Stable channel, [switch to the Beta channel](../../general/setup/switch-to-beta-branch.md) to get them.
4556
4657
That LED change is a handy way to tell an announcement from a glitch when you're across the room.
4758
4859
## Announce a sound instead of speech
4960
50-
Anything you can play can be an announcement, not just speech. A doorbell chime works the same way, ducking the music and lighting the LEDs:
61+
Anything you can play can be an announcement, not only speech. A doorbell chime works the same way, ducking the music and lighting the LEDs:
5162
5263
```yaml
5364
action: media_player.play_media

‎docs/products/castpro1/faq.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@ description: Frequently asked questions about the CAST PRO-1 audio caster.
1010

1111
* **Built-in Ethernet:** no addon module needed for a wired connection.
1212
* **Optical output:** the output jack takes an optical cable as well as a regular 3.5mm audio cable.
13-
* **Analog In:** a second jack for audio in, so you can play a turntable or TV through Music Assistant.
13+
* **Analog In (Line In):** a second jack for audio in, so you can play a turntable or TV through Music Assistant.
1414
* **LED strip terminals:** screw terminals for an addressable LED strip, no soldering.
1515

1616
3\. **Which jack is which?**
1717

18-
* The left jack is **Analog In**, audio in only. Whatever you plug in shows up in Music Assistant as a **Sendspin Source**. See [Play a source through Analog In](additional-info/analog-in.md).
18+
* The left jack is **Analog In (Line In)**, audio in only. Whatever you plug in shows up in Music Assistant as a **Sendspin Source**. See [Play a source through Analog In (Line In)](additional-info/analog-in.md).
1919
* The right jack is **Analog/Optical Out**, audio out only. It takes a 3.5mm audio cable for analog or a mini-TOSLINK optical cable for digital.
2020
* The [Getting Started guide](setup/getting-started.md#know-your-ports) has a labeled photo of every port.
2121

@@ -57,6 +57,7 @@ description: Frequently asked questions about the CAST PRO-1 audio caster.
5757
11\. **Can I play the same music in several rooms?**
5858

5959
* Yes. Group your CAST PRO-1 with other CAST PRO-1s and CAST-1s in Music Assistant and they play in sync. Volume can be set for the whole group or per player.
60+
* One room a little behind the others, for example through a soundbar? Raise that CAST PRO-1's **Static playback delay (ms)** in Music Assistant. See [Play in multiple rooms](setup/getting-started.md#play-in-multiple-rooms).
6061

6162
12\. **Does it need a cloud account or subscription?**
6263

‎docs/products/castpro1/introduction.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ description: Documentation for CAST PRO-1, including setup, usage, and best prac
1010

1111
**Analog or Optical Output:** The **Analog/Optical Out** jack takes a 3.5mm audio cable for powered speakers, or a mini-TOSLINK optical cable for a receiver or soundbar. Pick which one plays with the **Audio Output** setting on the device page.
1212

13-
**Audio In:** Plug a turntable, TV or other source into the **Analog In** jack and it shows up in Music Assistant as a source you can play on any player in your home. See [Play a source through Analog In](additional-info/analog-in.md).
13+
**Audio In:** Plug a turntable, TV or other source into the **Analog In (Line In)** jack and it shows up in Music Assistant as a source you can play on any player in your home. See [Play a source through Analog In (Line In)](additional-info/analog-in.md).
1414

1515
**Built-In Ethernet:** The CAST PRO-1 has an Ethernet port on board, so it can run on a wired connection with no addon. Without a cable, it works over Wi-Fi.
1616

0 commit comments

Comments
 (0)