diff --git a/src/components/HardwareCards.astro b/src/components/HardwareCards.astro new file mode 100644 index 0000000..f43bdb2 --- /dev/null +++ b/src/components/HardwareCards.astro @@ -0,0 +1,105 @@ +--- +/** + * Cross-link cards to NanoVNA hardware reference sites. + * Visual style matches NanoVNAFamily.astro from nanovna-h-docs. + */ +interface Props { + show?: 'both' | 'h' | 'f'; + heading?: string | false; +} + +const { show = 'both', heading = 'Hardware Reference' } = Astro.props; + +const showH = show === 'both' || show === 'h'; +const showF = show === 'both' || show === 'f'; +const singleCard = show === 'h' || show === 'f'; +--- + +{heading &&

{heading}

} + +
+ {showH && ( + +

NanoVNA-H

+ 600 Hz – 2 GHz +

Open-source hardware reference. Firmware internals, calibration theory, 60 shell commands.

+ nanovna-h.warehack.ing → + + )} + {showF && ( + +

NanoVNA-F V3

+ 1 MHz – 6 GHz +

Extended-range hardware reference. Measurement guides, antenna testing, TDR, data export.

+ nanovna-f.warehack.ing → + + )} +
+ + diff --git a/src/content/docs/getting-started/quickstart.mdx b/src/content/docs/getting-started/quickstart.mdx index 55cb0dd..83ad28a 100644 --- a/src/content/docs/getting-started/quickstart.mdx +++ b/src/content/docs/getting-started/quickstart.mdx @@ -4,6 +4,7 @@ description: Get mcnanovna running in 5 minutes --- import { Steps, Tabs, TabItem, Aside } from '@astrojs/starlight/components'; +import HardwareCards from '../../../components/HardwareCards.astro'; ## Prerequisites @@ -52,6 +53,8 @@ You should see device details like firmware version, serial number, and frequenc - [Explore all 91 tools](/mcnanovna/tools/) - [Multi-VNA measurements](/tutorials/multi-vna-basics/) — Use two VNAs together + + ## Troubleshooting ### VNA not detected diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 17edcab..ac0e3d9 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -18,6 +18,7 @@ hero: import { Card, CardGrid, Tabs, TabItem } from '@astrojs/starlight/components'; import { Image } from 'astro:assets'; +import HardwareCards from '../../components/HardwareCards.astro'; import smithChart from '../../assets/screenshots/smith-chart.png'; import swrTrace from '../../assets/screenshots/swr-trace.png'; import lcMatch from '../../assets/screenshots/measure-lc-match.png'; @@ -102,6 +103,8 @@ Then ask your assistant to analyze your antenna, measure a filter, or run a 3D p + + ## Example Prompts Once installed, try prompts like: diff --git a/src/content/docs/mcnanovna/overview.mdx b/src/content/docs/mcnanovna/overview.mdx index abe309a..b7c41be 100644 --- a/src/content/docs/mcnanovna/overview.mdx +++ b/src/content/docs/mcnanovna/overview.mdx @@ -4,6 +4,7 @@ description: MCP server for NanoVNA-H vector network analyzers --- import { Aside } from '@astrojs/starlight/components'; +import HardwareCards from '../../../components/HardwareCards.astro'; mcnanovna gives LLMs direct control of NanoVNA-H vector network analyzers over USB serial. It exposes 91 MCP tools for frequency sweeps, S-parameter measurements, calibration, LCD capture, RF analysis, 3D antenna radiation pattern visualization, and multi-VNA coordination. @@ -60,6 +61,8 @@ See [Multi-VNA Coordination](/mcnanovna/multi-vna/) for detailed tier comparison Other NanoVNA variants using the same USB serial protocol (VID 0x0483, PID 0x5740) should also work. + + ## Architecture ``` diff --git a/src/content/docs/reference/ham-bands.mdx b/src/content/docs/reference/ham-bands.mdx index d8521cb..759a469 100644 --- a/src/content/docs/reference/ham-bands.mdx +++ b/src/content/docs/reference/ham-bands.mdx @@ -3,6 +3,8 @@ title: Ham Bands description: Amateur radio frequency band presets --- +import HardwareCards from '../../../components/HardwareCards.astro'; + mcnanovna prompts accept ham band names as shortcuts for frequency ranges. ## Band Presets @@ -66,6 +68,8 @@ calibrate(start_hz=144000000, stop_hz=148000000) Bands outside these ranges can't be measured directly. + + ## Harmonic Measurements For bands above the VNA's range, harmonics can sometimes be used: diff --git a/src/content/docs/tutorials/antenna-analysis.mdx b/src/content/docs/tutorials/antenna-analysis.mdx index 5d96a22..bd1a220 100644 --- a/src/content/docs/tutorials/antenna-analysis.mdx +++ b/src/content/docs/tutorials/antenna-analysis.mdx @@ -4,6 +4,7 @@ description: Using mcnanovna to analyze antenna performance --- import { Tabs, TabItem, Aside } from '@astrojs/starlight/components'; +import HardwareCards from '../../../components/HardwareCards.astro'; This tutorial covers common antenna analysis tasks using mcnanovna. @@ -132,3 +133,5 @@ Say: "Show the radiation pattern for my dipole" This uses the S11 data to determine resonance and impedance, then generates an idealized 3D pattern. For measured patterns, see [3D Pattern Measurement](/tutorials/pattern-measurement/). + + diff --git a/src/content/docs/tutorials/calibration.mdx b/src/content/docs/tutorials/calibration.mdx index 4590c70..f513968 100644 --- a/src/content/docs/tutorials/calibration.mdx +++ b/src/content/docs/tutorials/calibration.mdx @@ -4,6 +4,7 @@ description: SOLT calibration for accurate measurements --- import { Steps, Aside } from '@astrojs/starlight/components'; +import HardwareCards from '../../../components/HardwareCards.astro'; Calibration removes systematic errors from VNA measurements. Without calibration, your readings will include errors from cables, adapters, and the VNA itself. @@ -136,3 +137,5 @@ The NanoVNA will use the stored calibration. Note that calibration must match th + +