skywalker-1/CLAUDE.md

2.5 KiB

Genpix SKYWALKER-1 USB 2.0 DBB-s card

SkyWalker-1 is a standalone advanced USB 2.0 DVB-s card.

Supported modulations:

DVB-S (QPSK) Turbo-coded QPSK Turbo-coded 8PSK Digicipher II Combo Digicipher II Split (I/Q) Digicipher II Offset QPSK DSS (QPSK)

DVB-S2 standard is not supported (incompatible FEC)

Symbol Rate: 256Ksps - 30Msps

RF specification

• Frequency range: 950-2150 MHz • input connector: IEC F-type female • LNB/switch control: 13/18V (or 14/19V), 22 kHz, Tone Burst, DiSEqC 1.0/1.2, Legacy switch commands, max. 750 mA *

  • 750mA is maximum NON-continuous (for several minutes) allowable load. To avoid overheating, it's advisable not to exceed 450mA for permanent load.

Documentation Site

Live at https://skywalker-1.warehack.ing — Astro Starlight, 37 pages, 9 sidebar groups.

Deployment

Production runs on warehack-ing@warehack.ing via Docker + caddy-docker-proxy.

Repo: git@git.supported.systems:warehack.ing/skywalker-1.git (Gitea, private)

Server layout:

~/skywalker-1/          # git clone
  site/
    .env                # not committed — see below
    docker-compose.yml  # caddy-docker-proxy labels
    Dockerfile          # multi-stage: dev (Astro HMR) / prod (Caddy static)
    Makefile            # shortcuts: make up, make prod, make logs

.env on production server (~/skywalker-1/site/.env):

COMPOSE_PROJECT=skywalker-1-docs
APP_ENV=prod
APP_PORT=80
PUBLIC_DOMAIN=skywalker-1.warehack.ing
VITE_HMR_HOST=

Deploy / update:

ssh -A warehack-ing@warehack.ing
cd ~/skywalker-1 && git pull
cd site && make prod      # rebuilds container with APP_ENV=prod, serves static via Caddy
make logs                 # verify startup

First-time setup (already done):

ssh -A warehack-ing@warehack.ing
ssh-keyscan -t ed25519 git.supported.systems >> ~/.ssh/known_hosts
git clone git@git.supported.systems:warehack.ing/skywalker-1.git ~/skywalker-1
# create site/.env as above
cd ~/skywalker-1/site && make prod

TLS is automatic via caddy-docker-proxy (ACME DNS challenge, Vultr API). New certs take ~2 min.

Local Dev

cd site
npm install
npm run dev          # http://localhost:4321

Or with Docker (HMR via volume mounts):

cd site
# set APP_ENV=dev, APP_PORT=4321 in .env
make dev

Links