Package: aiomadeavr
aiomadeavrA library/utility to control Marantz/Denon devices over the telnet port.InstallationWe are on PyPi sopip3 install aiomadeavrWhy?Another projectaio_marantz_avrtargets the
same problem. Unfortunately, it has a few shortcomings for my intended use. For one thing, whilst
it is using asyncio, it is not really asynchronous as  you need to poll the device to get data. Second,
there is no automatic discovery of devices.So I decided to write my own.Note that I lifted some code fromaio_marantz_avr, but
in the end, it is so far from the original that it made no sense to create this as a PR.RunningThis has been tested with a Marantz SR7013 receiver.Although aiomadeavr is meant to be use as a library, the module can be ran, just dopython3 -m aiomadeavrAfter a moment, if you type "enter", you should see a list of the device that have been
discovered. You will be able to power the device on/off, mute/unmute it, set the volume, choose
the source and select the surround mode. You will also be able to change the sound channels bias.DiscoveryThere is actually no way to discover the telnet service of those devices. So aiomadeavr cheats.
As far as I can tell all recent Marantz/Denon networked devices support Denon'sHEOS. That service advertises itself over theSimple Service Discovery Protocol. Discovery looks for those services
and, hopefoolly, the devices we can telnet to will answer the Denon/Marantz serial protocol.DocumentationHere are the exposed API functions and objectavr_factoryThis is a coroutine. It is how one creates devices instances.Parameters are:name: The friendly name of the instances, a string
addr: The IP asddress, a stringThese 2 are required, there are also 2 optional parameters:port: The port to connect to. An integer. Default is 23
timeout: A timeout,currently not used default 3.0If anything goes wrong, avr_factory will return None. If things go right, it will return an MDAVR objectMDAVRThis is the class used to communicate with the device.When created with avr_factory, the object will connect to the device and start reading the information
coming from the device. It will then issue a list of command to get the current state of the device.All communications with a device must be performed through a MDAVR instance.Here are the exposed attributes and method of the MDAVR class.String Attr: nameThe friendly name of the device. This was passed to avr_factory at creation time.Dictionary Attr: statusCurrent status of the device. Below is a pretty printed example from a marantz SR7013:Power:  On
Main Zone:      On
Zone 2: Off
Zone 3: Off
Muted:  False
Z2 Muted:       False
Z3 Muted:       False
Volume: 50.0
Z2 Volume:      50.0
Z3 Volume:      1.0
Source: Bluray
Z2 Source:      -
Z3 Source:      Online Music
Surround Mode:  Dolby Digital Surround
Channel Bias:
    Front Left:     0.0
    Front Right:    0.0
    Centre: 0.0
    Subwoofer:      0.0
    Surround Left:  0.0
    Surround Right: 0.0
    Subwoofer2:     0.0
    Front Top Left: 0.0
    Front Top Right:        0.0
    Rear Top Left:  0.0
    Rear Top Right: 0.0
