Skip to content
dcontrol

Powersoft Mezzo

This is the powersoftMezzo plugin documentation.

This plugin provides support for the Powersoft Mezzo series of amplifiers.

A single plugin instance can handle multiple amplifier connections. Therefore, the IP address setting is ignored and amplifiers must be listed as a separate list entity under the devices key in the plugin’s options.

The individual device parameters can be read and/or set by accessing their predefined key amplifier_name/parameter where the amplifier_name is the key in de devices_list (“amp1” and “amp2” in the example below). The parameter is defined by this plugin, and is separated by a / from the amplifier_name.

In order for the Mezzo plugin to work, the system firewall must pass through udp traffic on port 8002.

Supported parameters

All the parameters below can be accessed by referencing amp_name/parameter.

Parameter
IO type
R/W
Info
info_model string r
info_serial_number string r
info_manufacturer_id string r
info_manufacturer_model string r
info_manufacturer_serial_number string r
info_firmware_version string r
info_mac_address string r
info_nickname string r
Network Configuration
network_config_address_mode int8 r
network_config_ip_address string r
network_config_netmask string r
network_config_gateway string r
Network State
network_state_ip_address string r
network_state_netmask string r
network_state_gateway string r
Source Input Reference
input_analog_ref float rw
input_analog_delay float rw
input_digital_ref float rw
input_digital_delay float rw
Source
source_id_ch{i}_source{i} float rw
source_priority_ch{i}_source{i} int8 rw
source_default_priority_ch{i} int8 rw
source_manual_select_ch{i} float rw
source_backup_strat_enable_ch{i} int8 rw
source_backup_threshold_level_ch{i}_source{i} float rw
Matrix
matrix_mute_pre_source{i} int8 rw
matrix_gain_pre_source{i} float rw
matrix_gain_source{i}_ch{i} float rw
matrix_mute_source{i}_ch{i} int8 rw
User
user_gain_ch{i} float rw
user_delay_ch{i} float rw
user_polarity_ch{i} int8 rw
user_mute_ch{i} int8 rw
user_shading_ch{i} float rw
User EQ
user_eq{i}_enabled_ch{i} int8 rw
user_eq{i}_type_ch{i} int8 rw
user_eq{i}_q_ch{i} float rw
user_eq{i}_slope_ch{i} float rw
user_eq{i}_frequency_ch{i} uint rw
user_eq{i}_gain_ch{i} float rw
Speaker Layout
speakerlayout_description_speaker{i} string rw
speakerlayout_brandname_speaker{i} string rw
speakerlayout_familyname_speaker{i} string rw
speakerlayout_modelname_speaker{i} string rw
speakerlayout_applicationname_speaker{i} string rw
speakerlayout_note_speaker{i} string rw
speakerlayout_speakertype_speaker{i} int8 rw
speakerlayout_hiz_active_speaker{i} int8 rw
Ways
ways_gain_way{i} float rw
ways_delay_way{i} float rw
ways_polarity_way{i} int8 rw
ways_mute_way{i} int8 rw
ways_name_way{i} string rw
Dante Routing
dante_routing_gain_out{i} float rw
dante_routing_dsp_tap_type_out{i} int8 rw
dante_routing_channel_out{i} int8 rw
GPO
gpo_relay_mode int8 rw
gpo_relay_fault_mask float rw
gpo_relay_state int8 rw
Power
power_standby int8 w
Reading - Amp Alarms
alarms_amp_temp_transformer float r
alarms_amp_temp_heatsink float r
alarms_amp_voltage_mains_rms float r
alarms_amp_vcc_p float r
alarms_amp_vcc_n float r
alarms_amp_fan_current float r
alarms_amp_v_aux_p float r
alarms_amp_v_aux_n float r
alarms_amp_fan int8 r
alarms_amp_high_over_temp int8 r
alarms_amp_moderate_over_temp int8 r
alarms_amp_powersupply int8 r
alarms_amp_v_aux int8 r
alarms_amp_generic_fault int8 r
alarms_amp_fault_code int8 r
Readings - Channel Alarms
alarms_temp_ch{i} float r
alarms_temp_status_ch{i} int8 r
alarms_soa_thermal_status_ch{i} int8 r
alarms_voltage_rail_status_ch{i} int8 r
Readings - Channel Readings
readings_impedance_ch{i} float r
readings_gpi_ch{i} float r
Readings - Power
readings_standby_active int8 r
Readings - Meters
readings_meters_source_peak_ch{i}_source{i} float r
readings_meters_source_rms_ch{i}_source{i} float r
readings_meters_source_presence_ch{i}_source{i} int8 r
readings_meters_source_clip_ch{i}_source{i} int8 r
readings_selected_backup_ch{i} int8 r
readings_meters_input_matrix_peak_ch{i} float r
readings_meters_input_matrix_rms_ch{i} float r
readings_meters_ways_v_peak_ch{i} float r
readings_meters_ways_v_rms_ch{i} float r
readings_meters_ways_i_peak_ch{i} float r
readings_meters_ways_i_rms_ch{i} float r
readings_soa_gain_reduction_thermal_limiter_ch{i} float r
readings_soa_gain_reduction_voltage_hf_limiter_ch{i} float r
readings_soa_gain_reduction_current_long_limiter_ch{i} float r
readings_soa_gain_reduction_current_short_limiter_ch{i} float r
readings_soa_gain_reduction_power_limiter_ch{i} float r
readings_user_gain_reduction_voltage_peak_limiter_ch{i}` float r
readings_user_gain_reduction_voltage_rms_limiter_ch{i} float r
readings_user_gain_reduction_clip_limiter_ch{i} float r
readings_user_gain_reduction_total_ch{i} float r
readings_signal_presence_ch{i} int8 r
readings_headroom_ch{i} float r
System
system_blink int8 w
system_reboot int8 w

The parameters that have a {i} suffix really are 4 different parameters.

For example:

parameter gain_in_ch{i} can be expanded to:

  • gain_in_ch1
  • gain_in_ch2
  • gain_in_ch3
  • gain_in_ch4

Configuration options

The minimal device config when using the default options would be:

settings.yml
devices:
  - type: powersoftMezzo
    name: powersoftMezzo1
    options:
      devices_list:
        - name: amp1
          ip: 10.0.0.1

This assumes that the scan rate at which the amplifiers will be polled is the default of 100ms.

A complete config would look like this:

settings.yml
devices:
  - type: powersoftMezzo
    name: powersoftMezzo1
    options:
      scan_rate: 200
      ip: 0.0.0.0
      devices_list:
        - name: amp1
          ip: 10.0.0.1
        - name: amp2
          ip: 10.0.0.2


mappings:
  - name: arbitrary
    from:
      name: powersoftMezzo1
      type: int8
      address: amp1/user_mute_ch1
    to:
      name: websocket
      type: bool
      address: mute1

where

type

is always “powersoftMezzo” as this is the name of this plugin.

name

unique arbitrary name.

options/ip

the ip address of the powersoftMezzo device. Default: 127.0.0.1

options/scan_rate

this is the polling scan rate in ms and should be an integer. Default: 500. Minimum: 100.

options/devices_list

the list of amplifiers to monitor.

options/devices_list[]/name

amplifier name, used to identify amplifiers in the mappings

options/devices_list[]/ip

amplifier ip address

NOTE

The minimum scan rate is 100ms and when not specified will default to 500ms. When going faster the returned data is often invalid or seems to be oscillating. Unfortunately this happens in a way that can’t be tested. If returned data doesn’t make sense, it is advised to try and increase the scan_rate.

Metrics

The following metrics are exported by the powersoftMezzo plugin. They are prefixed / namespaced with powersoftmezzo_, and all of them have the label {instance:"plugin_name"} where plugin_name is the name specified in the settings.yml file with the name attribute. The amplifier metrics also have a label {amp:"amp_name"}. Multiple amps share the same metric name, but can be differentiated by the amp label.

Metric Name Metric Type Notes
General
connection_state Gauge The connection state of the powersoftX server.
Amplifier
connection_state Gauge The connection state of the X amplifier.

Furthermore, all controls that are numeric (everything except strings) are also available with the same metric name as the parameter name in the supported parameters table.