vsslctrl 0.1.9.dev1__py3-none-any.whl → 0.1.10.dev1__py3-none-any.whl

vsslctrl/__init__.py

@@ -1,6 +1,7 @@
+VSSL_VERSION = "0.1.10.dev1"
+VSSL_NAME = "VSSL"
+
 from .core import Vssl
 from .zone import Zone
 from .data_structure import ZoneIDs
 from .device import Models as DeviceModels
-
-VSSL_NAME = "VSSL"

vsslctrl/api_alpha.py

@@ -12,6 +12,7 @@ from .settings import EQSettings
 from .utils import hex_to_int, clamp_volume, hex_to_bytearray_string
 from .decorators import logging_helpers
 from .data_structure import (
+    ZoneIDs,
     ZoneStatusExtKeys,
     ZoneEQStatusExtKeys,
     ZoneRouterStatusExtKeys,
@@ -195,6 +196,17 @@ class APIAlpha(APIBase):
         self._log_debug("Requesting status transport state")
         self.send(bytearray([16, 7, 1, 0]))
 
+    #
+    # 0C [12]
+    # Party Mode
+    #
+    def request_action_0C(self, state: int):
+        self._log_debug(f"Requesting to set party memeber: {state}")
+        command = self._add_zone_id_to_request(
+            bytearray([16, 11, 2, 0, int(not not state)])
+        )
+        self.send(command)
+
     #
     # 0D [13]
     # EQ
@@ -383,9 +395,17 @@ class APIAlpha(APIBase):
     # Reboot All Zones
     #
     def request_action_33_device(self):
-        self._log_debug(f"Requesting to reboot device")
+        self._log_debug("Requesting to reboot device")
         self.send(bytearray([16, 51, 2, 0, 1]))
 
+    #
+    # 2B [43]
+    # Factory Reset Device
+    #
+    def request_action_2B(self):
+        self._log_debug("Requesting to factory reset device")
+        self.send(bytearray([16, 43, 2, 8, 0]))
+
     #
     # 47 [71]
     # Set Input Priority
@@ -481,6 +501,16 @@ class APIAlpha(APIBase):
         command = bytearray([16, 79, 2, 8, int(state)])
         self.send(command)
 
+    #
+    # 57 [87]
+    # Subwoofer Crossover
+    #
+    def request_action_57(self, freq: int):
+        self._log_debug(f"Requesting to set subwoofer crossover: {freq}")
+        # We hard code the zone ID to be 7 since this A.1(x)
+        command = bytearray([16, 87, 3, ZoneIDs.A1, 0, freq])
+        self.send(command)
+
     #
     #
     #
@@ -581,6 +611,9 @@ class APIAlpha(APIBase):
         # Not used?
 
         # B2Nm - Bus2 Name - For A3.X this is the optical input name
+        # B1Nm - Bus1 Name - For A1 this is the Optical input
+        # B2Nm - Bus2 Name - For A1 this is the coax
+
         if DeviceStatusExtKeys.OPTICAL_INPUT_NAME in metadata:
             self.vssl.settings._set_property(
                 "optical_input_name",
@@ -662,9 +695,10 @@ class APIAlpha(APIBase):
             self.zone._set_property("mute", bool(int(metadata[ZoneStatusExtKeys.MUTE])))
 
         # Party Mode
-        # Not supported by X series?
-        if ZoneStatusExtKeys.PARTY_MODE in metadata:
-            pass
+        if ZoneStatusExtKeys.PARTY_ZONE in metadata:
+            self.zone.group._set_property(
+                "is_party_zone_member", int(metadata[ZoneStatusExtKeys.PARTY_ZONE])
+            )
 
         # Group Index see below
         if ZoneStatusExtKeys.GROUP_INDEX in metadata:
@@ -929,11 +963,15 @@ class APIAlpha(APIBase):
             self.zone.transport._set_property("state", state)
 
     #
-    # 0B [11]
-    # Party Mode not supported on X series (I think. TODO)
+    # 0C [12]
+    # Party Mode
     #
-    def response_action_0B(self, hexl: list, response: bytes):
-        pass
+    # Not supported on X series
+    #
+    def response_action_0C(self, hexl: list, response: bytes):
+        state = hex_to_int(hexl[4])
+        self._log_debug(f"Received party member state: {state}")
+        self.zone.group._set_property("is_party_zone_member", state)
 
     #
     # 0E [14]
@@ -943,7 +981,7 @@ class APIAlpha(APIBase):
         if hex_to_int(hexl[2]) == 3:
             freq = hex_to_int(hexl[4])
             value = hex_to_int(hexl[5])
-            self._log_debug(f"Received EQ requency:{freq} value: {value}")
+            self._log_debug(f"Received EQ frequency:{freq} value: {value}")
             self.zone.settings.eq._set_eq_freq(freq, value)
 
     #
@@ -1087,6 +1125,16 @@ class APIAlpha(APIBase):
             self._log_debug(f"Received adaptive power setting: {enabled}")
             self.vssl.settings.power._set_property("adaptive", bool(int(enabled)))
 
+    #
+    # 58 [88]
+    # Subwoofer Crossover Feedback
+    #
+    def response_action_58(self, hexl: list, response: bytes):
+        if hex_to_int(hexl[2]) == 3:
+            freq = hex_to_int(hexl[5])
+            self._log_debug(f"Received subwoofer crossover frequency: {freq}")
+            self.zone.settings.subwoofer._set_property("crossover", freq)
+
     #
     # Command confimation
     #

vsslctrl/core.py

@@ -4,6 +4,7 @@
 import asyncio
 from typing import Dict, Union, List
 
+from . import VSSL_VERSION
 from .zone import Zone
 from .exceptions import VsslCtrlException, ZoneError, ZeroConfNotInstalled
 from .event_bus import EventBus
@@ -93,6 +94,7 @@ class Vssl:
                 raise VsslCtrlException(message)
 
             # Output a bit of helpful info
+            self._log_info(f"vsslctrl Version: {VSSL_VERSION}")
             self._log_info(f"Device Model: {self.model.name}")
             self._log_info(f"Device SW Version: {self.sw_version}")
             self._log_info(f"Device Serial: {self.serial}")
@@ -196,6 +198,10 @@ class Vssl:
     #
     #
     # THIS WONT WORK FOR ORIGINAL A SERIES! TODO!
+    # Maybe we can just use the ID of the zone because 7 will be an A1(x) otherwise
+    # we will need to count the zones.
+    #
+    # Or we just require a model to be passed?
     #
     #
     def _infer_device_model(self, data: Dict[str, int]):
@@ -301,6 +307,14 @@ class Vssl:
         if zone:
             zone.api_alpha.request_action_33_device()
 
+    #
+    # Factory Reset Device
+    #
+    def factory_reset(self):
+        zone = self.get_connected_zone()
+        if zone:
+            zone.api_alpha.request_action_2B()
+
     #
     # Zones Groups. Build a dict of zone according to group membership
     #

vsslctrl/data_structure.py

@@ -49,6 +49,16 @@ JSON Structure
 
 DO NOT CHANGE - VSSL Defined
 
+A.1
+{
+    "B1Src":"3",
+    "B2Src":"3",
+    "B1Nm":"OPT",
+    "B2Nm":"COAX",
+    "dev":"VSSL A.1",
+    "ver":"p15265.033.3703"
+}
+
 A.3x
 {
     "B1Src": "3",
@@ -112,17 +122,15 @@ DO NOT CHANGE - VSSL Defined
  IRMskL / IRMskH:
  These could potentially be related to Infrared (IR) remote control signals. "IRMskL" and "IRMskH" might represent the low and high values of the modulation frequency or pulse width for an infrared signal.
 
- BTSta:
- This might represent the Bluetooth status, with "0" indicating that Bluetooth is currently not active or disconnected.
-
- Crs:
- It could stand for "Crossfade" and may represent a setting related to crossfading between audio tracks.
-
- Fes:
- This might stand for "Frequency" or "Filter Effect Setting," representing a parameter related to frequency or filtering effects.
-
- Drk: ?
-
+A.1
+{
+    'IRMskL': '255',
+    'IRMskH': '255',
+    'BTSta': '0',
+    'Crs': '0',
+    'Fes': '0',
+    'Drk': '0'
+}
 
 A.3x
 {
@@ -161,7 +169,7 @@ class DeviceStatusExtendedExtKeys:
     IR_HIGH = "IRMskH"  # Guess - To Confirm
     IR_LOW = "IRMskL"  # Guess - To Confirm
     BLUETOOTH_STATUS = "BTSta"  # Guess - To Confirm
-    SUBWOOFER_CROSSOVER = "Crs"  # Guess - To Confirm
+    SUBWOOFER_CROSSOVER = "Crs"
 
 
 """
@@ -169,6 +177,23 @@ JSON Structure
 
 DO NOT CHANGE - VSSL Defined
 
+A.1
+{
+    'id': '7', 
+    'ac': '1', 
+    'mc': 'XXXXXXXXXXXX', 
+    'vol': '20', 
+    'mt': '0', 
+    'pa': '0', 
+    'rm': '0', 
+    'ts': '0', 
+    'lb': '17', 
+    'tp': '1', 
+    'wr': '0', 
+    'as': '0', 
+    'rg': '0'
+}
+
 A.3x
 {
     "id": "1",
@@ -234,7 +259,7 @@ class ZoneStatusExtKeys:
     SERIAL_NUMBER = "mc"
     VOLUME = "vol"
     MUTE = "mt"
-    PARTY_MODE = "pa"
+    PARTY_ZONE = "pa"
     GROUP_INDEX = "rm"
     TRACK_SOURCE = "lb"
     DISABLED = "wr"
@@ -245,10 +270,26 @@ JSON Structure
 
 DO NOT CHANGE - VSSL Defined
 
+A.1
+{
+    "mono":"0",
+    "AiNm":"",
+    "eq1":"100",
+    "eq2":"97",
+    "eq3":"103",
+    "eq4":"103",
+    "eq5":"103",
+    "eq6":"99",
+    "eq7":"99",
+    "voll":"75",
+    "volr":"75",
+    "vold":"0"
+}
+
 A.3x
 {
     "mono": "0",
-    "AiNm": "Analog In 1",
+    "AiNm": "Analog In",
     "eq1": "100",
     "eq2": "100",
     "eq3": "100",
@@ -264,7 +305,7 @@ A.3x
 A.3
 {
     'mono': '0', 
-    'AiNm': 'Backup', 
+    'AiNm': 'Analog In', 
     'eq1': '106', 
     'eq2': '102', 
     'eq3': '100', 
@@ -315,6 +356,22 @@ JSON Structure
 
 DO NOT CHANGE - VSSL Defined
 
+A.1
+{
+    "ECO":"0",
+    "eqsw":"1",
+    "inSrc":"3",
+    "SP":"0",
+    "BF1":"0",
+    "BF2":"0",
+    "GRM":"0",
+    "GRS":"255",
+    "Pwr":"1",
+    "Bvr":"7",
+    "fxv":"20",
+    "AtPwr":"1"
+}
+
 A.3x
 {
     "ECO": "0",
@@ -374,8 +431,8 @@ class ZoneRouterStatusExtKeys:
     EQ_ENABLED = "eqsw"
     INPUT_SOURCE = "inSrc"
     SOURCE_PRIORITY = "SP"
-    ANALOG_OUTPUT_1_FIXED_VOLUME = "BF1"
-    ANALOG_OUTPUT_2_FIXED_VOLUME = "BF2"
+    ANALOG_OUTPUT_1_FIXED_VOLUME = "BF1"  # TODO On A3 / A6 is this Bus 1?
+    ANALOG_OUTPUT_2_FIXED_VOLUME = "BF2"  # TODO On A6 is this Bus 2?
     ANALOG_OUTPUT_3_FIXED_VOLUME = "BF3"
     ANALOG_OUTPUT_4_FIXED_VOLUME = "BF4"
     ANALOG_OUTPUT_5_FIXED_VOLUME = "BF5"

vsslctrl/device.py

@@ -9,7 +9,7 @@ A.1x:
 SUB OUT
 ANALOG IN 1
 ANALOG OUT 1
-COAXIAL IN (Are Coxial and Optical inputs linked?)
+COAXIAL IN
 COAXIAL OUT
 OPTICAL IN
 OPTICAL OUT
@@ -19,7 +19,7 @@ A1:
 SUB OUT
 ANALOG IN 1
 ANALOG OUT 1
-COAXIAL IN (Are Coxial and Optical inputs linked?)
+COAXIAL IN
 COAXIAL OUT
 OPTICAL IN
 OPTICAL OUT
@@ -77,6 +77,8 @@ ANALOG IN 6
 
 ---------------------------------
 
+Following is from Source: https://vssl.gitbook.io/vssl-rest-api/zone-control/set-analog-input-source
+
 Analog Input Source legend: input: inputs specific to model (e.g. A3 does not have zones 4-6 or bus input 2, only A3 has optical input, ...) 
 
 
@@ -92,8 +94,7 @@ Analog Input Source legend: input: inputs specific to model (e.g. A3 does not ha
 16 - optical input
 
 
-Source: https://vssl.gitbook.io/vssl-rest-api/zone-control/set-analog-input-source
-
+TODO COAX Input and output!
 
 """
 
@@ -180,7 +181,7 @@ ANALOG_OUTPUT_SOURCES_FOR_A6 = list(AnalogOutput.Sources)
 class Features(VsslIntEnum):
     GROUPING = 1000
     BLUETOOTH = 1001
-    PARTY_MODE = 1002
+    PARTY_ZONE = 1002
     SUBWOOFER_CROSSOVER = 1003
 
 
@@ -247,7 +248,7 @@ class Models(VsslEnum):
             "zones": THREE_ZONES,
             "input_sources": INPUT_SOURCES_FOR_A3,
             "analog_output_sources": ANALOG_OUTPUT_SOURCES_FOR_A3,
-            "features": [Features.GROUPING, Features.PARTY_MODE],
+            "features": [Features.GROUPING, Features.PARTY_ZONE],
         }
     )
     A6 = Model(
@@ -256,7 +257,7 @@ class Models(VsslEnum):
             "zones": SIX_ZONES,
             "input_sources": INPUT_SOURCES_FOR_A6,
             "analog_output_sources": ANALOG_OUTPUT_SOURCES_FOR_A6,
-            "features": [Features.GROUPING, Features.PARTY_MODE],
+            "features": [Features.GROUPING, Features.PARTY_ZONE],
         }
     )
 

vsslctrl/group.py

@@ -32,8 +32,14 @@ class ZoneGroup(ZoneDataClass):
         INDEX_CHANGE = PREFIX + "index_change"
         SOURCE_CHANGE = PREFIX + "source_change"
         IS_MASTER_CHANGE = PREFIX + "is_master_change"
+        IS_PARTY_ZONE_MEMBER_CHANGE = PREFIX + "is_party_zone_member_change"
 
-    DEFAULTS = {"index": 0, "source": None, "is_master": False}
+    DEFAULTS = {
+        "index": 0,
+        "source": None,
+        "is_master": False,
+        "is_party_zone_member": False,
+    }
 
     def __init__(self, zone: "zone.Zone"):
         self.zone = zone
@@ -52,9 +58,10 @@ class ZoneGroup(ZoneDataClass):
         self._index_id = zone.id + 8
 
         # index is assigned when a stream is started (see action_32)
-        self._index = 0
-        self._source = None
-        self._is_master = False
+        self._index = self.DEFAULTS["index"]
+        self._source = self.DEFAULTS["source"]
+        self._is_master = self.DEFAULTS["is_master"]
+        self._is_party_zone_member = self.DEFAULTS["is_party_zone_member"]
 
     #
     # Group Add Zone
@@ -191,3 +198,22 @@ class ZoneGroup(ZoneDataClass):
             for zone in self.zone.vssl.zones.values()
             if zone.group.index == self.index and zone.group.is_member
         ]
