14 Commits

Author SHA1 Message Date
cfc9ca03eb Integrate uplink chain and PRN ranging into shared files and docs
Consolidate locally-defined constants into constants.py (single source
of truth for all uplink modulation and ranging parameters). Update
__init__.py with new imports across all three tiers. Add signal
architecture, block reference, and demo guide documentation for the
uplink and ranging subsystems.
2026-02-24 14:32:45 -07:00
04a17899fc Fix cache headers: immutable for hashed assets, revalidate for HTML
The blanket max-age=3600 caused stale HTML pages after redeployment.
Now _astro/* gets immutable (content-addressed filenames) and HTML
pages get no-cache (always revalidate, 304 when unchanged).
2026-02-24 11:16:58 -07:00
83493afdc7 Expand community references: Mike Stewart, Apollo Comms playlist, Ken Shirriff posts
Link Mike Stewart's GitHub (thewonderidiot), add the full Apollo
Comms YouTube playlist, and reference Ken Shirriff's PMP and FM
radio posts that directly relate to gr-apollo's block architecture.
2026-02-24 11:08:18 -07:00
b3f11052a8 Fix source links: point to git.supported.systems instead of GitHub 2026-02-24 11:02:54 -07:00
7d48398551 Add FM downlink mode: carrier blocks, convenience wrappers, and loopback demo
FM mode now has the same three-layer architecture as PM mode:
- fm_mod/fm_demod for carrier-level FM modulation
- fm_signal_source/fm_downlink_receiver convenience wrappers
- fm_loopback_demo.py verifying round-trip SCO voltage recovery

Includes GRC YAML for all 4 blocks and doc updates across
blocks reference, SCO guide, and signal architecture pages.
2026-02-24 10:18:42 -07:00
15756fa9dd Add playwright npm package for mermaid-isomorphic SSR 2026-02-23 16:25:46 -07:00
cdd91edf16 Install playwright chromium for mermaid SSR in Docker build 2026-02-23 16:23:53 -07:00
50060e48e9 Add TX chain docs: 3 new guides, 7 block entries, architecture section
New pages:
- guides/transmit-signal: composable TX block walkthrough
- guides/run-demos: loopback, voice, full downlink, AGC demos
- guides/sco-modulation: FM-mode SCO round-trip examples

Updated pages:
- reference/blocks: Transmit Chain section with all 7 TX blocks
- explanation/signal-architecture: TX diagram, Tabs, loopback note
- guides/voice-audio: TX-side modulation section
- guides/test-signals: streaming vs batch comparison
- getting-started/quick-start: loopback example + TX LinkCard
- index: updated tagline and feature card for TX+RX
- astro.config: sidebar entries, updated site description
2026-02-23 14:13:46 -07:00
0dffcdbb54 Add CuriousMarc Keysight and lab tour video links 2026-02-21 10:48:34 -07:00
200fa4e6dc Add reference links and credit CuriousMarc restoration team 2026-02-21 10:41:25 -07:00
a06f5e8dc1 Add Open Graph image generation for all docs pages
Custom renderer with NASA-blue theme, Inter font, signal arc decoration.
Generates 1200x630 PNG per page at build time via astro-opengraph-images.
Head component injects og:image meta tag using getImagePath().
2026-02-21 09:28:45 -07:00
db14b85633 Add Docker deployment for docs site at gr-apollo.l.warehack.ing
Multi-stage Dockerfile: node:22-slim build → caddy:2-alpine serve.
caddy-docker-proxy labels for automatic TLS + reverse proxy.
Profiles: prod (Caddy static) and dev (Astro HMR with volume mounts).
2026-02-21 09:10:16 -07:00
9dc52d1a5b Docs: replace default favicon, add git icon, fix Mermaid direction
- Favicon: MSFN antenna dish with signal arcs (NASA blue/red, dark mode)
- Social icon: generic git-branch replacing GitHub-specific icon
- Mermaid signal chain diagram: flowchart TB for vertical readability
- Add astro-icon (with Lucide icons) and astro-opengraph-images packages
2026-02-21 09:10:07 -07:00
12fb284d5f Add Starlight documentation site with diataxis structure
14 content pages across four diataxis categories:
- Getting Started: introduction, installation, quick-start tutorial
- Understanding Apollo USB: signal architecture, PCM frame structure, AGC integration
- How-To Guides: tuning parameters, test signals, voice audio, AGC bridge, PCM telemetry
- Reference: block reference (all 16 blocks), constants, protocol specification

Includes Mermaid diagram support via rehype-mermaid with client-side
rendering, dark theme, Pagefind search index, and edit-on-GitHub links.
2026-02-20 15:26:05 -07:00