Picture Mode:   ISF Day
Eco Mode:       Auto
Sampling Rate:  192.0String Attr: power, main_power, z2_power, z3_powerCurrent status status of the device, one of 'On' or 'Standby', for 'power', "On' or 'Off" for the others.Bool Attr: muted, z2_muted, z3_mutedCurrent "muted" status of the device: True or FalseFloat Attr: volume, z2_volume, z3_volumeCurrent zone volume of the device. From 0.0 to max_volume by 0,5 incrementsFloat Attr: max_volumeMaximum of the volume range.String Attr: source, z2_source, z3_sourceCurrent source of the device, for instance Bluray, CD, Set Top Box,...List Attr: source_listList of all the possible sources. When setting a source, the name MUST BE in this list.Not all sources are available to all devices. aiomadeave will try to get the list of inputs available to the device.String Attr: sound_modeCurrent sound processing mode, for instance: Stereo, DTS, Pure Direct,...List Attr: sound_mode_listList of all the possible sound_mode. When setting a sound_mode, the name MUST BE in this list.Not all sound_mode are available to all devices.String Attr: picture_modeCurrent video processing mode, for instance: Custum, Vivid, ISF Day,...List Attr: picture_mode_listList of all the possible picture_mode. When setting a picture_mode, the name MUST BE in this list.Not all picture_mode are available to all devices.String Attr: eco_modeCurrent economy mode setting, one of 'On', 'Off' or 'Auto'List Attr: eco_mode_listList of all the possible economy mode settings. When setting the economy mode, the name MUST BE in this list.Economy mode is not available on all devices.Dictionary Attr: channels_biasThe bias for all the currently available channels. The key is the channel name, and the
value is the bias as a float. The bias is between -12 dB and +12 dBList Attr: channels_bias_listList of all the possible channels for which a bias can be set. When setting a channel bias the name MUST BE in this list.Note that this list is dynamic has it depends on the sound mode. Values are like: Front Right, Surrond Left,...Method: refreshNo parameter.Ask the device to query its current status. Returns None.Method: turn_on, main_tunr_on, z2_turn_on, z3_turn_onNo parameter.Turn on the device/zone. Returns None. 'turn_on' will affect all zonesMethod: turn_off, main_power_off, z2_power_off, z3_poweer_offNo parameter.Turn off the device/zone. Returns None.Note that the associated value is "Standby" for'power' and "Off" for zones.Method: mute_volume, z2_mute_volume, z3_mute_volumeOne parameter:mute: booleanReturns None.Method: set_volume, z2_set_volume, z3_set_volumeOne parameter:level: float, valuer between 0.0 and 98.0 in 0.5 increments for main zone and 1.0 increment for other zones.Set the volume level.Returns None.Method: volume_up, z2_volume_up, z3_volume_upNo parameter.Raise the volume level by 0.5 for main zone, 1.0 for othersReturns None.Method: volume_down, z2_volume_down, z3_volume_downNo parameter.Lower the volume level by 0.5 for main zone, 1.0 for othersReturns None..Method: set_channel_biasTwo parameter:chan: The channel name. Must be in channels_bias_list
level: float, valuer between -12.0 and 12.0 in 0.5 incrementsSet the bias level for the specified channel.Returns None.Method: channel_bias_upOne parameter:chan: The channel name. Must be in channels_bias_listRaises the bias level for the specified channel by 0.5Returns None.Method: channel_bias_downOne parameter:chan: The channel name. Must be in channels_bias_listLower the bias level for the specified channel by 0.5Returns None.Method: channel_bias_resetNo parameter.Reset all the channels' bias to 0.0Returns None.Method: select_source, z2_select_source, z3_select_sourceOne parameter:source: The source name. Must be in source_listMake the source the current active one for the Main ZoneReturns None.Method: select_sound_modeOne parameter:mode: The mode name. Must be in sound_mode_listSet the sound mode for the active zone. The name of the sound mode
in the status may not be the same as the one set. For instance, setting 'Auto' may lead to a
'Stereo' mode.Returns None.Method: select_picture_modeOne parameter:mode: The mode name. Must be in picture_mode_listSet the picture mode for the active zone.Returns None.Method: select_eco_modeOne parameter:mode: The mode name. Must be in eco_mode_listSet the eco mode for the device.Returns None.Method: notifymeOne parameter:func: A callable with 2 parameters:

    lbl: The name of the property, a key in status
    value: The new valueThis function register a callable to be called when one
of the status value changes. For 'Channel Bias' it is called
everytime the channel bias info is received.Coroutine start_discoveryOne parameter:addr: The multicast address to use for discovery, by default this is the multicast address for SSDP discovery.
callb: A callable. It is called when and HEOS service is discoverd. The callablew must accept one parameter, a dictionary with the following keys:

    ip: ip address of the device
    name: friendly name
    model: The device model
    serial: the device serial numberCaveatTrying to set the current value will often result in AvrTimeoutError exception.The device will simply not respond to unknown commands and will secretly despise you for it. This makes it difficullt to use timeout on sending to detect disconnection.The channel bias list may get out of sync when setting the sound mode to 'Auto'. It looks like there is a delay before that information is sent.AfterthoughtsThe module uses asyncio Streams. I think using protocols may have been a wiser choice.Currently, most of the coroutine of the MDAVR object generate a future and wait for it. Not sure it is a good idea. May be removed in the future. Oh, wait!All that silly use of future has now been cleaned up.