+
+    #
+    # Party Mode - Is this zone a party mode member
+    #
+    @property
+    def is_party_zone_member(self):
+        return bool(self._is_party_zone_member)
+
+    @is_party_zone_member.setter
+    def is_party_zone_member(self, state: int):
+        # Check this device supports party mode
+        if not self.zone.vssl.model.supports_feature(DeviceFeatures.PARTY_ZONE):
+            self.zone._log_error(f"VSSL {self.zone.vssl.model.name} doesnt party zone")
+            return
+
+        self.zone.api_alpha.request_action_0C(state)
+
+    def is_party_zone_member_toggle(self):
+        self.is_party_zone_member = False if self.is_party_zone_member else True

vsslctrl/io.py

@@ -25,8 +25,8 @@ class InputRouter(ZoneDataClass):
     #
     class Sources(VsslIntEnum):
         STREAM = 0
-        BUS_IN_1 = 1  # TODO bus or party mode of original A series
-        BUS_IN_2 = 2  # TODO bus or party mode of original A series
+        BUS_IN_1 = 1
+        BUS_IN_2 = 2
         ANALOG_IN_1 = 3
         ANALOG_IN_2 = 4
         ANALOG_IN_3 = 5
@@ -112,7 +112,13 @@ class AnalogOutput(ZoneDataClass):
     Should this be on the VSSL or Zone? For now its on the zone, because the zone will
     receive feedback for the corrosponding analog output id
 
-    Zones will be determined by source Input Priority
+    Zones will be determined by source Input Priority @see InputRouter class
+
+    TODO: Support for Bus 1 & 2 - Bus 1 and 2 outs can have fixed volume also.
+        Since the BUS zones dont have a dedicated zone, maybe we should move these
+        commands to the VSSL device control class instead of the zone class?
+
+        TODO: A1 input and output mappings!
     """
 
     #
@@ -122,8 +128,8 @@ class AnalogOutput(ZoneDataClass):
     #
     class Sources(VsslIntEnum):
         OFF = 0  # Disconnected / Off / No Output
-        BUS_IN_1 = 1  # TODO bus or party mode of original A series
-        BUS_IN_2 = 2  # TODO bus or party mode of original A series
+        BUS_IN_1 = 1  # TODO bus or party mode of original A series?
+        BUS_IN_2 = 2  # TODO bus or party mode of original A series?
         ZONE_1 = 3
         ZONE_2 = 4
         ZONE_3 = 5
@@ -149,10 +155,10 @@ class AnalogOutput(ZoneDataClass):
         self.zone = zone
 
         self._is_fixed_volume = self.DEFAULTS["is_fixed_volume"]
-        self._source = self.Sources(zone.id + 2)
+        self._source = self.DEFAULTS["source"]
 
     #
-    # Analog Output Fix Volume. Output wont respond to volume control
+    # Analog Output Fix Volume. i.e output wont respond to volume control
     #
     @property
     def is_fixed_volume(self):

vsslctrl/settings.py

@@ -690,8 +690,8 @@ class EQSettings(ZoneDataClass):
 
 # Not in io.py to prevent circ import in device.py
 class SubwooferSettings(ZoneDataClass):
-    MIN_VALUE = 0
-    MAX_VALUE = 1000
+    MIN_VALUE = 50
+    MAX_VALUE = 200
 
     #
     # Subwoofer events
@@ -703,6 +703,10 @@ class SubwooferSettings(ZoneDataClass):
     #
     # Defaults
     #
+    # 0 is full range / off
+    #
+    # The crossover is adjustable from 50-200Hz.
+    #
     DEFAULTS = {"crossover": 0}
 
     def __init__(self, zone: "zone.Zone"):
@@ -713,7 +717,11 @@ class SubwooferSettings(ZoneDataClass):
     #
     # Clamp between min and max
     #
-    def _clamp_crossover(self, value: int = 100):
+    def _clamp_crossover(self, value: int = 0):
+        # Allow 0 to enable full range setting
+        if value < self.MIN_VALUE:
+            return 0
+
         return int(max(self.MIN_VALUE, min(value, self.MAX_VALUE)))
 
     #
@@ -732,11 +740,8 @@ class SubwooferSettings(ZoneDataClass):
                 f"VSSL {self.zone.vssl.model.name} does not have a subwoofer output"
             )
             return
-        #
-        # TODO
-        #
-        self.zone._log_info(f"TODO - crossover set function")
-        # self.zone.api_alpha.request_action_crossover(freq)
+
+        self.zone.api_alpha.request_action_57(freq)
 
     def _set_crossover(self, freq: int):
         freq = self._clamp_crossover(freq)

{vsslctrl-0.1.9.dev1.dist-info → vsslctrl-0.1.10.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vsslctrl
-Version: 0.1.9.dev1
+Version: 0.1.10.dev1
 Summary: Package for controlling VSSL's range of streaming amplifiers
 Author-email: vsslctrl <vsslcontrolled@proton.me>
 Classifier: Development Status :: 4 - Beta
@@ -30,8 +30,10 @@ Requires-Dist: zeroconf ==0.132.2 ; extra == 'optional'
 I am looking for testers with any VSSL amplifier models, please get in touch if you interested in helping. <vsslcontrolled@proton.me>
 
 Tested on:
-- Test suite run on a VSSL **A.3x** software version **p15305.016.3701**
-- The Home Assistant [integration](https://github.com/vsslctrl/integration.home-assistant) is reported working on a **A.6x** software version **p15305.017.3701**
+- **A.1** software version **p15265.033.3703** via Home Assistant [integration](https://github.com/vsslctrl/integration.home-assistant) (reported)
+- **A.3** software version **p12013.141.3703** via Home Assistant [integration](https://github.com/vsslctrl/integration.home-assistant) (reported)
+- **A.3x** software version **p15305.016.3701**
+- **A.6x** software version **p15305.017.3701** via Home Assistant [integration](https://github.com/vsslctrl/integration.home-assistant) (reported)
 
 ## Important
 
@@ -39,52 +41,79 @@ There should not be any *[VSSL Agent's](https://vssl.gitbook.io/vssl-rest-api/ge
 
 ## TODOs
 
-* **A.1(x)** specific control e.g sub crossover, bluetooth
+* **A.1(x)** specific control e.g bluetooth
 * Better test coverage
 
 ## Basic Usage
 
 `vsslctrl` needs to be running inside a **[asyncio](https://docs.python.org/3/library/asyncio.html)** event loop.
 
+### A.1 Example
+
 ```python
 import asyncio
 from vsslctrl import Vssl, DeviceModels, Zone, ZoneIDs
 
 async def main():
-	
-	# Represents a physical VSSL amplifier
-	vssl = Vssl()
+  
+  # Represents a physical VSSL amplifier
+  vssl = Vssl(DeviceModels.A1)
+  a1 = vssl.add_zone(ZoneIDs.A1, '192.168.1.10')
+
+  # Connect and initiate zones.
+  await vssl.initialise()
+
+  """Control Examples"""
+  # Print device name
+  print(a1.settings.name)
+  # Set volume to 25%
+  a1.volume = 25
+  # Pause
+  a1.pause()
+  # Print track name
+  print(a1.track.name)
+
+  # Shutdown and disconnect all zones
+  await vssl.shutdown()
 
-  """Optional to init Vssl with a device model
+asyncio.run(main())
+```
 
-    vssl = Vssl(DeviceModels.A3X)
+### A.3x Example
 
-    If no DeviceModels is passed, vsslctrl will default to the feature set of the X series amps
-  """
+```python
+import asyncio
+from vsslctrl import Vssl, DeviceModels, Zone, ZoneIDs
 
