| commit | 6f2e63170e1901c4b4eb53252a516efaf4742fd3 | [log] [tgz] |
|---|---|---|
| author | George-Daniel Matei <danielgeorgem@google.com> | Mon Nov 03 14:41:51 2025 |
| committer | Chromeos LUCI <chromeos-scoped@luci-project-accounts.iam.gserviceaccount.com> | Mon Nov 03 17:26:48 2025 |
| tree | cf87ac16e06a31d66148967de8e9ec74715eb359 | |
| parent | 30d2ba15ffabe0fa5155a8fbb8a5f7cb96266bff [diff] |
Unigraf: make reset a noop Make the reset function for the UTC274 a noop as it is linked to some instabilities. FW fix needed. To be reverted once that's done. BUG=b:456712361 TEST=Manual Change-Id: Ife8883ba098cca91070777ba142e3a911bd6cf57 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/passport/+/7112740 Commit-Queue: George-Daniel Matei <danielgeorgem@google.com> Tested-by: George-Daniel Matei <danielgeorgem@google.com> Auto-Submit: George-Daniel Matei <danielgeorgem@google.com> Reviewed-by: Svitlana Soltysyak <ssoltysyak@google.com> Reviewed-by: Alexandr Astrouski <astrouski@google.com> Commit-Queue: Svitlana Soltysyak <ssoltysyak@google.com>
A service for controlling components in ChromeOS peripheral testbeds.
See go/cros-pass-port
The executable can be built on your local machine by running ./scripts/build.sh
The service can be started in server mode by running:
./go/bin/passport
The service can be built on your local machine by running ./scripts/build_docker.sh
If you want to use TOT rather than your local checkout you should add the REMOTE_SOURCE variable to your build command e.g.
REMOTE_SOURCE=1 ./scripts/build_docker.sh
The container can be started on your local machine by running
docker run -p 8200:8300 passport:amd64
The service can be started on a remote machine by running ./scripts/docker_on_remote.sh <HOSTNAME>
For a remote satlab device this would look like
./scripts/docker_on_remote.sh moblab@XXX.XXX.XXX.XXX
The script will automatically start the service at port 8300 on the remote machine.
To connect to it locally, you will likely need to forward this port to your local machine.
The docker_on_remote.sh will print out an ssh tunnel command that can be used to connect to the service, the output will look like:
$ ./scripts/docker_on_remote.sh moblab@XXX.XXX.XXX.XXX ... ... ================================================================== Successfully updated passport on host moblab@YYY.YYY.YYY.YYY SSH COMMAND: ssh -L 8300:1XXX.XXX.XXX.XXX:8300 moblab@YYY.YYY.YYY.YYY ==================================================================
Once a service is running, it can be verified in a separate terminal by running:
./go/bin/passport switches detect
This will probe for all components connected to the machine and log them to STDOUT. This can also be used to check an already running service on a remote machine by forwarding the remote port to your local machine. The default port is 8300 but a different one can be provided via the -port flag e.g.
./go/bin/passport switches detect -port 9999
Additionally, you can test enabling/disabling specific switches from the command line using:
./go/bin/passport switches enable [-switches SWITCH1,SWITCH2] ./go/bin/passport switches disable [-switches SWITCH1,SWITCH2]
If you omit the -switches argument then all found switches will be used.
As of 2025-8-31 passport updates must be deployed manually. Before we discuss how to push a passport update lets talk first about the different versions of passport.
Passport has several versions that are used:
us-docker.pkg.dev/cros-passport/passport/passport:latestus-docker.pkg.dev/cros-registry/test-services/cros-passport with the tag staging_cros-passport for staging configs and prod_cros-passport for prod configs.The lab run versions are built from the us-docker.pkg.dev/cros-passport/passport/passport:latest development version.
To update development version simply run:
PUSH=1 REMOTE_SOURCE=1 ./scripts/build_docker.sh
Once that has been updated the staging version for the lab should get built and updated within about an hour. You can see the tagged versions here.
The prod version is updated manually ~2 times a week (along with other tools) but you can ask the TSE team to do a push if you need it sooner.