From 2dc096e306ef9543cdaa2df02882a1274111a297 Mon Sep 17 00:00:00 2001 From: onyx-and-iris Date: Fri, 16 Feb 2024 12:37:15 +0000 Subject: [PATCH] connect_timeout kwarg added to README Errors section added to README --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index aabb0e1..99c7be5 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,7 @@ if __name__ == "__main__": main() ``` -#### `xair_api.connect(kind_id, ip=ip, delay=delay)` +#### `xair_api.connect(kind_id, ip=ip, delay=0.02, connect_timeout=2)` Currently the following devices are supported: @@ -72,6 +72,7 @@ The following keyword arguments may be passed: - `port`: mixer port, defaults to 10023 for x32 and 10024 for xair - `delay`: a delay between each command (applies to the getters). Defaults to 20ms. - a note about delay, stability may rely on network connection. For wired connections the delay can be safely reduced. +- `connect_timeout`: amount of time to wait for a validated connection. Defaults to 2s. ## API @@ -317,6 +318,14 @@ for example: print(mixer.query("/ch/01/mix/on")) ``` +### Errors + +- `errors.XAirRemoteError`: Base error class for XAIR Remote. +- `errors.XAirRemoteConnectionTimeoutError`:Exception raised when a connection attempt times out. + - The following attributes are available: + - `ip`: IP of the mixer. + - `port`: Port of the mixer. + ### `Tests` Unplug any expensive equipment before running tests.