-	# Add each you wish to control
-	zone1 = vssl.add_zone(ZoneIDs.ZONE_1, '192.168.1.10')
-	zone2 = vssl.add_zone(ZoneIDs.ZONE_2, '192.168.1.11')
-	zone3 = vssl.add_zone(ZoneIDs.ZONE_3, '192.168.1.12')
-	#... up to 6 zones
+async def main():
+	
+  # Represents a physical VSSL amplifier
+  # If no DeviceModels is passed, vsslctrl will default to the feature set of the X series amps
+  vssl = Vssl(DeviceModels.A3X)
 
-	# Connect and initiate zones.
-   	await vssl.initialise()
+  # Add each you wish to control
+  zone1 = vssl.add_zone(ZoneIDs.ZONE_1, '192.168.1.10')
+  zone2 = vssl.add_zone(ZoneIDs.ZONE_2, '192.168.1.11')
+  zone3 = vssl.add_zone(ZoneIDs.ZONE_3, '192.168.1.12')
+  #... up to 6 zones
 
-   	"""Control Examples"""
-   	# Print zone1 name
-   	print(zone1.settings.name)
-   	# Set zone2 volume to 25%
-   	zone2.volume = 25
-   	# Pause zone3
-   	zone3.pause()
-   	# or zone3.transport.pause()
-   	# Print zone1 track name
-   	print(zone1.track.name)
+  # Connect and initiate zones.
+  await vssl.initialise()
 
