@kvell007/embed-labs-cli 0.1.0-alpha.3 → 0.1.0-alpha.31

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,22 @@ 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 embedlabs-cli embedboard embedboard-cli @kvell007/embed-labs-cli
56
+ npm install -g embedlabs@latest
57
+ embedlabs plugin install all --force
58
+ ```
59
+
50
60
  Future organization-scope install after final release approval:
51
61
 
52
62
  ```bash
@@ -81,6 +91,22 @@ embedlabs doctor
81
91
  embedlabs auth login --token <token>
82
92
  ```
83
93
 
94
+ If a cloud or plugin command reaches a protected API before a token is
95
+ configured, the CLI returns `auth_token_missing` with the registration URL and
96
+ these setup options:
97
+
98
+ ```bash
99
+ open https://api.embedboard.com/dashboard
100
+ embedlabs auth login --token <your_token>
101
+ # or for automation:
102
+ export EMBED_API_TOKEN=<your_token>
103
+ embedlabs auth status
104
+ ```
105
+
106
+ If `.embed-labs/auth.json` was copied from another computer, protected Cloud
107
+ requests fail before network I/O with `tool_integrity_check_failed` and the
108
+ message `工具完整性校验失败,请在当前电脑重新执行 embedlabs auth login --token <key>`.
109
+
84
110
  For the current public API plus local TaishanPi verification path, see
85
111
  `docs/runbooks/PUBLIC_CLI_USER_VERIFICATION.md`.
86
112
 
@@ -102,11 +128,18 @@ For local hardware access:
102
128
  embed bridge start
103
129
  embed device list
104
130
  embed tool call wifi.scan --input-json '{"host":"198.19.77.2","user":"root"}'
131
+ embed tool call rp2350.monitor.capabilities --json
132
+ embed tool call rp2350.monitor.gpio.read --input-json '{"pins":[16,17],"pull":"none"}' --approve
133
+ embed tool call rp2350.monitor.spi.transfer --input-json '{"hex":"a55a3cc3"}' --approve
134
+ embed tool call rp2350.monitor.uart.write --input-json '{"baud":115200,"text":"hello","line_ending":"lf"}' --approve
135
+ embed tool call rp2350.monitor.i2c.transfer --input-json '{"address":"0x50","write":"00","read_len":4}' --approve
136
+ embed tool call rp2350.monitor.wifi.manage --input-json '{"action":"scan"}' --approve
137
+ embed tool call rp2350.monitor.probe.debug --input-json '{"action":"status"}' --approve
105
138
  embed tool call chip.temperature --input-json '{"host":"198.19.77.2","user":"root"}'
106
139
  embed flash plan --board <rp2350|taishanpi> --artifact ./artifact.bin
107
140
  ```
108
141
 
109
- For cloud API workflows, point the CLI at a running cloud API service:
142
+ For local Cloud API development, override the production default:
110
143
 
111
144
  ```bash
112
145
  EMBED_CLOUD_API_URL=http://127.0.0.1:18100 embed cloud status
@@ -182,6 +215,14 @@ embed tool call chip.cpu.frequency --input-json '{"host":"198.19.77.2","user":"r
182
215
  embed tool call chip.temperature --input-json '{"host":"198.19.77.2","user":"root"}' [--json]
183
216
  embed tool call qml.runtime.status --input-json '{"host":"198.19.77.2","user":"root","port":18130}' [--json]
184
217
  embed tool call qml.runtime.start --input-json '{"host":"198.19.77.2","user":"root","port":18130}' [--json]
218
+ embed tool call rp2350.monitor.capabilities [--json]
219
+ embed tool call rp2350.monitor.gpio.read --input-json '{"pins":[16,17]}' --approve [--json]
220
+ embed tool call rp2350.monitor.spi.transfer --input-json '{"hex":"a55a3cc3"}' --approve [--json]
221
+ embed tool call rp2350.monitor.uart.write --input-json '{"baud":115200,"text":"hello","line_ending":"lf"}' --approve [--json]
222
+ embed tool call rp2350.monitor.i2c.transfer --input-json '{"address":"0x50","write":"00","read_len":4}' --approve [--json]
223
+ embed tool call rp2350.monitor.wifi.manage --input-json '{"action":"scan"}' --approve [--json]
224
+ embed tool call rp2350.monitor.probe.debug --input-json '{"action":"status"}' --approve [--json]
225
+ embed tool call rp2350.monitor.operation --input-json '{"action":"logic.stop","params":{}}' --approve [--json]
185
226
 
186
227
  embed serial list [--json]
187
228
  embed serial capture --path <port> [--baud 115200] [--duration 5] [--json]
@@ -248,7 +289,7 @@ preview records; they are not invoices and do not collect payment.
248
289
  - `EMBED_BRIDGE_URL`: local bridge URL used by bridge-backed commands. Default:
249
290
  `http://127.0.0.1:18083`.
250
291
  - `EMBED_CLOUD_API_URL`: cloud API URL used by cloud-backed commands. Default:
251
- `http://127.0.0.1:18100`.
292
+ `https://api.embedboard.com`.
252
293
  - `EMBED_API_TOKEN`: auth token source for non-interactive sessions.
253
294
  - `EMBED_AUTH_PROFILE`: profile name used with `EMBED_API_TOKEN`.
254
295
  - `EMBED_AUTH_FILE`: token file path for `embed auth login`. Default: