Using set_tuner_band in a HA script or automation

[rarroyo6]

I'm trying to use the set_tuner_band in an automation and I'm getting the following error:
The automation "Media: Play the family room media" (automation.media_play_the_family_room_media) has an action that calls an unknown service: media_player.set_tuner_band.
Is there an example, or a detailed documentation on using set_tuner_band, set_am_tuner_frequency, or set_fm_tuner_frequency?

[pantherale0]

Hi,

An example of set_fm_tuner_frequency

service: pioneer_async.set_fm_tuner_frequency
target:
  entity_id: media_player.living_room_avr
data:
  frequency: 104.5

I believe you need to supply the main AVR zone, although in theory it should work on zone 2 etc too as there is only one tuner in these amps.

To change the band, use:

service: pioneer_async.select_tuner_band
data:
  band: FM
target:
  entity_id: media_player.living_room_avr

@crowbarz I have noticed that the following error is logged when changing the band:

AVR command select_tuner_band failed: invalid TunerBand specified: FM

This might be because my AVR is off at the moment though.

[crowbarz]

@rarroyo6 The available services and supported data attributes are documented in two places:

• In the README
• Within HA itself: navigate to Developer Tools > Services, go to UI mode, then select one of the Pioneer AVR services

You can make sure that the service call works as expected using Developer Tools > Services before using it in an automation.

set_am_tuner_frequency and set_fm_tuner_frequency sets the frequency band for you, so there should be no real need to call select_tuner_band. Also, if you go to the device for your AVR and enable the Tuner Band configuration select entity, then you can select the frequency band using select.select_option on that entity too.

@pantherale0 select_tuner_band was missing a TunerBand enum constructor for the user specified band (str), thanks for finding that. It will be fixed in the next release. The code for the select entity correctly uses the enum constructor.

[rarroyo6]

Thank you for the quick response, I'll try it tonight.
Quick question: Is the frequency passed to set_am/fm_tuner_frequency string or float?

[crowbarz]

All service data types are documented in the README file:

[rarroyo6]

I have a VSX-823, and when I try to set the band or frequency from the developer tools, it does not give any errors, but it doesn't change the band or frequency either.
I was looking at the source for commands.py, and noticed that the set_tuner_band_am and set_tuner_band_fm are defined as 01TN and 00TN respectively. According to the Pioneer documentation I have, they should be 01TB and 00TB.
I don't know if it's different for the different models, or if the definition is incorrect.
I got my protocol information from: https://www.pioneerelectronics.com/pio/pe/images/portal/cit_3424/349506363VSX82TXS_RS232C_Protocols.pdf, there's also another document here with the same information: https://files.remotecentral.com/view/7127-18706-1/pioneer_2010_receivers.html.
All the other services I've tried seem to work OK, so thank you for the great integration.

[crowbarz]

I have used 2015 Pioneer & Elite AVR External Command (AMX) FY16AVR_External_Command_for_CI_AMX_2.xlsx as the reference, linked from Pioneer's website. All of the reference documents used to develop the underlying aiopioneer Python library can be found in References in crowbarz/aiopioneer.

The VSX-823 manual (from B&H) is dated 2012, so maybe your AVR uses an older version of the protocol where TB is used to change the band.

The FY16 spreadsheet lists TB as well on tab commands_list row 547, but it doesn't describe how to use it to set a particular radio band. I wonder if TB just toggles between the bands rather than explicitly sets it to a particular band? The 00TN and 01TN commands are defined on rows 555 and 556.

If you run the CLI aiopioneer from within your HA container/venv (depending on how you installed it), then you can send arbitrary raw commands to the AVR using the > command, eg. > 01TB, to see how your model of AVR responds. If you can determine the appropriate commands for the VSX-823, then it should be possible to redefine the set_tuner_band_am and set_tuner_band_fm commands for that model only.

[rarroyo6]

I can certainly try that, but I need some help with accessing the CLI. I tried typing aiopioneer from the console, from SSH, and from the Terminal addon, and I get a message saying Invalid command, I'm sure that I'm missing a step somewhere.
I'm an old time programmer (think Fortran and Cobol on an IBM-360), and I've done quite a bit of work with Visual Basic and C++, I even did a lot of work with Unix back in the day, but I'm just beginning to get familiar with Python, so any help is appreciated.
I'm using HAOS.

[crowbarz]

In this case it's the Docker container hierarchy on HAOS that makes it more difficult to access the aiopioneer CLI.

From the HAOS console (or SSH to port 22222 on the HAOS system, if you have that set up per https://developers.home-assistant.io/docs/operating-system/debugging/ ) run docker exec -it homeassistant bash to enter the core HA container. Then, run aiopioneer <avr_host_or_ip> from there.

The Terminal panel and SSH server (on port 22) provided by the Terminal & SSH add-on drops you into a different container that unfortunately doesn't have access to the aiopioneer Python module (including the CLI) that this integration installs into the core HA container.

[rarroyo6]

Thanks for the answer, I was able to test it.
Neither the TN or TB commands work, but I'm able to send other commands and they work fine.
Now that I know how to test it, I'll do some research and tests this weekend, and report back what I find.

[rarroyo6]

Apparently this model does not respond to band change or frequency change.
I also checked with an old VSX-822 that I had laying around, and it did not work either.
Most of the commands work, but these do not. Also the tuner frequency request ?FR does not return anything.
I updated my comment in the Models Supported list to reflect this.