+  """Control Examples"""
+  # Print zone1 name
+  print(zone1.settings.name)
+  # Set zone2 volume to 25%
+  zone2.volume = 25
+  # Pause zone3
+  zone3.pause()
+  # or zone3.transport.pause()
+  # Print zone1 track name
+  print(zone1.track.name)
 
-   	# Shutdown and disconnect all zones
-   	await vssl.shutdown()
+
+  # Shutdown and disconnect all zones
+  await vssl.shutdown()
 
 
 asyncio.run(main())
@@ -107,7 +136,7 @@ print(zone_name)
 >>> 'Living Room'
 ```
 
-**Important** in the above example, `zone1.settings.name` wont be set to its new value until after the VSSL device has changed the name and the `Zone` class has received confimation feedback. If you need to wait for the value change, you can await a `[property_name]_CHANGE` events.
+**Important** in the above example, `zone1.settings.name` wont be set to its new value until after the VSSL device has changed the name and the `Zone` class has received confirmation feedback. If you need to wait for the value change, you can await a `[property_name]_CHANGE` events.
 
 
 # `Vssl`
@@ -118,11 +147,15 @@ print(zone_name)
 | `serial`   			| Serial number        |	`str` readonly
 | `model`   			| Device Model        |	`int` readonly
 | `reboot()`   			| Reboot all zones        |	`func`  |
+| `factory_reset()`        | Factory reset device        | `func`  |
+
 
 ```python
 """Example"""
 # Reboot all zones
 vssl.reboot()
