@kvell007/embed-labs-cli 0.1.0-alpha.4 → 0.1.0-alpha.40

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.
package/README.md CHANGED
@@ -41,12 +41,29 @@ public SDK until a versioned API contract is approved.
41
41
  Current experimental npm install:
42
42
 
43
43
  ```bash
44
- npm install -g @kvell007/embed-labs-cli@alpha
44
+ npm install -g embedlabs@latest
45
45
  embedlabs --help
46
46
  embedlabs help getting-started
47
+ embedlabs local toolchain list
48
+ embedlabs plugin update check
47
49
  embedlabs plugin install all
48
50
  ```
49
51
 
52
+ Clean reinstall:
53
+
54
+ ```bash
55
+ npm uninstall -g embedlabs
56
+ npm install -g embedlabs@latest
57
+ embedlabs plugin install all --force
58
+ ```
59
+
60
+ If an early test build was installed under legacy alias names, remove those
61
+ aliases once with:
62
+
63
+ ```bash
64
+ npm uninstall -g embedlabs-cli embedboard embedboard-cli
65
+ ```
66
+
50
67
  Future organization-scope install after final release approval:
51
68
 
52
69
  ```bash
@@ -81,6 +98,22 @@ embedlabs doctor
81
98
  embedlabs auth login --token <token>
82
99
  ```
83
100
 
101
+ If a cloud or plugin command reaches a protected API before a token is
102
+ configured, the CLI returns `auth_token_missing` with the registration URL and
103
+ these setup options:
104
+
105
+ ```bash
106
+ open https://api.embedboard.com/dashboard
107
+ embedlabs auth login --token <your_token>
108
+ # or for automation:
109
+ export EMBED_API_TOKEN=<your_token>
110
+ embedlabs auth status
111
+ ```
112
+
113
+ If `.embed-labs/auth.json` was copied from another computer, protected Cloud
114
+ requests fail before network I/O with `tool_integrity_check_failed` and the
115
+ message `工具完整性校验失败,请在当前电脑重新执行 embedlabs auth login --token <key>`.
116
+
84
117
  For the current public API plus local TaishanPi verification path, see
85
118
  `docs/runbooks/PUBLIC_CLI_USER_VERIFICATION.md`.
86
119
 
@@ -102,11 +135,18 @@ For local hardware access:
102
135
  embed bridge start
103
136
  embed device list
104
137
  embed tool call wifi.scan --input-json '{"host":"198.19.77.2","user":"root"}'
138
+ embed tool call rp2350.monitor.capabilities --json
139
+ embed tool call rp2350.monitor.gpio.read --input-json '{"pins":[16,17],"pull":"none"}' --approve
140
+ embed tool call rp2350.monitor.spi.transfer --input-json '{"hex":"a55a3cc3"}' --approve
141
+ embed tool call rp2350.monitor.uart.write --input-json '{"baud":115200,"text":"hello","line_ending":"lf"}' --approve
142
+ embed tool call rp2350.monitor.i2c.transfer --input-json '{"address":"0x50","write":"00","read_len":4}' --approve
143
+ embed tool call rp2350.monitor.wifi.manage --input-json '{"action":"scan"}' --approve
144
+ embed tool call rp2350.monitor.probe.debug --input-json '{"action":"status"}' --approve
105
145
  embed tool call chip.temperature --input-json '{"host":"198.19.77.2","user":"root"}'
106
146
  embed flash plan --board <rp2350|taishanpi> --artifact ./artifact.bin
107
147
  ```
108
148
 
109
- For cloud API workflows, point the CLI at a running cloud API service:
149
+ For local Cloud API development, override the production default:
110
150
 
111
151
  ```bash
112
152
  EMBED_CLOUD_API_URL=http://127.0.0.1:18100 embed cloud status
@@ -182,6 +222,14 @@ embed tool call chip.cpu.frequency --input-json '{"host":"198.19.77.2","user":"r
182
222
  embed tool call chip.temperature --input-json '{"host":"198.19.77.2","user":"root"}' [--json]
183
223
  embed tool call qml.runtime.status --input-json '{"host":"198.19.77.2","user":"root","port":18130}' [--json]
184
224
  embed tool call qml.runtime.start --input-json '{"host":"198.19.77.2","user":"root","port":18130}' [--json]
225
+ embed tool call rp2350.monitor.capabilities [--json]
226
+ embed tool call rp2350.monitor.gpio.read --input-json '{"pins":[16,17]}' --approve [--json]
227
+ embed tool call rp2350.monitor.spi.transfer --input-json '{"hex":"a55a3cc3"}' --approve [--json]
228
+ embed tool call rp2350.monitor.uart.write --input-json '{"baud":115200,"text":"hello","line_ending":"lf"}' --approve [--json]
229
+ embed tool call rp2350.monitor.i2c.transfer --input-json '{"address":"0x50","write":"00","read_len":4}' --approve [--json]
230
+ embed tool call rp2350.monitor.wifi.manage --input-json '{"action":"scan"}' --approve [--json]
231
+ embed tool call rp2350.monitor.probe.debug --input-json '{"action":"status"}' --approve [--json]
232
+ embed tool call rp2350.monitor.operation --input-json '{"action":"logic.stop","params":{}}' --approve [--json]
185
233
 
186
234
  embed serial list [--json]
187
235
  embed serial capture --path <port> [--baud 115200] [--duration 5] [--json]
@@ -248,7 +296,7 @@ preview records; they are not invoices and do not collect payment.
248
296
  - `EMBED_BRIDGE_URL`: local bridge URL used by bridge-backed commands. Default:
249
297
  `http://127.0.0.1:18083`.
250
298
  - `EMBED_CLOUD_API_URL`: cloud API URL used by cloud-backed commands. Default:
251
- `http://127.0.0.1:18100`.
299
+ `https://api.embedboard.com`.
252
300
  - `EMBED_API_TOKEN`: auth token source for non-interactive sessions.
253
301
  - `EMBED_AUTH_PROFILE`: profile name used with `EMBED_API_TOKEN`.
254
302
  - `EMBED_AUTH_FILE`: token file path for `embed auth login`. Default: