78 lines
2.0 KiB
Markdown
78 lines
2.0 KiB
Markdown
# OmniSocketGo deployment bundle — 2026-08-08
|
|
|
|
This delivery bundle contains two independent source archives.
|
|
|
|
## Archive roles
|
|
|
|
### `OmniSocketGo_robot-20260808.tar.gz`
|
|
|
|
Transfer this archive to the physical robot. It contains:
|
|
|
|
- `b_side_omnid` source code;
|
|
- head/waist camera switching;
|
|
- serial-number based `/dev/video*` discovery;
|
|
- camera occupancy reporting and known-service release logic;
|
|
- direct-LAN and robot-side startup scripts;
|
|
- robot-side `requirements.txt` and installation notes.
|
|
|
|
Build it on the robot. Do not copy x86_64 host binaries to an ARM64 robot.
|
|
|
|
### `OmniSocketGo_host-20260808.tar.gz`
|
|
|
|
Install this archive on the operator/control computer. It contains:
|
|
|
|
- `OmniSocketGo_add_camera` for the local/public KCP transport;
|
|
- `robot-command-center` Django backend;
|
|
- `robot-command-center` Vue frontend, including camera switching and waist
|
|
image rotation;
|
|
- host-side `requirements.txt` and installation notes.
|
|
|
|
This archive can also supply the source needed to build `bin/kcpserver` on a
|
|
future public relay server. The public server only needs the KCP Hub binary and
|
|
does not need `robot-command-center`.
|
|
|
|
## Verify downloads
|
|
|
|
Run from the directory containing this README:
|
|
|
|
```bash
|
|
sha256sum -c SHA256SUMS
|
|
```
|
|
|
|
## Extract
|
|
|
|
Robot:
|
|
|
|
```bash
|
|
tar -xzf OmniSocketGo_robot-20260808.tar.gz
|
|
cd OmniSocketGo_robot-20260808
|
|
```
|
|
|
|
Control host:
|
|
|
|
```bash
|
|
tar -xzf OmniSocketGo_host-20260808.tar.gz
|
|
cd OmniSocketGo_host-20260808
|
|
```
|
|
|
|
Read each archive's `README_PACKAGE.md` and `requirements.txt` before building.
|
|
|
|
## Important configuration boundary
|
|
|
|
```text
|
|
Physical robot:
|
|
OmniSocketGo_robot only
|
|
|
|
Control host:
|
|
OmniSocketGo_add_camera
|
|
robot-command-center
|
|
|
|
Future public KCP Hub:
|
|
build and run bin/kcpserver from OmniSocketGo_add_camera source
|
|
```
|
|
|
|
Git does not automatically copy local uncommitted changes to the robot. These
|
|
archives capture the current working files, including the local camera and
|
|
frontend improvements, while excluding Git metadata, logs, virtual environments,
|
|
compiled binaries, frontend `node_modules` and generated frontend `dist` files.
|