+# Do a factory reset (reset all settings)
+vssl.factory_reset()
 ```
 
 ## `Vssl.settings`
@@ -131,6 +164,8 @@ vssl.reboot()
 | ---------------------- 	| ----------- | ----------- |
 | `name`     			 	| Device name |	`str`
 | `optical_input_name`   			| Name of the optical input        |	`str`
+| `bluetooth`        | Bluetooth enabled / disabled        |  `bool`
+| `bluetooth_toggle()`        | Toggle Bluetooth        | `func`  |
 
 ```python
 """Example"""
@@ -138,6 +173,10 @@ vssl.reboot()
 vssl.settings.name = 'My House'
 # Setting optical input name
 vssl.settings.optical_input_name = 'Optical Input 1'
+# Enable Bluetooth
+vssl.settings.bluetooth = True
+# Toggle Bluetooth
+vssl.settings.bluetooth_toggle()
 ```
 
 ## `Vssl.settings.power`
@@ -225,7 +264,7 @@ zone1.transport.state = ZoneTransport.States.PAUSE
 ## `Zone.track`
 
 * Not all sources have complete metadata - missing value will be set to defaults.
-* Airplay track `progress` is not avaiable.
+* Airplay track `progress` is not available.
 
 | Property      	| Description | Type		| Values 		| 
 | ---------------------- | ----------- | ----------- |----------- |
@@ -265,7 +304,7 @@ zone1.input.priority = InputRouter.Priorities.LOCAL
 
 ## `Zone.group`
 
-Working on A.3x but offically unsupported in x series amplifiers.
+Officially unsupported in X series amplifiers.
 
 | Property      	| Description | Type		| Values 		| 
 | ---------------------- 	| ----------- | ----------- |----------- |
@@ -275,6 +314,7 @@ Working on A.3x but offically unsupported in x series amplifiers.
 | `remove_member()`   		| Remove zone from group      |	`func`  | `ZoneIDs`
 | `dissolve()`   			| Dissolve group / remove all members       |	`func`  |
 | `leave()`   				| Leave the group if a member       |	`func`  |
+| `is_party_zone_member`  | Member of Party Zone |  `bool`  |
 
 ```python
 """Examples"""
@@ -285,6 +325,10 @@ zone2.group.leave() # or
 zone1.group.remove_member(ZoneIDs.ZONE_2)
 # If zone 1 is a master, remove all members
 zone1.group.dissolve()
