uwscli 0.2.0__tar.gz → 0.4.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {uwscli-0.2.0/src/uwscli.egg-info → uwscli-0.4.0}/PKG-INFO +51 -17
- uwscli-0.4.0/README.md +152 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/pyproject.toml +7 -4
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/__init__.py +2 -1
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/cli.py +353 -65
- uwscli-0.4.0/src/uwscli/data/__init__.py +0 -0
- uwscli-0.4.0/src/uwscli/data/twinkle.bin +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/lcd.py +2 -2
- uwscli-0.4.0/src/uwscli/tl_effects.py +1355 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/tlcontroller.py +1 -1
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/wireless.py +163 -22
- {uwscli-0.2.0 → uwscli-0.4.0/src/uwscli.egg-info}/PKG-INFO +51 -17
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli.egg-info/SOURCES.txt +3 -0
- uwscli-0.4.0/tests/test_cli_errors.py +101 -0
- uwscli-0.4.0/tests/test_cli_output.py +1200 -0
- uwscli-0.2.0/README.md +0 -118
- uwscli-0.2.0/tests/test_cli_errors.py +0 -49
- uwscli-0.2.0/tests/test_cli_output.py +0 -538
- {uwscli-0.2.0 → uwscli-0.4.0}/LICENSE +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/setup.cfg +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/led.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/logging_utils.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/structs.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/system_usb.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/tinyuz.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli/usbutil.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli.egg-info/dependency_links.txt +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli.egg-info/entry_points.txt +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli.egg-info/requires.txt +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/src/uwscli.egg-info/top_level.txt +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/tests/test_led_compression.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/tests/test_usbutil.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/tests/test_wireless_integration.py +0 -0
- {uwscli-0.2.0 → uwscli-0.4.0}/tests/test_wireless_led_packets.py +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: uwscli
|
|
3
|
-
Version: 0.
|
|
4
|
-
Summary: Uni-Wireless-Sync: wireless control toolkit for TL
|
|
3
|
+
Version: 0.4.0
|
|
4
|
+
Summary: Uni-Wireless-Sync: wireless control toolkit for TL fan receivers
|
|
5
5
|
Author: Study Hsueh
|
|
6
6
|
License: MIT License
|
|
7
7
|
|
|
@@ -24,8 +24,8 @@ License: MIT License
|
|
|
24
24
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
25
25
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
26
26
|
SOFTWARE.
|
|
27
|
-
Project-URL: Homepage, https://github.com/phstudy/
|
|
28
|
-
Project-URL: Issues, https://github.com/phstudy/
|
|
27
|
+
Project-URL: Homepage, https://github.com/phstudy/uni-wireless-sync
|
|
28
|
+
Project-URL: Issues, https://github.com/phstudy/uni-wireless-sync/issues
|
|
29
29
|
Keywords: lian-li,uni-fan,wireless,lcd
|
|
30
30
|
Classifier: Development Status :: 3 - Alpha
|
|
31
31
|
Classifier: Environment :: Console
|
|
@@ -66,7 +66,7 @@ Uni Wireless Sync (UWS) CLI provides command-line utilities for managing Uni Fan
|
|
|
66
66
|
## Supported Hardware
|
|
67
67
|
|
|
68
68
|
- UNI FAN TL wireless LCD panels
|
|
69
|
-
- UNI FAN TL wireless
|
|
69
|
+
- UNI FAN TL wireless fans (non-LCD)
|
|
70
70
|
|
|
71
71
|
Other Uni Fan series are currently not supported.
|
|
72
72
|
|
|
@@ -76,14 +76,23 @@ Other Uni Fan series are currently not supported.
|
|
|
76
76
|
- Query LCD firmware and handshake data.
|
|
77
77
|
- Send JPEG frames or apply control settings (mode, brightness, rotation) to the LCD.
|
|
78
78
|
- Keep the wireless TL LCD awake by emitting periodic handshakes.
|
|
79
|
-
- List wireless fan
|
|
79
|
+
- List wireless fan receivers with metadata (MAC, master MAC, channel, device type, fan speeds, PWM targets).
|
|
80
|
+
- List detected master controller MAC addresses to simplify binding workflows.
|
|
80
81
|
- Send one-shot PWM commands to TL wireless fans over the 2.4 GHz dongle.
|
|
81
|
-
- Bind or unbind wireless
|
|
82
|
-
- Toggle motherboard PWM sync mode for one
|
|
82
|
+
- Bind or unbind wireless receivers against the active master controller.
|
|
83
|
+
- Toggle motherboard PWM sync mode for one receiver or every bound receiver.
|
|
84
|
+
- Broadcast static RGB payloads to wireless receivers (experimental).
|
|
83
85
|
|
|
84
|
-
|
|
86
|
+
### Fan wiring modes
|
|
85
87
|
|
|
86
|
-
-
|
|
88
|
+
- **USB + PWM header (controller mode):** leave the receiver's PWM lead unplugged; control every fan via `uws fan set-fan` (any PWM value 0-255). The reported `fan_pwm` reflects your last command.
|
|
89
|
+
- **USB-only (receiver mode, PWM lead connected to motherboard):** the CLI writes a PWM of 6 (e.g. `uws fan pwm-sync --mode receiver --all`) so the receiver keeps syncing to the motherboard header. Sending another `set-fan` value at any time overrides the sync immediately; writing 6 (or re-running the sync helper) hands control back to the motherboard.
|
|
90
|
+
|
|
91
|
+
## FAQ
|
|
92
|
+
|
|
93
|
+
- **How do I mount the L-Wireless Controller (v1)?** The thicker dongle supports two options: (1) plug into a USB Type-A port—this wiring is equivalent to `pwm-sync` receiver mode; (2) plug the header into a 9-pin USB port on the motherboard—this matches `pwm-sync` controller mode, but 2.4 GHz signal strength drops because the dongle lives inside the chassis.
|
|
94
|
+
- **How do I mount the L-Wireless Controller (v2)?** The slimmer dongle only supports option (1): plug into a USB Type-A port (`pwm-sync` receiver mode).
|
|
95
|
+
- **What is the difference between L-Wireless Receiver (v1) and (v2)?** Receiver v1 exposes both USB and a 2-pin PWM lead only on the LCD bundle (USB powers the LCD, the 2-pin lead powers fans); non-LCD receiver v1 units ship with just the 2-pin power lead. Receiver v2 adds a dedicated 4-pin PWM header; plug it into the motherboard when you want it to mirror the motherboard duty cycle via `pwm-sync --mode receiver`, or leave it disconnected and the controller will keep driving fan PWM directly.
|
|
87
96
|
|
|
88
97
|
## Installation
|
|
89
98
|
|
|
@@ -111,8 +120,9 @@ uws lcd info --serial <usb-serial>
|
|
|
111
120
|
uws lcd send-jpg --serial <usb-serial> --file assets/sample_lcd.jpg
|
|
112
121
|
uws lcd keep-alive --serial <usb-serial> --interval 5
|
|
113
122
|
|
|
114
|
-
# Fan
|
|
115
|
-
uws fan set-fan --mac aa:bb:cc:dd:ee:ff --pwm 120
|
|
123
|
+
# Fan receiver operations
|
|
124
|
+
uws fan set-fan --mac aa:bb:cc:dd:ee:ff --pwm 120 # direct PWM control
|
|
125
|
+
uws fan pwm-sync --mode receiver --all # receiver mode receivers (sets PWM=6)
|
|
116
126
|
uws fan bind --mac aa:bb:cc:dd:ee:ff
|
|
117
127
|
uws fan unbind --mac aa:bb:cc:dd:ee:ff
|
|
118
128
|
uws fan pwm-sync --all
|
|
@@ -128,16 +138,40 @@ uws fan pwm-sync --mac aa:bb:cc:dd:ee:ff --once
|
|
|
128
138
|
- `uws lcd send-jpg --serial <usb-serial> --file <image.jpg>` – stream a JPEG asset.
|
|
129
139
|
- `uws lcd keep-alive --serial <usb-serial> [--interval seconds]` – emit periodic handshakes to prevent the wireless panel from dimming.
|
|
130
140
|
- `uws lcd control --serial <usb-serial> [--mode show-jpg|show-app-sync|lcd-test] [--jpg-index N] [--brightness 0-100] [--fps N] [--rotation 0|90|180|270] [--test-color R,G,B]` – send an `LCDControlSetting` payload.
|
|
131
|
-
- `uws fan list` – fetch a snapshot of bound wireless
|
|
132
|
-
- `uws fan
|
|
133
|
-
- `uws fan set-
|
|
134
|
-
- `uws fan pwm-sync --all
|
|
141
|
+
- `uws fan list` – fetch a snapshot of bound wireless receivers via the RF receiver.
|
|
142
|
+
- `uws fan list-masters` – enumerate master controllers and associated wireless receivers.
|
|
143
|
+
- `uws fan set-fan --mac <aa:bb:..> --pwm <0-255> [--sequence-index N]` – send a single shot PWM update to one receiver; `--all` broadcasts to every bound receiver.
|
|
144
|
+
- `uws fan pwm-sync --mac|--all [--mode controller|receiver] [--interval seconds] [--once] [--sequence-index N]` – synchronize receiver speeds. `controller` polls motherboard PWM and replays the value via RF (`--interval` / `--once` apply here); `receiver` sets PWM=6 so the receiver tracks the motherboard header directly (`--sequence-index` applies here).
|
|
145
|
+
- `uws fan set-led --mac <aa:bb:..> --mode static|rainbow|frames|effect|random-effect` – apply wireless LED effects (**experimental**).
|
|
146
|
+
|
|
147
|
+
### `uws fan set-led` modes
|
|
148
|
+
|
|
149
|
+
- `static`: requires `--color R,G,B` or `--color-list R,G,B;...` to paint the LED strip once.
|
|
150
|
+
- `rainbow`: procedural rainbow; optional `--frames N` (default 24) and `--interval-ms` (default 50).
|
|
151
|
+
- `frames`: feed a JSON animation via `--frames-file`. Each frame is an array of `[R, G, B]` triples; see `examples/tl_frames_sample.json` for a minimal illustration (the CLI will pad or truncate per device LED count).
|
|
152
|
+
- `effect`: drives any of the 29 TL presets. Choose an effect with `--effect <name>` (e.g. `twinkle`, `meteor_shower`), adjust brightness 0‑255 via `--effect-brightness`, pick direction with `--effect-direction 0|1`, and select which segment to update using `--effect-scope front|behind|both` (default `both`).
|
|
153
|
+
- `random-effect`: picks a random preset each time; accepts the same brightness/direction/scope flags as `effect`.
|
|
154
|
+
|
|
155
|
+
Available effect names (case-insensitive): `rainbow`, `rainbow_morph`, `static_color`, `breathing`, `runway`, `meteor`, `color_cycle`, `staggered`, `tide`, `mixing`, `voice`, `door`, `render`, `ripple`, `reflect`, `tail_chasing`, `paint`, `ping_pong`, `stack`, `cover_cycle`, `wave`, `racing`, `lottery`, `intertwine`, `meteor_shower`, `collide`, `electric_current`, `kaleidoscope`, `twinkle`.
|
|
156
|
+
|
|
157
|
+
Example:
|
|
158
|
+
|
|
159
|
+
```
|
|
160
|
+
uws fan set-led --mac aa:bb:cc:dd:ee:ff --mode effect --effect twinkle --effect-brightness 180 --effect-direction 0 --effect-scope both
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Random example:
|
|
164
|
+
|
|
165
|
+
```
|
|
166
|
+
uws fan set-led --mac aa:bb:cc:dd:ee:ff --mode random-effect --effect-brightness 200 --effect-direction 1
|
|
167
|
+
```
|
|
168
|
+
- `uws fan pwm-sync --all|--mac [--mode controller|receiver] [--interval seconds] [--once] [--sequence-index N]` – default `receiver` mode writes PWM=6 so fans follow the motherboard; `controller` mode polls and replays PWM from the motherboard (supports `--interval`/`--once` for polling loops; `--sequence-index` applies to receiver broadcasts).
|
|
135
169
|
|
|
136
170
|
## Dependencies
|
|
137
171
|
|
|
138
172
|
- `hidapi` (via `hid`) for TL LCD HID access.
|
|
139
173
|
- `pyusb` for the RF sender/receiver WinUSB endpoints.
|
|
140
|
-
- `pycryptodomex` for the DES-CBC transport used by the wireless LCD
|
|
174
|
+
- `pycryptodomex` for the DES-CBC transport used by the wireless LCD receiver.
|
|
141
175
|
- `Pillow` is optional for JPEG frame validation.
|
|
142
176
|
|
|
143
177
|
Each command expects the TL LCD USB display (vendor 0x04FC or 0x1CBE) and the wireless transmitter/receiver pair (vendor 0x0416) to be attached when the command executes.
|
uwscli-0.4.0/README.md
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# Uni Wireless Sync CLI
|
|
2
|
+
|
|
3
|
+
Warning: This is an unofficial implementation; use at your own risk.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
Uni Wireless Sync (UWS) CLI provides command-line utilities for managing Uni Fan Wireless controllers, L-Wireless receivers, and LCD panels. Each command re-opens the required USB or RF device so no background daemon is left running, and lower-level HID/USB errors are surfaced directly to simplify scripting.
|
|
8
|
+
|
|
9
|
+
## Supported Hardware
|
|
10
|
+
|
|
11
|
+
- UNI FAN TL wireless LCD panels
|
|
12
|
+
- UNI FAN TL wireless fans (non-LCD)
|
|
13
|
+
|
|
14
|
+
Other Uni Fan series are currently not supported.
|
|
15
|
+
|
|
16
|
+
## Features
|
|
17
|
+
|
|
18
|
+
- Discover TL LCD USB devices and 2.4 GHz wireless fan controllers.
|
|
19
|
+
- Query LCD firmware and handshake data.
|
|
20
|
+
- Send JPEG frames or apply control settings (mode, brightness, rotation) to the LCD.
|
|
21
|
+
- Keep the wireless TL LCD awake by emitting periodic handshakes.
|
|
22
|
+
- List wireless fan receivers with metadata (MAC, master MAC, channel, device type, fan speeds, PWM targets).
|
|
23
|
+
- List detected master controller MAC addresses to simplify binding workflows.
|
|
24
|
+
- Send one-shot PWM commands to TL wireless fans over the 2.4 GHz dongle.
|
|
25
|
+
- Bind or unbind wireless receivers against the active master controller.
|
|
26
|
+
- Toggle motherboard PWM sync mode for one receiver or every bound receiver.
|
|
27
|
+
- Broadcast static RGB payloads to wireless receivers (experimental).
|
|
28
|
+
|
|
29
|
+
### Fan wiring modes
|
|
30
|
+
|
|
31
|
+
- **USB + PWM header (controller mode):** leave the receiver's PWM lead unplugged; control every fan via `uws fan set-fan` (any PWM value 0-255). The reported `fan_pwm` reflects your last command.
|
|
32
|
+
- **USB-only (receiver mode, PWM lead connected to motherboard):** the CLI writes a PWM of 6 (e.g. `uws fan pwm-sync --mode receiver --all`) so the receiver keeps syncing to the motherboard header. Sending another `set-fan` value at any time overrides the sync immediately; writing 6 (or re-running the sync helper) hands control back to the motherboard.
|
|
33
|
+
|
|
34
|
+
## FAQ
|
|
35
|
+
|
|
36
|
+
- **How do I mount the L-Wireless Controller (v1)?** The thicker dongle supports two options: (1) plug into a USB Type-A port—this wiring is equivalent to `pwm-sync` receiver mode; (2) plug the header into a 9-pin USB port on the motherboard—this matches `pwm-sync` controller mode, but 2.4 GHz signal strength drops because the dongle lives inside the chassis.
|
|
37
|
+
- **How do I mount the L-Wireless Controller (v2)?** The slimmer dongle only supports option (1): plug into a USB Type-A port (`pwm-sync` receiver mode).
|
|
38
|
+
- **What is the difference between L-Wireless Receiver (v1) and (v2)?** Receiver v1 exposes both USB and a 2-pin PWM lead only on the LCD bundle (USB powers the LCD, the 2-pin lead powers fans); non-LCD receiver v1 units ship with just the 2-pin power lead. Receiver v2 adds a dedicated 4-pin PWM header; plug it into the motherboard when you want it to mirror the motherboard duty cycle via `pwm-sync --mode receiver`, or leave it disconnected and the controller will keep driving fan PWM directly.
|
|
39
|
+
|
|
40
|
+
## Installation
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
pip install uwscli
|
|
44
|
+
# optional image helpers
|
|
45
|
+
pip install uwscli[images]
|
|
46
|
+
|
|
47
|
+
python -m venv .venv
|
|
48
|
+
source .venv/bin/activate
|
|
49
|
+
pip install -e .
|
|
50
|
+
# or include dev extras
|
|
51
|
+
pip install -e .[dev]
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Usage Examples
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
# Enumerate connected devices
|
|
58
|
+
uws lcd list
|
|
59
|
+
uws fan list
|
|
60
|
+
|
|
61
|
+
# Display operations
|
|
62
|
+
uws lcd info --serial <usb-serial>
|
|
63
|
+
uws lcd send-jpg --serial <usb-serial> --file assets/sample_lcd.jpg
|
|
64
|
+
uws lcd keep-alive --serial <usb-serial> --interval 5
|
|
65
|
+
|
|
66
|
+
# Fan receiver operations
|
|
67
|
+
uws fan set-fan --mac aa:bb:cc:dd:ee:ff --pwm 120 # direct PWM control
|
|
68
|
+
uws fan pwm-sync --mode receiver --all # receiver mode receivers (sets PWM=6)
|
|
69
|
+
uws fan bind --mac aa:bb:cc:dd:ee:ff
|
|
70
|
+
uws fan unbind --mac aa:bb:cc:dd:ee:ff
|
|
71
|
+
uws fan pwm-sync --all
|
|
72
|
+
uws fan pwm-sync --mac aa:bb:cc:dd:ee:ff --once
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
`uws lcd list` prints JSON rows that include a `serial` field—copy that value when invoking other LCD subcommands.
|
|
76
|
+
|
|
77
|
+
## Command Reference
|
|
78
|
+
|
|
79
|
+
- `uws lcd list` – enumerate TL LCD devices and show their USB serial numbers.
|
|
80
|
+
- `uws lcd info --serial <usb-serial>` – read firmware and handshake data.
|
|
81
|
+
- `uws lcd send-jpg --serial <usb-serial> --file <image.jpg>` – stream a JPEG asset.
|
|
82
|
+
- `uws lcd keep-alive --serial <usb-serial> [--interval seconds]` – emit periodic handshakes to prevent the wireless panel from dimming.
|
|
83
|
+
- `uws lcd control --serial <usb-serial> [--mode show-jpg|show-app-sync|lcd-test] [--jpg-index N] [--brightness 0-100] [--fps N] [--rotation 0|90|180|270] [--test-color R,G,B]` – send an `LCDControlSetting` payload.
|
|
84
|
+
- `uws fan list` – fetch a snapshot of bound wireless receivers via the RF receiver.
|
|
85
|
+
- `uws fan list-masters` – enumerate master controllers and associated wireless receivers.
|
|
86
|
+
- `uws fan set-fan --mac <aa:bb:..> --pwm <0-255> [--sequence-index N]` – send a single shot PWM update to one receiver; `--all` broadcasts to every bound receiver.
|
|
87
|
+
- `uws fan pwm-sync --mac|--all [--mode controller|receiver] [--interval seconds] [--once] [--sequence-index N]` – synchronize receiver speeds. `controller` polls motherboard PWM and replays the value via RF (`--interval` / `--once` apply here); `receiver` sets PWM=6 so the receiver tracks the motherboard header directly (`--sequence-index` applies here).
|
|
88
|
+
- `uws fan set-led --mac <aa:bb:..> --mode static|rainbow|frames|effect|random-effect` – apply wireless LED effects (**experimental**).
|
|
89
|
+
|
|
90
|
+
### `uws fan set-led` modes
|
|
91
|
+
|
|
92
|
+
- `static`: requires `--color R,G,B` or `--color-list R,G,B;...` to paint the LED strip once.
|
|
93
|
+
- `rainbow`: procedural rainbow; optional `--frames N` (default 24) and `--interval-ms` (default 50).
|
|
94
|
+
- `frames`: feed a JSON animation via `--frames-file`. Each frame is an array of `[R, G, B]` triples; see `examples/tl_frames_sample.json` for a minimal illustration (the CLI will pad or truncate per device LED count).
|
|
95
|
+
- `effect`: drives any of the 29 TL presets. Choose an effect with `--effect <name>` (e.g. `twinkle`, `meteor_shower`), adjust brightness 0‑255 via `--effect-brightness`, pick direction with `--effect-direction 0|1`, and select which segment to update using `--effect-scope front|behind|both` (default `both`).
|
|
96
|
+
- `random-effect`: picks a random preset each time; accepts the same brightness/direction/scope flags as `effect`.
|
|
97
|
+
|
|
98
|
+
Available effect names (case-insensitive): `rainbow`, `rainbow_morph`, `static_color`, `breathing`, `runway`, `meteor`, `color_cycle`, `staggered`, `tide`, `mixing`, `voice`, `door`, `render`, `ripple`, `reflect`, `tail_chasing`, `paint`, `ping_pong`, `stack`, `cover_cycle`, `wave`, `racing`, `lottery`, `intertwine`, `meteor_shower`, `collide`, `electric_current`, `kaleidoscope`, `twinkle`.
|
|
99
|
+
|
|
100
|
+
Example:
|
|
101
|
+
|
|
102
|
+
```
|
|
103
|
+
uws fan set-led --mac aa:bb:cc:dd:ee:ff --mode effect --effect twinkle --effect-brightness 180 --effect-direction 0 --effect-scope both
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
Random example:
|
|
107
|
+
|
|
108
|
+
```
|
|
109
|
+
uws fan set-led --mac aa:bb:cc:dd:ee:ff --mode random-effect --effect-brightness 200 --effect-direction 1
|
|
110
|
+
```
|
|
111
|
+
- `uws fan pwm-sync --all|--mac [--mode controller|receiver] [--interval seconds] [--once] [--sequence-index N]` – default `receiver` mode writes PWM=6 so fans follow the motherboard; `controller` mode polls and replays PWM from the motherboard (supports `--interval`/`--once` for polling loops; `--sequence-index` applies to receiver broadcasts).
|
|
112
|
+
|
|
113
|
+
## Dependencies
|
|
114
|
+
|
|
115
|
+
- `hidapi` (via `hid`) for TL LCD HID access.
|
|
116
|
+
- `pyusb` for the RF sender/receiver WinUSB endpoints.
|
|
117
|
+
- `pycryptodomex` for the DES-CBC transport used by the wireless LCD receiver.
|
|
118
|
+
- `Pillow` is optional for JPEG frame validation.
|
|
119
|
+
|
|
120
|
+
Each command expects the TL LCD USB display (vendor 0x04FC or 0x1CBE) and the wireless transmitter/receiver pair (vendor 0x0416) to be attached when the command executes.
|
|
121
|
+
|
|
122
|
+
## Linux udev Permissions
|
|
123
|
+
|
|
124
|
+
Grant non-root access to the TL wireless dongles by adding `/etc/udev/rules.d/99-tl-wireless.rules` with:
|
|
125
|
+
|
|
126
|
+
```
|
|
127
|
+
# Winbond SLV3RX_V1.6 (receiver)
|
|
128
|
+
SUBSYSTEM=="usb", ATTR{idVendor}=="0416", ATTR{idProduct}=="8041", MODE="0666", GROUP="plugdev"
|
|
129
|
+
SUBSYSTEM=="usb_device", ATTR{idVendor}=="0416", ATTR{idProduct}=="8041", MODE="0666", GROUP="plugdev"
|
|
130
|
+
SUBSYSTEM=="usb_interface", ATTRS{idVendor}=="0416", ATTRS{idProduct}=="8041", MODE="0666", GROUP="plugdev"
|
|
131
|
+
|
|
132
|
+
# Winbond SLV3TX_V1.6 (transmitter)
|
|
133
|
+
SUBSYSTEM=="usb", ATTR{idVendor}=="0416", ATTR{idProduct}=="8040", MODE="0666", GROUP="plugdev"
|
|
134
|
+
SUBSYSTEM=="usb_device", ATTR{idVendor}=="0416", ATTR{idProduct}=="8040", MODE="0666", GROUP="plugdev"
|
|
135
|
+
SUBSYSTEM=="usb_interface", ATTRS{idVendor}=="0416", ATTRS{idProduct}=="8040", MODE="0666", GROUP="plugdev"
|
|
136
|
+
|
|
137
|
+
# Luminary Micro TL-LCD Wireless-1.3
|
|
138
|
+
SUBSYSTEM=="usb", ATTR{idVendor}=="1cbe", ATTR{idProduct}=="0006", MODE="0666", GROUP="plugdev"
|
|
139
|
+
SUBSYSTEM=="usb_device", ATTR{idVendor}=="1cbe", ATTR{idProduct}=="0006", MODE="0666", GROUP="plugdev"
|
|
140
|
+
SUBSYSTEM=="usb_interface", ATTRS{idVendor}=="1cbe", ATTRS{idProduct}=="0006", MODE="0666", GROUP="plugdev"
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Reload the rules and replug the dongles:
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
sudo udevadm control --reload
|
|
147
|
+
sudo udevadm trigger
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
## License
|
|
151
|
+
|
|
152
|
+
Released under the MIT License. See `LICENSE` for details.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "uwscli"
|
|
3
|
-
version = "0.
|
|
4
|
-
description = "Uni-Wireless-Sync: wireless control toolkit for TL
|
|
3
|
+
version = "0.4.0"
|
|
4
|
+
description = "Uni-Wireless-Sync: wireless control toolkit for TL fan receivers"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
requires-python = ">=3.10"
|
|
7
7
|
license = {file = "LICENSE"}
|
|
@@ -38,8 +38,8 @@ dev = [
|
|
|
38
38
|
images = ["Pillow>=10.0"]
|
|
39
39
|
|
|
40
40
|
[project.urls]
|
|
41
|
-
Homepage = "https://github.com/phstudy/
|
|
42
|
-
Issues = "https://github.com/phstudy/
|
|
41
|
+
Homepage = "https://github.com/phstudy/uni-wireless-sync"
|
|
42
|
+
Issues = "https://github.com/phstudy/uni-wireless-sync/issues"
|
|
43
43
|
|
|
44
44
|
[project.scripts]
|
|
45
45
|
uws = "uwscli.cli:main"
|
|
@@ -48,6 +48,9 @@ uws = "uwscli.cli:main"
|
|
|
48
48
|
where = ["src"]
|
|
49
49
|
include = ["uwscli", "uwscli.*"]
|
|
50
50
|
|
|
51
|
+
[tool.setuptools.package-data]
|
|
52
|
+
"uwscli" = ["data/twinkle.bin"]
|
|
53
|
+
|
|
51
54
|
[tool.pytest.ini_options]
|
|
52
55
|
pythonpath = ["src"]
|
|
53
56
|
addopts = "-ra"
|