@zenovate/opman 0.1.9 → 0.1.10

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.
Files changed (2) hide show
  1. package/README.md +14 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -67,8 +67,8 @@ opman deploy examples/hello.py --remote-dir /py -p COM3 -b 9600
67
67
  # Upload tuning
68
68
  opman deploy examples/hello.py.o -p COM3 --packet-size 200 --skip-command-mode
69
69
 
70
- # BLE by address or name (partial match)
71
- opman deploy examples/hello.py --ble ZENO --monitor
70
+ # BLE by address or name (partial match); on macOS use --packet-size 50
71
+ opman deploy examples/hello.py --ble ZENO --packet-size 50 --monitor
72
72
 
73
73
  # Monitor with hex + timestamp (press ESC to stop)
74
74
  opman deploy examples/hello.py -p COM3 --monitor --hex --timestamp
@@ -96,6 +96,12 @@ opman upload hello.py.o /py -p COM3 --remote-name custom.py.o
96
96
  opman upload hello.py.o /py -p COM3 --packet-size 200 --skip-command-mode
97
97
  ```
98
98
 
99
+ **macOS + BLE:** Default `--packet-size` is 100 bytes. On macOS over BLE, uploads may fail with `FileWrite timed out repeatedly`. Use a smaller chunk size, e.g. `--packet-size 50` (or `30` if still unstable). Serial uploads usually do not need this.
100
+
101
+ ```bash
102
+ opman upload hello.py.o /py --ble AA:BB:CC:DD:EE:FF --packet-size 50
103
+ ```
104
+
99
105
  ## monitor
100
106
 
101
107
  ```bash
@@ -161,13 +167,16 @@ opman shell -p COM5 -c "9600,N,8,1"
161
167
  opman ble-scan
162
168
  opman ble-scan --name OP
163
169
  opman ble-scan --all-devices
164
- opman deploy examples/hello.py --ble AA:BB:CC:DD:EE:FF
165
- opman deploy examples/hello.py.o --ble ZENO
166
- opman deploy examples/hello.py --ble ZENO --monitor --hex
170
+ opman deploy examples/hello.py --ble AA:BB:CC:DD:EE:FF --packet-size 50
171
+ opman deploy examples/hello.py.o --ble ZENO --packet-size 50
172
+ opman deploy examples/hello.py --ble ZENO --monitor --hex --packet-size 50
173
+ opman upload examples/hello.py.o /py --ble ZENO --packet-size 50
167
174
  opman python --ble ZENO
168
175
  opman monitor --ble ZENO --hex --timestamp
169
176
  ```
170
177
 
178
+ On **macOS**, prefer `--packet-size 50` (or `30`) for BLE upload/deploy; see [upload](#upload).
179
+
171
180
  Full parameter reference (Chinese): [docs/操作说明.md](docs/操作说明.md)
172
181
 
173
182
  ## Shell completion
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zenovate/opman",
3
- "version": "0.1.9",
3
+ "version": "0.1.10",
4
4
  "description": "CLI for OP devices: compile Python to PikaPython bytecode, serial/BLE upload, OP>1 shell and OP>2 REPL",
5
5
  "repository": {
6
6
  "type": "git",