+# Add zone to the party zone group
+zone1.group.is_party_zone_member = True
+# Toggle Party Zone Membership
+zone1.group.is_party_zone_member_toggle()
 ```
 
 ## `Zone.analog_output`
@@ -384,6 +428,23 @@ EQ to be set in [decibel](https://en.wikipedia.org/wiki/Decibel) using a range `
 zone1.settings.eq.khz1_db = -2
 ```
 
+## `Zone.settings.subwoofer`
+
+* **A.1 and A.1x only**
+* Set `0` for full frequency range
+
+| Property        | Description | Type    | Values    | Default |
+| ----------------------  | ----------- | ----------- |----------- |----------- |
+| `crossover`             | Set "sub out" crossover frequency from 50-200Hz.       |  `int` | `0` or `50...200` | `0`
+
+```python
+"""Examples"""
+# Set subwoofer ouput crossover to 100hz
+zone1.settings.subwoofer.crossover = 100
+```
+
+
+
 ## Another (Lite) Way
 
 If you perfer to not run the complete intergration, you can send basic HEX commands to the VSSL device using [Netcat](https://nc110.sourceforge.io/) (or any network tool) on port `50002`.
@@ -433,9 +494,11 @@ shell_command:
 
 ## Credit
 
+Thanks to [@dj-jam](https://github.com/dj-jam) for the continued testing.
+
 The VSSL API was reverse engineered using Wireshark, VSSLs native "legacy" iOS app and their deprecated [vsslagent](https://vssl.gitbook.io/vssl-rest-api/getting-started/start).
 
-Motovation for this project was to intergrate VSSLs amplifiers into [Home Assistant](https://www.home-assistant.io/) and have control over different subnets (not mDNS dependant)
+Motivation for this project was to integrate VSSLs amplifiers into [Home Assistant](https://www.home-assistant.io/) and have control over different subnets (not mDNS dependant)
 
 ## Known Issues & Limitiations
 
@@ -443,15 +506,15 @@ Motovation for this project was to intergrate VSSLs amplifiers into [Home Assist
 * VSSL can not start a stream except for playing a URL directly. This is a limitation of the hardware itself.
 * Not all sources set the volume to 0 when the zone is muted
 * Grouping feedback is flaky on the X series amplifiers
-* Airplay `Zone.track.progress` is not avaiable.
+* Airplay `Zone.track.progress` is not available.
 * Cant stop a URL playback, feedback is worng at least
 * VSSL likes to cache old track metadata. For example when playing a URL after Spotify, often the device will respond with the previous (Spotify) tracks metadata
-* `stop()` is intended to disconnect the client and pause the stream. Doesnt always function this way, depending on stream source
+* `stop()` is intended to disconnect the client and pause the stream. Doesn’t always function this way, depending on stream source
 * Occasionally a zones might stop responding to certain commands, issuing the `reboot` command generally corrects
 
 ## Future
 
-* A.1(x) coverage i.e Bluetooth and subwoofer control
+* A.1(x) coverage i.e Bluetooth
 * REST API / Web App
 * Save and recall EQ
 * IR Control

vsslctrl-0.1.10.dev1.dist-info/RECORD

@@ -0,0 +1,23 @@
+vsslctrl/__init__.py,sha256=Pi0MgplOWvu3EpicZcmY05ctjtsmj-Stvv9GQZVsJW0,174
+vsslctrl/api_alpha.py,sha256=I3BcyphEHtW89vN363W7hiGHiPhHnQFO6krmxtMwGQc,35504
+vsslctrl/api_base.py,sha256=a80CRtUkYK2OwXQOL8bP-YOvt4YE-ALd-VONza_gjK8,9623
+vsslctrl/api_bravo.py,sha256=pchZN16KIvdSrqkI1WU9PA9IEmxkyyP-XifxpRC0jDE,12283
+vsslctrl/core.py,sha256=uUNb8bU2JRZxDbzWgwrblXjKHYdeIWbuogSp9qQX3U8,9555
+vsslctrl/data_structure.py,sha256=Doxyl5S6ecdAKk1Z4UO1BlCw2kAntUtU4RBVXhW9ZN0,10322
+vsslctrl/decorators.py,sha256=lG8cYSSA-fNvdcp_90lv58tj50bF6iPoigLKcucWSSI,1707
+vsslctrl/device.py,sha256=zJg51SiOv8IRyxHRXx7SrYXeyOGEeZY3id7NL3fTuTw,6070
+vsslctrl/discovery.py,sha256=3z7z6YQUtvjFvRlQOZXIu6Wd4M896rMbi8SUkTub3AM,5568
+vsslctrl/event_bus.py,sha256=9liAEJnZfthJwy5O-qc3pDIWRBv5AcV19PjMCwH_niU,5014
+vsslctrl/exceptions.py,sha256=EEfNlu--9PMIidj3V3ZB8c7p3My8siqKw7YIOjPFaqE,419
+vsslctrl/group.py,sha256=DJRD3pLha5tvpN_RTO8Zg311TaNWQ_O4p5bJjZ47aWE,6311
+vsslctrl/io.py,sha256=bucsUQXUAlXx8D_s_Sa20eTamT_FiR1cKwMX4Yl4ySM,6902
+vsslctrl/settings.py,sha256=_VtZLTYXdo2otyqs4iruCaOwclnoMafpsvPS1UJGXA4,19083
+vsslctrl/track.py,sha256=_lQNHYe8ZBm3v1lehFLjZruF5-Rz8PGWuQN-zISBgwc,10136
+vsslctrl/transport.py,sha256=XJFy0kl9y7hm3YV4_9ElBrq3u6--_k73UKJqKdO6Rqg,6993
+vsslctrl/utils.py,sha256=FWOMHM_sl1Cp1xab-V6b-A5B7qRmDN67hMMxV4ReWCk,2087
+vsslctrl/zone.py,sha256=teSk8oE3LKteidRnuVK3koUOqtN-90LclEx0-T4FhAE,12978
+vsslctrl-0.1.10.dev1.dist-info/LICENSE,sha256=67Ekj8PIxjEvkPd7L3GYJ8dyvn1EC4sPM3q3FKtpN6w,1065
+vsslctrl-0.1.10.dev1.dist-info/METADATA,sha256=VJzk7TXVa5INkaz-0oZyzYUlsQHNeSZmHu6Vf5Ds-b8,18817
+vsslctrl-0.1.10.dev1.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+vsslctrl-0.1.10.dev1.dist-info/top_level.txt,sha256=MRycO_RKageNX27UZ2bLJDMlfeWTQzUZlsd3hS-0u3Y,9
+vsslctrl-0.1.10.dev1.dist-info/RECORD,,

{vsslctrl-0.1.9.dev1.dist-info → vsslctrl-0.1.10.dev1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.1.0)
+Generator: setuptools (75.3.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

vsslctrl-0.1.9.dev1.dist-info/RECORD

@@ -1,23 +0,0 @@
-vsslctrl/__init__.py,sha256=W7cljoE7L3DukAVr_TEqkxFycYrUbJiqaHrOlbPkmKU,145
-vsslctrl/api_alpha.py,sha256=UxsMKOFK4Uit3QoF96Wa3VE1WdbCq7FOJjt-3fewAe0,33962
-vsslctrl/api_base.py,sha256=a80CRtUkYK2OwXQOL8bP-YOvt4YE-ALd-VONza_gjK8,9623
-vsslctrl/api_bravo.py,sha256=pchZN16KIvdSrqkI1WU9PA9IEmxkyyP-XifxpRC0jDE,12283
-vsslctrl/core.py,sha256=G6XSH2_sxVaB6AfR6Btt8SMqiihlBQ6n_UZB9lsO7fw,9114
-vsslctrl/data_structure.py,sha256=i6xG72kQqFDSoEhI307Iw9QXTquMNMc4qMUGOK0MEbw,9793
-vsslctrl/decorators.py,sha256=lG8cYSSA-fNvdcp_90lv58tj50bF6iPoigLKcucWSSI,1707
-vsslctrl/device.py,sha256=M6fcd2ggE-ConHoENpQ3WtGQzmSyok9t-8Kt5pd-r6U,6104
-vsslctrl/discovery.py,sha256=3z7z6YQUtvjFvRlQOZXIu6Wd4M896rMbi8SUkTub3AM,5568
-vsslctrl/event_bus.py,sha256=9liAEJnZfthJwy5O-qc3pDIWRBv5AcV19PjMCwH_niU,5014
-vsslctrl/exceptions.py,sha256=EEfNlu--9PMIidj3V3ZB8c7p3My8siqKw7YIOjPFaqE,419
-vsslctrl/group.py,sha256=B7lmJb6DIwXGnMyTKsp-JfRWVCVRFQYzlvS71tutfx4,5368
-vsslctrl/io.py,sha256=RZCLxa0RAnyhRdDTM7IFpLcpYeQfV90DzVEJdNjR6lQ,6684
-vsslctrl/settings.py,sha256=ZUa_ixohGzowj6mhGlCcVAr_ZfsbpU_N5jK-7pEA5Jc,18997
-vsslctrl/track.py,sha256=_lQNHYe8ZBm3v1lehFLjZruF5-Rz8PGWuQN-zISBgwc,10136
-vsslctrl/transport.py,sha256=XJFy0kl9y7hm3YV4_9ElBrq3u6--_k73UKJqKdO6Rqg,6993
-vsslctrl/utils.py,sha256=FWOMHM_sl1Cp1xab-V6b-A5B7qRmDN67hMMxV4ReWCk,2087
-vsslctrl/zone.py,sha256=teSk8oE3LKteidRnuVK3koUOqtN-90LclEx0-T4FhAE,12978
-vsslctrl-0.1.9.dev1.dist-info/LICENSE,sha256=67Ekj8PIxjEvkPd7L3GYJ8dyvn1EC4sPM3q3FKtpN6w,1065
-vsslctrl-0.1.9.dev1.dist-info/METADATA,sha256=fKQI1brfCRDqoXlXfPNB_22heY6oQC-fxjADf02JYro,16990
-vsslctrl-0.1.9.dev1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-vsslctrl-0.1.9.dev1.dist-info/top_level.txt,sha256=MRycO_RKageNX27UZ2bLJDMlfeWTQzUZlsd3hS-0u3Y,9
-vsslctrl-0.1.9.dev1.dist-info/RECORD,,