diff --git a/.gitignore b/.gitignore index 3363db1..589e27d 100644 --- a/.gitignore +++ b/.gitignore @@ -7,3 +7,8 @@ firmware/fx2lib/ # Build artifacts firmware/build/ tools/__pycache__/ + +# Documentation site +site/node_modules/ +site/dist/ +site/.astro/ diff --git a/site/astro.config.mjs b/site/astro.config.mjs new file mode 100644 index 0000000..704dc9e --- /dev/null +++ b/site/astro.config.mjs @@ -0,0 +1,110 @@ +import { defineConfig } from 'astro/config'; +import starlight from '@astrojs/starlight'; +import starlightImageZoom from 'starlight-image-zoom'; +import starlightLinksValidator from 'starlight-links-validator'; + +export default defineConfig({ + telemetry: false, + devToolbar: { + enabled: false, + }, + integrations: [ + starlight({ + title: 'SkyWalker-1 Docs', + description: + 'Reverse-engineered documentation for the Genpix SkyWalker-1 DVB-S USB 2.0 satellite receiver', + plugins: [starlightImageZoom(), starlightLinksValidator()], + social: [ + { + icon: 'github', + label: 'GitHub', + href: 'https://github.com/placeholder/skywalker-1', + }, + ], + customCss: ['./src/styles/custom.css'], + sidebar: [ + { + label: 'Hardware', + items: [ + { label: 'Overview', slug: 'hardware/overview' }, + { label: 'GPIO Pin Map', slug: 'hardware/gpio-pinmap' }, + { label: 'RF Specifications', slug: 'hardware/rf-specifications' }, + ], + }, + { + label: 'USB Interface', + items: [ + { label: 'Interface', slug: 'usb/interface' }, + { label: 'Vendor Commands', slug: 'usb/vendor-commands' }, + { label: 'Boot Sequence', slug: 'usb/boot-sequence' }, + { label: 'Config Status', slug: 'usb/config-status' }, + ], + }, + { + label: 'BCM4500', + items: [ + { label: 'Demodulator', slug: 'bcm4500/demodulator' }, + { label: 'Tuning Protocol', slug: 'bcm4500/tuning-protocol' }, + { label: 'GPIF Streaming', slug: 'bcm4500/gpif-streaming' }, + { label: 'Signal Monitoring', slug: 'bcm4500/signal-monitoring' }, + ], + }, + { + label: 'LNB & DiSEqC', + items: [ + { label: 'LNB Control', slug: 'lnb-diseqc/lnb-control' }, + { label: 'DiSEqC Protocol', slug: 'lnb-diseqc/diseqc-protocol' }, + { label: 'Legacy Switch', slug: 'lnb-diseqc/legacy-switch' }, + ], + }, + { + label: 'I\u00B2C Bus', + items: [ + { label: 'Bus Architecture', slug: 'i2c/bus-architecture' }, + { + label: 'STOP Corruption Bug', + slug: 'i2c/stop-corruption-bug', + }, + ], + }, + { + label: 'Firmware', + items: [ + { + label: 'Version Comparison', + slug: 'firmware/version-comparison', + }, + { label: 'Rev.2 Analysis', slug: 'firmware/rev2-analysis' }, + { label: 'Kernel FW01', slug: 'firmware/kernel-fw01' }, + { label: 'FW2.13 Variants', slug: 'firmware/fw213-variants' }, + { label: 'Custom v3.01', slug: 'firmware/custom-v301' }, + { label: 'Storage Formats', slug: 'firmware/storage-formats' }, + ], + }, + { + label: 'Driver', + items: [ + { label: 'Linux Kernel', slug: 'driver/linux-kernel' }, + { label: 'DVB-S2', slug: 'driver/dvb-s2' }, + ], + }, + { + label: 'Tools', + items: [ + { label: 'Firmware Loader', slug: 'tools/firmware-loader' }, + { label: 'Tuning', slug: 'tools/tuning' }, + { label: 'EEPROM Utilities', slug: 'tools/eeprom-utilities' }, + { label: 'Debugging', slug: 'tools/debugging' }, + { label: 'TS Analyzer', slug: 'tools/ts-analyzer' }, + ], + }, + { + label: 'Reference', + items: [ + { label: 'Master Reference', slug: 'reference/master-reference' }, + ], + }, + ], + }), + ], +}); diff --git a/site/package-lock.json b/site/package-lock.json new file mode 100644 index 0000000..da8d9fa --- /dev/null +++ b/site/package-lock.json @@ -0,0 +1,7465 @@ +{ + "name": "skywalker-1-docs", + "version": "0.0.1", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "skywalker-1-docs", + "version": "0.0.1", + "dependencies": { + "@astrojs/starlight": "^0.37.6", + "astro": "^5.17.2", + "sharp": "^0.33.0", + "starlight-image-zoom": "^0.13.2", + "starlight-links-validator": "^0.19.2" + } + }, + "node_modules/@astrojs/compiler": { + "version": "2.13.1", + "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-2.13.1.tgz", + "integrity": "sha512-f3FN83d2G/v32ipNClRKgYv30onQlMZX1vCeZMjPsMMPl1mDpmbl0+N5BYo4S/ofzqJyS5hvwacEo0CCVDn/Qg==", + "license": "MIT" + }, + "node_modules/@astrojs/internal-helpers": { + "version": "0.7.5", + "resolved": "https://registry.npmjs.org/@astrojs/internal-helpers/-/internal-helpers-0.7.5.tgz", + "integrity": "sha512-vreGnYSSKhAjFJCWAwe/CNhONvoc5lokxtRoZims+0wa3KbHBdPHSSthJsKxPd8d/aic6lWKpRTYGY/hsgK6EA==", + "license": "MIT" + }, + "node_modules/@astrojs/markdown-remark": { + "version": "6.3.10", + "resolved": "https://registry.npmjs.org/@astrojs/markdown-remark/-/markdown-remark-6.3.10.tgz", + "integrity": "sha512-kk4HeYR6AcnzC4QV8iSlOfh+N8TZ3MEStxPyenyCtemqn8IpEATBFMTJcfrNW32dgpt6MY3oCkMM/Tv3/I4G3A==", + "license": "MIT", + "dependencies": { + "@astrojs/internal-helpers": "0.7.5", + "@astrojs/prism": "3.3.0", + "github-slugger": "^2.0.0", + "hast-util-from-html": "^2.0.3", + "hast-util-to-text": "^4.0.2", + "import-meta-resolve": "^4.2.0", + "js-yaml": "^4.1.1", + "mdast-util-definitions": "^6.0.0", + "rehype-raw": "^7.0.0", + "rehype-stringify": "^10.0.1", + "remark-gfm": "^4.0.1", + "remark-parse": "^11.0.0", + "remark-rehype": "^11.1.2", + "remark-smartypants": "^3.0.2", + "shiki": "^3.19.0", + "smol-toml": "^1.5.2", + "unified": "^11.0.5", + "unist-util-remove-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "unist-util-visit-parents": "^6.0.2", + "vfile": "^6.0.3" + } + }, + "node_modules/@astrojs/mdx": { + "version": "4.3.13", + "resolved": "https://registry.npmjs.org/@astrojs/mdx/-/mdx-4.3.13.tgz", + "integrity": "sha512-IHDHVKz0JfKBy3//52JSiyWv089b7GVSChIXLrlUOoTLWowG3wr2/8hkaEgEyd/vysvNQvGk+QhysXpJW5ve6Q==", + "license": "MIT", + "dependencies": { + "@astrojs/markdown-remark": "6.3.10", + "@mdx-js/mdx": "^3.1.1", + "acorn": "^8.15.0", + "es-module-lexer": "^1.7.0", + "estree-util-visit": "^2.0.0", + "hast-util-to-html": "^9.0.5", + "piccolore": "^0.1.3", + "rehype-raw": "^7.0.0", + "remark-gfm": "^4.0.1", + "remark-smartypants": "^3.0.2", + "source-map": "^0.7.6", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.3" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0" + }, + "peerDependencies": { + "astro": "^5.0.0" + } + }, + "node_modules/@astrojs/prism": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/@astrojs/prism/-/prism-3.3.0.tgz", + "integrity": "sha512-q8VwfU/fDZNoDOf+r7jUnMC2//H2l0TuQ6FkGJL8vD8nw/q5KiL3DS1KKBI3QhI9UQhpJ5dc7AtqfbXWuOgLCQ==", + "license": "MIT", + "dependencies": { + "prismjs": "^1.30.0" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0" + } + }, + "node_modules/@astrojs/sitemap": { + "version": "3.7.0", + "resolved": "https://registry.npmjs.org/@astrojs/sitemap/-/sitemap-3.7.0.tgz", + "integrity": "sha512-+qxjUrz6Jcgh+D5VE1gKUJTA3pSthuPHe6Ao5JCxok794Lewx8hBFaWHtOnN0ntb2lfOf7gvOi9TefUswQ/ZVA==", + "license": "MIT", + "dependencies": { + "sitemap": "^8.0.2", + "stream-replace-string": "^2.0.0", + "zod": "^3.25.76" + } + }, + "node_modules/@astrojs/starlight": { + "version": "0.37.6", + "resolved": "https://registry.npmjs.org/@astrojs/starlight/-/starlight-0.37.6.tgz", + "integrity": "sha512-wQrKwH431q+8FsLBnNQeG+R36TMtEGxTQ2AuiVpcx9APcazvL3n7wVW8mMmYyxX0POjTnxlcWPkdMGR3Yj1L+w==", + "license": "MIT", + "dependencies": { + "@astrojs/markdown-remark": "^6.3.1", + "@astrojs/mdx": "^4.2.3", + "@astrojs/sitemap": "^3.3.0", + "@pagefind/default-ui": "^1.3.0", + "@types/hast": "^3.0.4", + "@types/js-yaml": "^4.0.9", + "@types/mdast": "^4.0.4", + "astro-expressive-code": "^0.41.1", + "bcp-47": "^2.1.0", + "hast-util-from-html": "^2.0.1", + "hast-util-select": "^6.0.2", + "hast-util-to-string": "^3.0.0", + "hastscript": "^9.0.0", + "i18next": "^23.11.5", + "js-yaml": "^4.1.0", + "klona": "^2.0.6", + "magic-string": "^0.30.17", + "mdast-util-directive": "^3.0.0", + "mdast-util-to-markdown": "^2.1.0", + "mdast-util-to-string": "^4.0.0", + "pagefind": "^1.3.0", + "rehype": "^13.0.1", + "rehype-format": "^5.0.0", + "remark-directive": "^3.0.0", + "ultrahtml": "^1.6.0", + "unified": "^11.0.5", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.2" + }, + "peerDependencies": { + "astro": "^5.5.0" + } + }, + "node_modules/@astrojs/telemetry": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/@astrojs/telemetry/-/telemetry-3.3.0.tgz", + "integrity": "sha512-UFBgfeldP06qu6khs/yY+q1cDAaArM2/7AEIqQ9Cuvf7B1hNLq0xDrZkct+QoIGyjq56y8IaE2I3CTvG99mlhQ==", + "license": "MIT", + "dependencies": { + "ci-info": "^4.2.0", + "debug": "^4.4.0", + "dlv": "^1.1.3", + "dset": "^3.1.4", + "is-docker": "^3.0.0", + "is-wsl": "^3.1.0", + "which-pm-runs": "^1.1.0" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz", + "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.0" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/runtime": { + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.6.tgz", + "integrity": "sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz", + "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@capsizecss/unpack": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@capsizecss/unpack/-/unpack-4.0.0.tgz", + "integrity": "sha512-VERIM64vtTP1C4mxQ5thVT9fK0apjPFobqybMtA1UdUujWka24ERHbRHFGmpbbhp73MhV+KSsHQH9C6uOTdEQA==", + "license": "MIT", + "dependencies": { + "fontkitten": "^1.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@ctrl/tinycolor": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/@ctrl/tinycolor/-/tinycolor-4.2.0.tgz", + "integrity": "sha512-kzyuwOAQnXJNLS9PSyrk0CWk35nWJW/zl/6KvnTBMFK65gm7U1/Z5BqjxeapjZCIhQcM/DsrEmcbRwDyXyXK4A==", + "license": "MIT", + "engines": { + "node": ">=14" + } + }, + "node_modules/@emnapi/runtime": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.8.1.tgz", + "integrity": "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.3.tgz", + "integrity": "sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.3.tgz", + "integrity": "sha512-i5D1hPY7GIQmXlXhs2w8AWHhenb00+GxjxRncS2ZM7YNVGNfaMxgzSGuO8o8SJzRc/oZwU2bcScvVERk03QhzA==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.3.tgz", + "integrity": "sha512-YdghPYUmj/FX2SYKJ0OZxf+iaKgMsKHVPF1MAq/P8WirnSpCStzKJFjOjzsW0QQ7oIAiccHdcqjbHmJxRb/dmg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.3.tgz", + "integrity": "sha512-IN/0BNTkHtk8lkOM8JWAYFg4ORxBkZQf9zXiEOfERX/CzxW3Vg1ewAhU7QSWQpVIzTW+b8Xy+lGzdYXV6UZObQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.3.tgz", + "integrity": "sha512-Re491k7ByTVRy0t3EKWajdLIr0gz2kKKfzafkth4Q8A5n1xTHrkqZgLLjFEHVD+AXdUGgQMq+Godfq45mGpCKg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.3.tgz", + "integrity": "sha512-vHk/hA7/1AckjGzRqi6wbo+jaShzRowYip6rt6q7VYEDX4LEy1pZfDpdxCBnGtl+A5zq8iXDcyuxwtv3hNtHFg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.3.tgz", + "integrity": "sha512-ipTYM2fjt3kQAYOvo6vcxJx3nBYAzPjgTCk7QEgZG8AUO3ydUhvelmhrbOheMnGOlaSFUoHXB6un+A7q4ygY9w==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.3.tgz", + "integrity": "sha512-dDk0X87T7mI6U3K9VjWtHOXqwAMJBNN2r7bejDsc+j03SEjtD9HrOl8gVFByeM0aJksoUuUVU9TBaZa2rgj0oA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.3.tgz", + "integrity": "sha512-s6nPv2QkSupJwLYyfS+gwdirm0ukyTFNl3KTgZEAiJDd+iHZcbTPPcWCcRYH+WlNbwChgH2QkE9NSlNrMT8Gfw==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.3.tgz", + "integrity": "sha512-sZOuFz/xWnZ4KH3YfFrKCf1WyPZHakVzTiqji3WDc0BCl2kBwiJLCXpzLzUBLgmp4veFZdvN5ChW4Eq/8Fc2Fg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.3.tgz", + "integrity": "sha512-yGlQYjdxtLdh0a3jHjuwOrxQjOZYD/C9PfdbgJJF3TIZWnm/tMd/RcNiLngiu4iwcBAOezdnSLAwQDPqTmtTYg==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.3.tgz", + "integrity": "sha512-WO60Sn8ly3gtzhyjATDgieJNet/KqsDlX5nRC5Y3oTFcS1l0KWba+SEa9Ja1GfDqSF1z6hif/SkpQJbL63cgOA==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.3.tgz", + "integrity": "sha512-APsymYA6sGcZ4pD6k+UxbDjOFSvPWyZhjaiPyl/f79xKxwTnrn5QUnXR5prvetuaSMsb4jgeHewIDCIWljrSxw==", + "cpu": [ + "mips64el" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.3.tgz", + "integrity": "sha512-eizBnTeBefojtDb9nSh4vvVQ3V9Qf9Df01PfawPcRzJH4gFSgrObw+LveUyDoKU3kxi5+9RJTCWlj4FjYXVPEA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.3.tgz", + "integrity": "sha512-3Emwh0r5wmfm3ssTWRQSyVhbOHvqegUDRd0WhmXKX2mkHJe1SFCMJhagUleMq+Uci34wLSipf8Lagt4LlpRFWQ==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.3.tgz", + "integrity": "sha512-pBHUx9LzXWBc7MFIEEL0yD/ZVtNgLytvx60gES28GcWMqil8ElCYR4kvbV2BDqsHOvVDRrOxGySBM9Fcv744hw==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.3.tgz", + "integrity": "sha512-Czi8yzXUWIQYAtL/2y6vogER8pvcsOsk5cpwL4Gk5nJqH5UZiVByIY8Eorm5R13gq+DQKYg0+JyQoytLQas4dA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.3.tgz", + "integrity": "sha512-sDpk0RgmTCR/5HguIZa9n9u+HVKf40fbEUt+iTzSnCaGvY9kFP0YKBWZtJaraonFnqef5SlJ8/TiPAxzyS+UoA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.3.tgz", + "integrity": "sha512-P14lFKJl/DdaE00LItAukUdZO5iqNH7+PjoBm+fLQjtxfcfFE20Xf5CrLsmZdq5LFFZzb5JMZ9grUwvtVYzjiA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.3.tgz", + "integrity": "sha512-AIcMP77AvirGbRl/UZFTq5hjXK+2wC7qFRGoHSDrZ5v5b8DK/GYpXW3CPRL53NkvDqb9D+alBiC/dV0Fb7eJcw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.3.tgz", + "integrity": "sha512-DnW2sRrBzA+YnE70LKqnM3P+z8vehfJWHXECbwBmH/CU51z6FiqTQTHFenPlHmo3a8UgpLyH3PT+87OViOh1AQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.3.tgz", + "integrity": "sha512-NinAEgr/etERPTsZJ7aEZQvvg/A6IsZG/LgZy+81wON2huV7SrK3e63dU0XhyZP4RKGyTm7aOgmQk0bGp0fy2g==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.3.tgz", + "integrity": "sha512-PanZ+nEz+eWoBJ8/f8HKxTTD172SKwdXebZ0ndd953gt1HRBbhMsaNqjTyYLGLPdoWHy4zLU7bDVJztF5f3BHA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.3.tgz", + "integrity": "sha512-B2t59lWWYrbRDw/tjiWOuzSsFh1Y/E95ofKz7rIVYSQkUYBjfSgf6oeYPNWHToFRr2zx52JKApIcAS/D5TUBnA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.3.tgz", + "integrity": "sha512-QLKSFeXNS8+tHW7tZpMtjlNb7HKau0QDpwm49u0vUp9y1WOF+PEzkU84y9GqYaAVW8aH8f3GcBck26jh54cX4Q==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.3.tgz", + "integrity": "sha512-4uJGhsxuptu3OcpVAzli+/gWusVGwZZHTlS63hh++ehExkVT8SgiEf7/uC/PclrPPkLhZqGgCTjd0VWLo6xMqA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@expressive-code/core": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/@expressive-code/core/-/core-0.41.6.tgz", + "integrity": "sha512-FvJQP+hG0jWi/FLBSmvHInDqWR7jNANp9PUDjdMqSshHb0y7sxx3vHuoOr6SgXjWw+MGLqorZyPQ0aAlHEok6g==", + "license": "MIT", + "dependencies": { + "@ctrl/tinycolor": "^4.0.4", + "hast-util-select": "^6.0.2", + "hast-util-to-html": "^9.0.1", + "hast-util-to-text": "^4.0.1", + "hastscript": "^9.0.0", + "postcss": "^8.4.38", + "postcss-nested": "^6.0.1", + "unist-util-visit": "^5.0.0", + "unist-util-visit-parents": "^6.0.1" + } + }, + "node_modules/@expressive-code/plugin-frames": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/@expressive-code/plugin-frames/-/plugin-frames-0.41.6.tgz", + "integrity": "sha512-d+hkSYXIQot6fmYnOmWAM+7TNWRv/dhfjMsNq+mIZz8Tb4mPHOcgcfZeEM5dV9TDL0ioQNvtcqQNuzA1sRPjxg==", + "license": "MIT", + "dependencies": { + "@expressive-code/core": "^0.41.6" + } + }, + "node_modules/@expressive-code/plugin-shiki": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/@expressive-code/plugin-shiki/-/plugin-shiki-0.41.6.tgz", + "integrity": "sha512-Y6zmKBmsIUtWTzdefqlzm/h9Zz0Rc4gNdt2GTIH7fhHH2I9+lDYCa27BDwuBhjqcos6uK81Aca9dLUC4wzN+ng==", + "license": "MIT", + "dependencies": { + "@expressive-code/core": "^0.41.6", + "shiki": "^3.2.2" + } + }, + "node_modules/@expressive-code/plugin-text-markers": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/@expressive-code/plugin-text-markers/-/plugin-text-markers-0.41.6.tgz", + "integrity": "sha512-PBFa1wGyYzRExMDzBmAWC6/kdfG1oLn4pLpBeTfIRrALPjcGA/59HP3e7q9J0Smk4pC7U+lWkA2LHR8FYV8U7Q==", + "license": "MIT", + "dependencies": { + "@expressive-code/core": "^0.41.6" + } + }, + "node_modules/@img/colour": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.0.0.tgz", + "integrity": "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=18" + } + }, + "node_modules/@img/sharp-darwin-arm64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.33.5.tgz", + "integrity": "sha512-UT4p+iz/2H4twwAoLCqfA9UH5pI6DggwKEGuaPy7nCVQ8ZsiY5PIcrRvD1DzuY3qYL07NtIQcWnBSY/heikIFQ==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.0.4" + } + }, + "node_modules/@img/sharp-darwin-x64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.33.5.tgz", + "integrity": "sha512-fyHac4jIc1ANYGRDxtiqelIbdWkIuQaI84Mv45KvGRRxSAa7o7d1ZKAOBaYbnepLC1WqxfpimdeWfvqqSGwR2Q==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.0.4" + } + }, + "node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.0.4.tgz", + "integrity": "sha512-XblONe153h0O2zuFfTAbQYAX2JhYmDHeWikp1LM9Hul9gVPjFY427k6dFEcOL72O01QxQsWi761svJ/ev9xEDg==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-darwin-x64": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.0.4.tgz", + "integrity": "sha512-xnGR8YuZYfJGmWPvmlunFaWJsb9T/AO2ykoP3Fz/0X5XV2aoYBPkX6xqCQvUTKKiLddarLaxpzNe+b1hjeWHAQ==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.0.5.tgz", + "integrity": "sha512-gvcC4ACAOPRNATg/ov8/MnbxFDJqf/pDePbBnuBDcjsI8PssmjoKMAz4LtLaVi+OnSb5FK/yIOamqDwGmXW32g==", + "cpu": [ + "arm" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm64": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.0.4.tgz", + "integrity": "sha512-9B+taZ8DlyyqzZQnoeIvDVR/2F4EbMepXMc/NdVbkzsJbzkUjhXv/70GQJ7tdLA4YJgNP25zukcxpX2/SueNrA==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-ppc64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.4.tgz", + "integrity": "sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==", + "cpu": [ + "ppc64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-riscv64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.2.4.tgz", + "integrity": "sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==", + "cpu": [ + "riscv64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-s390x": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.0.4.tgz", + "integrity": "sha512-u7Wz6ntiSSgGSGcjZ55im6uvTrOxSIS8/dgoVMoiGE9I6JAfU50yH5BoDlYA1tcuGS7g/QNtetJnxA6QEsCVTA==", + "cpu": [ + "s390x" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-x64": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.0.4.tgz", + "integrity": "sha512-MmWmQ3iPFZr0Iev+BAgVMb3ZyC4KeFc3jFxnNbEPas60e1cIfevbtuyf9nDGIzOaW9PdnDciJm+wFFaTlj5xYw==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-arm64": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.0.4.tgz", + "integrity": "sha512-9Ti+BbTYDcsbp4wfYib8Ctm1ilkugkA/uscUn6UXK1ldpC1JjiXbLfFZtRlBhjPZ5o1NCLiDbg8fhUPKStHoTA==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-x64": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.0.4.tgz", + "integrity": "sha512-viYN1KX9m+/hGkJtvYYp+CCLgnJXwiQB39damAO7WMdKWlIhmYTfHjwSbQeUK/20vY154mwezd9HflVFM1wVSw==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-linux-arm": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.33.5.tgz", + "integrity": "sha512-JTS1eldqZbJxjvKaAkxhZmBqPRGmxgu+qFKSInv8moZ2AmT5Yib3EQ1c6gp493HvrvV8QgdOXdyaIBrhvFhBMQ==", + "cpu": [ + "arm" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.0.5" + } + }, + "node_modules/@img/sharp-linux-arm64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.33.5.tgz", + "integrity": "sha512-JMVv+AMRyGOHtO1RFBiJy/MBsgz0x4AWrT6QoEVVTyh1E39TrCUpTRI7mx9VksGX4awWASxqCYLCV4wBZHAYxA==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.0.4" + } + }, + "node_modules/@img/sharp-linux-ppc64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.5.tgz", + "integrity": "sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==", + "cpu": [ + "ppc64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-ppc64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-riscv64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.34.5.tgz", + "integrity": "sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==", + "cpu": [ + "riscv64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-riscv64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-s390x": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.33.5.tgz", + "integrity": "sha512-y/5PCd+mP4CA/sPDKl2961b+C9d+vPAveS33s6Z3zfASk2j5upL6fXVPZi7ztePZ5CuH+1kW8JtvxgbuXHRa4Q==", + "cpu": [ + "s390x" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.0.4" + } + }, + "node_modules/@img/sharp-linux-x64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.33.5.tgz", + "integrity": "sha512-opC+Ok5pRNAzuvq1AG0ar+1owsu842/Ab+4qvU879ippJBHvyY5n2mxF1izXqkPYlGuP/M556uh53jRLJmzTWA==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.0.4" + } + }, + "node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.33.5.tgz", + "integrity": "sha512-XrHMZwGQGvJg2V/oRSUfSAfjfPxO+4DkiRh6p2AFjLQztWUuY/o8Mq0eMQVIY7HJ1CDQUJlxGGZRw1a5bqmd1g==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.0.4" + } + }, + "node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.33.5.tgz", + "integrity": "sha512-WT+d/cgqKkkKySYmqoZ8y3pxx7lx9vVejxW/W4DOFMYVSkErR+w7mf2u8m/y4+xHe7yY9DAXQMWQhpnMuFfScw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.0.4" + } + }, + "node_modules/@img/sharp-wasm32": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.33.5.tgz", + "integrity": "sha512-ykUW4LVGaMcU9lu9thv85CbRMAwfeadCJHRsg2GmeRa/cJxsVY9Rbd57JcMxBkKHag5U/x7TSBpScF4U8ElVzg==", + "cpu": [ + "wasm32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.2.0" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.5.tgz", + "integrity": "sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-ia32": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.33.5.tgz", + "integrity": "sha512-T36PblLaTwuVJ/zw/LaH0PdZkRz5rd3SmMHX8GSmR7vtNSP5Z6bQkExdSK7xGWyxLw4sUknBuugTelgw2faBbQ==", + "cpu": [ + "ia32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-x64": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.33.5.tgz", + "integrity": "sha512-MpY/o8/8kj+EcnxwvrP4aTJSWw/aZ7JIGR4aBeZkZw5B7/Jn+tY9/VNwtcoGmdT7GfggGIU4kygOMSbYnOrAbg==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "license": "MIT" + }, + "node_modules/@mdx-js/mdx": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/@mdx-js/mdx/-/mdx-3.1.1.tgz", + "integrity": "sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdx": "^2.0.0", + "acorn": "^8.0.0", + "collapse-white-space": "^2.0.0", + "devlop": "^1.0.0", + "estree-util-is-identifier-name": "^3.0.0", + "estree-util-scope": "^1.0.0", + "estree-walker": "^3.0.0", + "hast-util-to-jsx-runtime": "^2.0.0", + "markdown-extensions": "^2.0.0", + "recma-build-jsx": "^1.0.0", + "recma-jsx": "^1.0.0", + "recma-stringify": "^1.0.0", + "rehype-recma": "^1.0.0", + "remark-mdx": "^3.0.0", + "remark-parse": "^11.0.0", + "remark-rehype": "^11.0.0", + "source-map": "^0.7.0", + "unified": "^11.0.0", + "unist-util-position-from-estree": "^2.0.0", + "unist-util-stringify-position": "^4.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/@oslojs/encoding": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@oslojs/encoding/-/encoding-1.1.0.tgz", + "integrity": "sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==", + "license": "MIT" + }, + "node_modules/@pagefind/darwin-arm64": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/darwin-arm64/-/darwin-arm64-1.4.0.tgz", + "integrity": "sha512-2vMqkbv3lbx1Awea90gTaBsvpzgRs7MuSgKDxW0m9oV1GPZCZbZBJg/qL83GIUEN2BFlY46dtUZi54pwH+/pTQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@pagefind/darwin-x64": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/darwin-x64/-/darwin-x64-1.4.0.tgz", + "integrity": "sha512-e7JPIS6L9/cJfow+/IAqknsGqEPjJnVXGjpGm25bnq+NPdoD3c/7fAwr1OXkG4Ocjx6ZGSCijXEV4ryMcH2E3A==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@pagefind/default-ui": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/default-ui/-/default-ui-1.4.0.tgz", + "integrity": "sha512-wie82VWn3cnGEdIjh4YwNESyS1G6vRHwL6cNjy9CFgNnWW/PGRjsLq300xjVH5sfPFK3iK36UxvIBymtQIEiSQ==", + "license": "MIT" + }, + "node_modules/@pagefind/freebsd-x64": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/freebsd-x64/-/freebsd-x64-1.4.0.tgz", + "integrity": "sha512-WcJVypXSZ+9HpiqZjFXMUobfFfZZ6NzIYtkhQ9eOhZrQpeY5uQFqNWLCk7w9RkMUwBv1HAMDW3YJQl/8OqsV0Q==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@pagefind/linux-arm64": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/linux-arm64/-/linux-arm64-1.4.0.tgz", + "integrity": "sha512-PIt8dkqt4W06KGmQjONw7EZbhDF+uXI7i0XtRLN1vjCUxM9vGPdtJc2mUyVPevjomrGz5M86M8bqTr6cgDp1Uw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@pagefind/linux-x64": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/linux-x64/-/linux-x64-1.4.0.tgz", + "integrity": "sha512-z4oddcWwQ0UHrTHR8psLnVlz6USGJ/eOlDPTDYZ4cI8TK8PgwRUPQZp9D2iJPNIPcS6Qx/E4TebjuGJOyK8Mmg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@pagefind/windows-x64": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@pagefind/windows-x64/-/windows-x64-1.4.0.tgz", + "integrity": "sha512-NkT+YAdgS2FPCn8mIA9bQhiBs+xmniMGq1LFPDhcFn0+2yIUEiIG06t7bsZlhdjknEQRTSdT7YitP6fC5qwP0g==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/pluginutils": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.3.0.tgz", + "integrity": "sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-walker": "^2.0.2", + "picomatch": "^4.0.2" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" + }, + "peerDependenciesMeta": { + "rollup": { + "optional": true + } + } + }, + "node_modules/@rollup/pluginutils/node_modules/estree-walker": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-2.0.2.tgz", + "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==", + "license": "MIT" + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.57.1.tgz", + "integrity": "sha512-A6ehUVSiSaaliTxai040ZpZ2zTevHYbvu/lDoeAteHI8QnaosIzm4qwtezfRg1jOYaUmnzLX1AOD6Z+UJjtifg==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.57.1.tgz", + "integrity": "sha512-dQaAddCY9YgkFHZcFNS/606Exo8vcLHwArFZ7vxXq4rigo2bb494/xKMMwRRQW6ug7Js6yXmBZhSBRuBvCCQ3w==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.57.1.tgz", + "integrity": "sha512-crNPrwJOrRxagUYeMn/DZwqN88SDmwaJ8Cvi/TN1HnWBU7GwknckyosC2gd0IqYRsHDEnXf328o9/HC6OkPgOg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.57.1.tgz", + "integrity": "sha512-Ji8g8ChVbKrhFtig5QBV7iMaJrGtpHelkB3lsaKzadFBe58gmjfGXAOfI5FV0lYMH8wiqsxKQ1C9B0YTRXVy4w==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.57.1.tgz", + "integrity": "sha512-R+/WwhsjmwodAcz65guCGFRkMb4gKWTcIeLy60JJQbXrJ97BOXHxnkPFrP+YwFlaS0m+uWJTstrUA9o+UchFug==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.57.1.tgz", + "integrity": "sha512-IEQTCHeiTOnAUC3IDQdzRAGj3jOAYNr9kBguI7MQAAZK3caezRrg0GxAb6Hchg4lxdZEI5Oq3iov/w/hnFWY9Q==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.57.1.tgz", + "integrity": "sha512-F8sWbhZ7tyuEfsmOxwc2giKDQzN3+kuBLPwwZGyVkLlKGdV1nvnNwYD0fKQ8+XS6hp9nY7B+ZeK01EBUE7aHaw==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.57.1.tgz", + "integrity": "sha512-rGfNUfn0GIeXtBP1wL5MnzSj98+PZe/AXaGBCRmT0ts80lU5CATYGxXukeTX39XBKsxzFpEeK+Mrp9faXOlmrw==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.57.1.tgz", + "integrity": "sha512-MMtej3YHWeg/0klK2Qodf3yrNzz6CGjo2UntLvk2RSPlhzgLvYEB3frRvbEF2wRKh1Z2fDIg9KRPe1fawv7C+g==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.57.1.tgz", + "integrity": "sha512-1a/qhaaOXhqXGpMFMET9VqwZakkljWHLmZOX48R0I/YLbhdxr1m4gtG1Hq7++VhVUmf+L3sTAf9op4JlhQ5u1Q==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.57.1.tgz", + "integrity": "sha512-QWO6RQTZ/cqYtJMtxhkRkidoNGXc7ERPbZN7dVW5SdURuLeVU7lwKMpo18XdcmpWYd0qsP1bwKPf7DNSUinhvA==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.57.1.tgz", + "integrity": "sha512-xpObYIf+8gprgWaPP32xiN5RVTi/s5FCR+XMXSKmhfoJjrpRAjCuuqQXyxUa/eJTdAE6eJ+KDKaoEqjZQxh3Gw==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.57.1.tgz", + "integrity": "sha512-4BrCgrpZo4hvzMDKRqEaW1zeecScDCR+2nZ86ATLhAoJ5FQ+lbHVD3ttKe74/c7tNT9c6F2viwB3ufwp01Oh2w==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.57.1.tgz", + "integrity": "sha512-NOlUuzesGauESAyEYFSe3QTUguL+lvrN1HtwEEsU2rOwdUDeTMJdO5dUYl/2hKf9jWydJrO9OL/XSSf65R5+Xw==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.57.1.tgz", + "integrity": "sha512-ptA88htVp0AwUUqhVghwDIKlvJMD/fmL/wrQj99PRHFRAG6Z5nbWoWG4o81Nt9FT+IuqUQi+L31ZKAFeJ5Is+A==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.57.1.tgz", + "integrity": "sha512-S51t7aMMTNdmAMPpBg7OOsTdn4tySRQvklmL3RpDRyknk87+Sp3xaumlatU+ppQ+5raY7sSTcC2beGgvhENfuw==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.57.1.tgz", + "integrity": "sha512-Bl00OFnVFkL82FHbEqy3k5CUCKH6OEJL54KCyx2oqsmZnFTR8IoNqBF+mjQVcRCT5sB6yOvK8A37LNm/kPJiZg==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.57.1.tgz", + "integrity": "sha512-ABca4ceT4N+Tv/GtotnWAeXZUZuM/9AQyCyKYyKnpk4yoA7QIAuBt6Hkgpw8kActYlew2mvckXkvx0FfoInnLg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.57.1.tgz", + "integrity": "sha512-HFps0JeGtuOR2convgRRkHCekD7j+gdAuXM+/i6kGzQtFhlCtQkpwtNzkNj6QhCDp7DRJ7+qC/1Vg2jt5iSOFw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.57.1.tgz", + "integrity": "sha512-H+hXEv9gdVQuDTgnqD+SQffoWoc0Of59AStSzTEj/feWTBAnSfSD3+Dql1ZruJQxmykT/JVY0dE8Ka7z0DH1hw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.57.1.tgz", + "integrity": "sha512-4wYoDpNg6o/oPximyc/NG+mYUejZrCU2q+2w6YZqrAs2UcNUChIZXjtafAiiZSUc7On8v5NyNj34Kzj/Ltk6dQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.57.1.tgz", + "integrity": "sha512-O54mtsV/6LW3P8qdTcamQmuC990HDfR71lo44oZMZlXU4tzLrbvTii87Ni9opq60ds0YzuAlEr/GNwuNluZyMQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.57.1.tgz", + "integrity": "sha512-P3dLS+IerxCT/7D2q2FYcRdWRl22dNbrbBEtxdWhXrfIMPP9lQhb5h4Du04mdl5Woq05jVCDPCMF7Ub0NAjIew==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.57.1.tgz", + "integrity": "sha512-VMBH2eOOaKGtIJYleXsi2B8CPVADrh+TyNxJ4mWPnKfLB/DBUmzW+5m1xUrcwWoMfSLagIRpjUFeW5CO5hyciQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.57.1.tgz", + "integrity": "sha512-mxRFDdHIWRxg3UfIIAwCm6NzvxG0jDX/wBN6KsQFTvKFqqg9vTrWUE68qEjHt19A5wwx5X5aUi2zuZT7YR0jrA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@shikijs/core": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-3.22.0.tgz", + "integrity": "sha512-iAlTtSDDbJiRpvgL5ugKEATDtHdUVkqgHDm/gbD2ZS9c88mx7G1zSYjjOxp5Qa0eaW0MAQosFRmJSk354PRoQA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.22.0", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4", + "hast-util-to-html": "^9.0.5" + } + }, + "node_modules/@shikijs/engine-javascript": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-3.22.0.tgz", + "integrity": "sha512-jdKhfgW9CRtj3Tor0L7+yPwdG3CgP7W+ZEqSsojrMzCjD1e0IxIbwUMDDpYlVBlC08TACg4puwFGkZfLS+56Tw==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.22.0", + "@shikijs/vscode-textmate": "^10.0.2", + "oniguruma-to-es": "^4.3.4" + } + }, + "node_modules/@shikijs/engine-oniguruma": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-3.22.0.tgz", + "integrity": "sha512-DyXsOG0vGtNtl7ygvabHd7Mt5EY8gCNqR9Y7Lpbbd/PbJvgWrqaKzH1JW6H6qFkuUa8aCxoiYVv8/YfFljiQxA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.22.0", + "@shikijs/vscode-textmate": "^10.0.2" + } + }, + "node_modules/@shikijs/langs": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-3.22.0.tgz", + "integrity": "sha512-x/42TfhWmp6H00T6uwVrdTJGKgNdFbrEdhaDwSR5fd5zhQ1Q46bHq9EO61SCEWJR0HY7z2HNDMaBZp8JRmKiIA==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.22.0" + } + }, + "node_modules/@shikijs/themes": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-3.22.0.tgz", + "integrity": "sha512-o+tlOKqsr6FE4+mYJG08tfCFDS+3CG20HbldXeVoyP+cYSUxDhrFf3GPjE60U55iOkkjbpY2uC3It/eeja35/g==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "3.22.0" + } + }, + "node_modules/@shikijs/types": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-3.22.0.tgz", + "integrity": "sha512-491iAekgKDBFE67z70Ok5a8KBMsQ2IJwOWw3us/7ffQkIBCyOQfm/aNwVMBUriP02QshIfgHCBSIYAl3u2eWjg==", + "license": "MIT", + "dependencies": { + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4" + } + }, + "node_modules/@shikijs/vscode-textmate": { + "version": "10.0.2", + "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.0.2.tgz", + "integrity": "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==", + "license": "MIT" + }, + "node_modules/@types/debug": { + "version": "4.1.12", + "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz", + "integrity": "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==", + "license": "MIT", + "dependencies": { + "@types/ms": "*" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "license": "MIT" + }, + "node_modules/@types/estree-jsx": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@types/estree-jsx/-/estree-jsx-1.0.5.tgz", + "integrity": "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==", + "license": "MIT", + "dependencies": { + "@types/estree": "*" + } + }, + "node_modules/@types/hast": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.4.tgz", + "integrity": "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/js-yaml": { + "version": "4.0.9", + "resolved": "https://registry.npmjs.org/@types/js-yaml/-/js-yaml-4.0.9.tgz", + "integrity": "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==", + "license": "MIT" + }, + "node_modules/@types/mdast": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", + "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/mdx": { + "version": "2.0.13", + "resolved": "https://registry.npmjs.org/@types/mdx/-/mdx-2.0.13.tgz", + "integrity": "sha512-+OWZQfAYyio6YkJb3HLxDrvnx6SWWDbC0zVPfBRzUk0/nqoDyf6dNxQi3eArPe8rJ473nobTMQ/8Zk+LxJ+Yuw==", + "license": "MIT" + }, + "node_modules/@types/ms": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz", + "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==", + "license": "MIT" + }, + "node_modules/@types/nlcst": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@types/nlcst/-/nlcst-2.0.3.tgz", + "integrity": "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/node": { + "version": "25.2.3", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.2.3.tgz", + "integrity": "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ==", + "license": "MIT", + "dependencies": { + "undici-types": "~7.16.0" + } + }, + "node_modules/@types/picomatch": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@types/picomatch/-/picomatch-3.0.2.tgz", + "integrity": "sha512-n0i8TD3UDB7paoMMxA3Y65vUncFJXjcUf7lQY7YyKGl6031FNjfsLs6pdLFCy2GNFxItPJG8GvvpbZc2skH7WA==", + "license": "MIT" + }, + "node_modules/@types/sax": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/@types/sax/-/sax-1.2.7.tgz", + "integrity": "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/unist": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz", + "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==", + "license": "MIT" + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz", + "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==", + "license": "ISC" + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/ansi-align": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz", + "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==", + "license": "ISC", + "dependencies": { + "string-width": "^4.1.0" + } + }, + "node_modules/ansi-align/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "license": "MIT" + }, + "node_modules/ansi-align/node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-align/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-escapes": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.3.0.tgz", + "integrity": "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==", + "license": "MIT", + "dependencies": { + "environment": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-regex": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz", + "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/anymatch/node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/arg": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz", + "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==", + "license": "MIT" + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "license": "Python-2.0" + }, + "node_modules/aria-query": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz", + "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==", + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/array-iterate": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/array-iterate/-/array-iterate-2.0.1.tgz", + "integrity": "sha512-I1jXZMjAgCMmxT4qxXfPXa6SthSoE8h6gkSI9BGGNv8mP8G/v0blc+qFnZu6K42vTOiuME596QaLO0TP3Lk0xg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/astring": { + "version": "1.9.0", + "resolved": "https://registry.npmjs.org/astring/-/astring-1.9.0.tgz", + "integrity": "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==", + "license": "MIT", + "bin": { + "astring": "bin/astring" + } + }, + "node_modules/astro": { + "version": "5.17.2", + "resolved": "https://registry.npmjs.org/astro/-/astro-5.17.2.tgz", + "integrity": "sha512-7jnMqGo53hOQNwo1N/wqeOvUp8wwW/p+DeerSjSkHNx8L/1mhy6P7rVo7EhdmF8DpKqw0tl/B5Fx1WcIzg1ysA==", + "license": "MIT", + "dependencies": { + "@astrojs/compiler": "^2.13.0", + "@astrojs/internal-helpers": "0.7.5", + "@astrojs/markdown-remark": "6.3.10", + "@astrojs/telemetry": "3.3.0", + "@capsizecss/unpack": "^4.0.0", + "@oslojs/encoding": "^1.1.0", + "@rollup/pluginutils": "^5.3.0", + "acorn": "^8.15.0", + "aria-query": "^5.3.2", + "axobject-query": "^4.1.0", + "boxen": "8.0.1", + "ci-info": "^4.3.1", + "clsx": "^2.1.1", + "common-ancestor-path": "^1.0.1", + "cookie": "^1.1.1", + "cssesc": "^3.0.0", + "debug": "^4.4.3", + "deterministic-object-hash": "^2.0.2", + "devalue": "^5.6.2", + "diff": "^8.0.3", + "dlv": "^1.1.3", + "dset": "^3.1.4", + "es-module-lexer": "^1.7.0", + "esbuild": "^0.27.0", + "estree-walker": "^3.0.3", + "flattie": "^1.1.1", + "fontace": "~0.4.0", + "github-slugger": "^2.0.0", + "html-escaper": "3.0.3", + "http-cache-semantics": "^4.2.0", + "import-meta-resolve": "^4.2.0", + "js-yaml": "^4.1.1", + "magic-string": "^0.30.21", + "magicast": "^0.5.1", + "mrmime": "^2.0.1", + "neotraverse": "^0.6.18", + "p-limit": "^6.2.0", + "p-queue": "^8.1.1", + "package-manager-detector": "^1.6.0", + "piccolore": "^0.1.3", + "picomatch": "^4.0.3", + "prompts": "^2.4.2", + "rehype": "^13.0.2", + "semver": "^7.7.3", + "shiki": "^3.21.0", + "smol-toml": "^1.6.0", + "svgo": "^4.0.0", + "tinyexec": "^1.0.2", + "tinyglobby": "^0.2.15", + "tsconfck": "^3.1.6", + "ultrahtml": "^1.6.0", + "unifont": "~0.7.3", + "unist-util-visit": "^5.0.0", + "unstorage": "^1.17.4", + "vfile": "^6.0.3", + "vite": "^6.4.1", + "vitefu": "^1.1.1", + "xxhash-wasm": "^1.1.0", + "yargs-parser": "^21.1.1", + "yocto-spinner": "^0.2.3", + "zod": "^3.25.76", + "zod-to-json-schema": "^3.25.1", + "zod-to-ts": "^1.2.0" + }, + "bin": { + "astro": "astro.js" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0", + "npm": ">=9.6.5", + "pnpm": ">=7.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/astrodotbuild" + }, + "optionalDependencies": { + "sharp": "^0.34.0" + } + }, + "node_modules/astro-expressive-code": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/astro-expressive-code/-/astro-expressive-code-0.41.6.tgz", + "integrity": "sha512-l47tb1uhmVIebHUkw+HEPtU/av0G4O8Q34g2cbkPvC7/e9ZhANcjUUciKt9Hp6gSVDdIuXBBLwJQn2LkeGMOAw==", + "license": "MIT", + "dependencies": { + "rehype-expressive-code": "^0.41.6" + }, + "peerDependencies": { + "astro": "^4.0.0-beta || ^5.0.0-beta || ^3.3.0 || ^6.0.0-beta" + } + }, + "node_modules/astro/node_modules/@img/sharp-darwin-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.5.tgz", + "integrity": "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-darwin-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.5.tgz", + "integrity": "sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.4.tgz", + "integrity": "sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-darwin-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.4.tgz", + "integrity": "sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-linux-arm": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.4.tgz", + "integrity": "sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==", + "cpu": [ + "arm" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-linux-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.4.tgz", + "integrity": "sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-linux-s390x": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.4.tgz", + "integrity": "sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==", + "cpu": [ + "s390x" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-linux-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.4.tgz", + "integrity": "sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-linuxmusl-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.4.tgz", + "integrity": "sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==", + "cpu": [ + "arm64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-libvips-linuxmusl-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.4.tgz", + "integrity": "sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==", + "cpu": [ + "x64" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-linux-arm": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.5.tgz", + "integrity": "sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==", + "cpu": [ + "arm" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-linux-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.5.tgz", + "integrity": "sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-linux-s390x": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.5.tgz", + "integrity": "sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==", + "cpu": [ + "s390x" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-linux-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.5.tgz", + "integrity": "sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.5.tgz", + "integrity": "sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.5.tgz", + "integrity": "sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.2.4" + } + }, + "node_modules/astro/node_modules/@img/sharp-wasm32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.5.tgz", + "integrity": "sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==", + "cpu": [ + "wasm32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.7.0" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-win32-ia32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.5.tgz", + "integrity": "sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==", + "cpu": [ + "ia32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/@img/sharp-win32-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.5.tgz", + "integrity": "sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/astro/node_modules/sharp": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz", + "integrity": "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==", + "hasInstallScript": true, + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@img/colour": "^1.0.0", + "detect-libc": "^2.1.2", + "semver": "^7.7.3" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.34.5", + "@img/sharp-darwin-x64": "0.34.5", + "@img/sharp-libvips-darwin-arm64": "1.2.4", + "@img/sharp-libvips-darwin-x64": "1.2.4", + "@img/sharp-libvips-linux-arm": "1.2.4", + "@img/sharp-libvips-linux-arm64": "1.2.4", + "@img/sharp-libvips-linux-ppc64": "1.2.4", + "@img/sharp-libvips-linux-riscv64": "1.2.4", + "@img/sharp-libvips-linux-s390x": "1.2.4", + "@img/sharp-libvips-linux-x64": "1.2.4", + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4", + "@img/sharp-libvips-linuxmusl-x64": "1.2.4", + "@img/sharp-linux-arm": "0.34.5", + "@img/sharp-linux-arm64": "0.34.5", + "@img/sharp-linux-ppc64": "0.34.5", + "@img/sharp-linux-riscv64": "0.34.5", + "@img/sharp-linux-s390x": "0.34.5", + "@img/sharp-linux-x64": "0.34.5", + "@img/sharp-linuxmusl-arm64": "0.34.5", + "@img/sharp-linuxmusl-x64": "0.34.5", + "@img/sharp-wasm32": "0.34.5", + "@img/sharp-win32-arm64": "0.34.5", + "@img/sharp-win32-ia32": "0.34.5", + "@img/sharp-win32-x64": "0.34.5" + } + }, + "node_modules/axobject-query": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz", + "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==", + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/bail": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz", + "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/base-64": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/base-64/-/base-64-1.0.0.tgz", + "integrity": "sha512-kwDPIFCGx0NZHog36dj+tHiwP4QMzsZ3AgMViUBKI0+V5n4U0ufTCUMhnQ04diaRI8EX/QcPfql7zlhZ7j4zgg==", + "license": "MIT" + }, + "node_modules/bcp-47": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/bcp-47/-/bcp-47-2.1.0.tgz", + "integrity": "sha512-9IIS3UPrvIa1Ej+lVDdDwO7zLehjqsaByECw0bu2RRGP73jALm6FYbzI5gWbgHLvNdkvfXB5YrSbocZdOS0c0w==", + "license": "MIT", + "dependencies": { + "is-alphabetical": "^2.0.0", + "is-alphanumerical": "^2.0.0", + "is-decimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/bcp-47-match": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/bcp-47-match/-/bcp-47-match-2.0.3.tgz", + "integrity": "sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/boolbase": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz", + "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==", + "license": "ISC" + }, + "node_modules/boxen": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/boxen/-/boxen-8.0.1.tgz", + "integrity": "sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw==", + "license": "MIT", + "dependencies": { + "ansi-align": "^3.0.1", + "camelcase": "^8.0.0", + "chalk": "^5.3.0", + "cli-boxes": "^3.0.0", + "string-width": "^7.2.0", + "type-fest": "^4.21.0", + "widest-line": "^5.0.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/camelcase": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-8.0.0.tgz", + "integrity": "sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA==", + "license": "MIT", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ccount": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz", + "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/character-entities": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz", + "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-html4": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz", + "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-legacy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz", + "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-reference-invalid": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz", + "integrity": "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/chokidar": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz", + "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==", + "license": "MIT", + "dependencies": { + "readdirp": "^5.0.0" + }, + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/ci-info": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.4.0.tgz", + "integrity": "sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/sibiraj-s" + } + ], + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cli-boxes": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-3.0.0.tgz", + "integrity": "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==", + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/clsx": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz", + "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/collapse-white-space": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/collapse-white-space/-/collapse-white-space-2.1.0.tgz", + "integrity": "sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/color": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz", + "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1", + "color-string": "^1.9.0" + }, + "engines": { + "node": ">=12.5.0" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/color-string": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz", + "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==", + "license": "MIT", + "dependencies": { + "color-name": "^1.0.0", + "simple-swizzle": "^0.2.2" + } + }, + "node_modules/comma-separated-tokens": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz", + "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/commander": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz", + "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==", + "license": "MIT", + "engines": { + "node": ">=16" + } + }, + "node_modules/common-ancestor-path": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/common-ancestor-path/-/common-ancestor-path-1.0.1.tgz", + "integrity": "sha512-L3sHRo1pXXEqX8VU28kfgUY+YGsk09hPqZiZmLacNib6XNTCM8ubYeT7ryXQw8asB1sKgcU5lkB7ONug08aB8w==", + "license": "ISC" + }, + "node_modules/cookie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz", + "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/cookie-es": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.2.tgz", + "integrity": "sha512-+W7VmiVINB+ywl1HGXJXmrqkOhpKrIiVZV6tQuV54ZyQC7MMuBt81Vc336GMLoHBq5hV/F9eXgt5Mnx0Rha5Fg==", + "license": "MIT" + }, + "node_modules/crossws": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/crossws/-/crossws-0.3.5.tgz", + "integrity": "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==", + "license": "MIT", + "dependencies": { + "uncrypto": "^0.1.3" + } + }, + "node_modules/css-select": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz", + "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0", + "css-what": "^6.1.0", + "domhandler": "^5.0.2", + "domutils": "^3.0.1", + "nth-check": "^2.0.1" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/css-selector-parser": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/css-selector-parser/-/css-selector-parser-3.3.0.tgz", + "integrity": "sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/mdevils" + }, + { + "type": "patreon", + "url": "https://patreon.com/mdevils" + } + ], + "license": "MIT" + }, + "node_modules/css-tree": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.1.0.tgz", + "integrity": "sha512-0eW44TGN5SQXU1mWSkKwFstI/22X2bG1nYzZTYMAWjylYURhse752YgbE4Cx46AC+bAvI+/dYTPRk1LqSUnu6w==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.12.2", + "source-map-js": "^1.0.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0" + } + }, + "node_modules/css-what": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz", + "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">= 6" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/cssesc": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz", + "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==", + "license": "MIT", + "bin": { + "cssesc": "bin/cssesc" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/csso": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/csso/-/csso-5.0.5.tgz", + "integrity": "sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==", + "license": "MIT", + "dependencies": { + "css-tree": "~2.2.0" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0", + "npm": ">=7.0.0" + } + }, + "node_modules/csso/node_modules/css-tree": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-2.2.1.tgz", + "integrity": "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.0.28", + "source-map-js": "^1.0.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0", + "npm": ">=7.0.0" + } + }, + "node_modules/csso/node_modules/mdn-data": { + "version": "2.0.28", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.28.tgz", + "integrity": "sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==", + "license": "CC0-1.0" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/decode-named-character-reference": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz", + "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==", + "license": "MIT", + "dependencies": { + "character-entities": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/defu": { + "version": "6.1.4", + "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.4.tgz", + "integrity": "sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==", + "license": "MIT" + }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/destr": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz", + "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==", + "license": "MIT" + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/deterministic-object-hash": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/deterministic-object-hash/-/deterministic-object-hash-2.0.2.tgz", + "integrity": "sha512-KxektNH63SrbfUyDiwXqRb1rLwKt33AmMv+5Nhsw1kqZ13SJBRTgZHtGbE+hH3a1mVW1cz+4pqSWVPAtLVXTzQ==", + "license": "MIT", + "dependencies": { + "base-64": "^1.0.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/devalue": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.6.2.tgz", + "integrity": "sha512-nPRkjWzzDQlsejL1WVifk5rvcFi/y1onBRxjaFMjZeR9mFpqu2gmAZ9xUB9/IEanEP/vBtGeGganC/GO1fmufg==", + "license": "MIT" + }, + "node_modules/devlop": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz", + "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==", + "license": "MIT", + "dependencies": { + "dequal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/diff": { + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/diff/-/diff-8.0.3.tgz", + "integrity": "sha512-qejHi7bcSD4hQAZE0tNAawRK1ZtafHDmMTMkrrIGgSLl7hTnQHmKCeB45xAcbfTqK2zowkM3j3bHt/4b/ARbYQ==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.3.1" + } + }, + "node_modules/direction": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/direction/-/direction-2.0.1.tgz", + "integrity": "sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA==", + "license": "MIT", + "bin": { + "direction": "cli.js" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/dlv": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz", + "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==", + "license": "MIT" + }, + "node_modules/dom-serializer": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz", + "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==", + "license": "MIT", + "dependencies": { + "domelementtype": "^2.3.0", + "domhandler": "^5.0.2", + "entities": "^4.2.0" + }, + "funding": { + "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1" + } + }, + "node_modules/dom-serializer/node_modules/entities": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", + "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/domelementtype": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz", + "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fb55" + } + ], + "license": "BSD-2-Clause" + }, + "node_modules/domhandler": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz", + "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==", + "license": "BSD-2-Clause", + "dependencies": { + "domelementtype": "^2.3.0" + }, + "engines": { + "node": ">= 4" + }, + "funding": { + "url": "https://github.com/fb55/domhandler?sponsor=1" + } + }, + "node_modules/domutils": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz", + "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==", + "license": "BSD-2-Clause", + "dependencies": { + "dom-serializer": "^2.0.0", + "domelementtype": "^2.3.0", + "domhandler": "^5.0.3" + }, + "funding": { + "url": "https://github.com/fb55/domutils?sponsor=1" + } + }, + "node_modules/dset": { + "version": "3.1.4", + "resolved": "https://registry.npmjs.org/dset/-/dset-3.1.4.tgz", + "integrity": "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "license": "MIT" + }, + "node_modules/entities": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz", + "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/environment": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz", + "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/es-module-lexer": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz", + "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==", + "license": "MIT" + }, + "node_modules/esast-util-from-estree": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/esast-util-from-estree/-/esast-util-from-estree-2.0.0.tgz", + "integrity": "sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "devlop": "^1.0.0", + "estree-util-visit": "^2.0.0", + "unist-util-position-from-estree": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/esast-util-from-js": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/esast-util-from-js/-/esast-util-from-js-2.0.1.tgz", + "integrity": "sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "acorn": "^8.0.0", + "esast-util-from-estree": "^2.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/esbuild": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.3.tgz", + "integrity": "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==", + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.3", + "@esbuild/android-arm": "0.27.3", + "@esbuild/android-arm64": "0.27.3", + "@esbuild/android-x64": "0.27.3", + "@esbuild/darwin-arm64": "0.27.3", + "@esbuild/darwin-x64": "0.27.3", + "@esbuild/freebsd-arm64": "0.27.3", + "@esbuild/freebsd-x64": "0.27.3", + "@esbuild/linux-arm": "0.27.3", + "@esbuild/linux-arm64": "0.27.3", + "@esbuild/linux-ia32": "0.27.3", + "@esbuild/linux-loong64": "0.27.3", + "@esbuild/linux-mips64el": "0.27.3", + "@esbuild/linux-ppc64": "0.27.3", + "@esbuild/linux-riscv64": "0.27.3", + "@esbuild/linux-s390x": "0.27.3", + "@esbuild/linux-x64": "0.27.3", + "@esbuild/netbsd-arm64": "0.27.3", + "@esbuild/netbsd-x64": "0.27.3", + "@esbuild/openbsd-arm64": "0.27.3", + "@esbuild/openbsd-x64": "0.27.3", + "@esbuild/openharmony-arm64": "0.27.3", + "@esbuild/sunos-x64": "0.27.3", + "@esbuild/win32-arm64": "0.27.3", + "@esbuild/win32-ia32": "0.27.3", + "@esbuild/win32-x64": "0.27.3" + } + }, + "node_modules/escape-string-regexp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz", + "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/estree-util-attach-comments": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/estree-util-attach-comments/-/estree-util-attach-comments-3.0.0.tgz", + "integrity": "sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/estree-util-build-jsx": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/estree-util-build-jsx/-/estree-util-build-jsx-3.0.1.tgz", + "integrity": "sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "devlop": "^1.0.0", + "estree-util-is-identifier-name": "^3.0.0", + "estree-walker": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/estree-util-is-identifier-name": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/estree-util-is-identifier-name/-/estree-util-is-identifier-name-3.0.0.tgz", + "integrity": "sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/estree-util-scope": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/estree-util-scope/-/estree-util-scope-1.0.0.tgz", + "integrity": "sha512-2CAASclonf+JFWBNJPndcOpA8EMJwa0Q8LUFJEKqXLW6+qBvbFZuF5gItbQOs/umBUkjviCSDCbBwU2cXbmrhQ==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "devlop": "^1.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/estree-util-to-js": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/estree-util-to-js/-/estree-util-to-js-2.0.0.tgz", + "integrity": "sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "astring": "^1.8.0", + "source-map": "^0.7.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/estree-util-visit": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/estree-util-visit/-/estree-util-visit-2.0.0.tgz", + "integrity": "sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/eventemitter3": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==", + "license": "MIT" + }, + "node_modules/expressive-code": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/expressive-code/-/expressive-code-0.41.6.tgz", + "integrity": "sha512-W/5+IQbrpCIM5KGLjO35wlp1NCwDOOVQb+PAvzEoGkW1xjGM807ZGfBKptNWH6UECvt6qgmLyWolCMYKh7eQmA==", + "license": "MIT", + "dependencies": { + "@expressive-code/core": "^0.41.6", + "@expressive-code/plugin-frames": "^0.41.6", + "@expressive-code/plugin-shiki": "^0.41.6", + "@expressive-code/plugin-text-markers": "^0.41.6" + } + }, + "node_modules/extend": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", + "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", + "license": "MIT" + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/flattie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/flattie/-/flattie-1.1.1.tgz", + "integrity": "sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/fontace": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/fontace/-/fontace-0.4.1.tgz", + "integrity": "sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw==", + "license": "MIT", + "dependencies": { + "fontkitten": "^1.0.2" + } + }, + "node_modules/fontkitten": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/fontkitten/-/fontkitten-1.0.2.tgz", + "integrity": "sha512-piJxbLnkD9Xcyi7dWJRnqszEURixe7CrF/efBfbffe2DPyabmuIuqraruY8cXTs19QoM8VJzx47BDRVNXETM7Q==", + "license": "MIT", + "dependencies": { + "tiny-inflate": "^1.0.3" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.4.0.tgz", + "integrity": "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/github-slugger": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/github-slugger/-/github-slugger-2.0.0.tgz", + "integrity": "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==", + "license": "ISC" + }, + "node_modules/h3": { + "version": "1.15.5", + "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.5.tgz", + "integrity": "sha512-xEyq3rSl+dhGX2Lm0+eFQIAzlDN6Fs0EcC4f7BNUmzaRX/PTzeuM+Tr2lHB8FoXggsQIeXLj8EDVgs5ywxyxmg==", + "license": "MIT", + "dependencies": { + "cookie-es": "^1.2.2", + "crossws": "^0.3.5", + "defu": "^6.1.4", + "destr": "^2.0.5", + "iron-webcrypto": "^1.2.1", + "node-mock-http": "^1.0.4", + "radix3": "^1.1.2", + "ufo": "^1.6.3", + "uncrypto": "^0.1.3" + } + }, + "node_modules/has-flag": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-5.0.1.tgz", + "integrity": "sha512-CsNUt5x9LUdx6hnk/E2SZLsDyvfqANZSUq4+D3D8RzDJ2M+HDTIkF60ibS1vHaK55vzgiZw1bEPFG9yH7l33wA==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/hast-util-embedded": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-embedded/-/hast-util-embedded-3.0.0.tgz", + "integrity": "sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-is-element": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-format": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/hast-util-format/-/hast-util-format-1.1.0.tgz", + "integrity": "sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-embedded": "^3.0.0", + "hast-util-minify-whitespace": "^1.0.0", + "hast-util-phrasing": "^3.0.0", + "hast-util-whitespace": "^3.0.0", + "html-whitespace-sensitive-tag-names": "^3.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-from-html": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/hast-util-from-html/-/hast-util-from-html-2.0.3.tgz", + "integrity": "sha512-CUSRHXyKjzHov8yKsQjGOElXy/3EKpyX56ELnkHH34vDVw1N1XSQ1ZcAvTyAPtGqLTuKP/uxM+aLkSPqF/EtMw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "devlop": "^1.1.0", + "hast-util-from-parse5": "^8.0.0", + "parse5": "^7.0.0", + "vfile": "^6.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-from-parse5": { + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/hast-util-from-parse5/-/hast-util-from-parse5-8.0.3.tgz", + "integrity": "sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "devlop": "^1.0.0", + "hastscript": "^9.0.0", + "property-information": "^7.0.0", + "vfile": "^6.0.0", + "vfile-location": "^5.0.0", + "web-namespaces": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-has-property": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-has-property/-/hast-util-has-property-3.0.0.tgz", + "integrity": "sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-is-body-ok-link": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/hast-util-is-body-ok-link/-/hast-util-is-body-ok-link-3.0.1.tgz", + "integrity": "sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-is-element": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-is-element/-/hast-util-is-element-3.0.0.tgz", + "integrity": "sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-minify-whitespace": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/hast-util-minify-whitespace/-/hast-util-minify-whitespace-1.0.1.tgz", + "integrity": "sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-embedded": "^3.0.0", + "hast-util-is-element": "^3.0.0", + "hast-util-whitespace": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-parse-selector": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/hast-util-parse-selector/-/hast-util-parse-selector-4.0.0.tgz", + "integrity": "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-phrasing": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/hast-util-phrasing/-/hast-util-phrasing-3.0.1.tgz", + "integrity": "sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-embedded": "^3.0.0", + "hast-util-has-property": "^3.0.0", + "hast-util-is-body-ok-link": "^3.0.0", + "hast-util-is-element": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-raw": { + "version": "9.1.0", + "resolved": "https://registry.npmjs.org/hast-util-raw/-/hast-util-raw-9.1.0.tgz", + "integrity": "sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "@ungap/structured-clone": "^1.0.0", + "hast-util-from-parse5": "^8.0.0", + "hast-util-to-parse5": "^8.0.0", + "html-void-elements": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "parse5": "^7.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0", + "web-namespaces": "^2.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-select": { + "version": "6.0.4", + "resolved": "https://registry.npmjs.org/hast-util-select/-/hast-util-select-6.0.4.tgz", + "integrity": "sha512-RqGS1ZgI0MwxLaKLDxjprynNzINEkRHY2i8ln4DDjgv9ZhcYVIHN9rlpiYsqtFwrgpYU361SyWDQcGNIBVu3lw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "bcp-47-match": "^2.0.0", + "comma-separated-tokens": "^2.0.0", + "css-selector-parser": "^3.0.0", + "devlop": "^1.0.0", + "direction": "^2.0.0", + "hast-util-has-property": "^3.0.0", + "hast-util-to-string": "^3.0.0", + "hast-util-whitespace": "^3.0.0", + "nth-check": "^2.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "unist-util-visit": "^5.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-estree": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/hast-util-to-estree/-/hast-util-to-estree-3.1.3.tgz", + "integrity": "sha512-48+B/rJWAp0jamNbAAf9M7Uf//UVqAoMmgXhBdxTDJLGKY+LRnZ99qcG+Qjl5HfMpYNzS5v4EAwVEF34LeAj7w==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "devlop": "^1.0.0", + "estree-util-attach-comments": "^3.0.0", + "estree-util-is-identifier-name": "^3.0.0", + "hast-util-whitespace": "^3.0.0", + "mdast-util-mdx-expression": "^2.0.0", + "mdast-util-mdx-jsx": "^3.0.0", + "mdast-util-mdxjs-esm": "^2.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "style-to-js": "^1.0.0", + "unist-util-position": "^5.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-html": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz", + "integrity": "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-whitespace": "^3.0.0", + "html-void-elements": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "stringify-entities": "^4.0.0", + "zwitch": "^2.0.4" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-jsx-runtime": { + "version": "2.3.6", + "resolved": "https://registry.npmjs.org/hast-util-to-jsx-runtime/-/hast-util-to-jsx-runtime-2.3.6.tgz", + "integrity": "sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "devlop": "^1.0.0", + "estree-util-is-identifier-name": "^3.0.0", + "hast-util-whitespace": "^3.0.0", + "mdast-util-mdx-expression": "^2.0.0", + "mdast-util-mdx-jsx": "^3.0.0", + "mdast-util-mdxjs-esm": "^2.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "style-to-js": "^1.0.0", + "unist-util-position": "^5.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-parse5": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/hast-util-to-parse5/-/hast-util-to-parse5-8.0.1.tgz", + "integrity": "sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "devlop": "^1.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "web-namespaces": "^2.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-string": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/hast-util-to-string/-/hast-util-to-string-3.0.1.tgz", + "integrity": "sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-text": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/hast-util-to-text/-/hast-util-to-text-4.0.2.tgz", + "integrity": "sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "hast-util-is-element": "^3.0.0", + "unist-util-find-after": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-whitespace": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz", + "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hastscript": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/hastscript/-/hastscript-9.0.1.tgz", + "integrity": "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-parse-selector": "^4.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/html-escaper": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-3.0.3.tgz", + "integrity": "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==", + "license": "MIT" + }, + "node_modules/html-void-elements": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-void-elements/-/html-void-elements-3.0.0.tgz", + "integrity": "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/html-whitespace-sensitive-tag-names": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/html-whitespace-sensitive-tag-names/-/html-whitespace-sensitive-tag-names-3.0.1.tgz", + "integrity": "sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/http-cache-semantics": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz", + "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==", + "license": "BSD-2-Clause" + }, + "node_modules/i18next": { + "version": "23.16.8", + "resolved": "https://registry.npmjs.org/i18next/-/i18next-23.16.8.tgz", + "integrity": "sha512-06r/TitrM88Mg5FdUXAKL96dJMzgqLE5dv3ryBAra4KCwD9mJ4ndOTS95ZuymIGoE+2hzfdaMak2X11/es7ZWg==", + "funding": [ + { + "type": "individual", + "url": "https://locize.com" + }, + { + "type": "individual", + "url": "https://locize.com/i18next.html" + }, + { + "type": "individual", + "url": "https://www.i18next.com/how-to/faq#i18next-is-awesome.-how-can-i-support-the-project" + } + ], + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.23.2" + } + }, + "node_modules/import-meta-resolve": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.2.0.tgz", + "integrity": "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/inline-style-parser": { + "version": "0.2.7", + "resolved": "https://registry.npmjs.org/inline-style-parser/-/inline-style-parser-0.2.7.tgz", + "integrity": "sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==", + "license": "MIT" + }, + "node_modules/iron-webcrypto": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/iron-webcrypto/-/iron-webcrypto-1.2.1.tgz", + "integrity": "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/brc-dd" + } + }, + "node_modules/is-absolute-url": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/is-absolute-url/-/is-absolute-url-4.0.1.tgz", + "integrity": "sha512-/51/TKE88Lmm7Gc4/8btclNXWS+g50wXhYJq8HWIBAGUBnoAdRu1aXeh364t/O7wXDAcTJDP8PNuNKWUDWie+A==", + "license": "MIT", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-alphabetical": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz", + "integrity": "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-alphanumerical": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz", + "integrity": "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==", + "license": "MIT", + "dependencies": { + "is-alphabetical": "^2.0.0", + "is-decimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-arrayish": { + "version": "0.3.4", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.4.tgz", + "integrity": "sha512-m6UrgzFVUYawGBh1dUsWR5M2Clqic9RVXC/9f8ceNlv2IcO9j9J/z8UoCLPqtsPBFNzEpfR3xftohbfqDx8EQA==", + "license": "MIT" + }, + "node_modules/is-decimal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz", + "integrity": "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-docker": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz", + "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==", + "license": "MIT", + "bin": { + "is-docker": "cli.js" + }, + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-hexadecimal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz", + "integrity": "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-inside-container": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz", + "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==", + "license": "MIT", + "dependencies": { + "is-docker": "^3.0.0" + }, + "bin": { + "is-inside-container": "cli.js" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-plain-obj": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", + "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-wsl": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.0.tgz", + "integrity": "sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==", + "license": "MIT", + "dependencies": { + "is-inside-container": "^1.0.0" + }, + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/klona": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.6.tgz", + "integrity": "sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==", + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/longest-streak": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz", + "integrity": "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/lru-cache": { + "version": "11.2.6", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.6.tgz", + "integrity": "sha512-ESL2CrkS/2wTPfuend7Zhkzo2u0daGJ/A2VucJOgQ/C48S/zB8MMeMHSGKYpXhIjbPxfuezITkaBH1wqv00DDQ==", + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/magicast": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.2.tgz", + "integrity": "sha512-E3ZJh4J3S9KfwdjZhe2afj6R9lGIN5Pher1pF39UGrXRqq/VDaGVIGN13BjHd2u8B61hArAGOnso7nBOouW3TQ==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.0", + "@babel/types": "^7.29.0", + "source-map-js": "^1.2.1" + } + }, + "node_modules/markdown-extensions": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/markdown-extensions/-/markdown-extensions-2.0.0.tgz", + "integrity": "sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==", + "license": "MIT", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/markdown-table": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-3.0.4.tgz", + "integrity": "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/mdast-util-definitions": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-definitions/-/mdast-util-definitions-6.0.0.tgz", + "integrity": "sha512-scTllyX6pnYNZH/AIp/0ePz6s4cZtARxImwoPJ7kS42n+MnVsI4XbnG6d4ibehRIldYMWM2LD7ImQblVhUejVQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-directive": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-directive/-/mdast-util-directive-3.1.0.tgz", + "integrity": "sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0", + "parse-entities": "^4.0.0", + "stringify-entities": "^4.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-find-and-replace": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/mdast-util-find-and-replace/-/mdast-util-find-and-replace-3.0.2.tgz", + "integrity": "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "escape-string-regexp": "^5.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-from-markdown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-2.0.2.tgz", + "integrity": "sha512-uZhTV/8NBuw0WHkPTrCqDOl0zVe1BIng5ZtHoDk49ME1qqcjYmmLmOf0gELgcRMxN4w2iuIeVso5/6QymSrgmA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "mdast-util-to-string": "^4.0.0", + "micromark": "^4.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-decode-string": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm/-/mdast-util-gfm-3.1.0.tgz", + "integrity": "sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==", + "license": "MIT", + "dependencies": { + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-gfm-autolink-literal": "^2.0.0", + "mdast-util-gfm-footnote": "^2.0.0", + "mdast-util-gfm-strikethrough": "^2.0.0", + "mdast-util-gfm-table": "^2.0.0", + "mdast-util-gfm-task-list-item": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-autolink-literal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-autolink-literal/-/mdast-util-gfm-autolink-literal-2.0.1.tgz", + "integrity": "sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "ccount": "^2.0.0", + "devlop": "^1.0.0", + "mdast-util-find-and-replace": "^3.0.0", + "micromark-util-character": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-footnote/-/mdast-util-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.1.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-strikethrough": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-strikethrough/-/mdast-util-gfm-strikethrough-2.0.0.tgz", + "integrity": "sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-table": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-table/-/mdast-util-gfm-table-2.0.0.tgz", + "integrity": "sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "markdown-table": "^3.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-gfm-task-list-item": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-gfm-task-list-item/-/mdast-util-gfm-task-list-item-2.0.0.tgz", + "integrity": "sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdx": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-mdx/-/mdast-util-mdx-3.0.0.tgz", + "integrity": "sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==", + "license": "MIT", + "dependencies": { + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-mdx-expression": "^2.0.0", + "mdast-util-mdx-jsx": "^3.0.0", + "mdast-util-mdxjs-esm": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdx-expression": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-mdx-expression/-/mdast-util-mdx-expression-2.0.1.tgz", + "integrity": "sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdx-jsx": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/mdast-util-mdx-jsx/-/mdast-util-mdx-jsx-3.2.0.tgz", + "integrity": "sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "devlop": "^1.1.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0", + "parse-entities": "^4.0.0", + "stringify-entities": "^4.0.0", + "unist-util-stringify-position": "^4.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-mdxjs-esm": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mdast-util-mdxjs-esm/-/mdast-util-mdxjs-esm-2.0.1.tgz", + "integrity": "sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.0", + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "devlop": "^1.0.0", + "mdast-util-from-markdown": "^2.0.0", + "mdast-util-to-markdown": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-phrasing": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/mdast-util-phrasing/-/mdast-util-phrasing-4.1.0.tgz", + "integrity": "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-hast": { + "version": "13.2.1", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", + "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@ungap/structured-clone": "^1.0.0", + "devlop": "^1.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "trim-lines": "^3.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-markdown": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/mdast-util-to-markdown/-/mdast-util-to-markdown-2.1.2.tgz", + "integrity": "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "@types/unist": "^3.0.0", + "longest-streak": "^3.0.0", + "mdast-util-phrasing": "^4.0.0", + "mdast-util-to-string": "^4.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-decode-string": "^2.0.0", + "unist-util-visit": "^5.0.0", + "zwitch": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdast-util-to-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-4.0.0.tgz", + "integrity": "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdn-data": { + "version": "2.12.2", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.12.2.tgz", + "integrity": "sha512-IEn+pegP1aManZuckezWCO+XZQDplx1366JoVhTpMpBB1sPey/SbveZQUosKiKiGYjg1wH4pMlNgXbCiYgihQA==", + "license": "CC0-1.0" + }, + "node_modules/micromark": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz", + "integrity": "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/debug": "^4.0.0", + "debug": "^4.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-core-commonmark": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.3.tgz", + "integrity": "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-factory-destination": "^2.0.0", + "micromark-factory-label": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-factory-title": "^2.0.0", + "micromark-factory-whitespace": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-html-tag-name": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-extension-directive": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/micromark-extension-directive/-/micromark-extension-directive-3.0.2.tgz", + "integrity": "sha512-wjcXHgk+PPdmvR58Le9d7zQYWy+vKEU9Se44p2CrCDPiLr2FMyiT4Fyb5UFKFC66wGB3kPlgD7q3TnoqPS7SZA==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-factory-whitespace": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "parse-entities": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm/-/micromark-extension-gfm-3.0.0.tgz", + "integrity": "sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==", + "license": "MIT", + "dependencies": { + "micromark-extension-gfm-autolink-literal": "^2.0.0", + "micromark-extension-gfm-footnote": "^2.0.0", + "micromark-extension-gfm-strikethrough": "^2.0.0", + "micromark-extension-gfm-table": "^2.0.0", + "micromark-extension-gfm-tagfilter": "^2.0.0", + "micromark-extension-gfm-task-list-item": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-autolink-literal": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz", + "integrity": "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==", + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-strikethrough": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-strikethrough/-/micromark-extension-gfm-strikethrough-2.1.0.tgz", + "integrity": "sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-table": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.1.tgz", + "integrity": "sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-tagfilter": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-tagfilter/-/micromark-extension-gfm-tagfilter-2.0.0.tgz", + "integrity": "sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==", + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-task-list-item": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-task-list-item/-/micromark-extension-gfm-task-list-item-2.1.0.tgz", + "integrity": "sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==", + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-mdx-expression": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/micromark-extension-mdx-expression/-/micromark-extension-mdx-expression-3.0.1.tgz", + "integrity": "sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "devlop": "^1.0.0", + "micromark-factory-mdx-expression": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-events-to-acorn": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-extension-mdx-jsx": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/micromark-extension-mdx-jsx/-/micromark-extension-mdx-jsx-3.0.2.tgz", + "integrity": "sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "devlop": "^1.0.0", + "estree-util-is-identifier-name": "^3.0.0", + "micromark-factory-mdx-expression": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-events-to-acorn": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-mdx-md": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-mdx-md/-/micromark-extension-mdx-md-2.0.0.tgz", + "integrity": "sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==", + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-mdxjs": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-mdxjs/-/micromark-extension-mdxjs-3.0.0.tgz", + "integrity": "sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==", + "license": "MIT", + "dependencies": { + "acorn": "^8.0.0", + "acorn-jsx": "^5.0.0", + "micromark-extension-mdx-expression": "^3.0.0", + "micromark-extension-mdx-jsx": "^3.0.0", + "micromark-extension-mdx-md": "^2.0.0", + "micromark-extension-mdxjs-esm": "^3.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-mdxjs-esm": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-mdxjs-esm/-/micromark-extension-mdxjs-esm-3.0.0.tgz", + "integrity": "sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-events-to-acorn": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unist-util-position-from-estree": "^2.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-factory-destination": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz", + "integrity": "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-label": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz", + "integrity": "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-mdx-expression": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/micromark-factory-mdx-expression/-/micromark-factory-mdx-expression-2.0.3.tgz", + "integrity": "sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-events-to-acorn": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unist-util-position-from-estree": "^2.0.0", + "vfile-message": "^4.0.0" + } + }, + "node_modules/micromark-factory-space": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.0.1.tgz", + "integrity": "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-title": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz", + "integrity": "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-whitespace": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz", + "integrity": "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-character": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz", + "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-chunked": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz", + "integrity": "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-classify-character": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz", + "integrity": "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-combine-extensions": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz", + "integrity": "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-chunked": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-numeric-character-reference": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz", + "integrity": "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-string": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-2.0.1.tgz", + "integrity": "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-encode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz", + "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-events-to-acorn": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/micromark-util-events-to-acorn/-/micromark-util-events-to-acorn-2.0.3.tgz", + "integrity": "sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "@types/unist": "^3.0.0", + "devlop": "^1.0.0", + "estree-util-visit": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "vfile-message": "^4.0.0" + } + }, + "node_modules/micromark-util-html-tag-name": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz", + "integrity": "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-normalize-identifier": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz", + "integrity": "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-resolve-all": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz", + "integrity": "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-sanitize-uri": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz", + "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-subtokenize": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz", + "integrity": "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-symbol": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz", + "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz", + "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/mrmime": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz", + "integrity": "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", + "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/neotraverse": { + "version": "0.6.18", + "resolved": "https://registry.npmjs.org/neotraverse/-/neotraverse-0.6.18.tgz", + "integrity": "sha512-Z4SmBUweYa09+o6pG+eASabEpP6QkQ70yHj351pQoEXIs8uHbaU2DWVmzBANKgflPa47A50PtB2+NgRpQvr7vA==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/nlcst-to-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/nlcst-to-string/-/nlcst-to-string-4.0.0.tgz", + "integrity": "sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/node-fetch-native": { + "version": "1.6.7", + "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.7.tgz", + "integrity": "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==", + "license": "MIT" + }, + "node_modules/node-mock-http": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.4.tgz", + "integrity": "sha512-8DY+kFsDkNXy1sJglUfuODx1/opAGJGyrTuFqEoN90oRc2Vk0ZbD4K2qmKXBBEhZQzdKHIVfEJpDU8Ak2NJEvQ==", + "license": "MIT" + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/nth-check": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz", + "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0" + }, + "funding": { + "url": "https://github.com/fb55/nth-check?sponsor=1" + } + }, + "node_modules/ofetch": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.5.1.tgz", + "integrity": "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==", + "license": "MIT", + "dependencies": { + "destr": "^2.0.5", + "node-fetch-native": "^1.6.7", + "ufo": "^1.6.1" + } + }, + "node_modules/ohash": { + "version": "2.0.11", + "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.11.tgz", + "integrity": "sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==", + "license": "MIT" + }, + "node_modules/oniguruma-parser": { + "version": "0.12.1", + "resolved": "https://registry.npmjs.org/oniguruma-parser/-/oniguruma-parser-0.12.1.tgz", + "integrity": "sha512-8Unqkvk1RYc6yq2WBYRj4hdnsAxVze8i7iPfQr8e4uSP3tRv0rpZcbGUDvxfQQcdwHt/e9PrMvGCsa8OqG9X3w==", + "license": "MIT" + }, + "node_modules/oniguruma-to-es": { + "version": "4.3.4", + "resolved": "https://registry.npmjs.org/oniguruma-to-es/-/oniguruma-to-es-4.3.4.tgz", + "integrity": "sha512-3VhUGN3w2eYxnTzHn+ikMI+fp/96KoRSVK9/kMTcFqj1NRDh2IhQCKvYxDnWePKRXY/AqH+Fuiyb7VHSzBjHfA==", + "license": "MIT", + "dependencies": { + "oniguruma-parser": "^0.12.1", + "regex": "^6.0.1", + "regex-recursion": "^6.0.2" + } + }, + "node_modules/p-limit": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-6.2.0.tgz", + "integrity": "sha512-kuUqqHNUqoIWp/c467RI4X6mmyuojY5jGutNU0wVTmEOOfcuwLqyMVoAi9MKi2Ak+5i9+nhmrK4ufZE8069kHA==", + "license": "MIT", + "dependencies": { + "yocto-queue": "^1.1.1" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-queue": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/p-queue/-/p-queue-8.1.1.tgz", + "integrity": "sha512-aNZ+VfjobsWryoiPnEApGGmf5WmNsCo9xu8dfaYamG5qaLP7ClhLN6NgsFe6SwJ2UbLEBK5dv9x8Mn5+RVhMWQ==", + "license": "MIT", + "dependencies": { + "eventemitter3": "^5.0.1", + "p-timeout": "^6.1.2" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-timeout": { + "version": "6.1.4", + "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-6.1.4.tgz", + "integrity": "sha512-MyIV3ZA/PmyBN/ud8vV9XzwTrNtR4jFrObymZYnZqMmW0zA8Z17vnT0rBgFE/TlohB+YCHqXMgZzb3Csp49vqg==", + "license": "MIT", + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/package-manager-detector": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.6.0.tgz", + "integrity": "sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==", + "license": "MIT" + }, + "node_modules/pagefind": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/pagefind/-/pagefind-1.4.0.tgz", + "integrity": "sha512-z2kY1mQlL4J8q5EIsQkLzQjilovKzfNVhX8De6oyE6uHpfFtyBaqUpcl/XzJC/4fjD8vBDyh1zolimIcVrCn9g==", + "license": "MIT", + "bin": { + "pagefind": "lib/runner/bin.cjs" + }, + "optionalDependencies": { + "@pagefind/darwin-arm64": "1.4.0", + "@pagefind/darwin-x64": "1.4.0", + "@pagefind/freebsd-x64": "1.4.0", + "@pagefind/linux-arm64": "1.4.0", + "@pagefind/linux-x64": "1.4.0", + "@pagefind/windows-x64": "1.4.0" + } + }, + "node_modules/parse-entities": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz", + "integrity": "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^2.0.0", + "character-entities-legacy": "^3.0.0", + "character-reference-invalid": "^2.0.0", + "decode-named-character-reference": "^1.0.0", + "is-alphanumerical": "^2.0.0", + "is-decimal": "^2.0.0", + "is-hexadecimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/parse-entities/node_modules/@types/unist": { + "version": "2.0.11", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz", + "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==", + "license": "MIT" + }, + "node_modules/parse-latin": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/parse-latin/-/parse-latin-7.0.0.tgz", + "integrity": "sha512-mhHgobPPua5kZ98EF4HWiH167JWBfl4pvAIXXdbaVohtK7a6YBOy56kvhCqduqyo/f3yrHFWmqmiMg/BkBkYYQ==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "@types/unist": "^3.0.0", + "nlcst-to-string": "^4.0.0", + "unist-util-modify-children": "^4.0.0", + "unist-util-visit-children": "^3.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/parse5": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz", + "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==", + "license": "MIT", + "dependencies": { + "entities": "^6.0.0" + }, + "funding": { + "url": "https://github.com/inikulin/parse5?sponsor=1" + } + }, + "node_modules/piccolore": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/piccolore/-/piccolore-0.1.3.tgz", + "integrity": "sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==", + "license": "ISC" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.6", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz", + "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/postcss-nested": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.2.0.tgz", + "integrity": "sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "postcss-selector-parser": "^6.1.1" + }, + "engines": { + "node": ">=12.0" + }, + "peerDependencies": { + "postcss": "^8.2.14" + } + }, + "node_modules/postcss-selector-parser": { + "version": "6.1.2", + "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz", + "integrity": "sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==", + "license": "MIT", + "dependencies": { + "cssesc": "^3.0.0", + "util-deprecate": "^1.0.2" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/prismjs": { + "version": "1.30.0", + "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", + "integrity": "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "license": "MIT", + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/property-information": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.1.0.tgz", + "integrity": "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/radix3": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/radix3/-/radix3-1.1.2.tgz", + "integrity": "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==", + "license": "MIT" + }, + "node_modules/readdirp": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.0.0.tgz", + "integrity": "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ==", + "license": "MIT", + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/recma-build-jsx": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/recma-build-jsx/-/recma-build-jsx-1.0.0.tgz", + "integrity": "sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-util-build-jsx": "^3.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/recma-jsx": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/recma-jsx/-/recma-jsx-1.0.1.tgz", + "integrity": "sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==", + "license": "MIT", + "dependencies": { + "acorn-jsx": "^5.0.0", + "estree-util-to-js": "^2.0.0", + "recma-parse": "^1.0.0", + "recma-stringify": "^1.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + }, + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/recma-parse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/recma-parse/-/recma-parse-1.0.0.tgz", + "integrity": "sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "esast-util-from-js": "^2.0.0", + "unified": "^11.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/recma-stringify": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/recma-stringify/-/recma-stringify-1.0.0.tgz", + "integrity": "sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "estree-util-to-js": "^2.0.0", + "unified": "^11.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz", + "integrity": "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-recursion": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/regex-recursion/-/regex-recursion-6.0.2.tgz", + "integrity": "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-utilities": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/regex-utilities/-/regex-utilities-2.3.0.tgz", + "integrity": "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==", + "license": "MIT" + }, + "node_modules/rehype": { + "version": "13.0.2", + "resolved": "https://registry.npmjs.org/rehype/-/rehype-13.0.2.tgz", + "integrity": "sha512-j31mdaRFrwFRUIlxGeuPXXKWQxet52RBQRvCmzl5eCefn/KGbomK5GMHNMsOJf55fgo3qw5tST5neDuarDYR2A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "rehype-parse": "^9.0.0", + "rehype-stringify": "^10.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-expressive-code": { + "version": "0.41.6", + "resolved": "https://registry.npmjs.org/rehype-expressive-code/-/rehype-expressive-code-0.41.6.tgz", + "integrity": "sha512-aBMX8kxPtjmDSFUdZlAWJkMvsQ4ZMASfee90JWIAV8tweltXLzkWC3q++43ToTelI8ac5iC0B3/S/Cl4Ql1y2g==", + "license": "MIT", + "dependencies": { + "expressive-code": "^0.41.6" + } + }, + "node_modules/rehype-format": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/rehype-format/-/rehype-format-5.0.1.tgz", + "integrity": "sha512-zvmVru9uB0josBVpr946OR8ui7nJEdzZobwLOOqHb/OOD88W0Vk2SqLwoVOj0fM6IPCCO6TaV9CvQvJMWwukFQ==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-format": "^1.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-parse": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/rehype-parse/-/rehype-parse-9.0.1.tgz", + "integrity": "sha512-ksCzCD0Fgfh7trPDxr2rSylbwq9iYDkSn8TCDmEJ49ljEUBxDVCzCHv7QNzZOfODanX4+bWQ4WZqLCRWYLfhag==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-from-html": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-raw": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/rehype-raw/-/rehype-raw-7.0.0.tgz", + "integrity": "sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-raw": "^9.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-recma": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/rehype-recma/-/rehype-recma-1.0.0.tgz", + "integrity": "sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==", + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0", + "@types/hast": "^3.0.0", + "hast-util-to-estree": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rehype-stringify": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/rehype-stringify/-/rehype-stringify-10.0.1.tgz", + "integrity": "sha512-k9ecfXHmIPuFVI61B9DeLPN0qFHfawM6RsuX48hoqlaKSF61RskNjSm1lI8PhBEM0MRdLxVVm4WmTqJQccH9mA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "hast-util-to-html": "^9.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-directive": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/remark-directive/-/remark-directive-3.0.1.tgz", + "integrity": "sha512-gwglrEQEZcZYgVyG1tQuA+h58EZfq5CSULw7J90AFuCTyib1thgHPoqQ+h9iFvU6R+vnZ5oNFQR5QKgGpk741A==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-directive": "^3.0.0", + "micromark-extension-directive": "^3.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-gfm": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/remark-gfm/-/remark-gfm-4.0.1.tgz", + "integrity": "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-gfm": "^3.0.0", + "micromark-extension-gfm": "^3.0.0", + "remark-parse": "^11.0.0", + "remark-stringify": "^11.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-mdx": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/remark-mdx/-/remark-mdx-3.1.1.tgz", + "integrity": "sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==", + "license": "MIT", + "dependencies": { + "mdast-util-mdx": "^3.0.0", + "micromark-extension-mdxjs": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-parse": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-11.0.0.tgz", + "integrity": "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-from-markdown": "^2.0.0", + "micromark-util-types": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-rehype": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/remark-rehype/-/remark-rehype-11.1.2.tgz", + "integrity": "sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "mdast-util-to-hast": "^13.0.0", + "unified": "^11.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/remark-smartypants": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/remark-smartypants/-/remark-smartypants-3.0.2.tgz", + "integrity": "sha512-ILTWeOriIluwEvPjv67v7Blgrcx+LZOkAUVtKI3putuhlZm84FnqDORNXPPm+HY3NdZOMhyDwZ1E+eZB/Df5dA==", + "license": "MIT", + "dependencies": { + "retext": "^9.0.0", + "retext-smartypants": "^6.0.0", + "unified": "^11.0.4", + "unist-util-visit": "^5.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/remark-stringify": { + "version": "11.0.0", + "resolved": "https://registry.npmjs.org/remark-stringify/-/remark-stringify-11.0.0.tgz", + "integrity": "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==", + "license": "MIT", + "dependencies": { + "@types/mdast": "^4.0.0", + "mdast-util-to-markdown": "^2.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/retext/-/retext-9.0.0.tgz", + "integrity": "sha512-sbMDcpHCNjvlheSgMfEcVrZko3cDzdbe1x/e7G66dFp0Ff7Mldvi2uv6JkJQzdRcvLYE8CA8Oe8siQx8ZOgTcA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "retext-latin": "^4.0.0", + "retext-stringify": "^4.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext-latin": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/retext-latin/-/retext-latin-4.0.0.tgz", + "integrity": "sha512-hv9woG7Fy0M9IlRQloq/N6atV82NxLGveq+3H2WOi79dtIYWN8OaxogDm77f8YnVXJL2VD3bbqowu5E3EMhBYA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "parse-latin": "^7.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext-smartypants": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/retext-smartypants/-/retext-smartypants-6.2.0.tgz", + "integrity": "sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "nlcst-to-string": "^4.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/retext-stringify": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/retext-stringify/-/retext-stringify-4.0.0.tgz", + "integrity": "sha512-rtfN/0o8kL1e+78+uxPTqu1Klt0yPzKuQ2BfWwwfgIUSayyzxpM1PJzkKt4V8803uB9qSy32MvI7Xep9khTpiA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "nlcst-to-string": "^4.0.0", + "unified": "^11.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rollup": { + "version": "4.57.1", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.57.1.tgz", + "integrity": "sha512-oQL6lgK3e2QZeQ7gcgIkS2YZPg5slw37hYufJ3edKlfQSGGm8ICoxswK15ntSzF/a8+h7ekRy7k7oWc3BQ7y8A==", + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.57.1", + "@rollup/rollup-android-arm64": "4.57.1", + "@rollup/rollup-darwin-arm64": "4.57.1", + "@rollup/rollup-darwin-x64": "4.57.1", + "@rollup/rollup-freebsd-arm64": "4.57.1", + "@rollup/rollup-freebsd-x64": "4.57.1", + "@rollup/rollup-linux-arm-gnueabihf": "4.57.1", + "@rollup/rollup-linux-arm-musleabihf": "4.57.1", + "@rollup/rollup-linux-arm64-gnu": "4.57.1", + "@rollup/rollup-linux-arm64-musl": "4.57.1", + "@rollup/rollup-linux-loong64-gnu": "4.57.1", + "@rollup/rollup-linux-loong64-musl": "4.57.1", + "@rollup/rollup-linux-ppc64-gnu": "4.57.1", + "@rollup/rollup-linux-ppc64-musl": "4.57.1", + "@rollup/rollup-linux-riscv64-gnu": "4.57.1", + "@rollup/rollup-linux-riscv64-musl": "4.57.1", + "@rollup/rollup-linux-s390x-gnu": "4.57.1", + "@rollup/rollup-linux-x64-gnu": "4.57.1", + "@rollup/rollup-linux-x64-musl": "4.57.1", + "@rollup/rollup-openbsd-x64": "4.57.1", + "@rollup/rollup-openharmony-arm64": "4.57.1", + "@rollup/rollup-win32-arm64-msvc": "4.57.1", + "@rollup/rollup-win32-ia32-msvc": "4.57.1", + "@rollup/rollup-win32-x64-gnu": "4.57.1", + "@rollup/rollup-win32-x64-msvc": "4.57.1", + "fsevents": "~2.3.2" + } + }, + "node_modules/sax": { + "version": "1.4.4", + "resolved": "https://registry.npmjs.org/sax/-/sax-1.4.4.tgz", + "integrity": "sha512-1n3r/tGXO6b6VXMdFT54SHzT9ytu9yr7TaELowdYpMqY/Ao7EnlQGmAQ1+RatX7Tkkdm6hONI2owqNx2aZj5Sw==", + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=11.0.0" + } + }, + "node_modules/semver": { + "version": "7.7.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", + "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/sharp": { + "version": "0.33.5", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.33.5.tgz", + "integrity": "sha512-haPVm1EkS9pgvHrQ/F3Xy+hgcuMV0Wm9vfIBSiwZ05k+xgb0PkBQpGsAA/oWdDobNaZTH5ppvHtzCFbnSEwHVw==", + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "color": "^4.2.3", + "detect-libc": "^2.0.3", + "semver": "^7.6.3" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.33.5", + "@img/sharp-darwin-x64": "0.33.5", + "@img/sharp-libvips-darwin-arm64": "1.0.4", + "@img/sharp-libvips-darwin-x64": "1.0.4", + "@img/sharp-libvips-linux-arm": "1.0.5", + "@img/sharp-libvips-linux-arm64": "1.0.4", + "@img/sharp-libvips-linux-s390x": "1.0.4", + "@img/sharp-libvips-linux-x64": "1.0.4", + "@img/sharp-libvips-linuxmusl-arm64": "1.0.4", + "@img/sharp-libvips-linuxmusl-x64": "1.0.4", + "@img/sharp-linux-arm": "0.33.5", + "@img/sharp-linux-arm64": "0.33.5", + "@img/sharp-linux-s390x": "0.33.5", + "@img/sharp-linux-x64": "0.33.5", + "@img/sharp-linuxmusl-arm64": "0.33.5", + "@img/sharp-linuxmusl-x64": "0.33.5", + "@img/sharp-wasm32": "0.33.5", + "@img/sharp-win32-ia32": "0.33.5", + "@img/sharp-win32-x64": "0.33.5" + } + }, + "node_modules/shiki": { + "version": "3.22.0", + "resolved": "https://registry.npmjs.org/shiki/-/shiki-3.22.0.tgz", + "integrity": "sha512-LBnhsoYEe0Eou4e1VgJACes+O6S6QC0w71fCSp5Oya79inkwkm15gQ1UF6VtQ8j/taMDh79hAB49WUk8ALQW3g==", + "license": "MIT", + "dependencies": { + "@shikijs/core": "3.22.0", + "@shikijs/engine-javascript": "3.22.0", + "@shikijs/engine-oniguruma": "3.22.0", + "@shikijs/langs": "3.22.0", + "@shikijs/themes": "3.22.0", + "@shikijs/types": "3.22.0", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.4" + } + }, + "node_modules/simple-swizzle": { + "version": "0.2.4", + "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.4.tgz", + "integrity": "sha512-nAu1WFPQSMNr2Zn9PGSZK9AGn4t/y97lEm+MXTtUDwfP0ksAIX4nO+6ruD9Jwut4C49SB1Ws+fbXsm/yScWOHw==", + "license": "MIT", + "dependencies": { + "is-arrayish": "^0.3.1" + } + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "license": "MIT" + }, + "node_modules/sitemap": { + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/sitemap/-/sitemap-8.0.2.tgz", + "integrity": "sha512-LwktpJcyZDoa0IL6KT++lQ53pbSrx2c9ge41/SeLTyqy2XUNA6uR4+P9u5IVo5lPeL2arAcOKn1aZAxoYbCKlQ==", + "license": "MIT", + "dependencies": { + "@types/node": "^17.0.5", + "@types/sax": "^1.2.1", + "arg": "^5.0.0", + "sax": "^1.4.1" + }, + "bin": { + "sitemap": "dist/cli.js" + }, + "engines": { + "node": ">=14.0.0", + "npm": ">=6.0.0" + } + }, + "node_modules/sitemap/node_modules/@types/node": { + "version": "17.0.45", + "resolved": "https://registry.npmjs.org/@types/node/-/node-17.0.45.tgz", + "integrity": "sha512-w+tIMs3rq2afQdsPJlODhoUEKzFP1ayaoyl1CcnwtIlsVe7K7bA1NGm4s3PraqTLlXnbIN84zuBlxBWo1u9BLw==", + "license": "MIT" + }, + "node_modules/smol-toml": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.6.0.tgz", + "integrity": "sha512-4zemZi0HvTnYwLfrpk/CF9LOd9Lt87kAt50GnqhMpyF9U3poDAP2+iukq2bZsO/ufegbYehBkqINbsWxj4l4cw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 18" + }, + "funding": { + "url": "https://github.com/sponsors/cyyynthia" + } + }, + "node_modules/source-map": { + "version": "0.7.6", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz", + "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 12" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/space-separated-tokens": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz", + "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/starlight-image-zoom": { + "version": "0.13.2", + "resolved": "https://registry.npmjs.org/starlight-image-zoom/-/starlight-image-zoom-0.13.2.tgz", + "integrity": "sha512-fDJrx+UZXhkbhEeXKoRogTKAYtrYVJPw6wmSUI3nHUTA0vuRM6EI//2Z8bzv3Ecvz0pHKD1vAxtS01mLyessBA==", + "license": "MIT", + "dependencies": { + "mdast-util-mdx-jsx": "^3.1.3", + "rehype-raw": "^7.0.0", + "unist-util-visit": "^5.0.0", + "unist-util-visit-parents": "^6.0.1" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "@astrojs/starlight": ">=0.32.0" + } + }, + "node_modules/starlight-links-validator": { + "version": "0.19.2", + "resolved": "https://registry.npmjs.org/starlight-links-validator/-/starlight-links-validator-0.19.2.tgz", + "integrity": "sha512-IHeK3R78fsmv53VfRkGbXkwK1CQEUBHM9QPzBEyoAxjZ/ssi5gjV+F4oNNUppTR48iPp+lEY0MTAmvkX7yNnkw==", + "license": "MIT", + "dependencies": { + "@types/picomatch": "^3.0.1", + "github-slugger": "^2.0.0", + "hast-util-from-html": "^2.0.3", + "hast-util-has-property": "^3.0.0", + "is-absolute-url": "^4.0.1", + "kleur": "^4.1.5", + "mdast-util-mdx-jsx": "^3.1.3", + "mdast-util-to-string": "^4.0.0", + "picomatch": "^4.0.2", + "terminal-link": "^5.0.0", + "unist-util-visit": "^5.0.0" + }, + "engines": { + "node": ">=18.17.1" + }, + "peerDependencies": { + "@astrojs/starlight": ">=0.32.0", + "astro": ">=5.1.5" + } + }, + "node_modules/starlight-links-validator/node_modules/kleur": { + "version": "4.1.5", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz", + "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/stream-replace-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/stream-replace-string/-/stream-replace-string-2.0.0.tgz", + "integrity": "sha512-TlnjJ1C0QrmxRNrON00JvaFFlNh5TTG00APw23j74ET7gkQpTASi6/L2fuiav8pzK715HXtUeClpBTw2NPSn6w==", + "license": "MIT" + }, + "node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/stringify-entities": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz", + "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==", + "license": "MIT", + "dependencies": { + "character-entities-html4": "^2.0.0", + "character-entities-legacy": "^3.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/strip-ansi": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz", + "integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/style-to-js": { + "version": "1.1.21", + "resolved": "https://registry.npmjs.org/style-to-js/-/style-to-js-1.1.21.tgz", + "integrity": "sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==", + "license": "MIT", + "dependencies": { + "style-to-object": "1.0.14" + } + }, + "node_modules/style-to-object": { + "version": "1.0.14", + "resolved": "https://registry.npmjs.org/style-to-object/-/style-to-object-1.0.14.tgz", + "integrity": "sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==", + "license": "MIT", + "dependencies": { + "inline-style-parser": "0.2.7" + } + }, + "node_modules/supports-color": { + "version": "10.2.2", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-10.2.2.tgz", + "integrity": "sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/supports-hyperlinks": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/supports-hyperlinks/-/supports-hyperlinks-4.4.0.tgz", + "integrity": "sha512-UKbpT93hN5Nr9go5UY7bopIB9YQlMz9nm/ct4IXt/irb5YRkn9WaqrOBJGZ5Pwvsd5FQzSVeYlGdXoCAPQZrPg==", + "license": "MIT", + "dependencies": { + "has-flag": "^5.0.1", + "supports-color": "^10.2.2" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/chalk/supports-hyperlinks?sponsor=1" + } + }, + "node_modules/svgo": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/svgo/-/svgo-4.0.0.tgz", + "integrity": "sha512-VvrHQ+9uniE+Mvx3+C9IEe/lWasXCU0nXMY2kZeLrHNICuRiC8uMPyM14UEaMOFA5mhyQqEkB02VoQ16n3DLaw==", + "license": "MIT", + "dependencies": { + "commander": "^11.1.0", + "css-select": "^5.1.0", + "css-tree": "^3.0.1", + "css-what": "^6.1.0", + "csso": "^5.0.5", + "picocolors": "^1.1.1", + "sax": "^1.4.1" + }, + "bin": { + "svgo": "bin/svgo.js" + }, + "engines": { + "node": ">=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/svgo" + } + }, + "node_modules/terminal-link": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/terminal-link/-/terminal-link-5.0.0.tgz", + "integrity": "sha512-qFAy10MTMwjzjU8U16YS4YoZD+NQLHzLssFMNqgravjbvIPNiqkGFR4yjhJfmY9R5OFU7+yHxc6y+uGHkKwLRA==", + "license": "MIT", + "dependencies": { + "ansi-escapes": "^7.0.0", + "supports-hyperlinks": "^4.1.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/tiny-inflate": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz", + "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==", + "license": "MIT" + }, + "node_modules/tinyexec": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.0.2.tgz", + "integrity": "sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg==", + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/trim-lines": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz", + "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/trough": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz", + "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/tsconfck": { + "version": "3.1.6", + "resolved": "https://registry.npmjs.org/tsconfck/-/tsconfck-3.1.6.tgz", + "integrity": "sha512-ks6Vjr/jEw0P1gmOVwutM3B7fWxoWBL2KRDb1JfqGVawBmO5UsvmWOQFGHBPl5yxYz4eERr19E6L7NMv+Fej4w==", + "license": "MIT", + "bin": { + "tsconfck": "bin/tsconfck.js" + }, + "engines": { + "node": "^18 || >=20" + }, + "peerDependencies": { + "typescript": "^5.0.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD", + "optional": true + }, + "node_modules/type-fest": { + "version": "4.41.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz", + "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==", + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "license": "Apache-2.0", + "peer": true, + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/ufo": { + "version": "1.6.3", + "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.3.tgz", + "integrity": "sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==", + "license": "MIT" + }, + "node_modules/ultrahtml": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/ultrahtml/-/ultrahtml-1.6.0.tgz", + "integrity": "sha512-R9fBn90VTJrqqLDwyMph+HGne8eqY1iPfYhPzZrvKpIfwkWZbcYlfpsb8B9dTvBfpy1/hqAD7Wi8EKfP9e8zdw==", + "license": "MIT" + }, + "node_modules/uncrypto": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/uncrypto/-/uncrypto-0.1.3.tgz", + "integrity": "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==", + "license": "MIT" + }, + "node_modules/undici-types": { + "version": "7.16.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz", + "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==", + "license": "MIT" + }, + "node_modules/unified": { + "version": "11.0.5", + "resolved": "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz", + "integrity": "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "bail": "^2.0.0", + "devlop": "^1.0.0", + "extend": "^3.0.0", + "is-plain-obj": "^4.0.0", + "trough": "^2.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unifont": { + "version": "0.7.3", + "resolved": "https://registry.npmjs.org/unifont/-/unifont-0.7.3.tgz", + "integrity": "sha512-b0GtQzKCyuSHGsfj5vyN8st7muZ6VCI4XD4vFlr7Uy1rlWVYxC3npnfk8MyreHxJYrz1ooLDqDzFe9XqQTlAhA==", + "license": "MIT", + "dependencies": { + "css-tree": "^3.1.0", + "ofetch": "^1.5.1", + "ohash": "^2.0.11" + } + }, + "node_modules/unist-util-find-after": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-find-after/-/unist-util-find-after-5.0.0.tgz", + "integrity": "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-is": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz", + "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-modify-children": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-modify-children/-/unist-util-modify-children-4.0.0.tgz", + "integrity": "sha512-+tdN5fGNddvsQdIzUF3Xx82CU9sMM+fA0dLgR9vOmT0oPT2jH+P1nd5lSqfCfXAw+93NhcXNY2qqvTUtE4cQkw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "array-iterate": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz", + "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-position-from-estree": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unist-util-position-from-estree/-/unist-util-position-from-estree-2.0.0.tgz", + "integrity": "sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-remove-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-remove-position/-/unist-util-remove-position-5.0.0.tgz", + "integrity": "sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-stringify-position": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz", + "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz", + "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-children": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/unist-util-visit-children/-/unist-util-visit-children-3.0.0.tgz", + "integrity": "sha512-RgmdTfSBOg04sdPcpTSD1jzoNBjt9a80/ZCzp5cI9n1qPzLZWF9YdvWGN2zmTumP1HWhXKdUWexjy/Wy/lJ7tA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-parents": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz", + "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unstorage": { + "version": "1.17.4", + "resolved": "https://registry.npmjs.org/unstorage/-/unstorage-1.17.4.tgz", + "integrity": "sha512-fHK0yNg38tBiJKp/Vgsq4j0JEsCmgqH58HAn707S7zGkArbZsVr/CwINoi+nh3h98BRCwKvx1K3Xg9u3VV83sw==", + "license": "MIT", + "dependencies": { + "anymatch": "^3.1.3", + "chokidar": "^5.0.0", + "destr": "^2.0.5", + "h3": "^1.15.5", + "lru-cache": "^11.2.0", + "node-fetch-native": "^1.6.7", + "ofetch": "^1.5.1", + "ufo": "^1.6.3" + }, + "peerDependencies": { + "@azure/app-configuration": "^1.8.0", + "@azure/cosmos": "^4.2.0", + "@azure/data-tables": "^13.3.0", + "@azure/identity": "^4.6.0", + "@azure/keyvault-secrets": "^4.9.0", + "@azure/storage-blob": "^12.26.0", + "@capacitor/preferences": "^6 || ^7 || ^8", + "@deno/kv": ">=0.9.0", + "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0", + "@planetscale/database": "^1.19.0", + "@upstash/redis": "^1.34.3", + "@vercel/blob": ">=0.27.1", + "@vercel/functions": "^2.2.12 || ^3.0.0", + "@vercel/kv": "^1 || ^2 || ^3", + "aws4fetch": "^1.0.20", + "db0": ">=0.2.1", + "idb-keyval": "^6.2.1", + "ioredis": "^5.4.2", + "uploadthing": "^7.4.4" + }, + "peerDependenciesMeta": { + "@azure/app-configuration": { + "optional": true + }, + "@azure/cosmos": { + "optional": true + }, + "@azure/data-tables": { + "optional": true + }, + "@azure/identity": { + "optional": true + }, + "@azure/keyvault-secrets": { + "optional": true + }, + "@azure/storage-blob": { + "optional": true + }, + "@capacitor/preferences": { + "optional": true + }, + "@deno/kv": { + "optional": true + }, + "@netlify/blobs": { + "optional": true + }, + "@planetscale/database": { + "optional": true + }, + "@upstash/redis": { + "optional": true + }, + "@vercel/blob": { + "optional": true + }, + "@vercel/functions": { + "optional": true + }, + "@vercel/kv": { + "optional": true + }, + "aws4fetch": { + "optional": true + }, + "db0": { + "optional": true + }, + "idb-keyval": { + "optional": true + }, + "ioredis": { + "optional": true + }, + "uploadthing": { + "optional": true + } + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT" + }, + "node_modules/vfile": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz", + "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-location": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/vfile-location/-/vfile-location-5.0.3.tgz", + "integrity": "sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-message": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz", + "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vite": { + "version": "6.4.1", + "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.1.tgz", + "integrity": "sha512-+Oxm7q9hDoLMyJOYfUYBuHQo+dkAloi33apOPP56pzj+vsdJDzr+j1NISE5pyaAuKL4A3UD34qd0lx5+kfKp2g==", + "license": "MIT", + "dependencies": { + "esbuild": "^0.25.0", + "fdir": "^6.4.4", + "picomatch": "^4.0.2", + "postcss": "^8.5.3", + "rollup": "^4.34.9", + "tinyglobby": "^0.2.13" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || ^20.0.0 || >=22.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0", + "jiti": ">=1.21.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vite/node_modules/@esbuild/aix-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz", + "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/android-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz", + "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/android-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz", + "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/android-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz", + "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/darwin-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz", + "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/darwin-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz", + "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/freebsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz", + "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/freebsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz", + "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-arm": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz", + "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz", + "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz", + "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-loong64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz", + "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-mips64el": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz", + "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==", + "cpu": [ + "mips64el" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-ppc64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz", + "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-riscv64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz", + "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-s390x": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz", + "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/linux-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz", + "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/netbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz", + "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/netbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz", + "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/openbsd-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz", + "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/openbsd-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz", + "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/openharmony-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz", + "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/sunos-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz", + "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/win32-arm64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz", + "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/win32-ia32": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz", + "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/@esbuild/win32-x64": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz", + "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/vite/node_modules/esbuild": { + "version": "0.25.12", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz", + "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==", + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.25.12", + "@esbuild/android-arm": "0.25.12", + "@esbuild/android-arm64": "0.25.12", + "@esbuild/android-x64": "0.25.12", + "@esbuild/darwin-arm64": "0.25.12", + "@esbuild/darwin-x64": "0.25.12", + "@esbuild/freebsd-arm64": "0.25.12", + "@esbuild/freebsd-x64": "0.25.12", + "@esbuild/linux-arm": "0.25.12", + "@esbuild/linux-arm64": "0.25.12", + "@esbuild/linux-ia32": "0.25.12", + "@esbuild/linux-loong64": "0.25.12", + "@esbuild/linux-mips64el": "0.25.12", + "@esbuild/linux-ppc64": "0.25.12", + "@esbuild/linux-riscv64": "0.25.12", + "@esbuild/linux-s390x": "0.25.12", + "@esbuild/linux-x64": "0.25.12", + "@esbuild/netbsd-arm64": "0.25.12", + "@esbuild/netbsd-x64": "0.25.12", + "@esbuild/openbsd-arm64": "0.25.12", + "@esbuild/openbsd-x64": "0.25.12", + "@esbuild/openharmony-arm64": "0.25.12", + "@esbuild/sunos-x64": "0.25.12", + "@esbuild/win32-arm64": "0.25.12", + "@esbuild/win32-ia32": "0.25.12", + "@esbuild/win32-x64": "0.25.12" + } + }, + "node_modules/vitefu": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/vitefu/-/vitefu-1.1.1.tgz", + "integrity": "sha512-B/Fegf3i8zh0yFbpzZ21amWzHmuNlLlmJT6n7bu5e+pCHUKQIfXSYokrqOBGEMMe9UG2sostKQF9mml/vYaWJQ==", + "license": "MIT", + "workspaces": [ + "tests/deps/*", + "tests/projects/*", + "tests/projects/workspace/packages/*" + ], + "peerDependencies": { + "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0-beta.0" + }, + "peerDependenciesMeta": { + "vite": { + "optional": true + } + } + }, + "node_modules/web-namespaces": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/web-namespaces/-/web-namespaces-2.0.1.tgz", + "integrity": "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/which-pm-runs": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/which-pm-runs/-/which-pm-runs-1.1.0.tgz", + "integrity": "sha512-n1brCuqClxfFfq/Rb0ICg9giSZqCS+pLtccdag6C2HyufBrh3fBOiy9nb6ggRMvWOVH5GrdJskj5iGTZNxd7SA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/widest-line": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-5.0.0.tgz", + "integrity": "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA==", + "license": "MIT", + "dependencies": { + "string-width": "^7.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/xxhash-wasm": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/xxhash-wasm/-/xxhash-wasm-1.1.0.tgz", + "integrity": "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==", + "license": "MIT" + }, + "node_modules/yargs-parser": { + "version": "21.1.1", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", + "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/yocto-queue": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-1.2.2.tgz", + "integrity": "sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==", + "license": "MIT", + "engines": { + "node": ">=12.20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yocto-spinner": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/yocto-spinner/-/yocto-spinner-0.2.3.tgz", + "integrity": "sha512-sqBChb33loEnkoXte1bLg45bEBsOP9N1kzQh5JZNKj/0rik4zAPTNSAVPj3uQAdc6slYJ0Ksc403G2XgxsJQFQ==", + "license": "MIT", + "dependencies": { + "yoctocolors": "^2.1.1" + }, + "engines": { + "node": ">=18.19" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yoctocolors": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.1.2.tgz", + "integrity": "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/zod": { + "version": "3.25.76", + "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz", + "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } + }, + "node_modules/zod-to-json-schema": { + "version": "3.25.1", + "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.25.1.tgz", + "integrity": "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA==", + "license": "ISC", + "peerDependencies": { + "zod": "^3.25 || ^4" + } + }, + "node_modules/zod-to-ts": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/zod-to-ts/-/zod-to-ts-1.2.0.tgz", + "integrity": "sha512-x30XE43V+InwGpvTySRNz9kB7qFU8DlyEy7BsSTCHPH1R0QasMmHWZDCzYm6bVXtj/9NNJAZF3jW8rzFvH5OFA==", + "peerDependencies": { + "typescript": "^4.9.4 || ^5.0.2", + "zod": "^3" + } + }, + "node_modules/zwitch": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", + "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + } + } +} diff --git a/site/package.json b/site/package.json new file mode 100644 index 0000000..0b91813 --- /dev/null +++ b/site/package.json @@ -0,0 +1,19 @@ +{ + "name": "skywalker-1-docs", + "type": "module", + "version": "0.0.1", + "scripts": { + "dev": "astro dev", + "start": "astro dev", + "build": "astro build", + "preview": "astro preview", + "astro": "astro" + }, + "dependencies": { + "astro": "^5.17.2", + "@astrojs/starlight": "^0.37.6", + "sharp": "^0.33.0", + "starlight-image-zoom": "^0.13.2", + "starlight-links-validator": "^0.19.2" + } +} diff --git a/site/public/downloads/DiSEqC for the Skywalker-1.pdf b/site/public/downloads/DiSEqC for the Skywalker-1.pdf new file mode 100644 index 0000000..575bcc0 Binary files /dev/null and b/site/public/downloads/DiSEqC for the Skywalker-1.pdf differ diff --git a/site/src/assets/diagrams/DiSEqC for the Skywalker-1_page_1.svg b/site/src/assets/diagrams/DiSEqC for the Skywalker-1_page_1.svg new file mode 100644 index 0000000..142a674 --- /dev/null +++ b/site/src/assets/diagrams/DiSEqC for the Skywalker-1_page_1.svg @@ -0,0 +1,323 @@ + + + + + + + + + + + + + + + + + + + +DiSEqC for SkyWalker +- +1 + + + + + + + + + + + + + + + + + + +1 + + + + + + +DiSEqC +for the GenPix Skywalker +- +1 BDA Driver + +(Extended) + + +Implementation Guidelines + +for Applications + + +I. + +GUID for the SkyWalker1 +Extended + +property + + +//Used to extend the feature of the BDA + +//{0B5221EB +- +F4C4 +- +4976 +- +B959 +- +EF74427464D9} + +#define + +STATIC_KSPROPSETID_BdaExtendedProperty +\ + + +0x0B5221EB, 0xF4C4, 0x4976, 0xB9, 0x59, 0xEF, 0x74, 0x42, 0x74, 0x64, 0xD9 + +DEFINE_GUIDSTRUCT( +"0B5221EB +- +F4C4 +- +4976 +- +B959 +- +EF74427464D9" +, KSPROPSETID_BdaExtendedProperty); + +#define + +KSPROPSETID_BdaExtendedProperty DEFINE_GUIDNAMED(KSPROPSETID_BdaExtendedProperty) + + +II. + +Extended Prope +rty List + +(Only DiSEqC +support is extended +) + + +//Extended Property List + +typedef + +enum + +__KSPROPERTY_EXTENDED + +{ + +/* DiSEqC Co +mmand */ + +//Used to send the Digital Sattelite Equipment Control (DiSEqC) + +//Commands by application + +KSPROPERTY_BDA_DISEQC = 0, +//Extension Property 1 + +}KSPROPERTY_EXTENDED; + +III. + +Enumeration for the Simple Tone Burst + + +typedef + +enum + +enSimpleToneBurst + +{ + +SEC_MINI_A, + +SEC_MINI_B + +}SIMPLE_TONE_BURST; + +IV. + +DiSEqC Command Structure + + +typedef + +struct + +__DISEQC_COMMAND + +{ + + +UCHAR ucMessage[MAX_DISEQC_COMMAND_LENGTH]; + +/* +Byte +- + +0 : Framing, + + + + + + + + +Byte +- + +1 : Address, + + + + + + + + +Byte +- + +2 : Command, + + + + + + + + +Byte +- + +3 : Data[0], + + + + + + + + +Byte +- + +4 : Data[1], + + + + + + + + +Byte +- + +5 : Data[2] + + + + + + + + +*/ + + +UCHAR ucMessageLength; +/* The Valid values for DiSEqC Command are 3...6 + +If this value is 1 then the Byte 0 is taken as Simple "Tone Burst" +Control + +Command */ + + +}DISEQC_COMMAND,*PDISEQC_COMMAND; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/site/src/assets/diagrams/DiSEqC for the Skywalker-1_page_2.svg b/site/src/assets/diagrams/DiSEqC for the Skywalker-1_page_2.svg new file mode 100644 index 0000000..62544f2 --- /dev/null +++ b/site/src/assets/diagrams/DiSEqC for the Skywalker-1_page_2.svg @@ -0,0 +1,186 @@ + + + + + + + + + + + + + + + + + + + +DiSEqC for SkyWalker +- +1 + + + + + + + + + + + + + + + + + + +2 + + + + + +V. + +Operation: + + +I. + +To send +the +Simple burst comman +d + +a. + +Create the DISEQC_COMMAND Structure + +b. + +Set the ucMessage[0] to either SEC_MINI_A or SEC_MINI_B + +c. + +Set the ucMessageLength as 1 + + +II. + +To send +the DiSEqC +comman +d +s + +a. + +Create the DISEQC_COMMAND Structure + +b. + +Set the +Framing value to +ucMessage[0] +e.g. E0 + +c. + +Set the +Device +Address +to ucMessage[1] e.g. 01 + +d. + +Send the Command for the Device +to ucMessage[2] + +e. + +I +f +require set the Data bytes ucMessage[3], + +ucMessage[ +4 +] +, + +ucMessage[ +5 +] + +f. + +Set the ucMessageLength accordingly.Valid ucMessageLength values are 3 to 6. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/site/src/assets/skywalker-1-hero.jpg b/site/src/assets/skywalker-1-hero.jpg new file mode 100644 index 0000000..9e7ccf0 Binary files /dev/null and b/site/src/assets/skywalker-1-hero.jpg differ diff --git a/site/src/content.config.ts b/site/src/content.config.ts new file mode 100644 index 0000000..7c4d287 --- /dev/null +++ b/site/src/content.config.ts @@ -0,0 +1,6 @@ +import { defineCollection } from 'astro:content'; +import { docsSchema } from '@astrojs/starlight/schema'; + +export const collections = { + docs: defineCollection({ schema: docsSchema() }), +}; diff --git a/site/src/content/docs/bcm4500/demodulator.mdx b/site/src/content/docs/bcm4500/demodulator.mdx new file mode 100644 index 0000000..e86a810 --- /dev/null +++ b/site/src/content/docs/bcm4500/demodulator.mdx @@ -0,0 +1,188 @@ +--- +title: BCM4500 Demodulator Interface +description: Broadcom BCM4500 I2C addressing, register access protocol, and indirect register programming. +--- + +import { Tabs, TabItem, Badge, Aside, Steps } from '@astrojs/starlight/components'; + +The Broadcom BCM4500 is a 128-pin MQFP satellite demodulator that handles RF demodulation, forward error correction, and MPEG-2 transport stream output. The FX2 communicates with it exclusively over the shared I2C bus using an indirect register protocol. + +## I2C Addressing + +| Parameter | Value | +|-----------|-------| +| 7-bit I2C address | 0x08 | +| 8-bit write address | 0x10 | +| 8-bit read address | 0x11 | +| Bus speed | 400 kHz | +| FX2 I2C controller registers | I2CS (0xE678), I2DAT (0xE679), I2CTL (0xE67A) | +| Alternate probe addresses (v2.13) | 0x3F, 0x7F | + +The custom firmware and kernel driver use the 7-bit address 0x08. The stock firmware writes `addr << 1` = 0x10 for write and `(addr << 1) | 1` = 0x11 for read, following standard I2C convention. + + + +## Direct Registers + +These registers are accessed via standard I2C write/read to the BCM4500's device address: + +| Register | Function | Used By | +|----------|----------|---------| +| 0xA2 | Status register (polled for readiness during boot) | Boot probe, signal strength | +| 0xA4 | Lock/ready register; bit 5 (0x20) = signal locked | Signal lock check | +| 0xA6 | Indirect page/address select | Indirect register protocol | +| 0xA7 | Indirect data register (read/write) | Indirect register protocol | +| 0xA8 | Indirect command register | Indirect register protocol | +| 0xF9 | Demod status (v2.13 only) | GET_DEMOD_STATUS (0x99) / INT0 polling | + +## Indirect Register Protocol + +The BCM4500 uses an indirect register access scheme through three directly-addressable registers (0xA6, 0xA7, 0xA8). All tuning configuration, initialization data, and signal monitoring are performed through this protocol. + +### Indirect Write Sequence + + +1. **Page select** -- I2C WRITE to 0x08, register 0xA6 with the page number (typically 0x00). + +2. **Data write** -- I2C WRITE to 0x08, register 0xA7 with N data bytes. The auto-increment feature allows writing multiple bytes in a single I2C transaction. + +3. **Execute** -- I2C WRITE to 0x08, register 0xA8 with value 0x03 (indirect write command). + +4. **Poll completion** -- I2C READ register 0xA8 until bit 0 clears (command complete). + +5. **Verify** -- Optionally I2C READ register 0xA7 to read back and compare. + + +```c title="Indirect Write Protocol" +// Step 1: Page select +I2C WRITE: [START] [0x10] [0xA6] [0x00] [STOP] + +// Step 2: Data write (multi-byte, auto-increment) +I2C WRITE: [START] [0x10] [0xA7] [data0] [data1] ... [dataN] [STOP] + +// Step 3: Execute indirect write +I2C WRITE: [START] [0x10] [0xA8] [0x03] [STOP] + +// Step 4: Poll until complete +I2C READ: [START] [0x10] [0xA8] [Sr] [0x11] [result] [STOP] + // Repeat until (result & 0x01) == 0 +``` + +### Indirect Read Sequence + + +1. **Address select** -- I2C WRITE to 0x08, register 0xA6 with the target register address. + +2. **Placeholder write** -- I2C WRITE to 0x08, register 0xA7 with value 0x00. + +3. **Execute** -- I2C WRITE to 0x08, register 0xA8 with value 0x01 (indirect read command). + +4. **Wait** -- Short delay (~1 ms) for the BCM4500 to fetch the data. + +5. **Read result** -- I2C READ from 0x08, register 0xA7 to get the result byte. + + +### Auto-Increment Behavior + +The BCM4500's data register (0xA7) supports auto-increment for multi-byte writes within a single I2C transaction. When writing N data bytes to 0xA7 without issuing STOP between bytes, the BCM4500 internally advances its data buffer pointer: + +``` +I2C transaction (single write, multiple data bytes): + START -> 0x10 (write) -> 0xA7 (reg) -> data[0] -> data[1] -> ... -> data[N-1] -> STOP +``` + +The firmware uses this for initialization blocks and tuning data, reducing I2C bus overhead compared to byte-by-byte writes. + +### Stock Firmware Init Block Write Pattern + +The stock firmware uses a specific pattern for writing initialization blocks, extracted from `FUN_CODE_0ddd`: + +```c title="Init Block Write Sequence" +// 1. Page select = 0 +I2C WRITE: [0x10] [0xA6] [0x00] + +// 2. Multi-byte data (auto-increment) +I2C WRITE: [0x10] [0xA7] [data0] [data1] ... [dataN] + +// 3. Trailing zero (stock firmware quirk) +I2C WRITE: [0x10] [0xA7] [0x00] + +// 4. Commit indirect write +I2C WRITE: [0x10] [0xA8] [0x03] + +// 5. Poll for completion +I2C READ: [0xA8] until bit 0 clear +``` + + + +## Demodulator Scan + +The tune function tries up to 3 different I2C address configurations per attempt, with 3 outer retries (up to 9 total I2C programming attempts). This supports hardware variants where the BCM4500 may appear at different bus addresses. + +The v2.13 firmware adds boot-time probing: the INT0 handler polls addresses 0x7F and 0x3F up to 40 times, setting a flag if neither responds. This flag prevents tuning attempts on boards with absent demodulators. + +## FEC Architecture + +The BCM4500 contains two FEC decoder paths: + + + + +**Advanced Modulation Turbo FEC Decoder** + +Iterative turbo code decoder with the following code rates: + +| Modulation | Supported Rates | +|-----------|----------------| +| QPSK | 1/4, 1/2, 3/4 | +| 8PSK | 2/3, 3/4, 5/6, 8/9 | +| 16QAM | 3/4 | + +Outer code: Reed-Solomon (t=10). + +These turbo codes are Broadcom/EchoStar proprietary and are not part of any open standard. They were used by Dish Network for high-definition satellite broadcasts. + + + + +**Legacy DVB/DIRECTV/DCII-Compliant FEC Decoder** + +Concatenated decoder with: + +| Stage | Type | Rates | +|-------|------|-------| +| Inner | Viterbi (convolutional code) | 1/2, 2/3, 3/4, 5/6, 7/8 | +| Outer | Reed-Solomon | Standard DVB-S parameters | + +This decoder handles standard DVB-S QPSK, DVB-S BPSK, DSS QPSK, and all Digicipher II modes. + + + + + + +## Modulation Mode Constants + +The firmware uses a 10-entry dispatch table for modulation types. See [Tuning Protocol](/bcm4500/tuning-protocol/) for the full tuning sequence. + +| Index | Modulation | FEC Path | +|-------|-----------|----------| +| 0 | DVB-S QPSK | Legacy (Viterbi + RS) | +| 1 | Turbo QPSK | Turbo | +| 2 | Turbo 8PSK | Turbo | +| 3 | Turbo 16QAM | Turbo | +| 4 | DCII Combo | Legacy | +| 5 | DCII I-stream | Legacy | +| 6 | DCII Q-stream | Legacy | +| 7 | DCII Offset QPSK | Legacy | +| 8 | DSS QPSK | Legacy (Viterbi + RS) | +| 9 | DVB-S BPSK | Legacy (Viterbi + RS) | + +Indices 8 and 9 (DSS and DVB BPSK) share the same firmware handler. The FEC lookup uses the same table as DVB-S QPSK but ORs the result with 0x80 to distinguish them. diff --git a/site/src/content/docs/bcm4500/gpif-streaming.mdx b/site/src/content/docs/bcm4500/gpif-streaming.mdx new file mode 100644 index 0000000..e0b4a52 --- /dev/null +++ b/site/src/content/docs/bcm4500/gpif-streaming.mdx @@ -0,0 +1,241 @@ +--- +title: GPIF Streaming +description: GPIF engine configuration, waveform descriptors, and transport stream data path from BCM4500 to USB host. +--- + +import { Tabs, TabItem, Badge, Aside, Steps } from '@astrojs/starlight/components'; + +The GPIF (General Programmable Interface) engine in the Cypress FX2 provides a hardware-managed data path from the BCM4500 demodulator to the USB host. After initial setup, no firmware intervention occurs in the data path -- the GPIF engine reads transport stream data directly into the EP2 FIFO, and the AUTOIN mechanism automatically commits full packets to the USB controller. + +## Data Flow Architecture + +``` + Cypress FX2 (CY7C68013A) + +-----------------------------+ + | | +BCM4500 P3.5 TS_EN | GPIF Engine EP2 FIFO | USB 2.0 HS +Demodulator <-----------------+ (Master Read) (AUTOIN) +------------> Host + (I2C:0x08) GPIF Data Bus | 0xE4xx wfm 4x buf | EP2 (0x82) + -------------------> CTL/RDY pins 8-bit | Bulk IN + 8-bit parallel TS | | 7 URBs x 8KB + +-----------------------------+ +``` + + + +## Key Register Configuration + +All values are identical across the three stock firmware versions (v2.06, Rev.2 v2.10, v2.13): + +| Register | Address | Value | Function | +|----------|---------|-------|----------| +| IFCONFIG | 0xE601 | 0xEE | Internal 48 MHz clock, GPIF master, async, debug output | +| EP2FIFOCFG | 0xE618 | 0x0C | AUTOIN=1, ZEROLENIN=1, 8-bit data path | +| REVCTL | 0xE60B | 0x03 | NOAUTOARM + SKIPCOMMIT | +| CPUCS | 0xE600 | bits [4:3]=10 | 48 MHz CPU clock | +| FLOWSTATEA | 0xE668 | OR 0x09 | FSEN (flow state enable) + FS[3] | +| GPIFIE | 0xE65C | OR 0x3D | Waveform, TC, DONE, FIFO flag, WF2 interrupts | + +### IFCONFIG Decode (0xEE = 1110_1110) + +| Bit | Name | Value | Meaning | +|-----|------|-------|---------| +| 7 | IFCLKSRC | 1 | Internal clock source | +| 6 | 3048MHZ | 1 | 48 MHz IFCLK frequency | +| 5 | IFCLKOE | 1 | IFCLK pin drives output (clock to BCM4500) | +| 4 | IFCLKPOL | 0 | Non-inverted clock polarity | +| 3 | ASYNC | 1 | Asynchronous GPIF (RDY pin handshaking) | +| 2 | GSTATE | 1 | Debug state output on PORTE | +| 1:0 | IFCFG | 10 | GPIF internal master mode | + +The FX2 operates as a GPIF master, reading data from the BCM4500's parallel transport stream output. Asynchronous mode means the GPIF uses RDY pin handshaking rather than clock-edge sampling. + +### EP2FIFOCFG Decode (0x0C = 0000_1100) + +| Bit | Name | Value | Meaning | +|-----|------|-------|---------| +| 4 | INFM1 | 0 | Packet count not decremented | +| 3 | AUTOIN | 1 | Auto-commit IN packets when FIFO buffer full | +| 2 | ZEROLENIN | 1 | Allow zero-length IN packets | +| 1 | (reserved) | 0 | -- | +| 0 | WORDWIDE | 0 | 8-bit data path (not 16-bit) | + +The AUTOIN bit is critical: when the GPIF fills an EP2 FIFO buffer to the configured packet size, the FX2 hardware automatically arms the buffer for USB transfer. + +## GPIF Waveform Configuration + +The GPIF waveform descriptors occupy 128 bytes at 0xE400-0xE47F and are loaded from a compressed init table during firmware startup. The waveform programs a straightforward read cycle: + +``` +States 0-5: CTL outputs = 0x01 (control line asserted), 1 IFCLK each +State 6: CTL = 0x07, length = 0 (idle/terminate) +Opcode: 0x00 (SDP = sample data point) +Output: 0xF0 (FIFO write flags) +``` + +This encodes a simple "assert read strobe, capture data, de-assert" cycle that reads one byte per GPIF transaction from the BCM4500's parallel port into the EP2 FIFO. + +## FIFO Reset Sequence + +All endpoint FIFOs are reset during initialization using the Cypress-prescribed procedure: + +```c title="FIFO Reset (FUN_CODE_10d9)" +FIFORESET = 0x80; // NAKALL: NAK all host transfers during reset +// 3-NOP SYNCDELAY +FIFORESET = 0x02; // Reset EP2 FIFO +// 3-NOP SYNCDELAY +FIFORESET = 0x04; // Reset EP4 FIFO +// 3-NOP SYNCDELAY +FIFORESET = 0x06; // Reset EP6 FIFO +// 3-NOP SYNCDELAY +FIFORESET = 0x08; // Reset EP8 FIFO +// 3-NOP SYNCDELAY +FIFORESET = 0x00; // Release NAKALL +``` + +The triple-NOP delays (mandatory SYNCDELAY) between writes are required by the FX2 architecture: XRAM register writes take 2 cycles to propagate, and back-to-back writes to the same register need at least 3 instruction cycles. + +## ARM_TRANSFER Command (0x85) + +The host issues vendor command 0x85 to start or stop the MPEG-2 transport stream. The handler checks the [configuration status byte](/usb/config-status/) bit 0 (demodulator active) before proceeding. + + + + +When `wValue=1` and the demodulator is active: + + +1. **Set streaming flag** -- config_byte bit 7 = 1 (bmArmed). + +2. **Load GPIF transaction count** -- GPIFTCB3:2 = 0x8000 (2 GB, effectively infinite). + +3. **Reset address and byte count** -- Clear GPIF address registers and EP2 FIFO byte count. + +4. **Assert TS_EN** -- P3.5 LOW (BCM4500 transport stream output enabled). + +5. **Wait for initial GPIF transaction** -- Poll GPIFTRIG bit 7 (DONE) until set. + +6. **De-assert TS_EN** -- P3.5 HIGH. + +7. **Trigger continuous GPIF read** -- GPIFTRIG = 0x04 (read direction, EP2 select). + +8. **Set streaming indicator** -- P0.7 LOW. + + +```asm title="Start Streaming (Rev.2 at CODE:0D84)" +ORL 0x4e, #0x80 ; config_byte |= 0x80 (streaming flag) +MOV DPTR, #0xE630 ; GPIFTCB3 +MOV A, #0x80 +MOVX @DPTR, A ; GPIFTCB3 = 0x80 (huge transaction count) +; ... address/FIFO reset ... +ANL 0xb0, #0xDF ; P3 &= 0xDF -> P3.5 = 0 (TS_EN assert) +; Poll GPIFTRIG.DONE ... +ORL 0xb0, #0x20 ; P3 |= 0x20 -> P3.5 = 1 +MOV 0xbb, #0x04 ; GPIFTRIG = 0x04 (read EP2) +ANL 0x80, #0x7F ; P0 &= 0x7F -> P0.7 = 0 (streaming) +``` + + + + +When `wValue=0` and currently streaming (config_byte bit 7 set): + + +1. **Set stopped indicator** -- P0.7 HIGH. + +2. **Force-flush buffer** -- EP2FIFOBCH = 0xFF (skip current FIFO packet). + +3. **Wait for GPIF idle** -- Poll GPIFTRIG bit 7 (DONE) until set. + +4. **Discard partial packet** -- OUTPKTEND = 0x82 (skip bit set, EP2 select). + +5. **Clear streaming flag** -- config_byte bit 7 = 0. + +6. **De-assert control lines** -- P3 bits 7:5 = 1 (all BCM4500 controls idle). + + +```asm title="Stop Streaming (Rev.2 at CODE:0DE1)" +ORL 0x80, #0x80 ; P0 |= 0x80 -> P0.7 = 1 (stopped) +MOV DPTR, #0xE6F5 ; EP2FIFOBCH +MOV A, #0xFF +MOVX @DPTR, A ; Force flush +; Poll GPIFTRIG.DONE ... +MOV DPTR, #0xE648 ; OUTPKTEND +MOV A, #0x82 ; Skip=1, EP2 +MOVX @DPTR, A ; Discard partial packet +ANL 0x4e, #0x7F ; config_byte &= 0x7F (clear streaming) +ORL 0xb0, #0xE0 ; P3 |= 0xE0 (de-assert all controls) +``` + + + + +## Interrupt Handling + +INT4 and INT6 (GPIF/FIFO events) share a common handler that sets a software flag and clears EXIF.4: + +```asm title="GPIF Interrupt Handler (Rev.2 at CODE:2084)" +PUSH A +PUSH DPH +PUSH DPL +SETB 0x01 ; Set GPIF event flag (_0_1) +ANL 0x91, #0xEF ; Clear EXIF.4 (INT4/INT6 IRQ flag) +MOV DPTR, #0xE65D ; GPIFIRQ +MOV A, #0x01 +MOVX @DPTR, A ; Clear GPIFIRQ bit 0 +POP DPL +POP DPH +POP A +RETI +``` + +The main loop polls this flag, enters CPU idle mode (PCON.0) between events, and checks EP2CS for buffer availability before re-arming the GPIF. The FLOWSTATE engine (FSEN=1) automatically re-triggers GPIF transactions when EP2 buffers become available. + +## GPIF Interrupt Enable (GPIFIE) + +| Bit | Name | Enabled | Purpose | +|-----|------|---------|---------| +| 0 | GPIFWF | Yes | Waveform completion interrupt | +| 1 | (reserved) | No | -- | +| 2 | GPIFTCEXP | Yes | Transaction count expired | +| 3 | GPIFGPIFDONE | Yes | GPIF operation done | +| 4 | GPIFFF | Yes | FIFO flag interrupt | +| 5 | GPIFWF2 | Yes | Waveform 2 completion | + +## Throughput Analysis + +| Metric | Value | +|--------|-------| +| USB 2.0 HS bulk (theoretical) | 480 Mbps | +| USB 2.0 HS bulk (practical) | ~280 Mbps (~35 MB/s) | +| GPIF engine (theoretical) | 48 MHz x 8 bits = 384 Mbps | +| Typical DVB-S TS rate | 1--5 MB/s | +| Maximum DVB-S2 rate (hypothetical) | ~7.25 MB/s (58 Mbps) | + +The USB/GPIF path has approximately 5x headroom even at the maximum theoretical data rate. The bottleneck for all supported modes is the satellite link, not the USB data path. + +## Timing + +| Parameter | Value | +|-----------|-------| +| GPIF clock | 48 MHz internal | +| CPU clock | 48 MHz | +| GPIF mode | Asynchronous (RDY pin handshaking) | +| NOP delays | 3 NOPs between XRAM writes (~62.5 ns at 48 MHz) | +| EP2 buffer commit | Automatic via AUTOIN on FIFO fullness | +| GPIF re-trigger | Automatic via FLOWSTATE when EP2 buffer space available | + +## Cross-Version Comparison + +The GPIF streaming path is functionally identical across all three firmware versions. Only code addresses differ due to recompilation: + +| Aspect | v2.06 | v2.13 FW1 | Rev.2 v2.10 | +|--------|-------|-----------|-------------| +| ARM_TRANSFER handler | CODE:0110 | CODE:0110 | CODE:00FA | +| GPIF control function | CODE:1919 | CODE:1800 | CODE:0D7C | +| Config byte IRAM | 0x6D | 0x4F | 0x4E | +| EP2FIFOCFG value | 0x0C | 0x0C | 0x0C | +| IFCONFIG value | 0xEE | 0xEE | 0xEE | +| FLOWSTATEA setting | OR 0x09 | OR 0x09 | OR 0x09 | diff --git a/site/src/content/docs/bcm4500/signal-monitoring.mdx b/site/src/content/docs/bcm4500/signal-monitoring.mdx new file mode 100644 index 0000000..8f97c1f --- /dev/null +++ b/site/src/content/docs/bcm4500/signal-monitoring.mdx @@ -0,0 +1,117 @@ +--- +title: Signal Monitoring +description: SNR, signal strength, and lock status readback from the BCM4500 demodulator. +--- + +import { Badge, Aside } from '@astrojs/starlight/components'; + +Signal monitoring uses two vendor commands: GET_SIGNAL_LOCK (0x90) for lock status and GET_SIGNAL_STRENGTH (0x87) for SNR and diagnostic data. Both read BCM4500 direct registers via I2C. + +## Signal Lock (GET_SIGNAL_LOCK, 0x90) + +Returns 1 byte from BCM4500 direct register 0xA4. + +| Bit | Mask | Meaning | +|-----|------|---------| +| 5 | 0x20 | Signal locked | +| Other bits | -- | Additional status (undocumented) | + +The kernel driver interprets **any non-zero value** as locked and reports the full lock status: + +```c title="Kernel Lock Status Flags" +FE_HAS_LOCK | FE_HAS_SYNC | FE_HAS_VITERBI | FE_HAS_SIGNAL | FE_HAS_CARRIER +``` + +### Lock States + +| Value | State | Description | +|-------|-------|-------------| +| 0x00 | | No signal or signal not acquired | +| 0x20 | | Signal locked, FEC decoding active | +| Other non-zero | | Signal acquired, partial status bits | + + + +## Signal Strength (GET_SIGNAL_STRENGTH, 0x87) + +Returns 6 bytes. The first two bytes contain a 16-bit SNR value; the remaining bytes are diagnostic register data from the BCM4500. + +### Response Format + +| Byte | Content | Notes | +|------|---------|-------| +| 0 | SNR low byte (LSB) | 16-bit little-endian | +| 1 | SNR high byte (MSB) | dBu x 256 units | +| 2 | Reserved | BCM4500 diagnostic register | +| 3 | Reserved | BCM4500 diagnostic register | +| 4 | Reserved | BCM4500 diagnostic register | +| 5 | Reserved | BCM4500 diagnostic register | + +### SNR Scaling + +The Windows BDA driver provides the scaling formula: + +```c title="SNR to Signal Strength Conversion" +uint16_t snr_raw = (buf[1] << 8) | buf[0]; + +if (snr_raw <= 0x0F00) { + signal_strength = snr_raw * 17; // Maps 0--0x0F00 to 0--65535 +} else { + signal_strength = 0xFFFF; // 100% at SNR >= 0x0F00 +} +``` + +| SNR Raw Value | Signal Strength | Quality | +|--------------|----------------|---------| +| 0x0000 | 0 (0%) | No signal | +| 0x0400 | ~27% | Poor | +| 0x0800 | ~53% | Fair | +| 0x0C00 | ~80% | Good | +| 0x0F00 | 100% | Maximum | +| > 0x0F00 | 100% (clamped) | Maximum | + +### Firmware Implementation Differences + +The signal strength readback involves I2C transactions to the BCM4500's [indirect register protocol](/bcm4500/demodulator/). The implementation varies between firmware versions: + +| Aspect | v2.06 | Rev.2 v2.10 | v2.13 | +|--------|-------|-------------|-------| +| Registers polled | 0xA2, 0xA8, 0xA4 | 0xA2, 0xA8, 0xA4 | Consolidated (1 register) | +| Max poll iterations | 6 | 6 | Simplified | +| Read-back verification | No | Yes (explicit) | No | +| Call chain | 3-register loop | 3-register + verify | Single register path | + +All versions ultimately return the same 6-byte response format to the host. + +## BCM4500 Status Registers + +These direct registers are used for signal monitoring: + +| Register | Address | Function | Access | +|----------|---------|----------|--------| +| Status | 0xA2 | BCM4500 readiness status | Polled during boot and signal checks | +| Lock | 0xA4 | Lock/ready; bit 5 = locked | Read by GET_SIGNAL_LOCK (0x90) | +| Command | 0xA8 | Indirect command status; bit 0 = busy | Polled during register operations | +| Demod Status | 0xF9 | Extended demod status | Read by GET_DEMOD_STATUS (0x99, v2.13 only) | + +### Register 0xA2 -- Status + +Read during boot probing and signal strength readback. Returns 0x02 when the BCM4500 is powered on but no signal is locked. Exact bit field definitions are not documented in the public BCM4500 datasheet. + +### Register 0xA4 -- Lock + +The primary lock indicator. The kernel driver reads this as a single byte via GET_SIGNAL_LOCK (0x90). Bit 5 (0x20) is the definitive lock status flag. + +### Register 0xA8 -- Command + +Used by the [indirect register protocol](/bcm4500/demodulator/) to track command completion. Bit 0 clear indicates the previous indirect read/write command has completed. This register is polled after every indirect register operation. + +### Register 0xF9 -- Demod Status (v2.13 only) + +Read by the GET_DEMOD_STATUS vendor command (0x99). Also polled by the v2.13 INT0 handler for demodulator availability detection. This register is not accessed by v2.06 or Rev.2 firmware. + + diff --git a/site/src/content/docs/bcm4500/tuning-protocol.mdx b/site/src/content/docs/bcm4500/tuning-protocol.mdx new file mode 100644 index 0000000..d741643 --- /dev/null +++ b/site/src/content/docs/bcm4500/tuning-protocol.mdx @@ -0,0 +1,258 @@ +--- +title: Tuning Protocol +description: Complete TUNE_8PSK command protocol including parameter encoding, modulation dispatch, and BCM4500 I2C programming. +--- + +import { Tabs, TabItem, Badge, Steps, Aside } from '@astrojs/starlight/components'; + +The TUNE_8PSK vendor command (0x86) is the primary mechanism for programming the BCM4500 demodulator to receive a satellite signal. The command carries a 10-byte payload encoding frequency, symbol rate, modulation type, and FEC rate. The firmware parses this payload, dispatches to a modulation-specific handler, programs the BCM4500 via I2C, and the host then polls for signal lock. + +## Command Format + +``` +USB SETUP: + bmRequestType = 0x40 (Vendor, Host-to-Device, OUT) + bRequest = 0x86 (TUNE_8PSK) + wValue = 0x0000 + wIndex = 0x0000 + wLength = 10 +``` + +### EP0 Payload Layout + +| Byte | Content | Encoding | +|------|---------|----------| +| [0] | Symbol Rate byte 0 | Little-endian LSB | +| [1] | Symbol Rate byte 1 | | +| [2] | Symbol Rate byte 2 | | +| [3] | Symbol Rate byte 3 | Little-endian MSB | +| [4] | Frequency byte 0 | Little-endian LSB | +| [5] | Frequency byte 1 | | +| [6] | Frequency byte 2 | | +| [7] | Frequency byte 3 | Little-endian MSB | +| [8] | Modulation Type | 0--9 (see table below) | +| [9] | Inner FEC Rate | Index into modulation-specific table | + +**Symbol Rate** is in samples per second (sps). The Windows driver converts from ksps: `ulTempSymbolRate = pDeviceParameter->ulSymbolRate * 1000`. Valid range: 256,000 -- 30,000,000 sps. + +**Frequency** is the IF frequency in kHz (950,000 -- 2,150,000), computed by the host as `(RF_freq - LO_freq) * multiplier`. + +## Firmware Parameter Parsing + +The firmware reads the 10-byte payload from EP0BUF (XRAM 0xE740--0xE749) and stores: + +| Source | Destination | Notes | +|--------|-------------|-------| +| EP0BUF[8] (modulation) | IRAM 0x4D | Direct copy | +| EP0BUF[9] (FEC rate) | IRAM 0x4F | Direct copy | +| EP0BUF[4--7] (frequency) | XRAM 0xE0DB--0xE0DE | Byte-reversed (LE to BE) | +| EP0BUF[0--3] (symbol rate) | XRAM 0xE0CB--0xE0CE | Byte-reversed (LE to BE) | + +The byte reversal converts host little-endian to BCM4500 big-endian, allowing values to be written directly to the demodulator via I2C without further conversion. + +```asm title="EP0BUF Read (Rev.2 at CODE:0802)" +; Read modulation type and FEC rate +MOV DPTR, #0xE748 ; EP0BUF[8] = modulation type +MOVX A, @DPTR +MOV 0x4D, A ; Store to IRAM 0x4D +INC DPTR ; DPTR = 0xE749 +MOVX A, @DPTR ; EP0BUF[9] = FEC rate +MOV 0x4F, A ; Store to IRAM 0x4F +``` + +## Modulation Dispatch + +After parsing, the firmware validates the modulation type (bounds check against 10) and dispatches via a 20-byte jump table (10 entries x 2 bytes) at CODE:0873. Values >= 10 are rejected silently. + +### Dispatch Table (Rev.2) + +| Entry | Target | Modulation | +|-------|--------|-----------| +| 0 | 0x08B7 | DVB-S QPSK | +| 1 | 0x08DF | Turbo QPSK | +| 2 | 0x08FA | Turbo 8PSK | +| 3 | 0x0915 | Turbo 16QAM | +| 4 | 0x0947 | DCII Combo | +| 5 | 0x094F | DCII I-stream | +| 6 | 0x0957 | DCII Q-stream | +| 7 | 0x095F | DCII Offset QPSK | +| 8 | 0x0887 | DSS QPSK | +| 9 | 0x0887 | DVB BPSK (shares DSS handler) | + +Each handler validates the FEC index, looks up a preconfigured byte from an XRAM table, and writes configuration to four XRAM registers. + +## Modulation Handler Details + + + + +### DVB-S QPSK (Index 0) + +| Parameter | Value | +|-----------|-------| +| FEC table base | XRAM 0xE0F9 | +| Max FEC index | 7 | +| Modulation type register | 0x09 | +| Turbo flag | 0x00 (off) | +| Demod mode | 0x10 (standard) | +| bmDCtuned | Cleared | + +**FEC rates available** (table at 0xE0F9): 1/2, 2/3, 3/4, 5/6, 7/8, auto, none. + +### DSS QPSK (Index 8) and DVB-S BPSK (Index 9) + +DSS and DVB BPSK share the same handler at 0x0887. They use the same FEC table as DVB-S QPSK (0xE0F9) but OR the lookup value with 0x80 to distinguish them: + +```c title="DSS/BPSK FEC Encoding" +XRAM[0xE0EB] = XRAM[0xE0F9 + FEC_index] | 0x80; +// Out-of-range default: 0x8C +``` + + + + +### Turbo QPSK (Index 1) + +| Parameter | Value | +|-----------|-------| +| FEC table base | XRAM 0xE0B7 | +| Max FEC index | 5 | +| Modulation type register | 0x09 | +| Turbo flag | 0x01 (on) | +| Demod mode | 0x10 | +| bmDCtuned | Cleared | + +### Turbo 8PSK (Index 2) + +| Parameter | Value | +|-----------|-------| +| FEC table base | XRAM 0xE0B1 | +| Max FEC index | 5 | +| Modulation type register | 0x09 | +| Turbo flag | 0x01 (on) | +| Demod mode | 0x10 | +| bmDCtuned | Cleared | + +### Turbo 16QAM (Index 3) + +| Parameter | Value | +|-----------|-------| +| FEC table base | XRAM 0xE0BC | +| Max FEC index | 1 | +| Modulation type register | 0x09 | +| Turbo flag | 0x01 (on) | +| Demod mode | 0x10 | +| bmDCtuned | Cleared | + + + + +All four DCII variants share a common post-processing path but set different demod mode values: + +| Modulation | Index | Demod Mode (0xE0F5) | +|-----------|-------|---------------------| +| DCII Combo | 4 | 0x10 | +| DCII Offset QPSK | 7 | 0x11 | +| DCII I-stream (split) | 5 | 0x12 | +| DCII Q-stream (split) | 6 | 0x16 | + +**Common DCII parameters:** + +| Parameter | Value | +|-----------|-------| +| FEC table base | XRAM 0xE0BD | +| Max FEC index | 9 | +| FEC code rate register | 0xFC (fixed for all DCII) | +| Turbo flag | 0x00 (off) | +| bmDCtuned | **Set** (0x40 OR'd into config status) | + +The DCII modulation type register (0xE0EC) is loaded from the lookup table at `0xE0BD + FEC_index`, unlike other modulations which use the fixed value 0x09. + + + + +## XRAM Configuration Summary + +After modulation dispatch, four XRAM registers hold the BCM4500 configuration: + +| XRAM Address | Register Name | DVB-S QPSK | Turbo (Q/8/16) | DCII | DSS/BPSK | +|-------------|---------------|-----------|---------------|------|----------| +| 0xE0EB | FEC Code Rate | Table lookup | Table lookup | 0xFC (fixed) | Lookup OR 0x80 | +| 0xE0EC | Modulation Type | 0x09 | 0x09 | From DCII table | 0x09 | +| 0xE0F5 | Demod Mode | 0x10 | 0x10 | 0x10/0x11/0x12/0x16 | 0x10 | +| 0xE0F6 | Turbo Flag | 0x00 | 0x01 | 0x00 | 0x00 | + +## FEC Rate Lookup Tables + +These tables are populated at boot from the CODE-space init table: + +| XRAM Base | Modulation | Max Index | Code Rates | +|-----------|-----------|-----------|------------| +| 0xE0F9 | DVB-S QPSK, DSS, BPSK | 7 | 1/2, 2/3, 3/4, 5/6, 7/8, auto, none | +| 0xE0B7 | Turbo QPSK | 5 | Turbo-specific rates | +| 0xE0B1 | Turbo 8PSK | 5 | Turbo-specific rates | +| 0xE0BC | Turbo 16QAM | 1 | Single code rate | +| 0xE0BD | DCII (all variants) | 9 | Combined code + modulation | + +## Complete Tuning Sequence + +The full sequence from host command to signal acquisition: + + +1. **LNB Configuration** (separate vendor commands, before TUNE_8PSK) + - SET_LNB_VOLTAGE (0x8B): GPIO P0.4, no I2C. wValue=1 for 18V (H/Circular-L), wValue=0 for 13V (V/Circular-R). + - SET_22KHZ_TONE (0x8C): GPIO P0.3, no I2C. wValue=1 for high band, wValue=0 for low band. + - SEND_DISEQC_COMMAND (0x8D): If multi-switch is needed. + +2. **TUNE_8PSK (0x86)** -- Host sends 10-byte payload via USB control transfer. + +3. **EP0BUF Parsing** -- Firmware reads modulation/FEC to IRAM, byte-reverses frequency/symbol rate to XRAM. + +4. **Modulation Dispatch** -- FEC lookup via jump table, XRAM configuration registers set. + +5. **GPIO P3.6** -- DVB mode select pin driven based on modulation type. + +6. **BCM4500 I2C Programming** (3 outer retries, each trying up to 3 I2C addresses): + - Poll BCM4500 ready: I2C READ registers 0xA2, 0xA8, 0xA4. + - Write page: I2C WRITE register 0xA6 with 0x00. + - Write config data: I2C WRITE register 0xA7 with frequency, symbol rate, FEC, modulation, and demod parameters. + - Execute: I2C WRITE register 0xA8 with 0x03 (indirect write command). + - Poll completion: I2C READ registers 0xA8, 0xA2. + - Verify: I2C READ register 0xA7 (read-back compare). + +7. **Signal Acquisition** (host polling): + - GET_SIGNAL_LOCK (0x90): Poll until non-zero. + - GET_SIGNAL_STRENGTH (0x87): Read [SNR value](/bcm4500/signal-monitoring/). + + +## I2C Programming Details + +The core I2C write function (`FUN_CODE_1670` on Rev.2) implements the [BCM4500 indirect register protocol](/bcm4500/demodulator/): + +```c title="BCM4500 Indirect Write (Decompiled)" +void bcm4500_indirect_write(byte *data, byte count) { + // Wait for BCM4500 ready (poll regs 0xA2, 0xA8, 0xA4) + bus_wait_ready(); + + // Write page address (0x00) to register 0xA6 + i2c_write(1, 0, 0xA6, 0x10); // [0x00] + + // Write data to register 0xA7 + i2c_write(count, 0, 0xA7, 0x10); // [data0..dataN] + + // Write command (0x03 = indirect write) to 0xA8 + i2c_write(1, 0, 0xA8, 0x10); // [0x03] + + // Poll completion (regs 0xA8, 0xA2) + poll_write_complete(); + + // Verify: read back from 0xA7 and compare + verify_readback(); +} +``` + +The demod scan function (`FUN_CODE_1dd0`) wraps this in a 3-address iteration loop, supporting hardware variants where the BCM4500 may respond at different I2C addresses. The outer tune function retries the entire scan up to 3 times. + + diff --git a/site/src/content/docs/driver/dvb-s2.mdx b/site/src/content/docs/driver/dvb-s2.mdx new file mode 100644 index 0000000..0e976e7 --- /dev/null +++ b/site/src/content/docs/driver/dvb-s2.mdx @@ -0,0 +1,169 @@ +--- +title: DVB-S2 Incompatibility +description: Why the SkyWalker-1 cannot support DVB-S2 and what the BCM4500 demodulator actually provides. +--- + +import { Badge, Aside, Tabs, TabItem } from '@astrojs/starlight/components'; + + + +## The Core Problem + +DVB-S2 (ETSI EN 302 307) requires two forward error correction technologies that do not exist in the BCM4500: + +| FEC Component | BCM4500 Has | DVB-S2 Requires | +|---------------|-------------|-----------------| +| Inner code | Viterbi (convolutional) + Turbo | **LDPC** (Low-Density Parity-Check) | +| Outer code | Reed-Solomon (t=10) | **BCH** (Bose-Chaudhuri-Hocquenghem) | +| Block size | Streaming (Viterbi) or short turbo blocks | **64,800 or 16,200 bits** | +| Decoder type | Trellis-based / iterative turbo | **Iterative belief propagation** | + +LDPC decoding requires dedicated silicon: large block RAM for message passing (the LDPC block is 64,800 bits), iterative belief propagation logic, and a fundamentally different decoder architecture. This cannot be emulated in firmware on the BCM4500's simple 8-bit on-chip microcontroller, which handles only configuration, acquisition, and monitoring -- not data-path processing. + +## BCM4500 FEC Architecture + +The BCM4500 contains exactly two FEC decoder paths (from the [BCM4500 datasheet](https://elcodis.com/parts/5786421/BCM4500.html)): + + + + +### Viterbi + Reed-Solomon (Legacy) + +Used for DVB-S QPSK, DSS QPSK, DVB-S BPSK, and Digicipher II modes. + +| Parameter | Value | +|-----------|-------| +| Inner decoder | Viterbi (convolutional) | +| Code rates | 1/2, 2/3, 3/4, 5/6, 7/8 | +| Outer decoder | Reed-Solomon | +| Signal path | Soft decisions fed to Viterbi, then RS outer code | +| Modulations | BPSK, QPSK | + +**Firmware evidence** (XRAM 0xE0F9): FEC lookup table with max index 7. Modulation dispatch sets `XRAM 0xE0F6 = 0x00` (turbo flag OFF), `XRAM 0xE0F5 = 0x10` (standard demod mode). + +**Windows driver**: `m_CurResource.ulInnerFecType = BDA_FEC_VITERBI` -- explicitly rejects any FEC type other than Viterbi. + + + + +### Turbo Code Decoder (Proprietary) + +Used for Turbo QPSK, Turbo 8PSK, and Turbo 16QAM -- proprietary "advanced modulation" modes developed by Broadcom for EchoStar/Dish Network. + +| Parameter | Value | +|-----------|-------| +| Inner decoder | Iterative turbo code | +| QPSK rates | 1/4, 1/2, 3/4 | +| 8PSK rates | 2/3, 3/4, 5/6, 8/9 | +| 16QAM rates | 3/4 | +| Outer decoder | Reed-Solomon (t=10) | +| Modulations | QPSK, 8PSK, 16QAM | + +**Firmware evidence** (XRAM 0xE0B7, 0xE0B1, 0xE0BC): Turbo FEC lookup tables. All turbo modes set `XRAM 0xE0F6 = 0x01` (turbo flag ON). + +These turbo codes are NOT the same as DVB-S2's LDPC codes. The turbo decoder uses parallel concatenated convolutional codes, while LDPC uses sparse parity-check matrix belief propagation. Different algorithms, different silicon. + + + + +### DCII Decoder + +Used for DCII combo, split I/Q, and offset QPSK modes. + +| Parameter | Value | +|-----------|-------| +| FEC table | XRAM 0xE0BD, max index 9 | +| Fixed FEC code | `0xFC` written to XRAM 0xE0EB | +| Modulations | QPSK variants (combo, split, offset) | + + + +The BCM4500 datasheet states explicitly: "Optimized soft decisions are then fed into either a DVB/DIRECTV/DCII-compliant FEC decoder, or an advanced modulation turbo decoder." These are the only two FEC paths. There is no third path for LDPC/BCH. + +## Zero DVB-S2 Evidence in Firmware or Driver + +Exhaustive search across all firmware versions and Windows driver source: + +| What Was Searched | Result | +|-------------------|--------| +| All firmware binaries (v2.06, Rev.2, v2.13) via Ghidra | No LDPC/BCH/DVB-S2 references | +| Windows driver `SkyWalker1Control.h` | Modulation constants 0--9 only, none for DVB-S2 | +| Windows driver `SkyWalker1TunerFilter.cpp` | Rejects non-Viterbi FEC types | +| Windows driver `SkyWalker1Control.cpp` | Hardcodes `ADV_MOD_DVB_QPSK` (value 0) | +| Firmware dispatch table (CODE:0873) | 10 entries max, values >= 10 rejected | +| All FEC lookup tables in XRAM | Only Viterbi rates and turbo rates, no LDPC rates | +| I2C register addresses | BCM4500-specific protocol only (page 0x00, regs 0xA6/A7/A8) | + +**Specific proof points:** +- `SkyWalker1TunerFilter.cpp`, line 1070: `if(ulNewInnerFecType == BDA_FEC_VITERBI)` -- only Viterbi accepted; any other FEC type returns `STATUS_INVALID_PARAMETER` +- `SkyWalker1Control.cpp`, line 292: `ucCommand[8] = ADV_MOD_DVB_QPSK;` -- always sends modulation type 0 +- Firmware jump table at CODE:0866: bounds check rejects modulation values >= 10 + +## Is the USB Data Path a Bottleneck? + +**No.** The GPIF/USB 2.0 streaming architecture has roughly 5x headroom for DVB-S2 data rates. The bottleneck is the demodulator silicon, not the transport path. + +| Metric | Value | +|--------|-------| +| DVB-S2 max net rate (8PSK 9/10, 30 Msps) | ~58 Mbps (~7.25 MB/s) | +| Typical HD transponder (8PSK 3/4, 27.5 Msps) | ~44 Mbps | +| USB 2.0 practical bulk throughput | ~280 Mbps (~35 MB/s) | +| GPIF engine theoretical throughput (48 MHz, 8-bit) | 384 Mbps (48 MB/s) | +| Current DVB-S typical TS rate | 1--5 MB/s | + +DVB-S2 uses the same MPEG-TS output format (188-byte packets) as DVB-S, so the GPIF waveform and AUTOIN configuration would work unchanged. + +However, this is a moot point: even if the BCM4500 were physically replaced with a DVB-S2-capable chip, the entire FX2 firmware would need rewriting (I2C register protocol, tuning sequence, modulation dispatch, FEC configuration), since every DVB-S2 demodulator uses a completely different register interface. + +## Broadcom's DVB-S2 Silicon Timeline + +Broadcom addressed DVB-S2 by designing entirely new chips -- they did not add LDPC to the BCM4500: + +| Chip | Year | DVB-S2 | Key Addition | +|------|------|--------|-------------| +| **BCM4500** | ~2003 | No | Turbo FEC + Viterbi/RS | +| **BCM4501** | 2006 | **Yes** | First dual-tuner DVB-S2; LDPC/BCH decoder | +| **BCM4505** | 2007 | **Yes** | Single-channel, 65nm, LDPC/BCH + legacy | +| **BCM4506** | 2007 | **Yes** | Dual-channel, 65nm, LDPC/BCH + legacy | + +The BCM4501 datasheet explicitly states it includes "four 8-bit ADCs, all-digital variable rate QPSK/8PSK receivers, advanced modulation LDPC/BCH, and DVB-S-compliant forward error correction decoder." Adding LDPC/BCH required new silicon. + + + +## What Genpix Did: The SkyWalker-3 + +Genpix released the SkyWalker-3 as a DVB-S2-capable successor using a completely different demodulator (likely STMicroelectronics STV0903): + +| Feature | SkyWalker-1 (BCM4500) | SkyWalker-3 (likely STV0903) | +|---------|----------------------|---------------------------| +| DVB-S QPSK | Yes | Yes | +| DVB-S2 QPSK | **No** | Yes | +| DVB-S2 8PSK | **No** | Yes | +| Turbo QPSK | Yes | **No** | +| Turbo 8PSK | Yes | **No** | +| Turbo 16QAM | Yes | **No** | +| DCII | Yes | Yes | +| DSS | Yes | Yes | +| Symbol rate (DVB-S) | 256 Ksps -- 30 Msps | 1 -- 45 Msps | +| Symbol rate (DVB-S2) | N/A | 5 -- 33 Msps | +| FEC inner (DVB-S) | Viterbi | Viterbi | +| FEC inner (DVB-S2) | N/A | LDPC | +| FEC outer (DVB-S2) | N/A | BCH | + +The trade-off is clear: the SkyWalker-3 gained DVB-S2 but **lost turbo-FEC support entirely**. The turbo codes were proprietary to Broadcom/EchoStar, and the STV0903 does not implement them. This means the SkyWalker-3 cannot receive Dish Network's legacy turbo-coded 8PSK transmissions. + +## Summary + +| Question | Answer | +|----------|--------| +| Is DVB-S2 a hardware or firmware limitation? | **Hardware** -- BCM4500 has no LDPC/BCH decoder | +| Could a firmware update add DVB-S2? | **No** -- LDPC requires dedicated silicon | +| Which Broadcom chip first added LDPC? | **BCM4501** (2006) | +| Any DVB-S2 hints in firmware/driver? | **None** -- zero references anywhere | +| Is the USB data path a bottleneck? | **No** -- ~5x headroom for DVB-S2 rates | +| What did Genpix do for DVB-S2? | Released SkyWalker-3 with STV0903 demodulator | +| What was lost in the SkyWalker-3? | Turbo-FEC support (Broadcom/EchoStar proprietary) | diff --git a/site/src/content/docs/driver/linux-kernel.mdx b/site/src/content/docs/driver/linux-kernel.mdx new file mode 100644 index 0000000..d44753a --- /dev/null +++ b/site/src/content/docs/driver/linux-kernel.mdx @@ -0,0 +1,272 @@ +--- +title: Linux Kernel Driver +description: Architecture and command analysis of the dvb_usb_gp8psk kernel module for Genpix satellite receivers. +--- + +import { Steps, Badge, Aside, Tabs, TabItem } from '@astrojs/starlight/components'; + +The `dvb_usb_gp8psk` module is a Linux kernel DVB-USB driver supporting multiple Genpix satellite receiver models. It communicates with the FX2 microcontroller via USB vendor control requests to manage tuning, demodulation, LNB control, DiSEqC switching, and transport stream capture. + +**Source files**: `drivers/media/usb/dvb-usb/gp8psk.c`, `gp8psk.h`, `gp8psk-fe.c` + +## USB Device Table + +| USB ID | Device Name | cold_ids | warm_ids | FW01 Needed? | +|--------|-------------|----------|----------|-------------| +| `v09C0p0200` | Rev.1 Cold | Yes | -- | **Yes** | +| `v09C0p0201` | Rev.1 Warm | -- | Yes | No (FW02 needed) | +| `v09C0p0202` | Rev.2 | -- | Yes | No | +| `v09C0p0203` | SkyWalker-1 | -- | Yes | No | +| `v09C0p0204` | SkyWalker-1 (alt) | -- | Yes | No | +| `v09C0p0206` | SkyWalker CW3K | -- | Yes | No | + + + +## Driver Architecture + +The driver consists of three source files: + +| File | Purpose | +|------|---------| +| `gp8psk.c` | USB device management, firmware loading, power control, vendor command wrappers | +| `gp8psk.h` | Vendor command constants, firmware version thresholds, USB PID definitions | +| `gp8psk-fe.c` | DVB frontend implementation: tuning, signal monitoring, LNB/DiSEqC callbacks | + +The driver registers with the DVB-USB framework (`dvb_usb_device_properties`) which handles: +- USB device enumeration and firmware download (for cold devices) +- DVB adapter and frontend creation +- URB management for bulk transport stream capture +- Power management callbacks + +## USB Transfer Parameters + +```c title="Driver USB configuration" +gp8psk_properties { + .usb_ctrl = CYPRESS_FX2; + .firmware = "dvb-usb-gp8psk-01.fw"; + .num_adapters = 1; + .generic_bulk_ctrl_endpoint = 0x01; + // Streaming: + .endpoint = 0x82; // IN bulk + .stream = USB_BULK; + .count = 7; // URBs + .buffersize = 8192; // bytes per URB +} +``` + +The driver allocates 7 URBs of 8192 bytes each (56 KB total) for transport stream reception on endpoint `0x82` (IN bulk). Vendor commands use endpoint `0x01` with a 2000 ms timeout. + +### Retry Logic + +IN operations retry up to 3 times if partial data is received. The command buffer is 80 bytes maximum: + +```c title="Vendor command wrapper" +static int gp8psk_usb_in_op(struct dvb_usb_device *d, + u8 req, u16 value, u16 index, u8 *b, int blen) +{ + int ret; + int try; + for (try = 0; try < 3; try++) { + ret = usb_control_msg(d->udev, + usb_rcvctrlpipe(d->udev, 0), + req, USB_TYPE_VENDOR | USB_DIR_IN, + value, index, b, blen, 2000); + if (ret == blen) break; + } + return ret; +} +``` + +## Complete Vendor Command Map + +| Cmd | Name | Dir | wValue | wLength | Purpose | +|-----|------|-----|--------|---------|---------| +| `0x80` | GET_8PSK_CONFIG | IN | `0x0000` | 1 | Read config status byte | +| `0x81` | SET_8PSK_CONFIG | OUT | varies | 0 | STALL (not implemented) | +| `0x83` | I2C_WRITE | OUT | dev_addr | N | Write to BCM4500 via I2C | +| `0x84` | I2C_READ | IN | dev_addr | N | Read from BCM4500 via I2C | +| `0x85` | ARM_TRANSFER | OUT | 0/1 | 0 | Start/stop TS streaming | +| `0x86` | TUNE_8PSK | OUT | `0x0000` | 10 | Send tuning parameters | +| `0x87` | GET_SIGNAL_STRENGTH | IN | `0x0000` | 6 | Read SNR values | +| `0x88` | LOAD_BCM4500 | OUT | 1 | 0 | Initiate demod FW download | +| `0x89` | BOOT_8PSK | IN | 0/1 | 1 | Power on/off demodulator | +| `0x8A` | START_INTERSIL | IN | 0/1 | 1 | Enable/disable LNB supply | +| `0x8B` | SET_LNB_VOLTAGE | OUT | 0/1 | 0 | Set 13V (0) or 18V (1) | +| `0x8C` | SET_22KHZ_TONE | OUT | 0/1 | 0 | Enable/disable 22 kHz tone | +| `0x8D` | SEND_DISEQC | OUT | msg[0] | 3-6 | Send DiSEqC message | +| `0x8E` | SET_DVB_MODE | OUT | 1 | 0 | Enable DVB-S mode | +| `0x8F` | SET_DN_SWITCH | OUT | cmd | 0 | Legacy Dish switch command | +| `0x90` | GET_SIGNAL_LOCK | IN | `0x0000` | 1 | Read lock status | +| `0x92` | GET_FW_VERS | IN | `0x0000` | 6 | Read firmware version | +| `0x94` | USE_EXTRA_VOLT | OUT | 0/1 | 0 | Enable +1V LNB boost | +| `0x95` | GET_FPGA_VERS | IN | `0x0000` | 1 | Read hardware platform ID | +| `0x99` | GET_DEMOD_STATUS | IN | `0x0000` | 1 | Read BCM4500 reg 0xF9 (v2.13+) | +| `0x9A` | INIT_DEMOD | OUT | `0x0000` | 0 | Re-init demodulator (v2.13+) | +| `0x9C` | DELAY_COMMAND | OUT | param | 0 | Tuning delay with polling (v2.13+) | +| `0x9D` | CW3K_INIT | OUT | 0/1 | 0 | CW3K model initialization | + +## Configuration Status Byte + +`GET_8PSK_CONFIG` (`0x80`) returns a bit-mapped status register: + +``` +Bit 0 (0x01): bm8pskStarted - Device booted and running +Bit 1 (0x02): bm8pskFW_Loaded - BCM4500 firmware loaded +Bit 2 (0x04): bmIntersilOn - LNB power supply enabled +Bit 3 (0x08): bmDVBmode - DVB mode enabled +Bit 4 (0x10): bm22kHz - 22 kHz tone active +Bit 5 (0x20): bmSEL18V - 18V LNB voltage selected +Bit 6 (0x40): bmDCtuned - DC offset tuning complete +Bit 7 (0x80): bmArmed - MPEG-2 stream transfer armed +``` + +## Boot Sequence + + + +1. **Read config** (`GET_8PSK_CONFIG 0x80`): Check bit 0 (`bm8pskStarted`) + +2. **Boot device** if not started: Send `BOOT_8PSK 0x89` with `wValue=1`, then read firmware version via `GET_FW_VERS 0x92` + +3. **Load BCM4500 firmware** if bit 1 not set: Only for Rev.1 Warm (PID `0x0201`). Send `LOAD_BCM4500 0x88` followed by firmware chunks. Skipped for SkyWalker-1 (bit already set from EEPROM boot). + +4. **Enable LNB** if bit 2 not set: Send `START_INTERSIL 0x8A` with `wValue=1` + +5. **Set DVB mode**: Send `SET_DVB_MODE 0x8E` with `wValue=1` (STALL on some revisions) + +6. **Cancel pending stream**: Send `ARM_TRANSFER 0x85` with `wValue=0` + +7. **Ready for tuning** + + + +## Tuning Flow + +```c title="10-byte tuning payload" +Bytes 0-3: Symbol Rate (u32 LE, in sps) +Bytes 4-7: Frequency (u32 LE, in kHz) +Byte 8: Modulation (0-9, see modulation types) +Byte 9: FEC Rate (index into firmware FEC table) +``` + +### Modulation Types + +| Value | Constant | Mode | +|-------|----------|------| +| 0 | `ADV_MOD_DVB_QPSK` | DVB-S QPSK | +| 1 | `ADV_MOD_TURBO_QPSK` | Turbo QPSK | +| 2 | `ADV_MOD_TURBO_8PSK` | Turbo 8PSK | +| 3 | `ADV_MOD_TURBO_16QAM` | Turbo 16QAM | +| 4 | `ADV_MOD_DCII_C_QPSK` | Digicipher II Combo | +| 5 | `ADV_MOD_DCII_I_QPSK` | Digicipher II I-stream | +| 6 | `ADV_MOD_DCII_Q_QPSK` | Digicipher II Q-stream | +| 7 | `ADV_MOD_DCII_C_OQPSK` | Digicipher II Offset QPSK | +| 8 | `ADV_MOD_DSS_QPSK` | DSS/DIRECTV QPSK | +| 9 | `ADV_MOD_DVB_BPSK` | DVB-S BPSK | + +### Signal Quality + +`GET_SIGNAL_STRENGTH` (`0x87`) returns 6 bytes: + +``` +Bytes 0-1: SNR value (u16 LE, in dBu*256 units) +Bytes 2-5: Reserved / diagnostics +``` + +SNR scaling in the kernel: `snr_value * 17` maps to the 0--65535 range. 100% signal quality corresponds to SNR >= `0x0F00`. + +## Firmware Version Handling + +The driver defines two version constants in `gp8psk-fe.h`: + +```c title="Firmware version thresholds" +#define GP8PSK_FW_REV1 0x020604 // v2.06.4 +#define GP8PSK_FW_REV2 0x020704 // v2.07.4 +``` + + + +Oldest firmware. No extended commands available. + + +v2.06.4 baseline. All standard commands operational. Uses `GET_SIGNAL_STRENGTH` for BER monitoring. + + +v2.07.4+. Enables additional code paths: +- `GET_DEMOD_STATUS` (`0x99`) for demod health check +- `INIT_DEMOD` (`0x9A`) for demod re-initialization +- `DELAY_COMMAND` (`0x9C`) for tuning acquisition delays +- Different signal quality calculation + + + +## Command Correlation with Firmware + +Not all vendor commands work on all firmware versions. The STALL behavior varies: + +| Command | v2.06 FW | v2.13 FW | Rev.2 FW | Custom v3.01 | +|---------|----------|----------|----------|-------------| +| `0x80` GET_8PSK_CONFIG | | | | | +| `0x86` TUNE_8PSK | | | | | +| `0x87` GET_SIGNAL_STRENGTH | | | | | +| `0x88` LOAD_BCM4500 | | | | | +| `0x99` GET_DEMOD_STATUS | | | | N/A | +| `0x9A` INIT_DEMOD | | | | N/A | +| `0x9C` DELAY_COMMAND | | | N/A | N/A | + + + +## Kernel Module Parameters + +The gp8psk module inherits standard DVB-USB parameters: + +| Parameter | Default | Description | +|-----------|---------|-------------| +| `debug` | 0 | Enable debug logging (bitmask) | +| `force_pid_filter` | 0 | Force PID filtering on/off | +| `generic_bulk_ctrl_endpoint` | `0x01` | Control endpoint | + +Enable verbose logging with: + +```bash +modprobe dvb_usb_gp8psk debug=0xff +``` + +Or at runtime: + +```bash +echo 0xff > /sys/module/dvb_usb_gp8psk/parameters/debug +``` + +## DVB Frontend Properties + +The gp8psk frontend (`gp8psk-fe.c`) registers with the following capabilities: + +```c title="Frontend info structure" +.name = "Genpix 8psk-to-USB2 DVB-S" +.frequency_min_hz = 800 * MHz +.frequency_max_hz = 2250 * MHz +.frequency_stepsize_hz = 100 * kHz +.symbol_rate_min = 256000 // 256 Ksps +.symbol_rate_max = 30000000 // 30 Msps +.caps = FE_CAN_INVERSION_AUTO | + FE_CAN_FEC_1_2 | FE_CAN_FEC_2_3 | + FE_CAN_FEC_3_4 | FE_CAN_FEC_5_6 | + FE_CAN_FEC_7_8 | FE_CAN_FEC_AUTO | + FE_CAN_QPSK +``` + + + +## Related Pages + +- [Vendor Commands](/usb/vendor-commands/) -- Complete command reference +- [Kernel FW01](/firmware/kernel-fw01/) -- Firmware format and loading analysis +- [DVB-S2 Investigation](/driver/dvb-s2/) -- Why DVB-S2 cannot be added +- [Custom Firmware v3.01](/firmware/custom-v301/) -- Open-source replacement with extended commands diff --git a/site/src/content/docs/firmware/custom-v301.mdx b/site/src/content/docs/firmware/custom-v301.mdx new file mode 100644 index 0000000..d545c69 --- /dev/null +++ b/site/src/content/docs/firmware/custom-v301.mdx @@ -0,0 +1,287 @@ +--- +title: Custom Firmware v3.01.0 +description: Open-source SDCC + fx2lib replacement firmware with diagnostic commands, spectrum sweep, and blind scan. +--- + +import { Steps, Badge, Aside, Tabs, TabItem, FileTree } from '@astrojs/starlight/components'; + +The custom v3.01.0 firmware is an open-source replacement for the stock SkyWalker-1 FX2 firmware, built with the SDCC compiler and fx2lib library. It implements all stock vendor commands for kernel driver compatibility and adds new diagnostic, spectrum sweep, and blind scan capabilities. + +## Project Structure + + +- firmware/ + - skywalker1.c Main firmware source (1351 lines) + - Makefile SDCC build rules + - skywalker1.ihx Compiled Intel HEX output +- tools/ + - fw_load.py FX2 RAM loader utility + - eeprom_flash.py EEPROM flash tool + + +## Architecture Overview + +| Property | Value | +|----------|-------| +| Toolchain | SDCC 4.x + fx2lib | +| Target | Cypress CY7C68013A (FX2LP) | +| Load method | RAM upload via `fw_load.py` (USB 0xA0 vendor request) | +| Binary size | ~3 KB | +| Source lines | 1351 | +| DiSEqC data pin | P0.7 (matches v2.06 hardware) | +| BCM4500 I2C address | `0x08` (7-bit); wire address `0x10`/`0x11` | + + + +## Stock-Compatible Commands + +All stock vendor commands (`0x80`--`0x94`) are implemented for full compatibility with the Linux `dvb_usb_gp8psk` kernel driver: + +| Command | Name | Implementation | +|---------|------|---------------| +| `0x80` | GET_8PSK_CONFIG | Returns `config_status` byte (1 byte) | +| `0x85` | ARM_TRANSFER | Calls `gpif_start()` / `gpif_stop()` | +| `0x86` | TUNE_8PSK | Parses 10-byte EP0 payload, programs BCM4500 | +| `0x87` | GET_SIGNAL_STRENGTH | Reads 6 BCM4500 indirect registers | +| `0x89` | BOOT_8PSK | Full BCM4500 boot sequence (see below) | +| `0x8A` | START_INTERSIL | Enables/disables LNB power supply | +| `0x8B` | SET_LNB_VOLTAGE | Sets P0.4 for 13V/18V selection | +| `0x8C` | SET_22KHZ_TONE | Sets P0.3 for 22 kHz oscillator gate | +| `0x8D` | SEND_DISEQC | DiSEqC tone burst via Timer2 bit-bang | +| `0x90` | GET_SIGNAL_LOCK | Reads BCM4500 lock register `0xA4` | +| `0x92` | GET_FW_VERS | Returns version `0x030100`, build date | +| `0x94` | USE_EXTRA_VOLT | Writes `0x62`/`0x6A` to XRAM `0xE0B6` | + +## Custom Diagnostic Commands + +Seven new vendor commands (`0xB0`--`0xB6`) extend the firmware with capabilities absent from all stock versions: + +| Command | Name | Direction | Payload | Purpose | +|---------|------|-----------|---------|---------| +| `0xB0` | SPECTRUM_SWEEP | OUT+Bulk | 10 bytes EP0 | Step through frequencies, return power readings via EP2 | +| `0xB1` | RAW_DEMOD_READ | IN | 2 bytes | Read arbitrary BCM4500 indirect register | +| `0xB2` | RAW_DEMOD_WRITE | OUT | 3 bytes | Write arbitrary BCM4500 indirect register | +| `0xB3` | BLIND_SCAN | OUT+EP0 | 16 bytes EP0 | Sweep symbol rates at a frequency, report lock | +| `0xB4` | I2C_SCAN | IN | N bytes | Scan I2C bus for responsive devices | +| `0xB5` | GET_BOOT_STAGE | IN | 2 bytes | Read `config_status` + `boot_stage` | +| `0xB6` | GET_GPIO_STATE | IN | 3 bytes | Read IOA, IOB, IOD port registers | + +### Spectrum Sweep (0xB0) + +Steps through frequencies from start to stop, reading BCM4500 signal energy at each step. Results are packed as u16 LE values into EP2 bulk endpoint. + +```c title="Spectrum sweep EP0 payload (10 bytes)" +EP0BUF[0..3] start_freq (u32 LE, kHz) +EP0BUF[4..7] stop_freq (u32 LE, kHz) +EP0BUF[8..9] step_khz (u16 LE, default 1000 if 0) +``` + +At each step, the firmware programs the BCM4500 frequency register via indirect write, waits 10 ms for settling, reads the SNR register pair, and packs the result into EP2 FIFO. When the buffer reaches 512 bytes, it is committed to the host. + +### Blind Scan (0xB3) + +Sweeps symbol rates from `sr_min` to `sr_max` at a given frequency, checking for signal lock at each step. + +```c title="Blind scan EP0 payload (16 bytes)" +EP0BUF[0..3] freq_khz (u32 LE) +EP0BUF[4..7] sr_min (u32 LE, sps) +EP0BUF[8..11] sr_max (u32 LE, sps) +EP0BUF[12..15] sr_step (u32 LE, sps, default 1000000 if 0) +``` + +Returns 8 bytes on lock (`freq_khz[4] + sr_locked[4]`), or 1 byte `0x00` if no lock found. + +### Raw Demod Access (0xB1 / 0xB2) + +Direct access to any BCM4500 indirect register, bypassing the stock firmware's limited register set: + +```c title="Raw demod read (0xB1)" +// wValue = register page, wIndex = register number +// Returns 1 byte in EP0 +bcm_indirect_read(page, &val); +EP0BUF[0] = val; +``` + +```c title="Raw demod write (0xB2)" +// wValue = register page, wIndex = register number +// EP0 data = 1 byte value +bcm_indirect_write(page, val); +``` + +## BCM4500 Boot Sequence + +The `bcm4500_boot()` function replicates the stock firmware's initialization with added diagnostic instrumentation. The `boot_stage` variable tracks progress for debugging failed boots. + + + +1. **GPIO setup** (`boot_stage = 1`): Set P3.7/P3.6/P3.5 HIGH (control lines idle), assert BCM4500 RESET (P0.5 LOW) + +2. **Power on** (`boot_stage = 2`): Enable power supply (P0.1 HIGH, P0.2 LOW), wait 30 ms for settling, release RESET (P0.5 HIGH), wait 50 ms for BCM4500 POR + +3. **I2C probe** (`boot_stage = 3`): Read BCM4500 status register `0xA2` to verify the chip is alive on the I2C bus + +4. **Init block 0** (`boot_stage = 4`): Write 7-byte configuration block to BCM4500 page 0 indirect registers + +5. **Init block 1** (`boot_stage = 5`): Write 8-byte configuration block + +6. **Init block 2** (`boot_stage = 6`): Write 3-byte configuration block + +7. **Success** (`boot_stage = 0xFF`): Set `BM_STARTED | BM_FW_LOADED` in config status + + + +### BCM4500 Init Data + +Three initialization blocks extracted from stock v2.06 firmware (`FUN_CODE_0ddd`): + +```c title="BCM4500 register initialization data" +static const __code BYTE bcm_init_block0[] = { + 0x06, 0x0b, 0x17, 0x38, 0x9f, 0xd9, 0x80 +}; +static const __code BYTE bcm_init_block1[] = { + 0x07, 0x09, 0x39, 0x4f, 0x00, 0x65, 0xb7, 0x10 +}; +static const __code BYTE bcm_init_block2[] = { + 0x0f, 0x0c, 0x09 +}; +``` + +Each block is written to BCM4500 page 0 via the indirect register protocol: page select to `0xA6`, data bytes to `0xA7`, trailing zero to `0xA7`, commit `0x03` to `0xA8`, then poll for completion. + +### Debug Boot Modes + +The BOOT_8PSK command (`0x89`) accepts debug wValue parameters that execute partial boot sequences for incremental hardware debugging: + +| wValue | Stage | What It Does | Success Marker | +|--------|-------|-------------|----------------| +| `0x80` | None | No-op, return current state | -- | +| `0x81` | GPIO only | GPIO setup + power + reset, no I2C | `0xA1` | +| `0x82` | GPIO + probe | GPIO + I2C read of status register | `0xA2` | +| `0x83` | GPIO + probe + block 0 | GPIO + I2C + first init block | `0xA3` | +| `0x84` | I2C only | Probe without GPIO (chip must be powered) | `0xA4` | +| `0x85` | GPIO + probe (no bus reset) | Same as `0x82` without I2CS bmSTOP | `0xA5` | +| `0x01` | Full boot | Complete `bcm4500_boot()` sequence | `0xFF` | +| `0x00` | Shutdown | Power off BCM4500 | -- | + + + +## I2C Implementation + +The custom firmware implements I2C from scratch rather than using fx2lib's I2C functions, providing full timeout protection: + +```c title="I2C timeout constant" +#define I2C_TIMEOUT 6000 // ~5ms at 48MHz (4 clocks/cycle, ~12 MIPS) +``` + +Key I2C functions: + +| Function | Purpose | +|----------|---------| +| `i2c_wait_done()` | Poll `I2CS.bmDONE` with 6000-count timeout | +| `i2c_wait_stop()` | Poll `I2CS.bmSTOP` clear with timeout | +| `i2c_combined_read()` | Write-then-read with repeated START (no intermediate STOP) | +| `i2c_write_timeout()` | Single-byte write with timeout on each phase | +| `i2c_write_multi_timeout()` | Multi-byte write with timeout | + + + +### BCM4500 Register Access + +The BCM4500 uses an indirect register protocol through three I2C registers: + +| Register | Address | Purpose | +|----------|---------|---------| +| BCM_REG_PAGE | `0xA6` | Page/register select | +| BCM_REG_DATA | `0xA7` | Data read/write | +| BCM_REG_CMD | `0xA8` | Command trigger (`0x01` = read, `0x03` = write) | + +```c title="Indirect register read sequence" +// 1. Write [page, 0x00, 0x01] to A6/A7/A8 in one I2C transaction +// 2. Wait for command completion (poll A8 bit 0 == 0) +// 3. Read result from A7 +``` + +## GPIF Streaming + +Transport stream data from the BCM4500 flows through the FX2's GPIF engine into USB endpoint EP2: + +```c title="GPIF configuration" +IFCONFIG = 0xEE; // Internal 48MHz, GPIF master, async, clock output +EP2FIFOCFG = 0x0C; // AUTOIN, ZEROLENIN, 8-bit +FLOWSTATE |= 0x09; // Enable flow state + FS[3] +GPIFTCB3 = 0x80; // Transaction count = 0x80000000 (effectively infinite) +``` + +The `gpif_start()` function arms the GPIF for continuous read into EP2, while `gpif_stop()` flushes the FIFO and de-asserts the BCM4500 control lines on P3. + +## GPIO Pin Map + +```c title="GPIO pin definitions (v2.06 hardware)" +#define PIN_PWR_EN 0x02 // P0.1 -- power supply enable +#define PIN_PWR_DIS 0x04 // P0.2 -- power supply disable +#define PIN_22KHZ 0x08 // P0.3 -- 22kHz oscillator gate +#define PIN_LNB_VOLT 0x10 // P0.4 -- LNB voltage select +#define PIN_BCM_RESET 0x20 // P0.5 -- BCM4500 hardware reset +#define PIN_DISEQC 0x80 // P0.7 -- DiSEqC data +``` + +Initial state after `TD_Init()`: +- `IOA = 0x84` (P0.7 HIGH, P0.2 HIGH -- power disabled, streaming off) +- `OEA = 0xBE` (P0.1 through P0.5 and P0.7 as outputs) + +## Differences from Stock Firmware + +| Feature | Stock v2.06 | Custom v3.01 | +|---------|-------------|--------------| +| Toolchain | Unknown (proprietary) | SDCC + fx2lib (open source) | +| I2C timeout | None (infinite spin) | 6000-count (~5 ms) | +| Boot diagnostics | None | Incremental debug modes | +| New commands | None | 7 commands (`0xB0`--`0xB6`) | +| Spectrum sweep | Not possible | `0xB0` with configurable step | +| Blind scan | Not possible | `0xB3` with SR sweep | +| Raw register access | Not possible | `0xB1`/`0xB2` | +| I2C bus scan | Not possible | `0xB4` | +| GPIO read | Not possible | `0xB6` | +| Anti-tampering | Present (v2.13) | Removed | +| Source available | No | Yes (`firmware/skywalker1.c`) | + +## Tuning Implementation + +The `do_tune()` function parses the same 10-byte EP0 payload as the stock firmware: + +```c title="Tune command payload parsing" +// Byte-reverse symbol rate and frequency from LE to BE +for (i = 0; i < 4; i++) { + tune_data[i] = EP0BUF[3 - i]; // Symbol rate (BE) + tune_data[4 + i] = EP0BUF[7 - i]; // Frequency (BE) +} +tune_data[8] = EP0BUF[8]; // Modulation type (0-9) +tune_data[9] = EP0BUF[9]; // FEC index +tune_data[10] = 0x10; // Demod mode (standard) +tune_data[11] = 0x00; // Turbo flag +``` + +Modulation-specific handling: +- Modulation types 1--3 (turbo modes): Set turbo flag `tune_data[11] = 0x01` +- Modulation type 5: DCII I-stream, demod mode `0x12` +- Modulation type 6: DCII Q-stream, demod mode `0x16` +- Modulation type 7: DCII offset QPSK, demod mode `0x11` diff --git a/site/src/content/docs/firmware/fw213-variants.mdx b/site/src/content/docs/firmware/fw213-variants.mdx new file mode 100644 index 0000000..a448574 --- /dev/null +++ b/site/src/content/docs/firmware/fw213-variants.mdx @@ -0,0 +1,213 @@ +--- +title: FW2.13 Sub-Variant Comparison +description: Binary and functional comparison of v2.13 firmware sub-variants FW1, FW2, and FW3. +--- + +import { Tabs, TabItem, Badge, Aside } from '@astrojs/starlight/components'; + +The v2.13 firmware was distributed as three sub-variants via the `SW1_update_2_13_x.exe` Windows updater tool. Ghidra analysis reveals that these target fundamentally different hardware interfaces, not just minor revisions. + +## Overview + +| Aspect | FW1 (v2.13.1) | FW2 (v2.13.2) | FW3 (v2.13.3) | +|--------|---------------|---------------|---------------| +| Version ID | `0x020D01` | `0x020D01` | `0x020D01` | +| Build date | 2010-03-12 | 2010-03-12 | 2010-03-12 | +| Functions | 82 | 83 | 83 | +| Binary size | 9,322 bytes | 9,377 bytes | 9,369 bytes | +| Stack pointer | `0x50` | `0x50` | **`0x52`** | +| P0 init | `0xA4` | `0xA4` | **`0xA0`** | +| Status register | INTMEM `0x4F` | INTMEM `0x4F` | **INTMEM `0x51`** | +| Demod interface | **I2C bus** | **Parallel bus (P0/P1)** | **Parallel bus (enhanced)** | +| Config source | Hardcoded | External (`0xE080`--`0xE08E`) | External (`0xE080`--`0xE08E`) | + + + +## Hardware Interface Evolution + + + + +### FW1 (v2.13.1) + +FW1 targets the original SkyWalker-1 PCB with an **I2C-connected demodulator**. The FX2 communicates with the demod entirely through standard I2C master-mode transactions. + +**Evidence from `FUN_CODE_0eea`:** +- Uses `FUN_CODE_23ae` (I2C START), `FUN_CODE_23ee` (I2C byte write), `FUN_CODE_23d0` (I2C address) +- Standard I2C retry with NACK detection +- Timer2-based I2C timeout (TR2 check in vendor handler) +- Reads back via `FUN_CODE_2164` + +**Unique functions:** +- `FUN_CODE_0fc7` -- I2C write-with-retry (20 attempts via I2C bus) +- `FUN_CODE_1405` -- Tuner/demodulator identification via I2C + P1 port reads with signature matching +- `FUN_CODE_14b9` -- Calibrated delay function with CPUCS clock divider awareness + +**Demodulator type detection** (from `FUN_CODE_1405`): +| Type Code | P1 Signature | +|-----------|--------------| +| Type 3 | `0xA5` or `0xB5` | +| Type 4 | `0x5A` | +| Type 5 | `0x5B` | +| Type 6 | `0x5C` | + + + + +### FW2 (v2.13.2) + +FW2 targets a revised PCB with a **parallel-bus connected demodulator**. The demod data port is connected directly to the FX2's P1, with P0 bits controlling bus signals. + +**Evidence from `FUN_CODE_0eea`:** +- Reads demod type from address table (BANK1 pointer + offset) +- Uses `FUN_CODE_11b6` for demod selection +- Toggles P0 bits 6/7 for bus control (P0.6 = chip select, P0.7 = read strobe) +- Reads data from **P1 port** (8-bit parallel data bus) +- Single-phase read: one P1 read per bus cycle + +**Bus protocol (decompiled):** +```c title="FW2 parallel bus read" +uVar1 = P1; // Read data with one bus state +P0 |= 0x40; // Change control line +uVar2 = P1; // Read again with new state +FUN_CODE_1b2a(uVar2, uVar1); // Process both samples +``` + +**Configuration loading:** +- Loads 15 configuration bytes from external memory (`0xE080`--`0xE08E`) into demod registers (`0xE6C0`--`0xE6CD`) +- Same device signature matching as FW1 but via parallel bus (`P1 ^ 0x1D` check) + + + + +### FW3 (v2.13.3) + +FW3 targets a further revised PCB with the same parallel-bus architecture as FW2 but with a **different bus timing protocol**. Uses dual-phase reads with OR-accumulation. + +**Evidence from `FUN_CODE_0eea`:** +- Initializes OR-accumulators: `DAT_INTMEM_3f = 0; DAT_INTMEM_40 = 0` +- Sets P0 | 0x80 once at start (not per-iteration like FW2) +- Two separate P1 reads per cycle with different P0.6 states +- OR-accumulates results before processing + +**Bus protocol (decompiled):** +```c title="FW3 dual-phase parallel bus read" +DAT_INTMEM_3f = 0; +DAT_INTMEM_40 = 0; // Clear accumulators + +// Phase 1: P0.6 high +P0 |= 0x44; +bVar2 = P1; +DAT_INTMEM_3f |= bVar2; // OR-accumulate + +// Phase 2: P0.6 low +P0 &= ~0x40; +bVar2 = P1; +DAT_INTMEM_40 |= bVar2; // OR-accumulate + +FUN_CODE_1b2a(0, DAT_INTMEM_3f, DAT_INTMEM_40); +``` + +**Why OR-accumulation?** This pattern suggests the demod chip variant has either: +- Open-drain outputs requiring multiple read cycles +- Bus settling time issues on the newer PCB layout +- A chip revision that serializes data across multiple bus phases + + + +## Binary Distance Matrix + +Byte-level differences between sub-variants: + +| Pair | Different Bytes | Percentage Different | +|------|----------------:|---------------------:| +| FW1 vs FW2 | 3,993 | 42.8% | +| FW1 vs FW3 | 3,789 | 40.6% | +| FW2 vs FW3 | **1,525** | **16.5%** | + +FW2 and FW3 are 83.5% identical at the byte level, confirming they share the same parallel-bus architecture. FW1 diverges significantly because it uses a completely different bus interface (I2C vs. parallel). + +## Memory Comparison at Key Offsets + +### Identical Regions + +These regions are byte-identical across all three sub-variants: + +| Address Range | Content | +|---------------|---------| +| `0x0000`--`0x000F` | RESET vector (`LJMP 0x170D`), INT0 handler | +| `0x0B88`--`0x0B9F` | Init table (same XRAM register initialization) | +| `0x06D9`--`0x06F0` | Generic memory access utilities | +| `0x1740`--`0x174F` | Bit manipulation lookup table | + +### Critical Divergence: `CODE:0EEA` + +This is where the three sub-variants diverge most dramatically: + +``` +FW1: 8f44 8c45 8d46 8b47 754a14 e544 b451... + (I2C transfer parameters in registers) + +FW2: 753e14 e50d 240a f582 e435 0cf5 83e0... + (reads from DPTR+offset table) + +FW3: 753e14 e4f5 3ff5 40 e50d 240a f582... + (similar to FW2 + accumulator initialization) +``` + +FW1's `FUN_CODE_0eea` is a standard I2C master transfer function. FW2/FW3's version is a parallel bus demodulator interface. + +### Thunk Target Divergence (`CODE:1500`) + +``` +FW1: 02 2252 00 02 22dd 00 02 22c7 00 02 226a 00 +FW2: 02 228d 00 02 2318 00 02 2302 00 02 22a5 00 +FW3: 02 228d 00 02 2318 00 02 2302 00 02 22a5 00 +``` + +FW2 and FW3 share identical interrupt handler targets. FW1 jumps to different addresses, reflecting its different internal function layout. + +## Detailed Differences + +### Stack Pointer and Status Register + +| Property | FW1 | FW2 | FW3 | +|----------|-----|-----|-----| +| SP value | `0x50` | `0x50` | `0x52` | +| Status IRAM | `0x4F` | `0x4F` | `0x51` | +| I2C buffer IRAM | `0x48`/`0x49` | `0x48`/`0x49` | `0x4A`/`0x4B` | + +FW3 pushes the stack pointer up by 2 bytes to make room for the additional status register at IRAM `0x51`. The 2-byte SP difference exactly accounts for moving the status register from `0x4F` to `0x51`. + +### P0 Init Value + +| Variant | P0 Init | Binary | Difference | +|---------|---------|--------|------------| +| FW1/FW2 | `0xA4` | `1010 0100` | Bit 2 = 1 | +| FW3 | `0xA0` | `1010 0000` | Bit 2 = 0 | + +P0 bit 2 controls a GPIO signal likely related to demodulator interface mode or reset polarity on the FW3 target PCB. + +### Vendor Handler Differences + +| Feature | FW1 | FW2/FW3 | +|---------|-----|---------| +| Case `0x3D3` | TR2 timer check (I2C timeout) | OR operation (parallel bus) | +| Case `0x421`-`0x423` | Simple check | P2.1 write + rotate-left (bus direction) | +| Error path | `func_0x06e4` | `DAT=0x0` | + +FW1's timer-based case is used for I2C bus timeout recovery. FW2/FW3's rotate-left and P2.1 write is a parallel bus data direction control. + +## Hardware Progression Theory + +The three sub-variants represent an evolutionary progression: + +1. **FW1 (v2.13.1)**: Original design with I2C-connected demodulator. Simple interface but limited in bandwidth. The FX2 acts purely as an I2C master bridge. + +2. **FW2 (v2.13.2)**: Redesigned with parallel-bus demodulator for higher throughput. P1 carries 8-bit data, P0 provides control signals. External calibration data at `0xE080`--`0xE08E`. + +3. **FW3 (v2.13.3)**: Refined parallel interface for a newer demod silicon revision. Dual-phase reads with OR-accumulation handle bus timing differences. Additional IRAM state tracking (SP bumped to `0x52`). + +All three support the same modulation types (DVB-S QPSK, Turbo QPSK/8PSK/16QAM, DCII, DSS) and the same demod type codes (3--6). The differences are purely hardware interface, not feature set. diff --git a/site/src/content/docs/firmware/kernel-fw01.mdx b/site/src/content/docs/firmware/kernel-fw01.mdx new file mode 100644 index 0000000..d48f675 --- /dev/null +++ b/site/src/content/docs/firmware/kernel-fw01.mdx @@ -0,0 +1,184 @@ +--- +title: Kernel FW01 Analysis +description: Analysis of the dvb-usb-gp8psk-01.fw firmware format, loading mechanism, and why SkyWalker-1 does not need it. +--- + +import { Steps, Badge, Aside, Tabs, TabItem, FileTree } from '@astrojs/starlight/components'; + +The Linux kernel `dvb_usb_gp8psk` driver references two firmware files: `dvb-usb-gp8psk-01.fw` (FX2 microcontroller code) and `dvb-usb-gp8psk-02.fw` (BCM4500 demodulator code). Neither file was ever open-sourced or included in the `linux-firmware` repository. The SkyWalker-1 does not need them. + +## Firmware File Status + +| File | Purpose | Available? | Needed by SkyWalker-1? | +|------|---------|------------|----------------------| +| `dvb-usb-gp8psk-01.fw` | FX2 RAM code | **Not in linux-firmware** | No | +| `dvb-usb-gp8psk-02.fw` | BCM4500 demod code | **Not in linux-firmware** | No | + +Standard locations checked: + +| Path | Result | +|------|--------| +| `/lib/firmware/dvb-usb-gp8psk-01.fw` | Not found | +| `/lib/firmware/dvb-usb-gp8psk-02.fw` | Not found | +| `linux-firmware` WHENCE manifest | No gp8psk entry | +| Kernel `scripts/get_dvb_firmware` | No gp8psk handler | +| `pacman -F dvb-usb-gp8psk-01.fw` | No package provides it | + + + +## Why SkyWalker-1 Works Without Firmware Files + +The answer is in the kernel driver's device table. Only Rev.1 Cold devices (PID `0x0200`) have a `cold_ids` entry, which triggers firmware download: + +```c title="Kernel device properties (from gp8psk.c)" +.devices = { + { .name = "Genpix 8PSK-to-USB2 Rev.1 DVB-S receiver", + .cold_ids = { &gp8psk_usb_table[GENPIX_8PSK_REV_1_COLD], NULL }, + .warm_ids = { &gp8psk_usb_table[GENPIX_8PSK_REV_1_WARM], NULL }, + }, + { .name = "Genpix SkyWalker-1 DVB-S receiver", + .cold_ids = { NULL }, // <-- NO cold_ids: skip firmware + .warm_ids = { &gp8psk_usb_table[GENPIX_SKYWALKER_1], NULL }, + }, + // ... +} +``` + +When `cold_ids` is NULL, the DVB-USB framework skips firmware download entirely. The SkyWalker-1 boots from its onboard EEPROM and enumerates directly as a "warm" device. + +| Device | PID | Needs FW01? | Needs FW02? | Boot Source | +|--------|-----|-------------|-------------|-------------| +| Rev.1 Cold | `0x0200` | **Yes** | -- | RAM (empty) | +| Rev.1 Warm | `0x0201` | No | **Yes** | RAM (FW01 loaded) | +| Rev.2 | `0x0202` | No | No | EEPROM | +| SkyWalker-1 | `0x0203` | No | No | EEPROM | +| SkyWalker CW3K | `0x0206` | No | No | EEPROM | + +## FW01 Loading Mechanism + +For Rev.1 Cold devices, the firmware loading follows this sequence: + + + +1. **DVB-USB framework** matches the USB VID:PID against `cold_ids` and calls `dvb_usb_download_firmware()` + +2. **Kernel requests firmware** via `request_firmware("dvb-usb-gp8psk-01.fw", ...)` from the userspace firmware loader + +3. **Cypress FX2 loader** (`usb_cypress_load_firmware()`) halts the FX2 CPU by writing `0x01` to CPUCS register (`0xE600`) via the 0xA0 vendor request + +4. **Hexline records** are parsed and written to FX2 RAM via USB control transfers (0xA0 vendor request) + +5. **FX2 CPU restarted** by writing `0x00` to CPUCS. The device re-enumerates with a new PID (0x0201, "warm") + +6. **DVB-USB framework** re-matches the new PID against `warm_ids` and proceeds to frontend attach + + + +The 0xA0 vendor request is handled by the FX2's built-in silicon boot ROM, which provides RAM read/write access regardless of whether user firmware is running. This is the same mechanism used by the custom firmware's `fw_load.py` tool. + +## FW01 Binary Hexline Format + +The kernel's `dvb_usb_get_hexline()` parser expects a compact binary representation of Intel HEX records. This is **not** standard Intel HEX text (`:10000000...`), nor the kernel's `ihex_binrec` format from ``. + +### Record Structure + +``` +Offset Size Field +------ ---- ----- +0 1 len - Number of data bytes +1 1 addr_lo - Target address low byte +2 1 addr_hi - Target address high byte +3 1 type - Record type +4 len data[] - Payload bytes +4+len 1 chk - Checksum byte + +Total per record: len + 5 bytes +``` + +### Record Types + +| Type | Name | Purpose | +|------|------|---------| +| `0x00` | Data | Code/data bytes for FX2 RAM | +| `0x01` | EOF | End of file | +| `0x04` | Extended Address | Sets upper 16 bits of target address | + +## FW02 Chunk Format (BCM4500 Firmware) + +FW02 is only relevant for Rev.1 Warm devices (PID `0x0201`). It uses a custom chunk protocol: + +``` +Chunk format: + Byte 0: payload_length (N) + Bytes 1-3: header/address bytes + Bytes 4..N+3: payload data + Terminator: single byte 0xFF + Maximum chunk size: 64 bytes (USB control transfer limit) +``` + +The loading sequence: + + + +1. **Initiate transfer**: Send `LOAD_BCM4500` command (`0x88`, `wValue=1`) + +2. **Download chunks**: Iterate through firmware data, sending each chunk via `dvb_usb_generic_write()` on bulk endpoint `0x01` + +3. **Detect end**: Stop when a byte with value `0xFF` is encountered + + + +```c title="BCM4500 firmware loading (from gp8psk.c)" +ptr = fw_data; +while (ptr[0] != 0xFF) { + chunk_size = ptr[0] + 4; + if (chunk_size > 64) { + // Error: chunk too large + } + usb_control_msg(device, USB_SNDCTRLPIPE, 0, ..., + buf, chunk_size, 2000); + ptr += chunk_size; +} +``` + + + +## C2 EEPROM Format vs Kernel Hexline + +The firmware as stored in the SkyWalker-1's EEPROM uses Cypress C2 format, which is structurally different from the kernel's binary hexline format. They carry identical payload data but are different containers. + +| Property | C2 (EEPROM) | Hexline (Kernel FW01) | +|----------|-------------|-----------------------| +| Header | 8-byte C2 with VID/PID/DID | None | +| Address encoding | Big-endian 16-bit per segment | Little-endian split (lo, hi) per record | +| Data chunking | 1023-byte segments | Typically 16-byte records | +| Record overhead | 4 bytes per segment | 5 bytes per record | +| Terminator | `0x80xx` + entry point | Type `0x01` EOF record | +| Entry point | Explicit in terminator | Implicit (CPUCS at `0xE600`) | + +A C2 file can theoretically be converted to hexline format by: +1. Stripping the 8-byte C2 header +2. Splitting each segment into 16-byte records with type `0x00` +3. Appending an EOF record (len=0, type=`0x01`) + +For the v2.06 EEPROM (9,472 code bytes), this would produce approximately 12,442 bytes in hexline format. + +See the [Storage Formats](/firmware/storage-formats/) page for detailed C2 format documentation. + +## Kernel dmesg Output + +When the SkyWalker-1 is connected, the kernel logs: + +``` +gp8psk: FW Version = 2.06.4 (0x20604) Build 2007/07/13 +gp8psk: usb in 149 operation failed. +gp8psk: failed to get FPGA version +gp8psk_fe: Frontend attached +gp8psk: found Genpix USB device pID = 203 (hex) +``` + +The "failed to get FPGA version" error is command `0x95` (`GET_FPGA_VERS`, decimal 149) returning an error on some units. Despite the name, there is no FPGA on the SkyWalker-1 -- this command reads a hardware platform ID from the EEPROM. The driver logs the failure but continues normally. diff --git a/site/src/content/docs/firmware/rev2-analysis.mdx b/site/src/content/docs/firmware/rev2-analysis.mdx new file mode 100644 index 0000000..30e3b49 --- /dev/null +++ b/site/src/content/docs/firmware/rev2-analysis.mdx @@ -0,0 +1,210 @@ +--- +title: Rev.2 Firmware Analysis +description: Deep analysis of the Rev.2 v2.10.4 firmware variant with 107 functions and transitional architecture. +--- + +import { Badge, Aside, Tabs, TabItem } from '@astrojs/starlight/components'; + +The Rev.2 v2.10.4 firmware targets the Rev.2 hardware variant (PID `0x0202`) and contains **107 functions** -- the most of any firmware version. Despite this, it produces the smallest binary (8,843 bytes) due to aggressive function decomposition into small helper routines. + +## Architectural Position + +Rev.2 sits architecturally between v2.06 and v2.13: + +| Aspect | v2.06 | Rev.2 v2.10 | v2.13 | +|--------|-------|-------------|-------| +| INT0 behavior | USB re-enumeration | USB re-enumeration | Demod polling | +| Descriptor base | `0x1200` | `0x0E00` | `0x0E00` | +| Stack pointer | `0x72` | `0x4F` | `0x50` | +| Vendor command range | `0x80`--`0x9D` (30) | `0x80`--`0x9A` (27) | `0x80`--`0x9D` (30) | +| Demod probe at boot | No | No | Yes | +| Retry loops | No | No | Yes | +| Function count | 61 | **107** | 82-88 | +| Binary size | 9,472 bytes | **8,843 bytes** | 9,322 bytes | + + + +## Why 107 Functions? + +The high function count is driven by three factors: + +1. **Granular decomposition**: Rev.2 breaks large operations into many small helper functions (10-30 bytes each), where v2.06 inlines the same logic and v2.13 recombines it differently. + +2. **Massive configuration dispatcher**: `FUN_CODE_0800` is 874 bytes and contains an embedded copy of the main loop, causing Ghidra to count additional entry points as separate functions. + +3. **Extra I2C/demodulator helper chains**: GPIO control primitives, hardware-polling wait loops, and I2C bus management exist as individual callable units rather than being inlined. + +## Function Inventory Overview + +The 107 functions are organized into logical groups: + +### Vector Table and ISR Region (0x0000--0x0055) + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x0000` | `RESET_vector` | 3 | Jump to `main` at `0x155F` | +| `0x0003` | `INT0_ISR` | 12 | INT0 handler -- USB re-enumeration | +| `0x000F` | `INT0_ISR_bit_clear` | 36 | CPUCS pulse, IRQ clear, delay | +| `0x0033` | `INT2_USB_GPIF_vector` | 3 | Clears CCON.4 (PCA timer) | +| `0x0036` | `i2c_exchange_byte` | 5 | I2C byte exchange primitive | +| `0x003B` | `I2C_ISR` | 8 | I2C interrupt handler | +| `0x0043` | `INT4_FX2_vector` | 8 | Sets `_0_1` flag, clears EXIF.4 | +| `0x004B` | `INT5_FX2_vector` | 3 | Empty (RETI) | +| `0x0053` | `INT6_FX2_vector` | 3 | Sets `_0_1` flag, clears EXIF.4 | + +### Vendor Command Dispatch (0x0056--0x0319) + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x0056` | `vendor_cmd_dispatch` | 342 | Range check `0x80`--`0x9A`, jump table at `0x0076` | +| `0x01AC` | GET_8PSK_CONFIG handler | 361 | Reads config byte, calls LNB probe | +| `0x0315` | `vendor_cmd_stall` | 2 | Stall handler (empty RET) | +| `0x0319` | Standard USB request handler | 869 | Switch for `bRequest` `0x00`--`0x0B` | + +### Configuration and Tuning (0x0800--0x09A8) + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x0800` | Config/tuning dispatcher | **874** | 128-entry switch on demod type, embedded main loop | +| `0x09A9` | Main init + main loop | 699 | Hardware init, infinite poll loop | + +### BCM4500 and GPIF (0x0C64--0x0F00) + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x0C64` | BCM4500 firmware loader | 280 | I2C block transfer with address tracking | +| `0x0D7C` | GPIF/slave FIFO config | 128 | Enable/disable streaming mode | +| `0x0F00` | I2C multi-byte read | 256 | Parameter setup for bus transfer | + +### DiSEqC Implementation (0x07D1, 0x1D5E--0x1E3D) + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x07D1` | `DiSEqC byte transmit` | 45 | 8 data bits + odd parity via **P0.4** | +| `0x1D5E` | DiSEqC message sender | 59 | Iterates bytes, calls bit-bang per byte | +| `0x1E3D` | DiSEqC byte wrapper | 54 | Sets P0.2, adds inter-byte delay | +| `0x213C` | DiSEqC bit symbol | 22 | Carrier on/off via P0.3, data via P0.4 | +| `0x20E2` | 22 kHz tone burst | 23 | P0.3 ON, 25 ticks, P0.3 OFF | +| `0x225F` | Timer2 tick wait | 6 | TF2 poll and clear (500 us tick) | + + + +### LNB and GPIO Control (0x1F5C--0x2038) + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x1F5C` | LNB voltage I2C select | 41 | Probes I2C device `0x60` or address from `0xE0B6` | +| `0x1FCF` | GPIO pin controller | 46 | Sets P0.6, P0.0, P3.4 based on parameter bits | +| `0x2038` | GPIO clock strobe | 51 | Calls pin controller 3 times (setup, clock, cleanup) | +| `0x21B1` | LNB voltage select | 17 | Sets/clears P0.4, updates config bit 5 | +| `0x21C2` | 22 kHz tone enable | 17 | Sets/clears P0.3, updates config bit 4 | +| `0x21D3` | DiSEqC port direction | 17 | Sets/clears P3.6, updates config bit 3 | + +### I2C Bus Management (0x19F4--0x1B90) + +Rev.2 decomposes I2C operations into particularly fine-grained functions: + +| Address | Name | Size | Role | +|---------|------|-----:|------| +| `0x19F4` | I2C bus controller | 92 | Manages SDA/SCL via XRAM `0xE678` | +| `0x1A50` | I2C address select + start | 83 | START condition generation | +| `0x1AA3` | I2C stop + cleanup | 82 | STOP condition and bus release | +| `0x1AF5` | I2C address write helper | 9 | Writes device address byte | +| `0x1B01` | I2C byte-level transfer | 67 | Single byte send/receive | +| `0x1B44` | I2C ACK/NAK handling | 76 | Acknowledge detection | +| `0x1B90` | I2C bus reset/recovery | 74 | Error recovery sequence | +| `0x1F06` | I2C completion wait | 43 | Polls XRAM `0xE678` bit 0 with 16-bit timeout | +| `0x1F85` | I2C completion wait (2-flag) | 37 | Polls bits 0 and 2 | +| `0x2000` | I2C busy wait | 30 | Polls XRAM `0xE678` bit 6 with timeout | + +## Rev.2-Specific Features + +### GPIO Pin Controller (`FUN_CODE_1fcf`) + +A unique function that provides parameterized GPIO control through a bit-field interface: + +```c title="GPIO pin controller (decompiled)" +void gpio_pin_controller(BYTE param) { + if (param & 0x02) P0 |= 0x01; // P0.0 + else P0 &= ~0x01; + + if (param & 0x04) P0 |= 0x40; // P0.6 + else P0 &= ~0x40; + + if (param & 0x08) P3 |= 0x10; // P3.4 + else P3 &= ~0x10; +} +``` + +This function is called via `FUN_CODE_2038` (GPIO clock strobe) which invokes it three times per cycle -- setup, clock edge, and cleanup -- suggesting it controls a clocked peripheral interface. + +### Descriptor Version Checker (`FUN_CODE_1f31`) + +Walks a USB descriptor chain checking whether `descriptor_byte + 1 == 0x03`, enabling hardware-revision-aware code paths. This mechanism appears in a simplified form in v2.13 as the `_1_3` flag check. + +### Prototype Commands 0x99/0x9A + +Commands 0x99 and 0x9A exist in Rev.2 as partial prototype implementations, before becoming fully functional in v2.13: + +| Command | Rev.2 Behavior | v2.13 Behavior | +|---------|---------------|---------------| +| `0x99` | Prototype -- limited status read | Full GET_DEMOD_STATUS (reads BCM4500 reg `0xF9`) | +| `0x9A` | Prototype -- basic init call | Full INIT_DEMOD (3-attempt re-init with flag check) | + +## Cross-Version Function Mapping + +Key Rev.2 functions and their counterparts in other versions: + +| Rev.2 Function | Role | v2.06 | v2.13 | +|----------------|------|-------|-------| +| `0x155F` main | RESET entry, IRAM clear | `0x188D` | `0x170D` | +| `0x09A9` main init | Init + main loop | `0x09A7` | `0x0800` | +| `0x10D9` USB setup | Descriptor/peripheral init | `0x13C3` | `0x11AB` | +| `0x0056` vendor dispatch | Vendor command dispatcher | `0x0056` | `0x0056` | +| `0x0C64` BCM4500 loader | Firmware block transfer | `0x0DDD` | `0x0CA4` | +| `0x0D7C` GPIF/FIFO | Streaming management | `0x1919` | `0x1800` | +| `0x1BDA` delay | Clock-compensated delay | `0x1DFB` | `0x14B9` | + +## GPIO Differences from SkyWalker-1 + +The Rev.2 board has a different GPIO assignment from the standard SkyWalker-1: + +| Pin | Rev.2 v2.10 | v2.06 / v2.13 | +|-----|-------------|---------------| +| P0.0 | LNB control (cmd `0x97`) | DiSEqC data (v2.13) / unused (v2.06) | +| P0.4 | LNB voltage **+ DiSEqC data** | LNB voltage only | +| P0.5 | GPIO status input (cmd `0x98`) | BCM4500 RESET | +| P0.6 | GPIO control (cmd `0x97`) | Unused | +| P0.7 | Streaming indicator | DiSEqC data (v2.06) / streaming (v2.13) | + +The most significant difference is that Rev.2 multiplexes DiSEqC data onto the LNB voltage pin (P0.4), and the BCM4500 RESET function on P0.5 is replaced by a GPIO status input. + +## Main Loop Structure + +The Rev.2 main loop follows the same pattern as other versions but with the event handling delegated to `FUN_CODE_201e`: + +```c title="Main loop poll (simplified)" +void main_loop(void) { + // Process init table from CODE:0B48 + // Call USB/peripheral setup + // Enable interrupts + + while (1) { + if (sudav_flag) { + handle_setupdata(); + sudav_flag = 0; + } + FUN_CODE_201e(); // Delegated I2C config read/write + if (gpif_flag) { + handle_gpif_event(); + gpif_flag = 0; + } else { + PCON |= 0x01; // CPU idle + } + } +} +``` diff --git a/site/src/content/docs/firmware/storage-formats.mdx b/site/src/content/docs/firmware/storage-formats.mdx new file mode 100644 index 0000000..30b1710 --- /dev/null +++ b/site/src/content/docs/firmware/storage-formats.mdx @@ -0,0 +1,256 @@ +--- +title: Firmware Storage Formats +description: Cypress C2 EEPROM boot format, kernel hexline format, and flat binary extraction. +--- + +import { Tabs, TabItem, Aside, FileTree, Badge } from '@astrojs/starlight/components'; + +The SkyWalker-1 firmware exists in multiple container formats depending on context: the onboard EEPROM uses the Cypress C2 IIC boot format, the Linux kernel expects a custom binary hexline format, and analysis tools work with flat extracted binaries. + +## Format Overview + + + + +### Cypress C2 IIC Second-Stage Boot Format + +This is the native format stored in the SkyWalker-1's onboard I2C EEPROM. The FX2's internal boot ROM reads this format on power-up. + +The `0xC2` marker byte in the header identifies this as "external memory, large code model" -- it tells the boot ROM to load code from the EEPROM into internal RAM using the segment map that follows. + + + + +### Kernel Binary Hexline Format + +Used only by `dvb-usb-gp8psk-01.fw` for Rev.1 Cold devices. This is a compact binary representation of Intel HEX records parsed by `dvb_usb_get_hexline()` in the kernel. It is NOT standard Intel HEX text. + + + + +### Flat Extracted Binary + +Raw 8051 machine code extracted from C2 segments. No headers or framing -- just code bytes at their target RAM addresses. Used for Ghidra analysis and binary diffing. + + + + +## C2 EEPROM Format + +### Header Structure (8 bytes) + +``` +Offset Size Field Value (SkyWalker-1) +------ ---- ---------- ------------------- +0x00 1 marker 0xC2 (external memory, large code model) +0x01 2 VID 0xC009 -> 0x09C0 (little-endian, Genpix) +0x03 2 PID 0x0302 -> 0x0203 (little-endian, SkyWalker-1) +0x05 2 DID 0x0000 (device ID, unused) +0x07 1 config 0x40 (400 kHz I2C bus speed) +``` + +The VID and PID in the C2 header determine the USB identifiers that the FX2 enumerates with after boot. This is how the kernel driver identifies the device model. + +### Config Byte (offset 0x07) + +| Value | I2C Speed | Notes | +|-------|-----------|-------| +| `0x00` | 100 kHz | Default if EEPROM missing | +| `0x20` | 200 kHz | | +| `0x40` | **400 kHz** | Used by SkyWalker-1 | + +### Code Segment Structure + +Following the 8-byte header, one or more code segments: + +``` +Offset Size Field +------ ---------- ----- +0 2 seg_len (big-endian) -- number of data bytes +2 2 seg_addr (big-endian) -- target RAM address +4 seg_len data[] -- code/data bytes +``` + +Segments are packed contiguously. The 1023-byte maximum segment size is the limit of the FX2 boot ROM's internal I2C read buffer. + +### Terminator + +``` +Offset Size Field +------ ---- ----- +0 2 0x8001 -- high bit set signals terminator (length with MSB set) +2 2 entry -- entry point address (big-endian) = 0xE600 (CPUCS) +``` + +Writing to CPUCS (`0xE600`) with value `0x00` releases the CPU from reset and begins execution at the reset vector (`0x0000`). + +## Decoded C2 Files + +### Header Comparison + +| File | VID | PID | DID | I2C Speed | Code Size | +|------|-----|-----|-----|-----------|-----------| +| `skywalker1_eeprom.bin` (v2.06) | `0x09C0` | **`0x0203`** | `0x0000` | 400 kHz | 9,472 bytes | +| `sw1_v213_fw_1_c2.bin` (v2.13.1) | `0x09C0` | **`0x0203`** | `0x0000` | 400 kHz | 9,322 bytes | +| `sw1_v213_fw_2_c2.bin` (v2.13.2) | `0x09C0` | **`0x0203`** | `0x0000` | 400 kHz | 9,377 bytes | +| `sw1_v213_fw_3_c2.bin` (v2.13.3) | `0x09C0` | **`0x0203`** | `0x0000` | 400 kHz | 9,369 bytes | +| `rev2_v210_fw_1_c2.bin` (Rev.2) | `0x09C0` | **`0x0202`** | `0x0000` | 400 kHz | 8,843 bytes | + + + +### Segment Layout (SkyWalker-1 Variants) + +All SkyWalker-1 C2 files use uniform 1023-byte segments (except the last): + +| Segment | Address | Length | Notes | +|---------|---------|-------:|-------| +| 1 | `0x0000` | 1023 | Reset vector, interrupt handlers | +| 2 | `0x03FF` | 1023 | | +| 3 | `0x07FE` | 1023 | | +| 4 | `0x0BFD` | 1023 | | +| 5 | `0x0FFC` | 1023 | | +| 6 | `0x13FB` | 1023 | | +| 7 | `0x17FA` | 1023 | | +| 8 | `0x1BF9` | 1023 | | +| 9 | `0x1FF8` | 1023 | | +| 10 | `0x23F7` | varies | 115--265 bytes depending on version | + +The address of each segment is exactly `previous_addr + 1023`, creating a contiguous mapping from `0x0000` to the end of the firmware image. + +### Rev.2 Segment Layout + +Rev.2 has only 9 segments (one fewer than SkyWalker-1 variants) because its firmware is smaller: + +| Segment | Address | Length | +|---------|---------|-------:| +| 1 | `0x0000` | 1023 | +| 2 | `0x03FF` | 1023 | +| 3 | `0x07FE` | 1023 | +| 4 | `0x0BFD` | 1023 | +| 5 | `0x0FFC` | 1023 | +| 6 | `0x13FB` | 1023 | +| 7 | `0x17FA` | 1023 | +| 8 | `0x1BF9` | 1023 | +| 9 | `0x1FF8` | 659 | + +## Kernel Binary Hexline Format + +This format is used exclusively by `dvb-usb-gp8psk-01.fw` for loading firmware into Rev.1 Cold devices (PID `0x0200`). The SkyWalker-1 never uses this format at runtime. + +### Record Structure + +``` +Offset Size Field +------ ---- ----- +0 1 len Number of data bytes in this record +1 1 addr_lo Target address, low byte +2 1 addr_hi Target address, high byte +3 1 type Record type +4 len data[] Payload bytes +4+len 1 chk Checksum byte + +Total per record: len + 5 bytes +``` + +### Record Types + +| Type | Name | Purpose | +|------|------|---------| +| `0x00` | Data | Write data bytes to FX2 RAM at address `(addr_hi * 256 + addr_lo)` | +| `0x01` | EOF | End of file, no more records | +| `0x04` | Extended Linear Address | `data[0]:data[1]` = upper 16 bits of target address | + +### Comparison With Other DVB-USB Firmware + +Files from other DVB-USB devices confirm the format: + +| File | Size | First Record | +|------|-----:|-------------| +| `dvb-usb-dib0700-1.20.fw` | 33,768 | len=2, addr=0x0000, type=0x04 | +| `dvb-usb-it9135-01.fw` | 8,128 | len=3, addr=0x0000, type=0x03 | +| `dvb-usb-it9135-02.fw` | 5,834 | len=3, addr=0x0000, type=0x03 | + +## 64K Full EEPROM Dump + +The complete EEPROM can be dumped as a 65,536-byte raw image. The firmware occupies the first ~10 KB; the remainder contains: + +| Offset Range | Content | +|-------------|---------| +| `0x0000`--`0x0007` | C2 header (8 bytes) | +| `0x0008`--`0x25xx` | Code segments (varies by version) | +| `0x25xx`--`0x26xx` | C2 terminator | +| `0x2700`--`0x3FFF` | Padding / unused (typically `0xFF`) | +| `0x4000`--`0x7FFF` | Mirror/unused (some EEPROMs wrap at 32K) | + + + +## Format Conversion + +### C2 to Flat Binary + +Extract raw code from a C2 file by stripping headers: + +```python title="C2 to flat binary extraction" +def c2_to_flat(c2_data): + """Extract flat binary from C2 EEPROM format.""" + pos = 8 # Skip 8-byte C2 header + flat = bytearray(0x10000) # 64K address space + + while pos < len(c2_data): + seg_len = (c2_data[pos] << 8) | c2_data[pos + 1] + seg_addr = (c2_data[pos + 2] << 8) | c2_data[pos + 3] + pos += 4 + + if seg_len & 0x8000: # Terminator (high bit set) + break + + flat[seg_addr:seg_addr + seg_len] = c2_data[pos:pos + seg_len] + pos += seg_len + + return flat +``` + +### C2 to Kernel Hexline + +Theoretical conversion for producing a `dvb-usb-gp8psk-01.fw` equivalent: + +```python title="C2 to kernel hexline conversion" +def c2_to_hexline(c2_data): + """Convert C2 EEPROM format to kernel binary hexline.""" + records = bytearray() + flat = c2_to_flat(c2_data) + code_end = find_code_end(flat) + + for addr in range(0, code_end, 16): + chunk = flat[addr:addr + 16] + rec_len = len(chunk) + addr_lo = addr & 0xFF + addr_hi = (addr >> 8) & 0xFF + rec_type = 0x00 # Data record + chk = (rec_len + addr_lo + addr_hi + rec_type + + sum(chunk)) & 0xFF + records.extend([rec_len, addr_lo, addr_hi, rec_type]) + records.extend(chunk) + records.append((~chk + 1) & 0xFF) + + # EOF record + records.extend([0x00, 0x00, 0x00, 0x01, 0xFF]) + return records +``` + +For the v2.06 firmware (9,472 code bytes), this produces approximately 12,442 bytes in hexline format. + +## File Identification + +Quick format identification by examining the first byte: + +| First Byte | Format | Notes | +|------------|--------|-------| +| `0xC2` | C2 EEPROM | Standard SkyWalker-1 EEPROM dump | +| `0xC0` | C0 EEPROM | VID/PID-only header (no code segments) | +| `0x02` | Flat binary | Likely starts with `LJMP` instruction (`0x02 xx xx`) | +| Other | Hexline or unknown | Check record structure | diff --git a/site/src/content/docs/firmware/version-comparison.mdx b/site/src/content/docs/firmware/version-comparison.mdx new file mode 100644 index 0000000..a15b6b8 --- /dev/null +++ b/site/src/content/docs/firmware/version-comparison.mdx @@ -0,0 +1,287 @@ +--- +title: Firmware Version Comparison +description: Side-by-side comparison of all known SkyWalker-1 firmware revisions including stock and custom builds. +--- + +import { Tabs, TabItem, Badge, Aside } from '@astrojs/starlight/components'; + +Five firmware versions have been analyzed through Ghidra reverse engineering and source code review. This page compares their architecture, features, and binary characteristics. + +## Version Summary + +| Firmware | Version ID | Build Date | Target PID | Functions | Binary Size | Stack Pointer | +|----------|-----------|------------|------------|-----------|-------------|---------------| +| v2.06.04 | `0x020604` | 2007-07-13 | `0x0203` | 61 | 9,472 bytes | `0x72` | +| Rev.2 v2.10.04 | `0x020A04` | 2010-03-12 | `0x0202` | 107 | 8,843 bytes | `0x4F` | +| v2.13.01 (FW1) | `0x020D01` | 2010-03-12 | `0x0203` | 82-88 | 9,322 bytes | `0x50` | +| v2.13.02 (FW2) | `0x020D01` | 2010-03-12 | `0x0203` | 83 | 9,377 bytes | `0x50` | +| v2.13.03 (FW3) | `0x020D01` | 2010-03-12 | `0x0203` | 83 | 9,369 bytes | `0x52` | +| Custom v3.01.0 | `0x030100` | 2026-02-12 | `0x0203` | N/A | ~3 KB (RAM) | N/A | + + + +## Version-by-Version Details + + + + +### v2.06.04 + +The original SkyWalker-1 firmware extracted from the device's onboard EEPROM. + +| Property | Value | +|----------|-------| +| Version ID | `0x020604` | +| Build date | 2007-07-13 | +| Functions | 61 | +| Binary size | 9,472 bytes | +| Stack pointer | `0x72` | +| Config byte IRAM | `0x6D` | +| Descriptor base | `0x1200` | +| Init table address | `CODE:0B46` | +| Vendor commands | 30 (`0x80`--`0x9D`) | +| DiSEqC data pin | P0.7 | + +**Characteristics:** +- Simplest firmware with the fewest functions +- INT0 handler performs USB re-enumeration (CPUCS pulse) +- No demodulator probe at boot +- No retry loops or integrity verification +- BCM4500 status polling reads 3 registers (0xA2, 0xA8, 0xA4) up to 6 times +- Commands 0x99, 0x9A, 0x9C route to STALL +- Command 0x9D reads descriptor byte and sets mode flag based on hardware revision (4, 5, or 6) + + + + +### Rev.2 v2.10.04 + +Firmware for the Rev.2 hardware variant (PID `0x0202`). Architecturally sits between v2.06 and v2.13. + +| Property | Value | +|----------|-------| +| Version ID | `0x020A04` | +| Build date | 2010-03-12 | +| Functions | 107 (most of any version) | +| Binary size | 8,843 bytes (smallest) | +| Stack pointer | `0x4F` | +| Config byte IRAM | `0x4E` | +| Descriptor base | `0x0E00` | +| Init table address | `CODE:0B48` | +| Vendor commands | 27 (`0x80`--`0x9A`) | +| DiSEqC data pin | P0.4 | + +**Characteristics:** +- Highest function count due to granular decomposition (10-30 byte helper functions) +- Smallest binary despite having the most functions +- Retained v2.06's INT0 USB re-enumeration behavior +- Already adopted v2.13's descriptor base (`0x0E00`) and similar stack pointer +- Contains `FUN_CODE_0800`: a massive 874-byte configuration dispatcher with embedded main loop +- Lacks v2.13's demodulator polling, retry loops, and additional vendor commands (0x9B--0x9D out of range) +- 0x99/0x9A present as prototype implementations + +See the [Rev.2 Analysis](/firmware/rev2-analysis/) page for the complete 107-function inventory. + + + + +### v2.13.01 (FW1) + +The most feature-complete stock firmware, targeting the original I2C-connected SkyWalker-1 hardware. + +| Property | Value | +|----------|-------| +| Version ID | `0x020D01` | +| Build date | 2010-03-12 | +| Functions | 82-88 | +| Binary size | 9,322 bytes | +| Stack pointer | `0x50` | +| Config byte IRAM | `0x4F` | +| Descriptor base | `0x0E00` | +| Init table address | `CODE:0B88` | +| Vendor commands | 30 (`0x80`--`0x9D`) | +| DiSEqC data pin | P0.0 | + +**New features over v2.06:** +- Three new vendor commands: `0x99` (GET_DEMOD_STATUS), `0x9A` (INIT_DEMOD), `0x9C` (DELAY_COMMAND) +- INT0 repurposed for demodulator availability polling (40 attempts at addresses 0x7F and 0x3F) +- USB re-enumeration moved to `FUN_CODE_2031` (called as normal function before main loop) +- Demodulator signature verification (`FUN_CODE_1799`) with 20 retry attempts +- Descriptor checksum verification (`FUN_CODE_1ca0`) with 20 retry attempts +- Hardware revision detection via descriptor byte (flag `_1_3`) +- Consolidated BCM4500 status polling (1 register instead of 3) +- Anti-tampering string at firmware offset 0x1880 + +See the [FW2.13 Variants](/firmware/fw213-variants/) page for sub-variant comparison. + + + + +### Custom v3.01.0 + +Open-source replacement firmware built with SDCC + fx2lib. RAM-loaded for testing. + +| Property | Value | +|----------|-------| +| Version ID | `0x030100` | +| Build date | 2026-02-12 | +| Toolchain | SDCC + fx2lib | +| Source | `firmware/skywalker1.c` (1351 lines) | +| Binary size | ~3 KB | +| Load method | RAM upload via `tools/fw_load.py` | +| DiSEqC data pin | P0.7 (v2.06 assignment) | + +**Additions over stock:** +- Seven new diagnostic commands (`0xB0`--`0xB6`) +- Incremental debug boot modes (wValue `0x80`--`0x85` for BOOT_8PSK) +- I2C timeout protection (6000-iteration countdown vs. infinite spin) +- I2C bus scan for device discovery +- Spectrum sweep and blind scan capabilities +- Raw BCM4500 register access + +See the [Custom v3.01](/firmware/custom-v301/) page for full details. + + + +## Architectural Differences + +| Feature | v2.06 | Rev.2 v2.10 | v2.13 | Custom v3.01 | +|---------|-------|-------------|-------|--------------| +| Vendor commands | 30 | 27 | 30 | 30 stock + 7 custom | +| INT0 handler | USB re-enum | USB re-enum | Demod polling | N/A (fx2lib ISR) | +| Demod probe at boot | No | No | Yes (40 attempts) | Yes (with timeout) | +| Retry loops | No | No | Yes (20-attempt) | Yes (with timeout) | +| HW revision detect | No | Yes (descriptor walker) | Yes (flag `_1_3`) | No | +| DiSEqC data pin | P0.7 | P0.4 | P0.0 | P0.7 | +| Config byte IRAM addr | `0x6D` | `0x4E` | `0x4F` | C variable | +| BCM4500 status poll | 3 registers | 3 registers | 1 register | 1 register | +| I2C timeout | None | None | None | 6000-count | +| Anti-tampering | No | No | Yes | No | +| New commands | -- | 0x99/0x9A proto | 0x99, 0x9A, 0x9C | 0xB0--0xB6 | +| 0x9D behavior | HW revision mode | N/A (out of range) | Conditional demod reset | N/A | + +## Kernel Version Constants + +The Linux kernel driver defines two firmware version thresholds in `gp8psk-fe.h`: + +```c title="Kernel firmware version constants" +GP8PSK_FW_REV1 = 0x020604 // v2.06.4 +GP8PSK_FW_REV2 = 0x020704 // v2.07.4 +``` + +If the firmware version reported by `GET_FW_VERS` (command `0x92`) is >= `GP8PSK_FW_REV2`, the kernel enables Rev.2-specific code paths. All v2.10 and v2.13 firmwares are newer than either constant. + +## Binary Similarity Matrix + +Byte-level comparison across the shared code length (percentage of identical bytes): + +| | v2.06 | v2.13.1 | v2.13.2 | v2.13.3 | Rev.2 | +|---|---|---|---|---|---| +| **v2.06** | -- | 4.8% | 4.3% | 4.3% | 6.0% | +| **v2.13.1** | | -- | 57.2% | 59.4% | 8.0% | +| **v2.13.2** | | | -- | 83.5% | 5.8% | +| **v2.13.3** | | | | -- | 5.8% | +| **Rev.2** | | | | | -- | + + + +## Key Function Correspondence + +Functions that serve the same role but reside at different addresses: + +| Role | v2.06 | Rev.2 | v2.13 | +|------|-------|-------|-------| +| RESET vector / main | `0x188D` | `0x155F` | `0x170D` | +| Main init + loop | `0x09A7` | `0x09A9` | `0x0800` | +| USB descriptor setup | `0x13C3` | `0x10D9` | `0x11AB` | +| Standard USB handler | `0x032A` | `0x0319` | `0x034E` | +| Vendor cmd dispatch | `0x0056` | `0x0056` | `0x0056` | +| Main loop poll | `0x2297` | -- | `0x21EC` | +| GPIF/FIFO management | `0x1919` | `0x0D7C` | `0x1800` | +| BCM4500 firmware loader | `0x0DDD` | `0x0C64` | `0x0CA4` | +| BCM4500 status polling | `0x2000` | -- | `0x208D` | +| Delay loop | `0x1DFB` | `0x1BDA` | `0x14B9` | + +## INT0 Handler Evolution + +The INT0 interrupt vector (`CODE:0003`) was repurposed between firmware generations: + + + + +**USB Re-enumeration** -- pulses CPUCS bit 3 to trigger controlled USB disconnect/reconnect: + +```c title="INT0 handler (v2.06 and Rev.2)" +void INT0_vec(void) { + if (flag == 0) CPUCS |= 0x08; // CPUCS bit 3 + else CPUCS |= 0x0A; // CPUCS bits 3+1 + delay(5, 0xDC); // ~1500 cycles + EPIRQ = 0xFF; // Clear endpoint IRQs + USBIRQ = 0xFF; // Clear USB IRQs + EXIF &= 0xEF; // Clear external interrupt flag + CPUCS &= 0xF7; // Clear CPUCS bit 3 +} +``` + + + + +**Demodulator Availability Polling** -- probes two I2C addresses up to 40 times: + +```c title="INT0 handler (v2.13)" +void INT0_vector(void) { + for (counter = 0x28; counter != 0; counter--) { + byte result = I2C_read(0x7F); + if (result != 0x01) { + result = I2C_read(0x3F); + if (result != 0x01) break; + } + } + no_demod_flag = (counter == 0); +} +``` + +The USB re-enumeration logic was moved to `FUN_CODE_2031` and called as a normal function before the main loop. + + + +## XRAM Initialization Table + +All versions initialize FX2 peripheral registers from a CODE-space table at startup. The table format is identical: `[addr_hi] [addr_lo] [data_byte]` triplets terminated by `0x0000`. + +| Firmware | Table Address | Key Registers Set | +|----------|--------------|-------------------| +| v2.06 | `CODE:0B46` | IFCONFIG, EP2CFG, EP2FIFOCFG, REVCTL, I2CTL | +| Rev.2 | `CODE:0B48` | Same set, 2 bytes later | +| v2.13 | `CODE:0B88` | Same set, different offsets | + +All versions set the same final values: `IFCONFIG=0xEE`, `EP2CFG=0xE2`, `EP2FIFOCFG=0x0C`, `REVCTL=0x03`, `I2CTL=0x01`. + +## Anti-Tampering (v2.13 Only) + +All v2.13 sub-variants contain this string at firmware offset `0x1880`: + +``` +"Tampering is detected. Attempt is logged. Warranty is voided ! \n" +``` + +This is followed by I2C register write commands (`01 10 aa 82 02 41 41 83`). The mechanism is absent from v2.06, Rev.2, and the custom firmware. + +## Version Identification + +The `GET_FW_VERS` command (`0x92`) returns 6 bytes of hardcoded constants: + +``` +Byte 0: version minor_minor (e.g., 0x04) +Byte 1: version minor (e.g., 0x06) +Byte 2: version major (e.g., 0x02) +Byte 3: build day (e.g., 0x0D = 13) +Byte 4: build month (e.g., 0x07 = July) +Byte 5: build year - 2000 (e.g., 0x07 = 2007) +``` + +Full version = `byte[2] << 16 | byte[1] << 8 | byte[0]`. Build date = `(2000 + byte[5]) / byte[4] / byte[3]`. diff --git a/site/src/content/docs/hardware/gpio-pinmap.mdx b/site/src/content/docs/hardware/gpio-pinmap.mdx new file mode 100644 index 0000000..507e929 --- /dev/null +++ b/site/src/content/docs/hardware/gpio-pinmap.mdx @@ -0,0 +1,131 @@ +--- +title: GPIO Pin Map +description: Complete FX2 GPIO pin assignments across all firmware versions including stock and custom firmware. +--- + +import { Tabs, TabItem, Badge, Aside } from '@astrojs/starlight/components'; + +The Cypress FX2 uses three GPIO ports for hardware control on the SkyWalker-1: Port 0 (IOA), Port 3 (IOD), and Port B (XRAM-mapped IOB). Pin assignments differ significantly between firmware versions due to PCB revisions and design changes. + + + +## Port 0 / Port A (SFR 0x80, IOA) + + + + +| Pin | v2.06 | Rev.2 v2.10 | v2.13 | Notes | +|-----|-------|-------------|-------|-------| +| P0.0 | -- | LNB control (0x97) | **DiSEqC data** | DiSEqC data pin moved across versions | +| P0.1 | Power enable | Power enable | Power enable | BCM4500 power supply enable | +| P0.2 | Power disable | Power disable (init=0x84) | Power disable | BCM4500 power supply disable | +| P0.3 | **22 kHz tone** | **22 kHz tone** | **22 kHz tone** | Gates external 22 kHz oscillator (all versions) | +| P0.4 | **LNB 13V/18V** | **LNB 13V/18V** + DiSEqC data | **LNB 13V/18V** | Also SET_DN_SWITCH bit-bang (all versions) | +| P0.5 | **BCM4500 RESET** | GPIO status input (0x98) | **BCM4500 RESET** | Reset and feedback pin | +| P0.6 | -- | GPIO control (0x97) | -- | LNB control on Rev.2 only | +| P0.7 | **DiSEqC data** | Streaming indicator | Streaming indicator | DiSEqC data on v2.06 only | + + + + +| Pin | Custom v3.01.0 | Notes | +|-----|----------------|-------| +| P0.0 | -- | Unused | +| P0.1 | **Power enable** | BCM4500 power supply enable (HIGH = on) | +| P0.2 | **Power disable** | BCM4500 power supply disable (LOW = off) | +| P0.3 | **22 kHz tone** | Gates external 22 kHz oscillator | +| P0.4 | **LNB 13V/18V** | Voltage select: LOW = 13V, HIGH = 18V | +| P0.5 | **BCM4500 RESET** | LOW = reset asserted, HIGH = released | +| P0.6 | -- | Unused | +| P0.7 | **DiSEqC data** + streaming | DiSEqC data (matches v2.06); also streaming indicator | + + + + +## Port 3 / Port D (SFR 0xB0, IOD) + +These pins are consistent across all firmware versions: + +| Pin | Function | Active State | Notes | +|-----|----------|-------------|-------| +| P3.0 | Init HIGH | -- | Set during initialization | +| P3.4 | GPIO control | -- | Used by Rev.2 `FUN_CODE_1fcf` | +| P3.5 | **TS_EN** | LOW | Transport stream enable: LOW = active, HIGH = idle | +| P3.6 | **DVB mode** | -- | BCM4500 mode select; DiSEqC port direction (Rev.2) | +| P3.7 | BCM4500 control | HIGH (idle) | De-asserted (HIGH) when streaming stops | + + + +## Port B (XRAM-mapped IOB) + +Port B is used exclusively by the internal debug commands 0x96--0x98. These commands are not used by the Linux or Windows drivers. + + + + +| Pin | Function | Command | +|-----|----------|---------| +| IOB.0 | GPIO status input | GET_GPIO_STATUS (0x98) | +| IOB.1 | LNB control line 1 | SET_GPIO_PINS (0x97) | +| IOB.2 | LNB control line 2 | SET_GPIO_PINS (0x97) | +| IOB.3 | LNB GPIO mode | SET_LNB_GPIO_MODE (0x96) | +| IOB.4 | -- | Unused | + + + + +| Pin | Function | Command | +|-----|----------|---------| +| IOB.0 | -- | Unused | +| IOB.1 | -- | Unused | +| IOB.2 | -- | Unused | +| IOB.3 | -- | Unused | +| IOB.4 | LNB GPIO mode + control | SET_LNB_GPIO_MODE (0x96) + SET_GPIO_PINS (0x97) | + +Rev.2 moved LNB control from Port B to Port A (P0.6, P0.0). + + + + +## DiSEqC Data Pin Summary + +The DiSEqC data pin assignment is the most significant change between firmware versions. The carrier pin (P0.3) remains constant. + +| Firmware Version | Data Pin | Carrier Pin | +|-----------------|----------|-------------| +| v2.06 | P0.7 | P0.3 | +| Rev.2 v2.10 | P0.4 | P0.3 | +| v2.13 | P0.0 | P0.3 | +| Custom v3.01.0 | P0.7 | P0.3 | + +The data pin is used only internally by the firmware's Manchester encoding logic. It controls whether the 22 kHz carrier gate signal (on P0.3) is cut short or held for the full bit period during DiSEqC transmission. See [DiSEqC Protocol](/lnb-diseqc/diseqc-protocol/) for the encoding details. + +## Initial GPIO State + +On power-up, the FX2 initialization code sets: + +| Register | Value | Decode | +|----------|-------|--------| +| IOA (P0) | 0x84 | P0.7=1 (idle), P0.2=1 (power disable active) | +| IOD (P3) | 0xE1 | P3.7:5=1 (all control lines idle), P3.0=1 | +| OEA | 0xBE | P0.1-5,7 configured as outputs | + +These initial states ensure: +- The BCM4500 is held in reset (P0.5 driven by output enable, but P0 init has it low after OEA is set) +- The transport stream bus is idle (P3.5 = HIGH) +- The streaming indicator is off (P0.7 = HIGH) +- All BCM4500 control lines are de-asserted (P3.7:5 = 1) + +## Streaming GPIO State Changes + +| Pin | SFR | Direction | During Streaming | Streaming Stopped | Function | +|-----|-----|-----------|-----------------|-------------------|----------| +| P0.2 | 0x80 | Output | Set during init | -- | BCM4500 config | +| P0.7 | 0x80 | Output | **LOW** | HIGH | Streaming status indicator | +| P3.5 | 0xB0 | Output | Pulsed LOW | HIGH | BCM4500 TS_EN (transport stream enable) | +| P3.6 | 0xB0 | Output | Controlled | HIGH | BCM4500 DVB mode control | +| P3.7 | 0xB0 | Output | Controlled | HIGH | BCM4500 control line | diff --git a/site/src/content/docs/hardware/overview.mdx b/site/src/content/docs/hardware/overview.mdx new file mode 100644 index 0000000..d213a34 --- /dev/null +++ b/site/src/content/docs/hardware/overview.mdx @@ -0,0 +1,94 @@ +--- +title: Hardware Overview +description: Board layout, chip identification, supported modulations, and architecture of the Genpix SkyWalker-1 DVB-S USB 2.0 receiver. +--- + +import { Tabs, TabItem, Badge, Aside, CardGrid, Card } from '@astrojs/starlight/components'; + +The Genpix SkyWalker-1 is a standalone USB 2.0 DVB-S satellite receiver built around two primary ICs: a Cypress FX2LP USB microcontroller and a Broadcom BCM4500 satellite demodulator. The FX2 handles all USB communication, LNB control, and DiSEqC signaling, while the BCM4500 performs RF demodulation, forward error correction, and outputs an MPEG-2 transport stream on an 8-bit parallel bus. + +## Core Components + +| Component | Part Number | Role | +|-----------|-------------|------| +| MCU | Cypress CY7C68013A (FX2LP) | USB 2.0 Hi-Speed controller, 8051 core at 48 MHz | +| Demodulator | Broadcom BCM4500 | DVB-S / Turbo / DCII / DSS demodulator, 128-pin MQFP | +| EEPROM | 24Cxx-family (I2C address 0x51) | FX2 firmware storage, serial number, calibration data | +| Tuner/LNB | Unknown IC (I2C address 0x10) | Tuner or LNB controller on shared I2C bus | + +## Board Block Diagram + +``` + +--[ I2C EEPROM 0x51 ] + | +USB 2.0 HS | I2C Bus (400 kHz) +Host PC <----> [ CY7C68013A FX2LP ] <-----> [ BCM4500 Demod 0x08 ] + | 8051 @ 48 MHz | | + | GPIF Engine |<-----------+ 8-bit parallel TS + | EP2 Bulk IN | + | GPIO (P0/P3) |---> [ 22 kHz Osc ] ---> LNB/Coax + | |---> [ LNB Voltage Ctrl ] + +-----------------+ + | + +--[ Tuner/LNB IC 0x10 ] +``` + +The GPIF engine inside the FX2 transfers the BCM4500's transport stream output directly into USB bulk endpoint EP2 with zero firmware intervention in the data path. This hardware-managed pipeline provides approximately 5x bandwidth headroom over the maximum DVB-S transport stream rate. + +## Supported Modulations + +| Index | Modulation | Constant | FEC Family | +|-------|-----------|----------|------------| +| 0 | DVB-S QPSK | `ADV_MOD_DVB_QPSK` | Viterbi + Reed-Solomon | +| 1 | Turbo-coded QPSK | `ADV_MOD_TURBO_QPSK` | Turbo | +| 2 | Turbo-coded 8PSK | `ADV_MOD_TURBO_8PSK` | Turbo | +| 3 | Turbo-coded 16QAM | `ADV_MOD_TURBO_16QAM` | Turbo | +| 4 | Digicipher II Combo | `ADV_MOD_DCII_C_QPSK` | DCII | +| 5 | Digicipher II I-stream (split) | `ADV_MOD_DCII_I_QPSK` | DCII | +| 6 | Digicipher II Q-stream (split) | `ADV_MOD_DCII_Q_QPSK` | DCII | +| 7 | Digicipher II Offset QPSK | `ADV_MOD_DCII_C_OQPSK` | DCII | +| 8 | DSS QPSK | `ADV_MOD_DSS_QPSK` | Viterbi + Reed-Solomon | +| 9 | DVB-S BPSK | `ADV_MOD_DVB_BPSK` | Viterbi + Reed-Solomon | + + + +## Architecture Overview + + + + EP0 for vendor commands (tuning, LNB control, status). EP2 for bulk MPEG-2 transport stream data. VID `0x09C0`, PID `0x0203`. See [USB Interface](/usb/interface/). + + + Indirect register access via I2C (0xA6/0xA7/0xA8 protocol). Two FEC decoder paths: turbo codes and legacy Viterbi/Reed-Solomon. See [Demodulator Interface](/bcm4500/demodulator/). + + + Hardware-managed data path. 8-bit parallel bus from BCM4500 to EP2 FIFO via GPIF master read. AUTOIN auto-commits full packets to USB. See [GPIF Streaming](/bcm4500/gpif-streaming/). + + + 400 kHz bus connecting FX2 to BCM4500 (0x08), tuner IC (0x10), and EEPROM (0x51). Bit-banged DiSEqC on separate GPIO pins. See [I2C Bus Architecture](/i2c/bus-architecture/). + + + +## FEC Architecture + +The BCM4500 contains two distinct FEC decoder paths: + +1. **Advanced Modulation Turbo FEC Decoder** -- Iterative turbo code decoder supporting QPSK (rates 1/4, 1/2, 3/4), 8PSK (rates 2/3, 3/4, 5/6, 8/9), 16QAM (rate 3/4), with Reed-Solomon (t=10) outer code. + +2. **Legacy DVB/DIRECTV/DCII-Compliant FEC Decoder** -- Concatenated Viterbi inner decoder (convolutional code, rates 1/2 through 7/8) plus Reed-Solomon outer decoder. + +There is no LDPC or BCH decoder hardware. The turbo FEC codes are Broadcom/EchoStar proprietary and are not part of any open standard. + +## Firmware + +The SkyWalker-1 boots from an on-board I2C EEPROM containing firmware in Cypress C2 format. No host-side firmware files are required. Multiple stock firmware versions have been identified: + +| Firmware | Version ID | Build Date | Notes | +|----------|-----------|------------|-------| +| v2.06.04 | 0x020604 | 2007-07-13 | Original release, 61 functions | +| v2.13.01 | 0x020D01 | 2010-03-12 | Latest revision, 82-88 functions | +| Custom v3.01.0 | 0x030100 | 2026-02-12 | Open-source SDCC + fx2lib, RAM-loaded | + +See [Firmware Version Comparison](/firmware/version-comparison/) for a full analysis of the differences between stock firmware versions. diff --git a/site/src/content/docs/hardware/rf-specifications.mdx b/site/src/content/docs/hardware/rf-specifications.mdx new file mode 100644 index 0000000..911eea2 --- /dev/null +++ b/site/src/content/docs/hardware/rf-specifications.mdx @@ -0,0 +1,94 @@ +--- +title: RF Specifications +description: RF input parameters, LNB voltage and current limits, and symbol rate range for the SkyWalker-1. +--- + +import { Aside } from '@astrojs/starlight/components'; + +## RF Input Parameters + +| Parameter | Value | +|-----------|-------| +| IF frequency range | 950 -- 2150 MHz | +| Symbol rate | 256 Ksps -- 30 Msps | +| Input connector | IEC F-type female | + +The IF frequency is the intermediate frequency after LNB downconversion. The host computes it as `(RF_freq - LO_freq) * multiplier` and sends it in the [TUNE_8PSK](/bcm4500/tuning-protocol/) command payload. + +## LNB Power Supply + +| Parameter | Value | +|-----------|-------| +| LNB voltage (standard) | 13V / 18V | +| LNB voltage (boosted) | 14V / 19V (with USE_EXTRA_VOLT) | +| Maximum continuous current | 450 mA | +| Maximum burst current | 750 mA | + + + +LNB voltage is controlled via GPIO P0.4 on all firmware versions. The voltage selection determines the polarization: + +| wValue | Voltage | GPIO P0.4 | Polarization | +|--------|---------|-----------|-------------| +| 0 | 13V | LOW | Vertical / Circular-Right | +| 1 | 18V | HIGH | Horizontal / Circular-Left | + +The USE_EXTRA_VOLT command (0x94) enables a +1V boost for long cable runs by toggling bit 3 of the LNB control register at XRAM 0xE0B6 (0x62 = normal, 0x6A = boosted). See [Vendor Commands](/usb/vendor-commands/) for the command interface. + +## Switch Control + +The SkyWalker-1 supports multiple satellite switching protocols: + +| Protocol | Implementation | Command | +|----------|---------------|---------| +| 22 kHz tone | GPIO P0.3 gates external oscillator | SET_22KHZ_TONE (0x8C) | +| Tone Burst (mini DiSEqC) | Timer2-based carrier gating | SEND_DISEQC_COMMAND (0x8D) | +| DiSEqC 1.0 | Timer2 Manchester encoding | SEND_DISEQC_COMMAND (0x8D) | +| DiSEqC 1.2 | Timer2 Manchester encoding | SEND_DISEQC_COMMAND (0x8D) | +| Legacy Dish Network | 7-bit serial bit-bang on P0.4 | SET_DN_SWITCH (0x8F) | + +## 22 kHz Tone + +The 22 kHz tone signal is generated by an external oscillator on the PCB, gated by GPIO P0.3. The firmware does not generate the 22 kHz carrier directly -- it only enables or disables the oscillator output. + +| wValue | State | GPIO P0.3 | Band Selection | +|--------|-------|-----------|------| +| 0 | OFF | LOW | Low band (9.75 GHz LO on universal LNB) | +| 1 | ON | HIGH | High band (10.6 GHz LO on universal LNB) | + +## Signal Path + +``` +Satellite + | + v +[ LNB on Dish ] <-- 13V/18V + 22kHz from SkyWalker-1 + | + | Coax (950-2150 MHz IF) + v +[ SkyWalker-1 F-connector ] + | + v +[ BCM4500 Demodulator ] -- demod + FEC decode + | + | 8-bit parallel MPEG-2 TS + v +[ FX2 GPIF Engine ] -- zero-copy DMA to EP2 + | + | USB 2.0 High-Speed Bulk + v +[ Host PC ] +``` + +The USB/GPIF data path has substantial headroom over the satellite link throughput: + +| Metric | Value | +|--------|-------| +| USB 2.0 HS bulk (practical) | ~280 Mbps (~35 MB/s) | +| GPIF engine (theoretical) | 48 MHz x 8 bits = 384 Mbps | +| Typical DVB-S TS rate | 1--5 MB/s | +| Maximum symbol rate (30 Msps) | ~58 Mbps | + +The bottleneck for all supported modulation modes is the satellite link, not the USB data path. diff --git a/site/src/content/docs/i2c/bus-architecture.mdx b/site/src/content/docs/i2c/bus-architecture.mdx new file mode 100644 index 0000000..58c171f --- /dev/null +++ b/site/src/content/docs/i2c/bus-architecture.mdx @@ -0,0 +1,156 @@ +--- +title: I2C Bus Architecture +description: FX2 I2C controller details, bus topology, device addresses, and the combined write-read protocol. +--- + +import { Aside, Steps } from '@astrojs/starlight/components'; + +The SkyWalker-1 uses a single I2C bus connecting the FX2 microcontroller (master) to three slave devices. The FX2's hardware I2C controller handles all bus transactions through XRAM-mapped registers. + +## FX2 I2C Controller + +| SFR | Address | Function | +|-----|---------|----------| +| I2CS | 0xE678 (XRAM) | I2C control/status register | +| I2DAT | 0xE679 (XRAM) | I2C data register | +| I2CTL | 0xE67A (XRAM) | I2C control (speed selection) | + +### I2CS Control/Status Bits + +| Bit | Name | Function | +|-----|------|----------| +| bmSTART | bit 7 | Write: initiate START condition | +| bmSTOP | bit 6 | Write: initiate STOP condition | +| bmLASTRD | bit 5 | Write: signal last read byte (NACK after next read) | +| bmDONE | bit 2 | Read: byte transfer complete | +| bmACK | bit 1 | Read: ACK received from slave | +| bmBERR | bit 0 | Read: bus error detected | + +## Bus Speed + +The I2C bus operates at 400 kHz. The speed is set through two mechanisms: + +1. **C2 EEPROM header** -- Config byte at offset 7 = 0x40, which the FX2 boot ROM uses to configure the I2C speed during initial EEPROM read. +2. **Firmware/software** -- I2CTL = `bm400KHZ` (written by the custom firmware and init table). + +## Known Bus Devices + +| 7-bit Address | Wire Write | Wire Read | Identity | +|---------------|-----------|----------|----------| +| 0x08 | 0x10 | 0x11 | BCM4500 demodulator | +| 0x10 | 0x20 | 0x21 | Tuner or LNB controller | +| 0x51 | 0xA2 | 0xA3 | Configuration EEPROM (24Cxx-family) | + +These addresses were confirmed via the I2C_BUS_SCAN command (0xB4) in custom firmware v3.01.0, which probes all 7-bit addresses from 0x01 to 0x77. + +### BCM4500 Demodulator (0x08) + +The primary device for all demodulation operations. Register access uses the [indirect register protocol](/bcm4500/demodulator/) through registers 0xA6, 0xA7, and 0xA8. Direct registers 0xA2, 0xA4, and 0xF9 provide status information. + +The v2.13 firmware also probes alternate addresses 0x7F and 0x3F at startup to detect which demodulator variant is present. + +### Tuner/LNB Controller (0x10) + +Likely a tuner IC or LNB controller. In normal operation, the BCM4500 accesses this device internally for tuning. It is also directly addressable on the shared I2C bus. The kernel driver does not directly communicate with this device. + +### Configuration EEPROM (0x51) + +A 24Cxx-family serial EEPROM that stores: +- Device serial number (read by GET_SERIAL_NUMBER, 0x93) +- Hardware platform ID (read by GET_FPGA_VERS, 0x95) +- Calibration data + +## Bus Topology + +``` + FX2 I2C Master + (I2CS/I2DAT/I2CTL) + | + +----------+-----------+ + | | | + BCM4500 Tuner/LNB EEPROM + (0x08) (0x10) (0x51) +``` + +All three devices share the same SCL/SDA lines. The FX2's hardware I2C controller manages bus arbitration and clock stretching detection. + +## Combined Write-Read Protocol + +All BCM4500 register reads use the I2C combined write-read protocol with a repeated START condition. This is required because the BCM4500 uses a register-addressed protocol where the register number must be sent in a write phase before the read phase. + +``` +Complete I2C transaction for reading register 0xA2 from device 0x08: + + Phase 1 (Write): + [S] [0x10] [ACK] [0xA2] [ACK] + | | | | | + | | | | +-- BCM4500 ACKs register address + | | | +--------- Register address byte + | | +---------------- BCM4500 ACKs its device address + | +----------------------- Device address (0x08 << 1) = 0x10 (write) + +---------------------------- START condition + + Phase 2 (Read with Repeated START): + [Sr] [0x11] [ACK] [DATA] [NACK] [P] + | | | | | | + | | | | | +-- STOP condition + | | | | +--------- Master NACKs (last byte) + | | | +---------------- Register data + | | +----------------------- BCM4500 ACKs its device address + | +------------------------------ Device address (0x08 << 1 | 1) = 0x11 (read) + +------------------------------------ REPEATED START (no STOP between phases) +``` + +The repeated START (Sr) is essential. A STOP between phases would release the bus, and the BCM4500 would lose the register address context. + +### FX2 SFR Sequence for Combined Read + +```c title="Combined Write-Read Implementation" +// Phase 1: Write register address +I2CS |= bmSTART; // Generate START +I2DAT = 0x10; // Write: device addr + W +// wait bmDONE, check bmACK +I2DAT = 0xA2; // Write: register address +// wait bmDONE, check bmACK + +// Phase 2: Read with repeated START +I2CS |= bmSTART; // Generate REPEATED START (no STOP first!) +I2DAT = 0x11; // Write: device addr + R +// wait bmDONE, check bmACK +I2CS |= bmLASTRD; // Signal this is the last read byte +tmp = I2DAT; // Dummy read (triggers first clock burst) +// wait bmDONE +I2CS |= bmSTOP; // Generate STOP after reading +data = I2DAT; // Read actual data byte +// wait bmSTOP to clear +``` + + + +## Timeout Protection + +The fx2lib I2C functions poll `bmDONE` with no timeout: + +```c title="fx2lib Original Code (Vulnerable)" +while (!(I2CS & bmDONE) && !cancel_i2c_trans); +``` + +Since `cancel_i2c_trans` is never set during normal operation, these loops are effectively infinite. If a slave holds SCL low or a bus error prevents bmDONE from asserting, the firmware hangs. + +The custom firmware replaces all fx2lib I2C functions with timeout-protected wrappers: + +```c title="Timeout-Protected I2C Wait" +#define I2C_TIMEOUT 6000 + +static BOOL i2c_wait_done(void) { + WORD timeout = I2C_TIMEOUT; + while (!(I2CS & bmDONE)) { + if (--timeout == 0) return FALSE; + } + return TRUE; +} +``` + +A WORD counter of 6000 decremented in a tight SDCC-compiled loop at 48 MHz gives approximately 5--10 ms per wait. At 400 kHz I2C, a single byte transfer takes 22.5 us, so the timeout provides over 200x margin for normal operations while bounding the worst case. diff --git a/site/src/content/docs/i2c/stop-corruption-bug.mdx b/site/src/content/docs/i2c/stop-corruption-bug.mdx new file mode 100644 index 0000000..3c80882 --- /dev/null +++ b/site/src/content/docs/i2c/stop-corruption-bug.mdx @@ -0,0 +1,167 @@ +--- +title: I2C STOP Corruption Bug +description: Root cause analysis of the spurious I2C STOP condition that corrupted the FX2 controller state during boot. +--- + +import { Steps, Aside, Badge } from '@astrojs/starlight/components'; + +During development of the custom firmware v3.01.0, the BOOT_8PSK (0x89) command caused the FX2 to hang for over 10 seconds, making the USB device completely unresponsive. The root cause was traced to a single line of code: a spurious I2C STOP condition issued when no transaction was active. + + + +## The Problem + +The boot function originally included a "bus reset" step before any I2C communication: + +```c title="Broken Code" +I2CS |= bmSTOP; +i2c_wait_stop(); +``` + +This pattern appears in various FX2 example code and seems reasonable -- send a STOP to ensure the I2C bus is in a known idle state before starting fresh. On the FX2's I2C controller hardware, this is incorrect. + +## Root Cause Analysis + +The root cause was discovered through a series of incremental debug modes added to the BOOT_8PSK handler. Each mode executes a subset of the full boot sequence, isolating which step introduces the failure. + +### Debug Mode Results + +| wValue | Action | Result | Key Observation | +|--------|--------|--------|-----------------| +| 0x80 | No-op: return status only | | Baseline | +| 0x81 | GPIO + power + delays (no I2C) | | Power sequencing is correct | +| 0x82 | GPIO + power + bmSTOP + I2C probe | | bmSTOP corrupts I2C | +| 0x83 | GPIO + power + bmSTOP + probe + init | | Same root cause | +| 0x84 | I2C probe only (chip already powered) | | BCM4500 is alive | +| 0x85 | GPIO + power + probe (**no bmSTOP**) | | Confirms bmSTOP is the cause | + +### Three Key Observations + +1. **Mode 0x82 fails but mode 0x85 succeeds.** These modes are identical except that 0x82 issues `I2CS |= bmSTOP` before the probe and 0x85 does not. The bmSTOP is the only difference. + +2. **Mode 0x84 succeeds immediately after 0x82 fails.** Mode 0x84 performs a plain I2C combined read with no GPIO manipulation or bus reset. If called after a failed 0x82, it succeeds. This proves the BCM4500 was alive and responding -- the FX2 I2C controller was in a bad state, not the bus or the slave. + +3. **Raw I2C reads via command 0xB5 succeed after 0x82 fails.** Command 0xB5 uses the same `i2c_combined_read` function. Running it from the host after a failed 0x82 returns valid data from the BCM4500. + +## What Happens Inside the FX2 + +The FX2's I2C master controller is a hardware peripheral accessed through the I2CS, I2DAT, and I2CTL SFRs. The controller implements an I2C state machine in silicon. Writing bmSTOP to I2CS instructs the hardware to generate a STOP condition (SDA rising while SCL is high). + +When no I2C transaction is active -- no prior START has been issued, and the bus is idle -- writing bmSTOP puts the controller into an inconsistent internal state: + +- The bmSTOP bit may not clear properly (it is supposed to self-clear when the STOP condition completes) +- Subsequent START conditions fail to generate proper clock sequences +- ACK detection from slaves becomes unreliable + +The Cypress TRM describes STOP as a step that follows a completed read or write transaction. It is not documented as a standalone bus-reset mechanism. + +## The Fix + +The fix is a single deletion. Remove the spurious STOP from the boot sequence: + +```c title="Before (Broken)" +/* "Reset" I2C bus */ +I2CS |= bmSTOP; +i2c_wait_stop(); +``` + +```c title="After (Correct)" +/* NOTE: Do NOT send I2CS bmSTOP here. Sending STOP when no + * transaction is active corrupts the FX2 I2C controller state, + * causing subsequent START+ACK detection to fail. The I2C bus + * will be in a clean state when we reach the probe step -- + * any prior transaction ended with STOP. */ +``` + +The correct approach is to simply proceed with a new START condition. If the bus is idle (after power-on or after the previous transaction completed normally), the START succeeds and the controller enters its normal operating state. The hardware handles bus arbitration automatically. + +## Corrected Boot Sequence + +```c title="bcm4500_boot() -- Corrected" +static BOOL bcm4500_boot(void) { + boot_stage = 1; + cancel_i2c_trans = FALSE; + + /* P3.7, P3.6, P3.5 HIGH (idle state for control lines) */ + IOD |= 0xE0; + + /* Assert BCM4500 hardware RESET (P0.5 LOW) */ + OEA |= PIN_BCM_RESET; + IOA &= ~PIN_BCM_RESET; + + /* No I2CS bmSTOP here -- see note above */ + + /* Power on: P0.1 HIGH (enable), P0.2 LOW (disable off) */ + OEA |= (PIN_PWR_EN | PIN_PWR_DIS); + IOA = (IOA & ~PIN_PWR_DIS) | PIN_PWR_EN; + + boot_stage = 2; + delay(30); /* power settle */ + + IOA |= PIN_BCM_RESET; /* release reset */ + delay(50); /* BCM4500 POR + mask ROM boot */ + + boot_stage = 3; + /* I2C probe -- if this fails, the chip didn't respond */ + if (!bcm_direct_read(BCM_REG_STATUS, &i2c_rd[0])) + return FALSE; + + /* ... register init blocks follow ... */ +} +``` + +## Boot Results After Fix + +| Metric | Value | +|--------|-------| +| Boot time | ~90 ms total | +| config_status | 0x03 (STARTED + FW_LOADED) | +| boot_stage | 0xFF (COMPLETE) | +| Direct registers 0xA2-0xA8 | All return 0x02 (powered, not locked) | +| Signal lock | 0x00 (no lock -- dish not aimed) | +| USB responsiveness | No hang; fully responsive throughout | + +## Test Scripts + +The investigation was driven by a series of test scripts in the `tools/` directory: + +| Script | Purpose | +|--------|---------| +| `test_boot_debug.py` | Sends debug modes 0x80--0x83 sequentially | +| `test_i2c_debug.py` | Powers on via 0x81, runs bus scans, tests probe timing | +| `test_i2c_isolate.py` | Tests whether re-reset or insufficient delay causes failure | +| `test_i2c_pinpoint.py` | The definitive test: compares modes 0x84, 0x85, and 0x82 | + +## Timeout Protection + +Even with the bmSTOP fix, timeout protection on all I2C operations is essential. The FX2's I2C controller has no hardware timeout -- if a slave holds SCL low (clock stretching) or a fault prevents bmDONE from asserting, the firmware spins forever. + +The custom firmware replaces all fx2lib I2C functions with timeout-protected wrappers: + +```c title="Timeout-Protected I2C Waits" +#define I2C_TIMEOUT 6000 + +static BOOL i2c_wait_done(void) { + WORD timeout = I2C_TIMEOUT; + while (!(I2CS & bmDONE)) { + if (--timeout == 0) return FALSE; + } + return TRUE; +} + +static BOOL i2c_wait_stop(void) { + WORD timeout = I2C_TIMEOUT; + while (I2CS & bmSTOP) { + if (--timeout == 0) return FALSE; + } + return TRUE; +} +``` + +A WORD counter of 6000 at 48 MHz gives approximately 5--10 ms per wait, providing over 200x margin above the 22.5 us required for a single byte transfer at 400 kHz. + + diff --git a/site/src/content/docs/index.mdx b/site/src/content/docs/index.mdx new file mode 100644 index 0000000..edfc987 --- /dev/null +++ b/site/src/content/docs/index.mdx @@ -0,0 +1,77 @@ +--- +title: SkyWalker-1 Documentation +description: Reverse-engineered technical documentation for the Genpix SkyWalker-1 DVB-S USB 2.0 satellite receiver. +template: splash +hero: + title: SkyWalker-1 + tagline: Open-source reverse-engineered documentation for the Genpix SkyWalker-1 DVB-S USB 2.0 satellite receiver + image: + file: ../../assets/skywalker-1-hero.jpg + alt: Genpix Electronics SkyWalker-1 DVB-S USB satellite receiver + actions: + - text: Get Started + link: /hardware/overview/ + icon: right-arrow + - text: Master Reference + link: /reference/master-reference/ + variant: minimal +--- + +import { CardGrid, Card, Aside } from '@astrojs/starlight/components'; + +The Genpix SkyWalker-1 is a standalone USB 2.0 DVB-S satellite receiver built around a Cypress FX2LP microcontroller and Broadcom BCM4500 demodulator. This project documents its complete internal architecture through Linux kernel driver analysis, Ghidra firmware reverse engineering across five firmware images, Windows BDA driver source review, and custom firmware development. + +The result is a fully open-source technical reference covering every vendor command, register, GPIO pin, and data path -- from the USB control transfers down to the I2C bit timing on the BCM4500's indirect register protocol. + +**Supported modulations:** DVB-S (QPSK), Turbo QPSK, Turbo 8PSK, Turbo 16QAM, Digicipher II (Combo, Split I/Q, Offset QPSK), DSS (QPSK), and DVB-S BPSK. Symbol rates from 256 Ksps to 30 Msps across a 950--2150 MHz IF range. + + + +## Explore the Documentation + + + + FX2LP + BCM4500 architecture, GPIO pin maps, RF specifications, and board block diagram. + + [Hardware Overview](/hardware/overview/) + + + Vendor command reference, boot sequence, configuration status byte, and endpoint layout. + + [USB Interface](/usb/interface/) + + + Demodulator I2C protocol, indirect register access, tuning sequence, and GPIF streaming path. + + [Demodulator](/bcm4500/demodulator/) + + + LNB voltage and tone control, DiSEqC 1.0/1.2 protocol, legacy Dish Network switches. + + [LNB Control](/lnb-diseqc/lnb-control/) + + + Version comparison across five firmware images, custom v3.01.0 development, and storage formats. + + [Firmware Versions](/firmware/version-comparison/) + + + Python utilities for RAM loading, EEPROM flashing, transponder tuning, transport stream analysis, and hardware debugging. + + [Firmware Loader](/tools/firmware-loader/) + + + +## Project Scope + +This documentation covers the complete reverse engineering of the SkyWalker-1 hardware and firmware: + +- **5 firmware images** decompiled in Ghidra: v2.06.04, Rev.2 v2.10.04, and three v2.13 sub-variants +- **30 vendor USB commands** fully decoded with parameter formats and version-specific behavior +- **Custom firmware** (v3.01.0) built from scratch with SDCC + fx2lib, including 7 new diagnostic commands +- **13 Python tools** for firmware management, satellite tuning, transport stream analysis, and hardware debugging +- **I2C STOP corruption bug** discovered and fixed through incremental debug modes on the FX2 controller + +All source code, firmware binaries, analysis reports, and this documentation are available in the project repository. diff --git a/site/src/content/docs/lnb-diseqc/diseqc-protocol.mdx b/site/src/content/docs/lnb-diseqc/diseqc-protocol.mdx new file mode 100644 index 0000000..3684736 --- /dev/null +++ b/site/src/content/docs/lnb-diseqc/diseqc-protocol.mdx @@ -0,0 +1,273 @@ +--- +title: DiSEqC Protocol +description: DiSEqC 1.0/1.2 implementation with Manchester-encoded GPIO bit-bang, timing analysis, and command framing. +--- + +import { Steps, Badge, Aside, Tabs, TabItem } from '@astrojs/starlight/components'; + +The SkyWalker-1 implements DiSEqC (Digital Satellite Equipment Control) via Timer2-based GPIO bit-bang on the FX2 microcontroller. The algorithm is identical across all firmware versions -- only the data pin assignment changes per PCB revision. + +[Download DiSEqC PDF](/downloads/DiSEqC%20for%20the%20Skywalker-1.pdf) + +## Protocol Diagrams + +The following diagrams document the Genpix BDA driver's DiSEqC extended property interface: + +![DiSEqC Protocol Diagram Page 1](../../../assets/diagrams/DiSEqC%20for%20the%20Skywalker-1_page_1.svg) + +![DiSEqC Protocol Diagram Page 2](../../../assets/diagrams/DiSEqC%20for%20the%20Skywalker-1_page_2.svg) + +## Signal Architecture + +The firmware does **not** generate the 22 kHz carrier directly. GPIO P0.3 gates an external 22 kHz oscillator circuit on the PCB: + +``` +FX2 Firmware External Hardware Coax Cable ++------------------+ +--------------------+ +------------------+ +| P0.3 (carrier) |---->| 22 kHz oscillator |---->| LNB power line | +| (enable/disable) | | (gated by P0.3) | | (13V/18V + tone) | +| | | | | | +| P0.x (data bit) | | (internal firmware | | | +| (firmware only) | | logic only) | | | ++------------------+ +--------------------+ +------------------+ +``` + +The data pin (P0.7 / P0.4 / P0.0 depending on version) is used only internally by the firmware's Manchester encoding logic. It controls whether the carrier gate signal is cut short or held for the full bit period. + +## Timer2 Configuration + +All firmware versions configure Timer2 identically during USB descriptor setup: + +| Parameter | Value | Notes | +|-----------|-------|-------| +| T2CON | `0x04` | Auto-reload mode, timer running | +| RCAP2H | `0xF8` | Reload high byte | +| RCAP2L | `0x2F` | Reload low byte (reload = 63535) | +| CKCON.T2M | `0` | Timer2 clock = 48 MHz / 12 = 4 MHz | + +**Tick period calculation:** + +``` +FX2 master clock = 48 MHz +CKCON.T2M = 0 -> Timer2 clock = 48 MHz / 12 = 4 MHz +Count per overflow = 65536 - 63535 = 2001 +Tick period = 2001 / 4,000,000 = 500.25 us ~ 500 us +Tick frequency ~ 2.0 kHz +``` + +Timer2 runs continuously from power-on and is never stopped or reconfigured. It serves as a stable 500 us timebase for all DiSEqC operations. + +## Manchester Encoding + +Each DiSEqC bit consists of 3 Timer2 ticks (3 x 500 us = 1.5 ms): + + + +**Data '0'** -- 2/3 tone, 1/3 silence (1.0 ms carrier + 0.5 ms silence): + +``` + Tick 1 Tick 2 Tick 3 + (500 us) (500 us) (500 us) +P0.3: _____|========|========|________| + ^tone ON ^tone OFF + (setup gap) (1.0 ms carrier) (0.5 ms silence) +``` + + +**Data '1'** -- 1/3 tone, 2/3 silence (0.5 ms carrier + 1.0 ms silence): + +``` + Tick 1 Tick 2 Tick 3 + (500 us) (500 us) (500 us) +P0.3: _____|========|________|________| + ^tone ON ^tone OFF early + (setup gap) (0.5 ms carrier) (1.0 ms silence) +``` + + + +### Bit Symbol Implementation + +Decompiled from Rev.2 `FUN_CODE_213c`: + +```c title="DiSEqC bit symbol function" +void diseqc_bit_symbol(void) { + wait_TF2(); // Tick 1: inter-bit gap (500 us) + P0 |= 0x08; // P0.3 = 1 -> 22 kHz carrier ON + wait_TF2(); // Tick 2: carrier period (500 us) + if (data_pin != 0) { // If data = '1': + P0 &= 0xF7; // P0.3 = 0 -> carrier OFF (short pulse) + } + wait_TF2(); // Tick 3: final period (500 us) + P0 &= 0xF7; // P0.3 = 0 -> carrier always OFF at end +} +``` + +The `wait_TF2()` function is the lowest-level timing primitive -- a busy-wait on the Timer2 overflow flag: + +```c title="Timer2 tick wait (identical across all versions)" +void wait_TF2(void) { + while (TF2 == 0) {} // Poll Timer2 overflow flag + TF2 = 0; // Clear flag for next tick +} +``` + +## Byte Transmission + +Each DiSEqC byte is 9 bits: 8 data bits (MSB first) + 1 odd parity bit. + +```c title="DiSEqC byte transmit (from Rev.2 FUN_CODE_07d1)" +void diseqc_send_byte(char first_byte, byte data) { + byte ones_count = 0; + if (first_byte == 0) TF2 = 0; // Sync timer on first byte + + for (char i = 8; i > 0; i--) { // 8 bits, MSB first + if (data & 0x80) { + data_pin = 1; // Set data = '1' + diseqc_bit_symbol(); + ones_count++; + } else { + data_pin = 0; // Set data = '0' + diseqc_bit_symbol(); + } + data <<= 1; // Next bit + } + + data_pin = ~ones_count & 1; // Odd parity: '1' if even count + diseqc_bit_symbol(); // Transmit parity bit +} +``` + +**Timing per byte:** 9 bits x 1.5 ms = 13.5 ms + +## DiSEqC Command Sequence + +The full command flow for sending a DiSEqC message via vendor command `0x8D` (`SEND_DISEQC_COMMAND`): + + + +1. **Read wLength** from USB SETUP packet (`0xE6BE`) to determine message byte count + +2. **Disable 22 kHz carrier** by clearing P0.3 (ensuring a clean start state) + +3. **Pre-transmission delay** of 15 Timer2 ticks (7.5 ms) for LNB voltage settling + +4. **Transmit message bytes** if wLength > 0: iterate through EP0BUF, sending each byte via Manchester-encoded bit-bang (8 data bits + odd parity, 3 Timer2 ticks per bit) + +5. **Or send tone burst** if wLength == 0: + - `wValue == 0`: Tone Burst A (25 Timer2 ticks = 12.5 ms of unmodulated carrier) + - `wValue != 0`: Tone Burst B (transmitted as `0xFF` byte pattern through the bit-bang function) + + + +## USB Command Format + +### Full DiSEqC Message (3-6 bytes) + +``` +USB SETUP: + bmRequestType = 0x40 (vendor, host-to-device) + bRequest = 0x8D (SEND_DISEQC_COMMAND) + wValue = msg[0] (framing byte, typically 0xE0 or 0xE1) + wIndex = 0x0000 + wLength = message length (3-6) + +EP0 Data: + Byte 0: Framing byte (e.g., 0xE0 = command from master, no reply expected) + Byte 1: Address byte (e.g., 0x10 = any LNB, 0x11 = LNB 1) + Byte 2: Command byte (e.g., 0x38 = Write N0, committed switch port) + Byte 3: Data byte 0 (optional, port selection bits) + Byte 4: Data byte 1 (optional) + Byte 5: Data byte 2 (optional) +``` + +### Tone Burst (Mini DiSEqC) + +``` +USB SETUP: + bmRequestType = 0x40 + bRequest = 0x8D + wValue = 0x00 (Burst A) or 0x01 (Burst B) + wIndex = 0x0000 + wLength = 0 (zero length signals tone burst mode) +``` + +## Windows BDA Driver Interface + +The Windows driver exposes DiSEqC through a BDA extended property GUID: + +```c title="BDA Extended Property GUID" +// {0B5221EB-F4C4-4976-B959-EF74427464D9} +#define STATIC_KSPROPSETID_BdaExtendedProperty \ + 0x0B5221EB, 0xF4C4, 0x4976, 0xB9, 0x59, 0xEF, 0x74, 0x42, 0x74, 0x64, 0xD9 +``` + +The DiSEqC command structure: + +```c title="DISEQC_COMMAND structure" +typedef enum enSimpleToneBurst { + SEC_MINI_A, + SEC_MINI_B +} SIMPLE_TONE_BURST; + +typedef struct __DISEQC_COMMAND { + UCHAR ucMessage[6]; // Framing, Address, Command, Data[0..2] + UCHAR ucMessageLength; // 3-6 for DiSEqC; 1 for tone burst +} DISEQC_COMMAND; +``` + +For tone burst commands, set `ucMessageLength = 1` and `ucMessage[0]` to either `SEC_MINI_A` (0x00) or `SEC_MINI_B` (0x01). + +## Data Pin Assignment Per Version + +The DiSEqC algorithm is identical across all firmware versions. Only the data pin changes per PCB revision: + +| Firmware Version | Data Pin | Carrier Pin | Byte Transmit Function | Bit Symbol Function | Timer Wait | +|------------------|----------|-------------|----------------------|--------------------|-----------:| +| v2.06 | **P0.7** | P0.3 | `0x2098` | `0x23B5` | `0x24C6` | +| Rev.2 v2.10 | **P0.4** | P0.3 | `FUN_CODE_07d1` | `FUN_CODE_213c` | `FUN_CODE_225f` | +| v2.13 FW1 | **P0.0** | P0.3 | `FUN_CODE_2060` | `FUN_CODE_22f3` | `func_0x2431` | +| Custom v3.01.0 | **P0.7** | P0.3 | `diseqc_tone_burst()` | (inline) | (inline) | + + + +## CPU Clock Compensation + +The delay function used before DiSEqC transmission adjusts its loop count based on the FX2 CPU clock speed: + +```c title="Clock-aware delay function" +void delay(byte high, byte low) { + byte clkspd = CPUCS & 0x18; // CPUCS[4:3] = clock speed bits + if (clkspd == 0x00) { // 12 MHz: halve the count + // Adjust high:low /= 2 + } else if (clkspd == 0x10) { // 48 MHz: double the count + // Adjust high:low *= 2 + } + // 24 MHz (0x08): use count as-is + while (high:low > 0) { + wait_TF2(); + high:low--; + } +} +``` + +The pre-DiSEqC delay call is `delay(0, 0x0F)` = 15 ticks x 500 us = **7.5 ms**. This allows the LNB voltage to stabilize before DiSEqC signaling begins. + +## Complete Timing Summary + +| Parameter | Value | Source | +|-----------|-------|--------| +| Timer2 clock | 4 MHz (48 MHz / 12) | CKCON default, T2M=0 | +| Timer2 reload | `0xF82F` | RCAP2H:RCAP2L | +| Tick period | 500.25 us | (65536 - 63535) / 4 MHz | +| Bit period | 1.5 ms (3 ticks) | DiSEqC Manchester encoding | +| Byte period | 13.5 ms (9 bits) | 8 data + 1 parity | +| Tone burst duration | 12.5 ms (25 ticks) | Mini-command A/B | +| Pre-TX settling delay | 7.5 ms (15 ticks) | Voltage stabilization | +| Data '0' | 1.0 ms tone + 0.5 ms silence | 2/3 duty cycle | +| Data '1' | 0.5 ms tone + 1.0 ms silence | 1/3 duty cycle | +| Carrier frequency | 22 kHz (external oscillator) | Gated by P0.3 | +| 3-byte DiSEqC message | ~48 ms total | 7.5 ms settle + 3 x 13.5 ms | +| 6-byte DiSEqC message | ~88.5 ms total | 7.5 ms settle + 6 x 13.5 ms | diff --git a/site/src/content/docs/lnb-diseqc/legacy-switch.mdx b/site/src/content/docs/lnb-diseqc/legacy-switch.mdx new file mode 100644 index 0000000..486bf1b --- /dev/null +++ b/site/src/content/docs/lnb-diseqc/legacy-switch.mdx @@ -0,0 +1,106 @@ +--- +title: Legacy Dish Network Switch +description: SET_DN_SWITCH (0x8F) protocol for Dish Network SW21/SW44 legacy switches. +--- + +import { Badge, Aside, Steps } from '@astrojs/starlight/components'; + +The SkyWalker-1 supports legacy Dish Network satellite switches (SW21, SW44) through vendor command `0x8F` (`SET_DN_SWITCH`). This protocol predates DiSEqC and uses a simpler serial bit-bang scheme on a shared GPIO pin. + +## Protocol Overview + +The legacy Dish Network switch protocol sends a 7-bit serial command via **GPIO P0.4** (the same pin used for LNB voltage selection). The command is bit-banged LSB-first with fixed timing delays. + + + +## USB Command Format + +``` +USB SETUP: + bmRequestType = 0x40 (vendor, host-to-device) + bRequest = 0x8F (SET_DN_SWITCH) + wValue = 7-bit switch command (bits 0-6) + wIndex = 0x0000 + wLength = 0 +``` + +## Bit-Bang Sequence + +The firmware transmits the 7-bit command using the following GPIO sequence: + + + +1. **Start pulse**: Assert P0.4 HIGH, delay approximately 32 CPU cycles (~0.67 us at 48 MHz) + +2. **Gap**: De-assert P0.4 LOW, delay approximately 8 CPU cycles (~0.17 us at 48 MHz) + +3. **Data bits**: Shift out 7 bits LSB-first via P0.4, with approximately 8-cycle delays between each bit transition + +4. **End**: P0.4 returns to its previous LNB voltage state + + + +## Switch Position Mapping + +The legacy protocol supports the SW21 (2-input, 1-output) and SW44 (4-input, 4-output) switches. The 7-bit command encodes the desired input port and satellite selection: + +| Switch Type | Bit Pattern | Function | +|-------------|-------------|----------| +| SW21 | `0bxxxxxxx` with port bit = 0 | Select satellite A input | +| SW21 | `0bxxxxxxx` with port bit = 1 | Select satellite B input | +| SW44 | Multiple bit fields | Select one of 4 inputs to one of 4 outputs | + +The exact bit-field layout is proprietary to Dish Network. The kernel driver constructs the command value in `dishnetwork_send_legacy_command()` based on the requested switch position. + +## Timing Characteristics + +The legacy switch protocol is significantly simpler and faster than DiSEqC: + +| Parameter | Value | +|-----------|-------| +| Start pulse width | ~0.67 us (32 cycles at 48 MHz) | +| Inter-bit gap | ~0.17 us (8 cycles at 48 MHz) | +| Total command time | ~5-10 us for 7 bits | +| GPIO pin | P0.4 (shared with LNB voltage) | + + + +## Kernel Driver Integration + +The Linux kernel driver implements legacy Dish Network support through a dedicated callback: + +```c title="Legacy Dish Network command callback" +// Registered as .send_legacy_dish_cmd in dvb_usb_device_properties +static int gp8psk_send_legacy_dish_cmd(struct dvb_frontend *fe, unsigned long cmd) +{ + struct dvb_usb_adapter *adap = fe->dvb->priv; + struct dvb_usb_device *d = adap->dev; + + // Bit 7 (0x80) controls voltage, sent separately + gp8psk_usb_out_op(d, SET_LNB_VOLTAGE, (cmd >> 7) & 1, 0, NULL, 0); + + // Bits 0-6 sent via SET_DN_SWITCH + gp8psk_usb_out_op(d, SET_DN_SWITCH, cmd & 0x7F, 0, NULL, 0); + + return 0; +} +``` + +## Comparison with DiSEqC + +| Feature | Legacy Dish Protocol | DiSEqC 1.0 | +|---------|---------------------|------------| +| Standard | Proprietary (Dish Network) | EUTELSAT standard | +| Encoding | Serial bit-bang, LSB-first | Manchester encoding, MSB-first | +| Carrier | None (direct GPIO) | 22 kHz modulated | +| Message length | 7 bits | 3-6 bytes (24-54 bits + parity) | +| Timing | ~5-10 us total | ~48-88 ms total | +| Switch support | SW21, SW44 | DiSEqC 1.0/1.1/1.2 compatible switches | +| GPIO pin | P0.4 (shared with voltage) | P0.x (data) + P0.3 (carrier) | +| Vendor command | `0x8F` | `0x8D` | + +For modern satellite installations, DiSEqC is the preferred switch protocol. The legacy Dish Network protocol exists for backward compatibility with older SW21 and SW44 switches commonly found in North American installations. See the [DiSEqC Protocol](/lnb-diseqc/diseqc-protocol/) page for the full DiSEqC implementation. diff --git a/site/src/content/docs/lnb-diseqc/lnb-control.mdx b/site/src/content/docs/lnb-diseqc/lnb-control.mdx new file mode 100644 index 0000000..b78ad9b --- /dev/null +++ b/site/src/content/docs/lnb-diseqc/lnb-control.mdx @@ -0,0 +1,127 @@ +--- +title: LNB Control +description: LNB voltage selection (13V/18V), 22 kHz tone generation, extra volt mode, and current limits. +--- + +import { Badge, Aside, Tabs, TabItem } from '@astrojs/starlight/components'; + +The SkyWalker-1 controls LNB power and band selection through dedicated GPIO pins on the FX2 microcontroller. No I2C transactions are involved in basic LNB control -- voltage and tone are driven directly by port pins. + +## LNB Voltage (13V / 18V) + +LNB voltage selects the polarization of the received signal. It is controlled via **GPIO P0.4** using vendor command `0x8B` (`SET_LNB_VOLTAGE`). + +| wValue | Voltage | GPIO P0.4 | Polarization | +|--------|---------|-----------|--------------| +| `0x00` | 13V | LOW | Vertical / Circular-Right | +| `0x01` | 18V | HIGH | Horizontal / Circular-Left | + +The Linux kernel driver sets the voltage during the tuning sequence based on the requested polarization: + +```c title="Kernel driver polarization mapping" +// From gp8psk-fe.c set_voltage callback +case SEC_VOLTAGE_13: // Vertical / Circular-R + gp8psk_usb_out_op(d, SET_LNB_VOLTAGE, 0, 0, NULL, 0); + break; +case SEC_VOLTAGE_18: // Horizontal / Circular-L + gp8psk_usb_out_op(d, SET_LNB_VOLTAGE, 1, 0, NULL, 0); + break; +``` + +The configuration status byte (returned by `GET_8PSK_CONFIG`, command `0x80`) reflects the current voltage selection in **bit 5** (`0x20`, `bmSEL18V`). + +## Extra Volt Mode (+1V Boost) + +For long cable runs where voltage drop is significant, the SkyWalker-1 supports a +1V boost mode (13V becomes 14V, 18V becomes 19V). This is controlled via vendor command `0x94` (`USE_EXTRA_VOLT`). + +| wValue | XRAM 0xE0B6 | Result | +|--------|-------------|--------| +| `0x00` | `0x62` | Normal voltage (13V / 18V) | +| `0x01` | `0x6A` | Boosted voltage (14V / 19V) | + +The difference between the two XRAM values is **bit 3** (`0x08`), which enables the boost on the LNB power regulator circuitry. + + + +The kernel driver exposes extra volt mode through the `enable_high_lnb_voltage` callback in the DVB frontend properties. + +## 22 kHz Tone Generation + +The 22 kHz tone selects the high or low band on a universal LNB. It is controlled via **GPIO P0.3** using vendor command `0x8C` (`SET_22KHZ_TONE`). + +| wValue | State | GPIO P0.3 | LNB Band | +|--------|-------|-----------|----------| +| `0x00` | OFF | LOW | Low band (9.75 GHz LO on universal LNB) | +| `0x01` | ON | HIGH | High band (10.6 GHz LO on universal LNB) | + + + +The configuration status byte tracks the tone state in **bit 4** (`0x10`, `bm22kHz`). + +## LNB Power Supply Enable + +Before any LNB control is possible, the LNB power supply itself must be enabled via vendor command `0x8A` (`START_INTERSIL`). The kernel driver does this during the boot sequence if bit 2 (`bmIntersilOn`) of the configuration status byte is not already set. + +| wValue | Action | Config Bit | +|--------|--------|------------| +| `0x01` | Enable LNB power supply | Sets `bmIntersilOn` (bit 2) | +| `0x00` | Disable LNB power supply | Clears `bmIntersilOn` (bit 2) | + +In the custom v3.01.0 firmware, enabling the LNB supply also configures the output enable masks for the LNB control GPIO pins: + +```c title="START_INTERSIL handler in custom firmware" +case START_INTERSIL: + if (wval) { + OEA |= (PIN_22KHZ | PIN_LNB_VOLT | PIN_DISEQC); + config_status |= BM_INTERSIL; + } else { + config_status &= ~BM_INTERSIL; + } +``` + +## GPIO Pin Assignments + +The LNB control pins are consistent across firmware versions, though their exact initialization differs: + +| GPIO Pin | Function | Direction | Init State | +|----------|----------|-----------|------------| +| P0.1 | Power supply enable | Output | LOW (off) | +| P0.2 | Power supply disable | Output | HIGH (active disable) | +| P0.3 | 22 kHz tone gate | Output | LOW (tone off) | +| P0.4 | LNB voltage select | Output | LOW (13V) | +| P0.5 | BCM4500 hardware reset | Output | LOW (reset asserted) | + +The initial GPIO state after power-on is `IOA = 0x84` (P0.7 and P0.2 HIGH, all others LOW), with the output enable mask `OEA = 0xBE` (P0.1 through P0.5 and P0.7 as outputs). + +## LNB GPIO Debug Commands + +Three vendor commands provide low-level GPIO access for LNB debugging: + +| Command | Name | Purpose | +|---------|------|---------| +| `0x96` | `SET_LNB_GPIO_MODE` | Configure LNB GPIO output enables | +| `0x97` | `SET_GPIO_PINS` | Direct write to LNB GPIO pins via `wValue` bitmap | +| `0x98` | `GET_GPIO_STATUS` | Read LNB feedback GPIO pin (1 byte) | + +These commands access Port B (XRAM-mapped IOB) rather than Port A. In v2.06 and v2.13, `0x97` controls IOB bits 1 and 2 for LNB, while `0x96` configures IOB bit 3 as the GPIO mode select. Rev.2 uses IOB bit 4 instead. + + + +## Complete LNB Configuration Sequence + +During a typical tune operation, the kernel driver configures the LNB in this order: + +``` +1. SET_LNB_VOLTAGE (0x8B) -- Select 13V or 18V based on polarization +2. SET_22KHZ_TONE (0x8C) -- Select low or high band +3. SEND_DISEQC (0x8D) -- Switch multi-port switch if needed +4. TUNE_8PSK (0x86) -- Send tuning parameters +``` + +The voltage and tone are set before any DiSEqC commands because the LNB must be powered and in the correct band before the switch can respond. See the [DiSEqC Protocol](/lnb-diseqc/diseqc-protocol/) page for details on switch control, and the [Tuning Protocol](/bcm4500/tuning-protocol/) for the complete tune flow. diff --git a/site/src/content/docs/reference/master-reference.md b/site/src/content/docs/reference/master-reference.md new file mode 100644 index 0000000..d8f8c6f --- /dev/null +++ b/site/src/content/docs/reference/master-reference.md @@ -0,0 +1,1711 @@ +--- +title: Master Reference +description: Complete consolidated hardware and firmware reference for the Genpix SkyWalker-1. +--- + +# Genpix SkyWalker-1 Master Hardware and Firmware Reference + +Consolidated technical reference for the Genpix SkyWalker-1 DVB-S USB 2.0 satellite receiver. Derived from Linux kernel driver analysis (`dvb_usb_gp8psk`), Ghidra firmware reverse engineering (v2.06, v2.10 Rev.2, v2.13 FW1/FW2/FW3), Windows BDA driver source review, and custom firmware development (v3.01.0, SDCC + fx2lib). + +--- + +## Table of Contents + +1. [Hardware Overview](#1-hardware-overview) +2. [USB Interface](#2-usb-interface) +3. [Vendor Command Reference](#3-vendor-command-reference) +4. [Configuration Status Byte](#4-configuration-status-byte) +5. [Boot Sequence](#5-boot-sequence) +6. [BCM4500 Demodulator Interface](#6-bcm4500-demodulator-interface) +7. [Tuning Protocol](#7-tuning-protocol) +8. [GPIF Streaming Path](#8-gpif-streaming-path) +9. [LNB and DiSEqC Control](#9-lnb-and-diseqc-control) +10. [GPIO Pin Map](#10-gpio-pin-map) +11. [Firmware Versions](#11-firmware-versions) +12. [I2C Bus Architecture](#12-i2c-bus-architecture) +13. [Custom Firmware v3.01.0](#13-custom-firmware-v3010) +14. [DVB-S2 Incompatibility](#14-dvb-s2-incompatibility) +15. [Kernel Driver Notes](#15-kernel-driver-notes) +16. [Firmware Storage Formats](#16-firmware-storage-formats) +17. [Debugging Reference](#17-debugging-reference) +18. [Sources](#18-sources) + +--- + +## 1. Hardware Overview + +The Genpix SkyWalker-1 is a standalone USB 2.0 DVB-S satellite receiver built around two ICs: + +| Component | Part | Role | +|-----------|------|------| +| MCU | Cypress CY7C68013A (FX2LP) | USB 2.0 Hi-Speed controller, 8051 core at 48 MHz | +| Demodulator | Broadcom BCM4500 | DVB-S / Turbo / DCII / DSS demodulator, 128-pin MQFP | +| EEPROM | 24Cxx-family (I2C address 0x51) | FX2 firmware storage, serial number, calibration | +| Tuner/LNB | Unknown IC (I2C address 0x10) | Tuner or LNB controller on shared I2C bus | + +The FX2 handles USB communication, LNB control, DiSEqC signaling, and orchestrates tuning via I2C commands to the BCM4500. The BCM4500 performs RF demodulation, forward error correction, and outputs an MPEG-2 transport stream on an 8-bit parallel bus. The FX2's GPIF engine transfers the transport stream directly into a USB bulk endpoint with zero firmware intervention in the data path. + +### 1.1 Supported Modulations + +| Index | Modulation | Constant | FEC Family | +|-------|-----------|----------|------------| +| 0 | DVB-S QPSK | `ADV_MOD_DVB_QPSK` | Viterbi + Reed-Solomon | +| 1 | Turbo-coded QPSK | `ADV_MOD_TURBO_QPSK` | Turbo | +| 2 | Turbo-coded 8PSK | `ADV_MOD_TURBO_8PSK` | Turbo | +| 3 | Turbo-coded 16QAM | `ADV_MOD_TURBO_16QAM` | Turbo | +| 4 | Digicipher II Combo | `ADV_MOD_DCII_C_QPSK` | DCII | +| 5 | Digicipher II I-stream (split) | `ADV_MOD_DCII_I_QPSK` | DCII | +| 6 | Digicipher II Q-stream (split) | `ADV_MOD_DCII_Q_QPSK` | DCII | +| 7 | Digicipher II Offset QPSK | `ADV_MOD_DCII_C_OQPSK` | DCII | +| 8 | DSS QPSK | `ADV_MOD_DSS_QPSK` | Viterbi + Reed-Solomon | +| 9 | DVB-S BPSK | `ADV_MOD_DVB_BPSK` | Viterbi + Reed-Solomon | + +DVB-S2 is not supported. See [Section 14](#14-dvb-s2-incompatibility). + +### 1.2 RF Specifications + +| Parameter | Value | +|-----------|-------| +| IF frequency range | 950 -- 2150 MHz | +| Symbol rate | 256 Ksps -- 30 Msps | +| Input connector | IEC F-type female | +| LNB voltage | 13V / 18V (or 14V / 19V with USE_EXTRA_VOLT) | +| LNB current | 450 mA continuous, 750 mA burst | +| Switch control | 22 kHz, Tone Burst, DiSEqC 1.0/1.2, Legacy Dish Network | + +### 1.3 Board Block Diagram + +``` + +--[ I2C EEPROM 0x51 ] + | + USB 2.0 HS | I2C Bus (400 kHz) + Host PC <----> [ CY7C68013A FX2LP ] <-----> [ BCM4500 Demod 0x08 ] + | 8051 @ 48 MHz | | + | GPIF Engine |<-----------+ 8-bit parallel TS + | EP2 Bulk IN | + | GPIO (P0/P3) |---> [ 22 kHz Osc ] ---> LNB/Coax + | |---> [ LNB Voltage Ctrl ] + +-----------------+ + | + +--[ Tuner/LNB IC 0x10 ] +``` + +--- + +## 2. USB Interface + +### 2.1 VID/PID Table + +All Genpix products share VID `0x09C0`: + +| PID | Product | cold_ids | warm_ids | Notes | +|-----|---------|----------|----------|-------| +| 0x0200 | 8PSK-to-USB2 Rev.1 Cold | Yes | No | Requires FW01 upload to RAM | +| 0x0201 | 8PSK-to-USB2 Rev.1 Warm | No | Yes | Requires FW02 (BCM4500 firmware) | +| 0x0202 | 8PSK-to-USB2 Rev.2 | No | Yes | Boots from EEPROM | +| 0x0203 | **SkyWalker-1** | No | Yes | Boots from EEPROM | +| 0x0204 | SkyWalker-1 (alternate) | No | Yes | Boots from EEPROM | +| 0x0205 | SkyWalker-2 | -- | -- | Not in kernel 6.16.5 | +| 0x0206 | SkyWalker CW3K | No | Yes | Requires CW3K_INIT (0x9D) | + +PID 0x0203 was added to the kernel device table after v6.6.1. + +### 2.2 USB Endpoints and Streaming Properties + +| Property | Value | +|----------|-------| +| Control endpoint | EP0 (default, vendor requests) | +| Bulk IN endpoint | EP2 (0x82) -- MPEG-2 transport stream | +| Generic bulk CTRL endpoint | 0x01 (BCM4500 FW02 upload, Rev.1 only) | +| URB count | 7 | +| URB buffer size | 8192 bytes each | +| Stream type | USB_BULK | +| FX2 controller type | CYPRESS_FX2 | + +### 2.3 Warm Boot Behavior + +The SkyWalker-1 (PID 0x0203) enumerates directly as a "warm" device. The DVB-USB framework skips firmware download when `cold_ids` is NULL. No host-side firmware files are required. + +| Device | PID | Needs FW01? | Needs FW02? | Boot Source | +|--------|-----|-------------|-------------|-------------| +| Rev.1 Cold | 0x0200 | Yes | -- | RAM (empty) | +| Rev.1 Warm | 0x0201 | No | Yes | RAM (FW01 loaded) | +| Rev.2 | 0x0202 | No | No | EEPROM | +| SkyWalker-1 | 0x0203 | No | No | EEPROM | +| SkyWalker CW3K | 0x0206 | No | No | EEPROM | + +The firmware files `dvb-usb-gp8psk-01.fw` and `dvb-usb-gp8psk-02.fw` were never open-sourced or included in `linux-firmware`. + +--- + +## 3. Vendor Command Reference + +All vendor commands use USB control transfers: +- **USB Type**: `USB_TYPE_VENDOR` +- **Timeout**: 2000 ms (kernel driver) +- **Retry**: Up to 3 attempts for IN operations if partial data received +- **Data buffer maximum**: 80 bytes (kernel driver state structure) + +### 3.1 Stock Command Table (0x80--0x9D) + +The vendor command dispatcher at CODE:0056 validates `bRequest` in the range 0x80--0x9D (30 entries) and dispatches via an indexed jump table at CODE:0076. Rev.2 supports only 0x80--0x9A (27 entries). + +| Cmd | Name | Dir | wValue | wIndex | wLength | Purpose | v2.06 | Rev.2 | v2.13 | +|-----|------|-----|--------|--------|---------|---------|-------|-------|-------| +| 0x80 | GET_8PSK_CONFIG | IN | 0 | 0 | 1 | Read configuration status byte | OK | OK | OK | +| 0x81 | SET_8PSK_CONFIG | OUT | varies | 0 | 0 | Set config (reserved) | STALL | STALL | STALL | +| 0x82 | (reserved) | -- | -- | -- | -- | Reserved | STALL | STALL | STALL | +| 0x83 | I2C_WRITE | OUT | dev_addr | reg_addr | N | Write to I2C device | OK | OK | OK | +| 0x84 | I2C_READ | IN | dev_addr | reg_addr | N | Read from I2C device | OK | OK | OK | +| 0x85 | ARM_TRANSFER | OUT | 0/1 | 0 | 0 | Start (1) / stop (0) MPEG-2 stream | OK | OK | OK | +| 0x86 | TUNE_8PSK | OUT | 0 | 0 | 10 | Set tuning parameters ([Section 7](#7-tuning-protocol)) | OK | OK | OK | +| 0x87 | GET_SIGNAL_STRENGTH | IN | 0 | 0 | 6 | Read SNR and diagnostics | OK | OK | Changed | +| 0x88 | LOAD_BCM4500 | OUT | 1 | 0 | 0 | Initiate BCM4500 FW download | STALL | STALL | STALL | +| 0x89 | BOOT_8PSK | IN | 0/1 | 0 | 1 | Power on (1) / off (0) demodulator | OK | OK | OK | +| 0x8A | START_INTERSIL | IN | 0/1 | 0 | 1 | Enable (1) / disable (0) LNB supply | OK | OK | OK | +| 0x8B | SET_LNB_VOLTAGE | OUT | 0/1 | 0 | 0 | 13V (0) or 18V (1) | OK | OK | OK | +| 0x8C | SET_22KHZ_TONE | OUT | 0/1 | 0 | 0 | Tone off (0) or on (1) | OK | OK | OK | +| 0x8D | SEND_DISEQC_COMMAND | OUT | msg[0] | 0 | len | DiSEqC message or tone burst | OK | OK | OK | +| 0x8E | SET_DVB_MODE | OUT | 1 | 0 | 0 | Enable DVB-S mode | STALL | STALL | STALL | +| 0x8F | SET_DN_SWITCH | OUT | cmd7bit | 0 | 0 | Legacy Dish Network switch protocol | OK | OK | OK | +| 0x90 | GET_SIGNAL_LOCK | IN | 0 | 0 | 1 | Read signal lock status | OK | OK | OK | +| 0x91 | I2C_ADDR_ADJUST | IN | 0/1 | 0 | 1 | Inc/dec internal counter (debug) | OK | OK | OK | +| 0x92 | GET_FW_VERS | IN | 0 | 0 | 6 | Read firmware version + build date | OK | OK | OK | +| 0x93 | GET_SERIAL_NUMBER | IN | 0 | 0 | 4 | Read 4-byte serial from EEPROM | OK | OK | OK | +| 0x94 | USE_EXTRA_VOLT | OUT | 0/1 | 0 | 0 | Enable +1V LNB boost (14V/19V) | OK | OK | OK | +| 0x95 | GET_FPGA_VERS | IN | 0 | 0 | 1 | Read EEPROM hardware/platform ID | OK | OK | OK | +| 0x96 | SET_LNB_GPIO_MODE | OUT | 0/1 | 0 | 0 | Configure LNB GPIO output enables | OK | OK | OK | +| 0x97 | SET_GPIO_PINS | OUT | bitmap | 0 | 0 | Direct write to LNB GPIO pins | OK | OK | OK | +| 0x98 | GET_GPIO_STATUS | IN | 0 | 0 | 1 | Read LNB feedback GPIO pin | OK | OK | OK | +| 0x99 | GET_DEMOD_STATUS | IN | 0 | 0 | 1 | Read BCM4500 register 0xF9 | STALL | Proto | OK | +| 0x9A | INIT_DEMOD | OUT | 0 | 0 | 0 | Trigger demod re-init (3 attempts) | STALL | Proto | OK | +| 0x9B | (reserved) | -- | -- | -- | -- | Reserved | STALL | N/A | STALL | +| 0x9C | DELAY_COMMAND | OUT | delay | 0 | 0 | Host-controlled tuning delay + poll | STALL | N/A | OK | +| 0x9D | CW3K_INIT / SET_MODE_FLAG | OUT | 0/1 | 0 | 0 | CW3K init or conditional demod reset | OK | N/A | Changed | + +**Status key**: OK = implemented. STALL = routes to stall handler. Proto = partial/prototype. N/A = out of range (Rev.2 supports 0x80--0x9A only). Changed = implementation differs between versions. + +**Driver usage notes**: +- The Linux driver only sends LOAD_BCM4500 (0x88) for Rev.1 Warm (PID 0x0201). On SkyWalker-1, `bm8pskFW_Loaded` is already set and 0x88 STALLs. +- The Linux driver only sends CW3K_INIT (0x9D) for SkyWalker CW3K (PID 0x0206). + +### 3.2 Vendor Command Dispatch Mechanism + +The vendor command dispatcher at CODE:0056 (identical code address across v2.06, v2.13, and Rev.2) follows this logic: + +``` +1. Check bmRequestType bit 6: if not set, not a vendor request -> handle standard +2. Read bRequest from SETUPDAT[1] +3. Subtract 0x80 (command base offset) +4. Compare against maximum: < 0x1E (v2.06/v2.13) or < 0x1B (Rev.2) +5. If in range: double the index (2 bytes per entry) and JMP @A+DPTR to jump table +6. If out of range: route to STALL handler +``` + +The jump table at CODE:0076 contains 2-byte AJMP targets. Each entry points to the handler for commands 0x80 through 0x9D (or 0x9A for Rev.2). + +**Jump table layout (first 6 entries shown, Rev.2):** + +``` +CODE:0076: 01C1 ; 0x80 GET_8PSK_CONFIG -> 0x01C1 +CODE:0078: 034B ; 0x81 SET_8PSK_CONFIG -> 0x034B (STALL) +CODE:007A: 034B ; 0x82 (reserved) -> 0x034B (STALL) +CODE:007C: 0103 ; 0x83 I2C_WRITE -> 0x0103 +CODE:007E: 00D9 ; 0x84 I2C_READ -> 0x00D9 +CODE:0080: 00C2 ; 0x85 ARM_TRANSFER -> 0x00C2 +... +``` + +### 3.3 Custom Firmware Commands (0xB0--0xB6) + +Commands added in custom firmware v3.01.0: + +| Cmd | Name | Dir | wValue | wIndex | wLength | Purpose | +|-----|------|-----|--------|--------|---------|---------| +| 0xB0 | SPECTRUM_SWEEP | OUT | 0 | 0 | 10 | Step through freq range, read SNR at each step | +| 0xB1 | RAW_DEMOD_READ | IN | reg | 0 | 1 | Read BCM4500 indirect register | +| 0xB2 | RAW_DEMOD_WRITE | OUT | reg | data | 0 | Write BCM4500 indirect register | +| 0xB3 | BLIND_SCAN | OUT | 0 | 0 | 16 | Try symbol rates at given freq, report lock | +| 0xB4 | I2C_BUS_SCAN | IN | 0 | 0 | 16 | Probe all 7-bit addresses, return 16-byte bitmap | +| 0xB5 | I2C_RAW_READ | IN | addr7 | reg | N | Combined write-read from any I2C device | +| 0xB6 | I2C_DIAG | IN | page | 0 | 8 | Step-by-step indirect register diagnostic | + +### 3.4 Detailed Parameter Formats + +**0x87 GET_SIGNAL_STRENGTH**: Returns 6 bytes. Bytes 0--1 are a 16-bit SNR value (little-endian, dBu * 256 units). Bytes 2--5 are reserved/diagnostic. SNR scaling from Windows BDA driver: `if snr_raw <= 0x0F00: strength = snr_raw * 17; else strength = 0xFFFF`. Version differences: v2.06 polls 3 registers (0xA2, 0xA8, 0xA4) up to 6 times; v2.13 consolidates to 1 register. + +**0x8D SEND_DISEQC_COMMAND**: When `wLength > 0`, the payload is a standard DiSEqC message (3--6 bytes) with `wValue` = `msg[0]` (framing byte, typically 0xE0 or 0xE1). When `wLength == 0`: `wValue == 0` sends tone burst A; `wValue != 0` sends tone burst B. See [Section 9](#9-lnb-and-diseqc-control). + +**0x8F SET_DN_SWITCH**: `wValue` carries a 7-bit Dish Network switch command, bit-banged LSB-first on GPIO P0.4. The 8th bit (0x80) of the original switch command controls LNB voltage and is sent separately via SET_LNB_VOLTAGE (0x8B). + +**0x92 GET_FW_VERS**: Returns 6 bytes of hardcoded constants: + +``` +Byte 0: version minor_minor (e.g., 0x04) +Byte 1: version minor (e.g., 0x06) +Byte 2: version major (e.g., 0x02) +Byte 3: build day (e.g., 0x0D = 13) +Byte 4: build month (e.g., 0x07 = July) +Byte 5: build year - 2000 (e.g., 0x07 = 2007) +``` + +Full version = `byte[2] << 16 | byte[1] << 8 | byte[0]`. Build date = `(2000 + byte[5]) / byte[4] / byte[3]`. + +**0x93 GET_SERIAL_NUMBER**: Returns 4 bytes read from I2C EEPROM at device address 0x51 (7-bit), extracted at 8-bit intervals using a shift/rotate routine. + +**0x94 USE_EXTRA_VOLT**: `wValue=1` writes 0x6A to XRAM 0xE0B6; `wValue=0` writes 0x62. The difference is bit 3 (0x08), which controls the voltage boost on the LNB power regulator. + +**0x95 GET_FPGA_VERS**: Reads from I2C EEPROM at 0x51. Despite the name, there is no FPGA on the SkyWalker-1 -- this returns a hardware platform ID. v2.06 reads EEPROM offset 0x31 (2 bytes); v2.13/Rev.2 read offset 0x00 (1 byte). + +**0xB0 SPECTRUM_SWEEP**: 10-byte EP0 payload: `[start_freq(u32 LE kHz), stop_freq(u32 LE kHz), step_khz(u16 LE)]`. Programs BCM4500 at each frequency step, reads SNR, packs u16 LE results into EP2 bulk FIFO. + +**0xB3 BLIND_SCAN**: 16-byte EP0 payload: `[freq_khz(u32 LE), sr_min(u32 LE sps), sr_max(u32 LE sps), sr_step(u32 LE sps)]`. Returns 8 bytes on lock `[freq_khz(4) + sr_locked(4)]` or 1 byte 0x00 if no lock found. + +**0xB4 I2C_BUS_SCAN**: Returns a 16-byte bitmap (128 bits for addresses 0x00--0x77). Each bit position corresponds to a 7-bit address; bit set = ACK received. Known devices on the SkyWalker-1 bus: + +| Address | Identity | +|---------|----------| +| 0x08 | BCM4500 demodulator (7-bit; wire addresses 0x10 write / 0x11 read) | +| 0x10 | Tuner or LNB controller | +| 0x51 | Configuration EEPROM (24Cxx-family) | + +--- + +## 4. Configuration Status Byte + +Returned by GET_8PSK_CONFIG (0x80). Stored in IRAM at a version-dependent address. + +``` +Bit 7 (0x80): bmArmed - MPEG-2 stream transfer armed / GPIF active +Bit 6 (0x40): bmDCtuned - DC offset tuning complete (set for DCII modes) +Bit 5 (0x20): bmSEL18V - 18V LNB voltage selected (else 13V) +Bit 4 (0x10): bm22kHz - 22 kHz tone active +Bit 3 (0x08): bmDVBmode - DVB mode enabled +Bit 2 (0x04): bmIntersilOn - LNB power supply enabled +Bit 1 (0x02): bm8pskFW_Loaded - BCM4500 firmware loaded (always set on SkyWalker-1) +Bit 0 (0x01): bm8pskStarted - Device booted and running +``` + +| Firmware | IRAM Address | +|----------|-------------| +| v2.06 | 0x6D | +| Rev.2 v2.10.4 | 0x4E | +| v2.13 | 0x4F | + +The kernel driver checks these bits to decide which initialization steps to perform. On the SkyWalker-1 after a successful BOOT_8PSK, `config_status = 0x03` (STARTED + FW_LOADED). + +--- + +## 5. Boot Sequence + +### 5.1 Kernel Driver Boot Flow + +``` +1. GET_8PSK_CONFIG (0x80) -- read config status byte + |-- Check bit 0: bm8pskStarted? + +2. If not started: + |-- BOOT_8PSK (0x89, wValue=1) + |-- GET_FW_VERS (0x92) -- read firmware version + +3. If bit 1 clear (bm8pskFW_Loaded): + |-- LOAD_BCM4500 (0x88) -- Rev.1 Warm only; STALLs on SkyWalker-1 + +4. If bit 2 clear (bmIntersilOn): + |-- START_INTERSIL (0x8A, wValue=1) -- enable LNB power supply + +5. SET_DVB_MODE (0x8E, wValue=1) -- STALLs on all SkyWalker-1 FW versions + +6. ARM_TRANSFER (0x85, wValue=0) -- abort any pending MPEG transfer + +7. Device ready for tuning +``` + +### 5.2 BCM4500 Boot Sequence (BOOT_8PSK, 0x89) + +As implemented in `bcm4500_boot()` in custom firmware v3.01.0, reverse-engineered from stock v2.06 `FUN_CODE_1D4F` + `FUN_CODE_0ddd`: + +``` +Step Action GPIO/I2C Duration +---- ------------------------------------ ----------------- -------- +1 Assert BCM4500 RESET P0.5 = LOW -- +2 Power on P0.1 = HIGH -- + P0.2 = LOW +3 Wait for power settle -- 30 ms +4 Release RESET P0.5 = HIGH -- +5 Wait for BCM4500 POR + ROM boot -- 50 ms +6 I2C probe (read register 0xA2) I2C read 0x08:0xA2 ~0.1 ms +7 Write init block 0 to page 0 I2C write 0xA6/A7/A8 ~2 ms +8 Write init block 1 to page 0 I2C write 0xA6/A7/A8 ~2 ms +9 Write init block 2 to page 0 I2C write 0xA6/A7/A8 ~1 ms +10 Set config_status = 0x03 -- -- +``` + +**Total boot time**: approximately 90 ms (30 ms power + 50 ms POR + ~10 ms I2C). + +### 5.3 BCM4500 Initialization Data + +Three register initialization blocks are written to BCM4500 indirect registers (page 0x00) via the 0xA6/0xA7/0xA8 protocol. Data extracted from stock v2.06 firmware `FUN_CODE_0ddd`: + +| Block | Start Register | Length | Data (hex) | +|-------|---------------|--------|------------| +| 0 | 0x06 | 7 bytes | `06 0b 17 38 9f d9 80` | +| 1 | 0x07 | 8 bytes | `07 09 39 4f 00 65 b7 10` | +| 2 | 0x0F | 3 bytes | `0f 0c 09` | + +Each block is written as: page select (0xA6 = 0x00), data bytes to 0xA7, trailing zero to 0xA7, then commit (0xA8 = 0x03). The firmware polls 0xA8 until the command completes before proceeding to the next block. + +### 5.4 FX2 CPUCS Recovery + +The FX2's CPUCS register at 0xE600 controls the 8051 run/halt state. The standard vendor request bRequest=0xA0 (RAM read/write) is handled by the FX2 boot ROM in silicon, not by user firmware. This means `fw_load.py` can reload firmware over a completely hung device: + +```bash +sudo python3 tools/fw_load.py load firmware/build/skywalker1.ihx --wait 3 +``` + +Writing 0x01 to CPUCS halts the CPU. New code is written to RAM. Writing 0x00 restarts it. The device re-enumerates with the new firmware. + +--- + +## 6. BCM4500 Demodulator Interface + +### 6.1 I2C Addressing + +| Parameter | Value | +|-----------|-------| +| 7-bit I2C address | 0x08 | +| 8-bit write address | 0x10 | +| 8-bit read address | 0x11 | +| Bus speed | 400 kHz | +| FX2 I2C controller SFRs | I2CS, I2DAT, I2CTL | +| Alternate probe addresses (v2.13) | 0x3F, 0x7F | + +The custom firmware and kernel driver use the 7-bit address 0x08. The stock firmware writes `addr << 1` = 0x10 for write and `(addr << 1) | 1` = 0x11 for read, which is the standard I2C convention for 7-bit address 0x08. + +The v2.13 firmware probes addresses 0x7F and 0x3F at startup (INT0 handler) to detect which demodulator variant is present. These may be alternative I2C address configurations or addresses for different demodulator sub-systems. + +### 6.2 Direct Registers + +Accessed via standard I2C write/read to the BCM4500's device address: + +| Register | Function | +|----------|----------| +| 0xA2 | Status register (polled for readiness during boot) | +| 0xA4 | Lock/ready register; bit 5 (0x20) = signal locked | +| 0xA6 | Indirect page/address select | +| 0xA7 | Indirect data register (read/write) | +| 0xA8 | Indirect command register | +| 0xF9 | Demod status (read by v2.13 GET_DEMOD_STATUS / INT0 polling) | + +### 6.3 Indirect Register Protocol + +The BCM4500 uses an indirect register access scheme through three directly-addressable registers: + +**Indirect Write Sequence:** + +``` +1. I2C WRITE to 0x08, register 0xA6 <- page_number (typically 0x00) +2. I2C WRITE to 0x08, register 0xA7 <- data bytes (N bytes, auto-increment) +3. I2C WRITE to 0x08, register 0xA8 <- 0x03 (execute indirect write) +4. Poll register 0xA8 until bit 0 clear (command complete) +5. Optionally read back register 0xA7 to verify +``` + +**Indirect Read Sequence:** + +``` +1. I2C WRITE to 0x08, register 0xA6 <- target_register +2. I2C WRITE to 0x08, register 0xA7 <- 0x00 (placeholder) +3. I2C WRITE to 0x08, register 0xA8 <- 0x01 (execute indirect read) +4. Short delay (~1 ms) +5. I2C READ from 0x08, register 0xA7 <- result byte +``` + +### 6.4 Indirect Protocol Auto-Increment + +The BCM4500's data register (0xA7) supports auto-increment for multi-byte writes within a single I2C transaction. When writing N data bytes to 0xA7 in one I2C WRITE operation (without issuing STOP between bytes), the BCM4500 internally advances its data buffer pointer after each byte. This allows writing an entire initialization block in a single I2C transaction: + +``` +I2C transaction: + START -> 0x10 (write) -> 0xA7 (reg) -> data[0] -> data[1] -> ... -> data[N-1] -> STOP +``` + +The firmware exploits this for initialization blocks and tuning data, reducing I2C overhead compared to byte-by-byte writes. + +**Stock firmware init block write sequence (from FUN_CODE_0ddd):** + +``` +1. I2C WRITE: [0x10] [0xA6] [0x00] -- Page select = 0 +2. I2C WRITE: [0x10] [0xA7] [data0..dataN] -- Multi-byte data (auto-increment) +3. I2C WRITE: [0x10] [0xA7] [0x00] -- Trailing zero (stock firmware quirk) +4. I2C WRITE: [0x10] [0xA8] [0x03] -- Commit indirect write +5. Poll: I2C READ [0xA8] until bit 0 clear -- Wait for completion +``` + +The trailing zero write (step 3) appears in all stock firmware versions. Its purpose is unclear -- it may zero-pad the data buffer or serve as an end-of-data marker within the BCM4500's indirect register engine. + +### 6.5 Demodulator Scan + +The tune function (stock firmware) tries up to 3 different I2C address configurations per attempt, with 3 outer retries (up to 9 total I2C programming attempts). This supports hardware variants where the BCM4500 may appear at different bus addresses. + +v2.13 adds a boot-time probe: INT0 polls addresses 0x7F and 0x3F up to 40 times (0x28), setting flag `_1_4` if neither responds. This prevents tuning attempts on boards with absent demodulators. + +### 6.6 BCM4500 FEC Architecture + +The BCM4500 contains two FEC decoder paths: + +1. **Advanced Modulation Turbo FEC Decoder**: Iterative turbo code decoder supporting QPSK (rates 1/4, 1/2, 3/4), 8PSK (rates 2/3, 3/4, 5/6, 8/9), 16QAM (rate 3/4), with Reed-Solomon (t=10) outer code. + +2. **Legacy DVB/DIRECTV/DCII-Compliant FEC Decoder**: Concatenated Viterbi inner decoder (convolutional code, rates 1/2 through 7/8) + Reed-Solomon outer decoder. + +There is no LDPC or BCH decoder hardware. See [Section 14](#14-dvb-s2-incompatibility). + +--- + +## 7. Tuning Protocol + +### 7.1 TUNE_8PSK Command Format (0x86) + +The host sends a 10-byte OUT payload via USB control transfer: + +``` +USB SETUP: bmRequestType=0x40, bRequest=0x86, wValue=0, wIndex=0, wLength=10 + +EP0BUF Layout: + Byte Content Encoding + ---- ------------------ ---------------- + [0] Symbol Rate byte 0 Little-endian LSB + [1] Symbol Rate byte 1 + [2] Symbol Rate byte 2 + [3] Symbol Rate byte 3 Little-endian MSB + [4] Frequency byte 0 Little-endian LSB + [5] Frequency byte 1 + [6] Frequency byte 2 + [7] Frequency byte 3 Little-endian MSB + [8] Modulation Type 0--9 (see Section 1.1) + [9] Inner FEC Rate Index into modulation-specific table +``` + +**Symbol Rate** is in samples per second (sps). The Windows driver multiplies ksps by 1000. + +**Frequency** is the IF frequency in kHz (950000--2150000), computed by the host as `(RF_freq - LO_freq) * multiplier`. + +### 7.2 Firmware EP0BUF Parsing + +The firmware reads the 10-byte payload from EP0BUF (XRAM 0xE740--0xE749) and stores: + +| Source | Destination | Notes | +|--------|-------------|-------| +| EP0BUF[8] (modulation) | IRAM 0x4D | Direct copy | +| EP0BUF[9] (FEC) | IRAM 0x4F | Direct copy | +| EP0BUF[4--7] (frequency) | XRAM 0xE0DB--0xE0DE | Byte-reversed (LE to BE) | +| EP0BUF[0--3] (symbol rate) | XRAM 0xE0CB--0xE0CE | Byte-reversed (LE to BE) | + +The byte reversal converts host little-endian to BCM4500 big-endian so values can be written directly to the demodulator via I2C. + +### 7.3 Modulation Dispatch + +After parsing, the firmware validates the modulation type (bounds check `< 10`) and dispatches via a 20-byte jump table (10 entries x 2 bytes) at CODE:0873. Each handler: + +1. Validates the FEC index against the maximum for that modulation +2. Looks up a preconfigured byte from an XRAM FEC rate table +3. Writes configuration to four XRAM registers (0xE0EB, 0xE0EC, 0xE0F5, 0xE0F6) + +**Modulation jump table (from Rev.2 at CODE:0873):** + +| Entry | AJMP Target | Modulation | +|-------|------------|-----------| +| 0 | 0x08B7 | DVB-S QPSK | +| 1 | 0x08DF | Turbo QPSK | +| 2 | 0x08FA | Turbo 8PSK | +| 3 | 0x0915 | Turbo 16QAM | +| 4 | 0x0947 | DCII Combo | +| 5 | 0x094F | DCII I-stream | +| 6 | 0x0957 | DCII Q-stream | +| 7 | 0x095F | DCII Offset QPSK | +| 8 | 0x0887 | DSS QPSK | +| 9 | 0x0887 | DVB BPSK (shares DSS handler) | + +DSS and DVB BPSK share the same handler. Their FEC lookup uses the same table (0xE0F9) but ORs the result with 0x80 to distinguish them from DVB-S QPSK. + +### 7.4 FEC Rate Lookup Tables + +Populated from the CODE-space init table at boot: + +| XRAM Base | Modulation | Max FEC Index | Code Rates | +|-----------|-----------|---------------|------------| +| 0xE0F9 | DVB-S QPSK, DSS, BPSK | 7 | 1/2, 2/3, 3/4, 5/6, 7/8, auto, none | +| 0xE0B7 | Turbo QPSK | 5 | Turbo-specific rates | +| 0xE0B1 | Turbo 8PSK | 5 | Turbo-specific rates | +| 0xE0BC | Turbo 16QAM | 1 | Single code rate | +| 0xE0BD | DCII (all variants) | 9 | Combined code + modulation | + +### 7.5 BCM4500 XRAM Configuration After Dispatch + +| XRAM Addr | Register | DVB-S QPSK | Turbo (Q/8/16) | DCII | DSS/BPSK | +|-----------|----------|-----------|---------------|------|----------| +| 0xE0EB | FEC Code Rate | Table lookup | Table lookup | 0xFC (fixed) | Table lookup OR 0x80 | +| 0xE0EC | Modulation Type | 0x09 | 0x09 | From DCII table | 0x09 | +| 0xE0F5 | Demod Mode | 0x10 | 0x10 | 0x10/0x11/0x12/0x16 | 0x10 | +| 0xE0F6 | Turbo Flag | 0x00 | 0x01 | 0x00 | 0x00 | + +**DCII Demod Mode values:** + +| Modulation | Index | XRAM 0xE0F5 | +|-----------|-------|-------------| +| DCII Combo | 4 | 0x10 | +| DCII I-stream | 5 | 0x12 | +| DCII Q-stream | 6 | 0x16 | +| DCII Offset QPSK | 7 | 0x11 | + +DSS (8) and DVB BPSK (9) share the DVB-S QPSK handler; they use the same FEC table but OR the lookup value with 0x80. + +### 7.6 Complete Tuning Sequence (Host to Satellite) + +``` +=== Phase 1: LNB Configuration (separate vendor commands) === +1. SET_LNB_VOLTAGE (0x8B) -- GPIO P0.4 (no I2C) + H / Circular-L -> wValue=1 (18V) + V / Circular-R -> wValue=0 (13V) +2. SET_22KHZ_TONE (0x8C) -- GPIO P0.3 (no I2C) + High band -> wValue=1 (tone on) + Low band -> wValue=0 (tone off) +3. SEND_DISEQC_COMMAND (0x8D) -- if multi-switch needed + +=== Phase 2: Tune Command === +4. TUNE_8PSK (0x86) -- 10-byte payload + +=== Phase 3: Firmware Internal Processing === +5. EP0BUF parsing: mod/FEC to IRAM, freq/SR byte-reversed to XRAM +6. Modulation dispatch: FEC lookup, XRAM config registers set +7. GPIO P3.6: DVB mode select + +=== Phase 4: BCM4500 I2C Programming (3 outer retries x 3 I2C addresses) === +8. Poll BCM4500 ready: I2C READ regs 0xA2, 0xA8, 0xA4 +9. Write page: I2C WRITE reg 0xA6 <- 0x00 +10. Write config: I2C WRITE reg 0xA7 <- [freq, SR, FEC, mod, demod params] +11. Execute: I2C WRITE reg 0xA8 <- 0x03 (indirect write command) +12. Poll completion: I2C READ regs 0xA8, 0xA2 +13. Verify: I2C READ reg 0xA7 (read-back compare) + +=== Phase 5: Signal Acquisition (host polling) === +14. GET_SIGNAL_LOCK (0x90) -- poll until non-zero +15. GET_SIGNAL_STRENGTH (0x87) -- read SNR +``` + +### 7.7 Signal Lock and Strength + +**GET_SIGNAL_LOCK (0x90)**: Returns 1 byte from BCM4500 register 0xA4. Bit 5 (0x20) indicates signal lock. The kernel driver interprets any non-zero value as locked and reports `FE_HAS_LOCK | FE_HAS_SYNC | FE_HAS_VITERBI | FE_HAS_SIGNAL | FE_HAS_CARRIER`. + +**GET_SIGNAL_STRENGTH (0x87)**: Returns 6 bytes. Bytes 0--1 = 16-bit SNR (LE, dBu * 256). SNR scaling: `snr_raw * 17` maps 0x0000--0x0F00 to 0--65535 (100% at SNR >= 0x0F00). + +--- + +## 8. GPIF Streaming Path + +### 8.1 Data Flow + +``` +BCM4500 Cypress FX2 (CY7C68013A) USB Host +Demodulator P3.5 GPIF Engine EP2 FIFO EP2 (0x82) + (I2C:0x08) <-----> (Master Read) (AUTOIN) ------------> Bulk IN + 8-bit 0xE4xx wfm 4x buffer 7 URBs + parallel 8-bit x 8KB +``` + +The path is fully hardware-managed. The GPIF engine reads data from the BCM4500's 8-bit parallel transport stream output directly into the EP2 FIFO. The AUTOIN bit causes automatic USB commit when the FIFO buffer is full. The FLOWSTATE engine re-triggers GPIF transactions when buffer space becomes available. No firmware intervention occurs in the data path after initial setup. + +### 8.2 Key Register Configuration + +All values are identical across the three stock firmware versions: + +| Register | Address | Value | Function | +|----------|---------|-------|----------| +| IFCONFIG | 0xE601 | 0xEE | Internal 48 MHz clock, GPIF master, async, debug | +| EP2FIFOCFG | 0xE618 | 0x0C | AUTOIN=1, ZEROLENIN=1, 8-bit data path | +| REVCTL | 0xE60B | 0x03 | NOAUTOARM + SKIPCOMMIT | +| CPUCS | 0xE600 | bits [4:3]=10 | 48 MHz CPU clock | +| FLOWSTATEA | 0xE668 | OR 0x09 | FSEN (flow state enable) + FS[3] | +| GPIFIE | 0xE65C | OR 0x3D | Waveform, TC, DONE, FIFO flag, WF2 interrupts | + +**IFCONFIG decode (0xEE = 1110_1110):** + +| Bit | Name | Value | Meaning | +|-----|------|-------|---------| +| 7 | IFCLKSRC | 1 | Internal clock source | +| 6 | 3048MHZ | 1 | 48 MHz IFCLK frequency | +| 5 | IFCLKOE | 1 | IFCLK pin drives output (clock to BCM4500) | +| 4 | IFCLKPOL | 0 | Non-inverted clock polarity | +| 3 | ASYNC | 1 | Asynchronous GPIF (RDY pin handshaking) | +| 2 | GSTATE | 1 | Debug state output on PORTE | +| 1:0 | IFCFG | 10 | GPIF internal master mode | + +### 8.3 ARM_TRANSFER Sequences + +**Start streaming (wValue=1):** + +1. Set config_byte bit 7 (streaming active) +2. Load GPIF transaction count: GPIFTCB3:2 = 0x8000 (effectively infinite) +3. Reset GPIF address and EP2 FIFO byte count +4. Assert P3.5 LOW (BCM4500 transport stream enable) +5. Wait for initial GPIF transaction (poll GPIFTRIG bit 7) +6. De-assert P3.5 HIGH +7. Trigger continuous GPIF read: GPIFTRIG = 0x04 (read into EP2) +8. Set P0.7 LOW (streaming indicator) + +**Stop streaming (wValue=0):** + +1. Set P0.7 HIGH (streaming stopped) +2. Write EP2FIFOBCH = 0xFF (force-flush current buffer) +3. Wait for GPIF idle (poll GPIFTRIG bit 7) +4. Write OUTPKTEND = 0x82 (skip/discard partial EP2 packet) +5. Clear config_byte bit 7 (streaming inactive) +6. Set P3 bits 7:5 = 1 (de-assert all BCM4500 control lines) + +### 8.4 Throughput Analysis + +| Metric | Value | +|--------|-------| +| USB 2.0 HS bulk theoretical | 480 Mbps | +| USB 2.0 HS bulk practical | ~280 Mbps (~35 MB/s) | +| GPIF engine theoretical | 48 MHz x 8 bits = 384 Mbps | +| Typical DVB-S TS rate | 1--5 MB/s | +| Maximum DVB-S2 rate (hypothetical) | ~7.25 MB/s (58 Mbps) | + +The USB/GPIF path has approximately 5x headroom even at maximum theoretical DVB-S2 data rates. The bottleneck for supported modes is the satellite link, not the USB data path. + +### 8.5 FIFO Reset Sequence + +All endpoint FIFOs are reset during initialization using the Cypress-prescribed procedure: + +``` +FIFORESET = 0x80 ; NAKALL: NAK all host transfers during reset +FIFORESET = 0x02 ; Reset EP2 FIFO +FIFORESET = 0x04 ; Reset EP4 FIFO +FIFORESET = 0x06 ; Reset EP6 FIFO +FIFORESET = 0x08 ; Reset EP8 FIFO +FIFORESET = 0x00 ; Release NAKALL +``` + +Three NOP instructions (mandatory SYNCDELAY) are inserted between each write per Cypress TRM requirements. + +### 8.6 EP2 Endpoint Configuration + +```c +EP2CFG = 0xE2; // valid=1, dir=IN, type=BULK, size=512, buf=DOUBLE +``` + +| Bit | Value | Meaning | +|-----|-------|---------| +| 7 (VALID) | 1 | Endpoint enabled | +| 6 (DIR) | 1 | IN (device to host) | +| 5:4 (TYPE) | 10 | Bulk transfer | +| 3 (SIZE) | 0 | 512-byte packets | +| 1:0 (BUF) | 10 | Double-buffered | + +EP4, EP6, EP8 are disabled (`&= ~bmVALID`). + +### 8.7 Interrupt Handling + +INT4 and INT6 (GPIF/FIFO events) share a common handler that sets a software flag (`_0_1`) and clears EXIF.4. The main loop polls this flag, enters CPU idle mode (PCON.0) between events, and checks EP2CS for buffer availability before re-arming the GPIF. + +**Main loop structure (from v2.06 FUN_CODE_2297):** + +```c +void main_loop_poll(void) { + if (_0_1) { // GPIF/FIFO event pending + _0_1 = 0; // Clear flag + if (EP2CS & bmEPFULL) { // EP2 buffer full? + // Wait for host to read EP2 + } + } else { + PCON |= 0x01; // CPU idle until next interrupt + } +} +``` + +### 8.8 Prior IFCONFIG Value + +During early initialization, IFCONFIG is temporarily set to 0xCA before the final 0xEE: + +| Value | Decode | Difference from 0xEE | +|-------|--------|---------------------| +| 0xCA | 1100_1010 | GSTATE=0, ASYNC=0 | +| 0xEE | 1110_1110 | GSTATE=1, ASYNC=1 (final) | + +The temporary value disables async mode and debug state output during FIFO setup. + +--- + +## 9. LNB and DiSEqC Control + +### 9.1 LNB Voltage + +LNB voltage is controlled via GPIO P0.4. No I2C is involved. + +| wValue | Voltage | GPIO P0.4 | Polarization | +|--------|---------|-----------|-------------| +| 0 | 13V | LOW | Vertical / Circular-Right | +| 1 | 18V | HIGH | Horizontal / Circular-Left | + +USE_EXTRA_VOLT (0x94) enables a +1V boost (13V->14V, 18V->19V) for long cable runs by writing to XRAM 0xE0B6 (0x62=normal, 0x6A=boosted; bit 3 is the difference). + +### 9.2 22 kHz Tone + +Controlled via GPIO P0.3. P0.3 gates an external 22 kHz oscillator on the PCB. The firmware does not generate the 22 kHz carrier directly. + +| wValue | State | GPIO P0.3 | Band | +|--------|-------|-----------|------| +| 0 | OFF | LOW | Low band (9.75 GHz LO on universal LNB) | +| 1 | ON | HIGH | High band (10.6 GHz LO on universal LNB) | + +### 9.3 DiSEqC Protocol Implementation + +All firmware versions implement DiSEqC via Timer2-based GPIO bit-bang. The algorithm is identical across versions; only the data pin differs per PCB revision. + +**Timer2 configuration (identical across all versions):** + +| Parameter | Value | +|-----------|-------| +| T2CON | 0x04 (auto-reload, running) | +| RCAP2H:RCAP2L | 0xF82F (reload = 63535) | +| CKCON.T2M | 0 (Timer2 clock = 48 MHz / 12 = 4 MHz) | +| Tick period | (65536 - 63535) / 4 MHz = 500.25 us | + +**DiSEqC timing parameters:** + +| Parameter | Value | +|-----------|-------| +| Bit period | 1.5 ms (3 Timer2 ticks) | +| Byte period | 13.5 ms (9 bits: 8 data + 1 parity) | +| Tone burst A/B | 12.5 ms (25 ticks) | +| Pre-TX settling delay | 7.5 ms (15 ticks) | +| Data '0' | 1.0 ms tone + 0.5 ms silence (2/3 duty cycle) | +| Data '1' | 0.5 ms tone + 1.0 ms silence (1/3 duty cycle) | +| Carrier frequency | 22 kHz (external oscillator, gated by P0.3) | + +**Manchester encoding (decompiled from Rev.2 FUN_CODE_213c):** + +``` +Each DiSEqC bit = 3 Timer2 ticks: + Tick 1: inter-bit gap (carrier OFF via P0.3 = 0) + Tick 2: carrier ON (P0.3 = 1) + Tick 3: if data_pin='1', carrier OFF early; if '0', carrier stays ON + End: carrier always OFF +``` + +**DiSEqC bit waveforms:** + +``` +Data '0' (2/3 tone, 1/3 silence): + Tick 1 Tick 2 Tick 3 + (500 us) (500 us) (500 us) +P0.3: _____|========|========|________| + ^tone ON ^tone OFF + (setup gap) (1.0 ms carrier) (0.5 ms silence) + +Data '1' (1/3 tone, 2/3 silence): + Tick 1 Tick 2 Tick 3 + (500 us) (500 us) (500 us) +P0.3: _____|========|________|________| + ^tone ON ^tone OFF early + (setup gap) (0.5 ms carrier) (1.0 ms silence) +``` + +**Decompiled bit symbol function (from Rev.2 FUN_CODE_213c):** + +```c +void diseqc_bit_symbol(void) { + wait_TF2(); // Tick 1: inter-bit gap (500 us) + P0 |= 0x08; // P0.3 = 1 -> 22 kHz carrier ON + wait_TF2(); // Tick 2: carrier period (500 us) + if (data_pin != 0) { // If data = '1': + P0 &= 0xF7; // P0.3 = 0 -> carrier OFF (short pulse) + } + wait_TF2(); // Tick 3: final period (500 us) + P0 &= 0xF7; // P0.3 = 0 -> carrier always OFF at end +} +``` + +**Decompiled byte transmission (from Rev.2 FUN_CODE_07d1):** + +```c +void diseqc_send_byte(char first_byte, byte data) { + byte ones_count = 0; + if (first_byte == 0) TF2 = 0; // Sync timer on first byte + + for (char i = 8; i > 0; i--) { // 8 bits, MSB first + if (data & 0x80) { + data_pin = 1; // Set data = '1' + diseqc_bit_symbol(); + ones_count++; + } else { + data_pin = 0; // Set data = '0' + diseqc_bit_symbol(); + } + data <<= 1; // Next bit + } + data_pin = ~ones_count & 1; // Odd parity + diseqc_bit_symbol(); // Transmit parity bit +} +``` + +**Timing per byte**: 9 bits x 1.5 ms = 13.5 ms + +**Tone burst (mini DiSEqC)**: 25 consecutive Timer2 ticks of carrier (12.5 ms). Tone burst A: `wValue==0` and `wLength==0`. Tone burst B: `wValue!=0` and `wLength==0`. + +**Timer tick wait (TF2 polling, identical across all versions):** + +```c +void wait_TF2(void) { + while (TF2 == 0) {} // Poll Timer2 overflow flag + TF2 = 0; // Clear flag for next tick +} +``` + +### 9.4 DiSEqC Signal Architecture + +``` +FX2 Firmware External Hardware Coax Cable ++------------------+ +--------------------+ +------------------+ +| P0.3 (carrier) |---->| 22 kHz oscillator |---->| LNB power line | +| (enable/disable) | | (gated by P0.3) | | (13V/18V + tone) | +| | | | | | +| P0.x (data bit) | | (internal firmware | | | +| (firmware only) | | logic only) | | | ++------------------+ +--------------------+ +------------------+ +``` + +The data pin (P0.7 / P0.4 / P0.0 depending on firmware version) is used only internally by the firmware's Manchester encoding logic. It controls whether the carrier gate signal is cut short or held for the full bit period. + +### 9.5 Windows BDA Driver DiSEqC Interface + +The Windows driver exposes DiSEqC through a BDA extended property: + +```c +// GUID: {0B5221EB-F4C4-4976-B959-EF74427464D9} +typedef struct __DISEQC_COMMAND { + UCHAR ucMessage[6]; // Framing, Address, Command, Data[0..2] + UCHAR ucMessageLength; // 3-6 for DiSEqC; 1 for tone burst +} DISEQC_COMMAND; +``` + +For tone burst: `ucMessageLength=1`, `ucMessage[0]=SEC_MINI_A` (0x00) or `SEC_MINI_B` (0x01). + +### 9.6 SET_DN_SWITCH (0x8F) -- Legacy Dish Network + +A 7-bit serial command bit-banged on GPIO P0.4: + +1. Assert P0.4 HIGH (start pulse), delay ~32 cycles +2. De-assert P0.4, delay ~8 cycles +3. Shift out 7 bits LSB-first via P0.4, ~8 cycle delays between bits + +The kernel calls this via `dishnetwork_send_legacy_command`. Bit 7 (0x80) of the original switch command selects LNB voltage and is sent separately via SET_LNB_VOLTAGE. + +--- + +## 10. GPIO Pin Map + +### 10.1 Port 0 / Port A (SFR 0x80, IOA) + +| Pin | v2.06 | Rev.2 v2.10 | v2.13 | Custom v3.01.0 | +|-----|-------|-------------|-------|----------------| +| P0.0 | -- | LNB control (0x97) | DiSEqC data | -- | +| P0.1 | Power enable | Power enable | Power enable | Power enable | +| P0.2 | Power disable | Power disable (init=0x84) | Power disable | Power disable | +| P0.3 | **22 kHz tone** | **22 kHz tone** | **22 kHz tone** | **22 kHz tone** | +| P0.4 | **LNB 13V/18V** | **LNB 13V/18V** + DiSEqC data | **LNB 13V/18V** | **LNB 13V/18V** | +| P0.5 | **BCM4500 RESET** | GPIO status input (0x98) | **BCM4500 RESET** | **BCM4500 RESET** | +| P0.6 | -- | GPIO control (0x97) | -- | -- | +| P0.7 | **DiSEqC data** | Streaming indicator | Streaming indicator | **DiSEqC data** + streaming | + +### 10.2 Port 3 / Port D (SFR 0xB0, IOD) + +| Pin | Function | Notes | +|-----|----------|-------| +| P3.0 | Init HIGH | | +| P3.4 | GPIO control | Used by Rev.2 FUN_CODE_1fcf | +| P3.5 | **TS_EN** | Transport stream enable: LOW=active, HIGH=idle | +| P3.6 | **DVB mode** | BCM4500 mode select; DiSEqC direction (Rev.2) | +| P3.7 | BCM4500 control | De-asserted (HIGH) when streaming stops | + +### 10.3 Port B (XRAM-mapped IOB) + +Used by internal debug commands 0x96--0x98: + +| Pin | v2.06/v2.13 | Rev.2 | +|-----|-------------|-------| +| IOB.0 | GPIO status input (0x98) | -- | +| IOB.1 | LNB control (0x97) | -- | +| IOB.2 | LNB control (0x97) | -- | +| IOB.3 | LNB GPIO mode (0x96) | -- | +| IOB.4 | -- | LNB GPIO mode (0x96) + control (0x97) | + +### 10.4 DiSEqC Data Pin Summary + +| Firmware Version | Data Pin | Carrier Pin | +|-----------------|----------|-------------| +| v2.06 | P0.7 | P0.3 | +| Rev.2 v2.10 | P0.4 | P0.3 | +| v2.13 | P0.0 | P0.3 | +| Custom v3.01.0 | P0.7 | P0.3 | + +The carrier pin (P0.3) is the same across all versions. + +### 10.5 Initial GPIO State + +| Register | Value | Decode | +|----------|-------|--------| +| IOA (P0) | 0x84 | P0.7=1 (idle), P0.2=1 (power disable active) | +| IOD (P3) | 0xE1 | P3.7:5=1 (controls idle), P3.0=1 | +| OEA | 0xBE | P0.1-5,7 as outputs | + +--- + +## 11. Firmware Versions + +### 11.1 Version Table + +| Firmware | Version ID | Build Date | PID | Functions | Binary Size | SP | +|----------|-----------|------------|-----|-----------|-------------|-----| +| v2.06.04 | 0x020604 | 2007-07-13 | 0x0203 | 61 | 9,472 bytes | 0x72 | +| Rev.2 v2.10.04 | 0x020A04 | 2010-03-12 | 0x0202 | 107 | 8,843 bytes | 0x4F | +| v2.13.01 (FW1) | 0x020D01 | 2010-03-12 | 0x0203 | 82-88 | 9,322 bytes | 0x50 | +| v2.13.02 (FW2) | 0x020D01 | 2010-03-12 | 0x0203 | 83 | 9,377 bytes | 0x50 | +| v2.13.03 (FW3) | 0x020D01 | 2010-03-12 | 0x0203 | 83 | 9,369 bytes | 0x52 | +| Custom v3.01.0 | 0x030100 | 2026-02-12 | 0x0203 | N/A | ~3 KB (RAM) | N/A | + +Rev.2 v2.10 targets PID 0x0202 (different product). The v2.13 sub-variants target different SkyWalker-1 hardware sub-revisions. Custom v3.01.0 is compiled with SDCC + fx2lib and loaded into FX2 RAM (not flashed to EEPROM). + +### 11.2 Kernel Version Constants + +From `gp8psk-fe.h`: + +``` +GP8PSK_FW_REV1 = 0x020604 (v2.06.4) +GP8PSK_FW_REV2 = 0x020704 (v2.07.4) +``` + +If `fw_vers >= GP8PSK_FW_REV2`, the kernel enables Rev.2-specific code paths. The v2.10 and v2.13 firmwares are newer than either kernel constant. + +### 11.3 Key Architectural Differences + +| Feature | v2.06 | Rev.2 v2.10 | v2.13 | +|---------|-------|-------------|-------| +| Vendor commands | 30 (0x80--0x9D) | 27 (0x80--0x9A) | 30 (0x80--0x9D) | +| INT0 handler | USB re-enumeration | USB re-enumeration | Demod availability polling | +| Demod probe at boot | No | No | Yes (40 attempts at 0x7F + 0x3F) | +| Retry loops | No | No | Yes (20-attempt with checksum verify) | +| HW revision detection | No | Yes (descriptor walker) | Yes (flag `_1_3`) | +| DiSEqC data pin | P0.7 | P0.4 | P0.0 | +| Config byte IRAM | 0x6D | 0x4E | 0x4F | +| Descriptor base | 0x1200 | 0x0E00 | 0x0E00 | +| Init table address | CODE:0B46 | CODE:0B48 | CODE:0B88 | +| BCM4500 status poll | 3 registers | 3 registers | 1 register (consolidated) | +| Anti-tampering string | No | No | Yes (at firmware offset 0x1880) | +| New commands | -- | 0x99/0x9A proto | 0x99, 0x9A, 0x9C | +| 0x9D behavior | HW revision mode | N/A (out of range) | Conditional demod reset | + +### 11.4 v2.13 Sub-Variant Differences + +The three v2.13 sub-variants target fundamentally different hardware interfaces: + +| Aspect | FW1 (v2.13.1) | FW2 (v2.13.2) | FW3 (v2.13.3) | +|--------|---------------|---------------|---------------| +| Demod interface | I2C bus | Parallel bus (P0/P1) | Parallel bus (enhanced) | +| Bus protocol | I2C START/STOP/ACK | Single-phase P1 read | Dual-phase P1 read + OR accumulate | +| Stack pointer | 0x50 | 0x50 | 0x52 | +| P0 init | 0xa4 | 0xa4 | 0xa0 | +| Status register | INTMEM 0x4F | INTMEM 0x4F | INTMEM 0x51 | +| Config source | Hardcoded | External (0xE080-0xE08E) | External (0xE080-0xE08E) | +| Binary distance from FW1 | -- | 3,993 bytes | 3,789 bytes | +| Binary distance from FW2 | 3,993 bytes | -- | 1,525 bytes | + +FW1 uses standard I2C master-mode transactions. FW2/FW3 use a parallel data bus with P0 for control signals (chip select, read strobe) and P1 for 8-bit data. FW3 adds dual-phase reading with OR-accumulation, likely for a demodulator chip with different bus timing. The updater program selects the correct sub-variant based on hardware detection. + +### 11.5 Binary Comparison Matrix + +Byte-level similarity (percentage of matching bytes within shared length): + +| | v2.06 | v2.13.1 | v2.13.2 | v2.13.3 | Rev.2 | +|---|---|---|---|---|---| +| **v2.06** | -- | 4.8% | 4.3% | 4.3% | 6.0% | +| **v2.13.1** | | -- | 57.2% | 59.4% | 8.0% | +| **v2.13.2** | | | -- | 83.5% | 5.8% | +| **v2.13.3** | | | | -- | 5.8% | +| **Rev.2** | | | | | -- | + +The very low similarity between major versions (4--8%) indicates complete recompilation with different linker configurations. Functions relocate even when logic is identical. + +### 11.6 Anti-Tampering (v2.13 Only) + +At firmware offset 0x1880, all v2.13 sub-variants contain: + +``` +"Tampering is detected. Attempt is logged. Warranty is voided ! \n" +``` + +Followed by I2C register write commands (`01 10 aa 82 02 41 41 83`). This string and mechanism are absent from v2.06 and Rev.2. + +### 11.7 Rev.2 as Transitional Firmware + +Rev.2 v2.10.4 sits architecturally between v2.06 and v2.13: +- Adopted v2.13's descriptor base (0x0E00) and similar stack pointer +- Retained v2.06's INT0 USB re-enumeration behavior +- Has the most functions (107) but smallest binary (~8.8 KB) due to granular decomposition +- Lacks v2.13's demodulator polling, retry loops, and additional vendor commands + +### 11.8 Key Function Correspondence Across Versions + +| v2.06 Function | Rev.2 Function | v2.13 Function | Role | +|---------------|---------------|---------------|------| +| `main` (0x188D) | `main` (0x155F) | `main_entry` (0x170D) | RESET vector: clear IRAM, process init table | +| `FUN_CODE_09a7` | `FUN_CODE_09a9` | `FUN_CODE_0800` | Main init + main loop | +| `FUN_CODE_13c3` | `FUN_CODE_10d9` | `FUN_CODE_11ab` | USB/peripheral descriptor setup | +| `FUN_CODE_032a` | `FUN_CODE_0319` | `FUN_CODE_034e` | Standard USB request handler | +| `FUN_CODE_0056` | `vendor_cmd_dispatch` | `FUN_CODE_0056` | Vendor request dispatcher (identical code) | +| `FUN_CODE_2297` | -- | `FUN_CODE_21ec` | Main loop poll (USB IRQ processing) | +| `FUN_CODE_1919` | `FUN_CODE_0d7c` | `FUN_CODE_1800` | GPIF/FIFO management | +| `FUN_CODE_1d4f` | -- | -- | v2.06 demod init (GPIO-based) | +| -- | -- | `FUN_CODE_1d4b` | v2.13 demod init (I2C write to 0x7F/0xF0) | +| `FUN_CODE_0ddd` | `FUN_CODE_0c64` | `FUN_CODE_0ca4` | BCM4500 firmware loader | +| `FUN_CODE_2000` | -- | `FUN_CODE_208d` | BCM4500 status polling | +| `FUN_CODE_1dfb` | `FUN_CODE_1bda` | `FUN_CODE_14b9` | Delay loop (clock-speed-aware) | +| `INT0_vec` (0x0003) | `INT0_ISR` (0x0003) | `INT0_vector` (0x0003) | INT0 handler (different purpose) | +| -- | -- | `FUN_CODE_2239` | v2.13 I2C single-byte read helper | +| -- | -- | `FUN_CODE_2031` | v2.13 USB reconnect function | +| -- | -- | `FUN_CODE_1799` | v2.13 demod signature verification | +| -- | -- | `FUN_CODE_1ac6` | v2.13 tuning acquisition sequence | + +### 11.9 INT0 Handler Evolution + +The INT0 interrupt vector (CODE:0003) was repurposed between firmware versions: + +**v2.06 and Rev.2 -- USB Re-enumeration:** + +``` +void INT0_vec(void) { + if (flag == 0) CPUCS |= 0x08; // CPUCS bit 3 + else CPUCS |= 0x0A; // CPUCS bits 3+1 + delay(5, 0xDC); // ~1500 cycles + EPIRQ = 0xFF; // Clear endpoint IRQs + USBIRQ = 0xFF; // Clear USB IRQs + EXIF &= 0xEF; // Clear external interrupt flag + CPUCS &= 0xF7; // Clear CPUCS bit 3 +} +``` + +Pulses CPUCS.3 to trigger a controlled USB re-enumeration, then clears all pending interrupts. + +**v2.13 -- Demodulator Availability Polling:** + +``` +void INT0_vector(void) { + for (counter = 0x28; counter != 0; counter--) { // 40 attempts + byte result = I2C_read(0x7F); // Demod address A + if (result != 0x01) { + result = I2C_read(0x3F); // Demod address B + if (result != 0x01) break; + } + } + no_demod_flag = (counter == 0); // Set if loop exhausted +} +``` + +Polls two I2C addresses (0x7F, 0x3F) to detect which demodulator variant is present. The `no_demod_flag` prevents tuning attempts on boards with absent or failed demodulators. + +In v2.13, the USB re-enumeration code was moved to `FUN_CODE_2031` and called as a normal function before the main loop starts, freeing INT0 for demodulator polling. + +### 11.10 v2.13 Integrity Verification + +v2.13 performs two integrity checks during initialization, absent from v2.06 and Rev.2: + +**Demodulator Signature Verification (FUN_CODE_1799):** + +1. Writes 4 bytes to I2C device 0x7F, register 0xF0 +2. Reads 5 bytes from register 0x0A (stepping by 2), each character +3. Subtracts 0x30 ('0') from each byte (ASCII to binary) +4. Sums values and compares against expected parameter (0x021C) +5. Up to 20 retry attempts + +**Descriptor Checksum Verification (FUN_CODE_1ca0):** + +1. Iterates bytes 6 through 0x29 (36 bytes) of a descriptor block +2. Computes running sum, compares against 0x0706 +3. Iterates bytes 0x2C through 0x4F (36 bytes) of same block +4. Computes second sum, compares against 0x0686 +5. Up to 20 retry attempts + +Both checks call `FUN_CODE_1ac6(100)` (tuning acquisition with 100 ms delay) as a recovery action if verification fails after all attempts. + +### 11.11 XRAM Initialization Table + +All firmware versions initialize XRAM peripheral registers from a table stored in CODE space. The table is processed at startup before entering the main loop. + +**Table format (all versions):** + +``` +Each entry: [addr_hi] [addr_lo] [data_byte] +Terminator: [0x00] [0x00] (address 0x0000) +``` + +The parser reads 3 bytes at a time: a 16-bit XRAM address (big-endian) and a data byte. It writes the byte to the address until it encounters address 0x0000. + +**Key XRAM registers initialized from the table:** + +| XRAM Address | Register | Typical Value | Purpose | +|-------------|----------|---------------|---------| +| 0xE604 | FIFORESET | 0x80 | Start FIFO reset sequence | +| 0xE601 | IFCONFIG | 0xCA | Initial interface config (overwritten later) | +| 0xE610 | EP2CFG | 0xE2 | EP2 bulk IN, 512-byte, double-buffered | +| 0xE612 | EP4CFG | 0x00 | EP4 disabled | +| 0xE618 | EP2FIFOCFG | 0x0C | AUTOIN, ZEROLENIN, 8-bit | +| 0xE620 | REVCTL | 0x03 | NOAUTOARM + SKIPCOMMIT | +| 0xE67A | I2CTL | 0x01 | I2C 400 kHz | +| 0xE68A | EP0BCH | 0x00 | EP0 byte count high = 0 | + +**Init table addresses by version:** + +| Firmware | Table Address | +|----------|--------------| +| v2.06 | CODE:0B46 | +| Rev.2 | CODE:0B48 | +| v2.13 | CODE:0B88 | + +### 11.12 Main Loop Architecture + +All firmware versions use the same main loop structure: poll the SUDAV (setup data available) interrupt flag, process vendor commands, then idle the CPU until the next interrupt. + +**v2.06 (simplified decompilation):** + +```c +void main_loop(void) { // FUN_CODE_09a7 + // 1. Process init table from CODE:0B46 + // 2. Call FUN_CODE_13c3 (USB/peripheral setup) + // 3. EA = 1 (global interrupts enable) + + while (1) { + if (sudav_flag) { + handle_setupdata(); // Process USB SETUP packet + sudav_flag = 0; + } + if (gpif_flag) { + handle_gpif_event(); + gpif_flag = 0; + } else { + PCON |= 0x01; // CPU idle until next interrupt + } + } +} +``` + +The SUDAV ISR simply sets `sudav_flag = 1` and clears the interrupt. All actual USB processing happens in the main loop context. + +--- + +## 12. I2C Bus Architecture + +### 12.1 FX2 I2C Controller + +The FX2's I2C master controller is a hardware peripheral accessed through SFRs: + +| SFR | Address | Function | +|-----|---------|----------| +| I2CS | 0xE678 (XRAM) | I2C control/status register | +| I2DAT | 0xE679 (XRAM) | I2C data register | +| I2CTL | 0xE67A (XRAM) | I2C control (speed selection) | + +Key I2CS bits: bmSTART (initiate START), bmSTOP (initiate STOP), bmLASTRD (signal last read byte), bmDONE (transaction byte complete), bmACK (ACK received), bmBERR (bus error). + +### 12.2 Bus Speed + +The I2C bus speed is 400 kHz, set via: +- C2 EEPROM header config byte = 0x40 (at boot) +- I2CTL = bm400KHZ (in custom firmware) + +### 12.3 Known Bus Devices + +| 7-bit Address | Wire Write/Read | Identity | +|---------------|-----------------|----------| +| 0x08 | 0x10 / 0x11 | BCM4500 demodulator | +| 0x10 | 0x20 / 0x21 | Tuner or LNB controller | +| 0x51 | 0xA2 / 0xA3 | Configuration EEPROM (24Cxx-family) | + +The EEPROM at 0x51 stores: device serial number (read by GET_SERIAL_NUMBER 0x93), hardware platform ID (read by GET_FPGA_VERS 0x95), and calibration data. + +### 12.4 Combined Write-Read (Repeated START) Protocol + +All BCM4500 register reads use the I2C combined write-read protocol with a repeated START condition. This is required because the BCM4500 uses a register-addressed protocol where the register number must be sent as a write phase before the read phase: + +``` +Complete I2C transaction for reading register 0xA2 from device 0x08: + + Phase 1 (Write): + [S] [0x10] [ACK] [0xA2] [ACK] + | | | | | + | | | | +-- BCM4500 ACKs register address + | | | +--------- Register address + | | +---------------- BCM4500 ACKs its address + | +----------------------- Device address (0x08 << 1) = 0x10 (write) + +---------------------------- START condition + + Phase 2 (Read with Repeated START): + [Sr] [0x11] [ACK] [DATA] [NACK] [P] + | | | | | | + | | | | | +-- STOP condition + | | | | +--------- Master NACKs (last byte) + | | | +---------------- Register data + | | +----------------------- BCM4500 ACKs its address + | +------------------------------ Device address (0x08 << 1 | 1) = 0x11 (read) + +------------------------------------ REPEATED START (no STOP between phases) +``` + +The repeated START (Sr) is essential. A STOP between phases would release the bus, and the BCM4500 would lose the register address context. + +**FX2 I2C SFR sequence for combined read (from custom firmware):** + +```c +I2CS |= bmSTART; // Generate START +I2DAT = 0x10; // Write: device addr + W +// wait bmDONE, check bmACK +I2DAT = 0xA2; // Write: register address +// wait bmDONE, check bmACK +I2CS |= bmSTART; // Generate REPEATED START (no STOP first!) +I2DAT = 0x11; // Write: device addr + R +// wait bmDONE, check bmACK +I2CS |= bmLASTRD; // Signal this is the last read byte +tmp = I2DAT; // Dummy read (triggers first clock burst) +// wait bmDONE +I2CS |= bmSTOP; // Generate STOP after reading +data = I2DAT; // Read actual data byte +// wait bmSTOP to clear +``` + +### 12.5 I2C STOP Corruption Bug + +Sending `I2CS |= bmSTOP` when no I2C transaction is active (no prior START issued, bus idle) corrupts the FX2 I2C controller's internal state machine. The bmSTOP bit may not self-clear, and subsequent START conditions fail to detect ACK from slaves. + +This was the root cause of the firmware hang in custom v3.01.0 during boot. The stock firmware's "bus reset" step: + +```c +/* BROKEN: */ +I2CS |= bmSTOP; +i2c_wait_stop(); +``` + +was removed. The correct approach is to simply proceed with a new START condition. If the bus is idle (after power-on or after the previous transaction completed normally), the START succeeds and the controller enters its normal operating state. The Cypress TRM does not document STOP as a standalone bus-reset mechanism. + +### 12.6 Timeout Protection + +The fx2lib I2C functions poll `bmDONE` with no timeout: + +```c +while (!(I2CS & bmDONE) && !cancel_i2c_trans); +``` + +Since `cancel_i2c_trans` is never set during normal operation, these loops are effectively infinite. The custom firmware replaces all fx2lib I2C functions with timeout-protected wrappers: + +```c +#define I2C_TIMEOUT 6000 + +static BOOL i2c_wait_done(void) { + WORD timeout = I2C_TIMEOUT; + while (!(I2CS & bmDONE)) { + if (--timeout == 0) return FALSE; + } + return TRUE; +} +``` + +A WORD counter of 6000 decremented in a tight SDCC-compiled loop at 48 MHz gives approximately 5--10 ms per wait. At 400 kHz I2C, a single byte transfer takes 22.5 us, so the timeout provides over 200x margin for normal operations. + +--- + +## 13. Custom Firmware v3.01.0 + +### 13.1 Overview + +Custom replacement firmware built with SDCC and fx2lib. Loaded into FX2 RAM for testing via `fw_load.py` (not flashed to EEPROM). + +| Property | Value | +|----------|-------| +| Toolchain | SDCC + fx2lib | +| Source | `firmware/skywalker1.c` (1351 lines) | +| Version ID | 0x030100 | +| Build date | 2026-02-12 | +| Load method | RAM upload via `tools/fw_load.py` | + +### 13.2 Stock-Compatible Commands + +The custom firmware implements all commands needed for the kernel driver: GET_8PSK_CONFIG (0x80), ARM_TRANSFER (0x85), TUNE_8PSK (0x86), GET_SIGNAL_STRENGTH (0x87), BOOT_8PSK (0x89), START_INTERSIL (0x8A), SET_LNB_VOLTAGE (0x8B), SET_22KHZ_TONE (0x8C), SEND_DISEQC (0x8D), GET_SIGNAL_LOCK (0x90), GET_FW_VERS (0x92), USE_EXTRA_VOLT (0x94). + +### 13.3 Custom Commands + +| Command | Function | +|---------|----------| +| SPECTRUM_SWEEP (0xB0) | Step through frequency range reading signal energy | +| RAW_DEMOD_READ (0xB1) | Read any BCM4500 indirect register | +| RAW_DEMOD_WRITE (0xB2) | Write any BCM4500 indirect register | +| BLIND_SCAN (0xB3) | Try symbol rates at a frequency looking for lock | +| I2C_BUS_SCAN (0xB4) | Probe all 7-bit I2C addresses | +| I2C_RAW_READ (0xB5) | Read from any I2C device address | +| I2C_DIAG (0xB6) | Step-by-step indirect register read diagnostic | + +### 13.4 Debug Boot Modes + +The BOOT_8PSK (0x89) command supports incremental debug modes via wValue: + +| wValue | Action | Result | +|--------|--------|--------| +| 0x80 | No-op: return `config_status` and `boot_stage` | Works | +| 0x81 | GPIO + power + delays only (no I2C) | Works | +| 0x82 | GPIO + power + I2C probe (bmSTOP removed) | Works | +| 0x83 | GPIO + power + probe + init block 0 | Works | +| 0x84 | I2C-only probe (chip already powered) | Works | +| 0x85 | Same as 0x82 without bmSTOP | Works | +| 0x01 | Full boot (production) | Works | +| 0x00 | Shutdown | Works | + +These modes were used to isolate the I2C STOP corruption bug (see [Section 12.4](#12-i2c-bus-architecture)). + +### 13.5 Key Implementation Patterns + +**I2C Combined Read** (repeated START): + +```c +static BOOL i2c_combined_read(BYTE addr, BYTE reg, BYTE len, BYTE *buf) { + I2CS |= bmSTART; + I2DAT = addr << 1; // START + write address + // ... wait for DONE, check ACK ... + I2DAT = reg; // Register address + // ... wait for DONE, check ACK ... + I2CS |= bmSTART; + I2DAT = (addr << 1) | 1; // REPEATED START + read address + // ... read len bytes with LASTRD/STOP on final byte ... +} +``` + +**BCM4500 Init Block Write**: + +```c +static BOOL bcm_write_init_block(const __code BYTE *data, BYTE len) { + bcm_direct_write(BCM_REG_PAGE, 0x00); // Page select + i2c_write_multi_timeout(BCM4500_ADDR, BCM_REG_DATA, len, data); // Data + bcm_direct_write(BCM_REG_DATA, 0x00); // Trailing zero + bcm_direct_write(BCM_REG_CMD, BCM_CMD_WRITE); // Commit (0x03) + return bcm_poll_ready(); // Wait for completion +} +``` + +--- + +## 14. DVB-S2 Incompatibility + +### 14.1 Definitive Conclusion + +The SkyWalker-1's inability to receive DVB-S2 is a fundamental hardware limitation of the BCM4500 demodulator silicon. The BCM4500 was designed before the DVB-S2 standard was ratified (March 2005) and contains no LDPC or BCH decoder hardware. No firmware update can add DVB-S2 support. + +### 14.2 FEC Architecture Comparison + +| Feature | BCM4500 (SkyWalker-1) | DVB-S2 Requirement | +|---------|----------------------|-------------------| +| Inner FEC | Viterbi (DVB-S) or Turbo (proprietary) | LDPC | +| Outer FEC | Reed-Solomon (t=10) | BCH | +| Block size | Convolutional / short turbo blocks | 64,800 or 16,200 bits | +| Decoder type | Trellis (Viterbi) or iterative turbo | Iterative belief propagation | +| Hardware IP | Hardwired Viterbi + turbo silicon | Requires dedicated LDPC engine | + +### 14.3 Evidence + +**From firmware analysis:** + +1. The firmware modulation dispatch table has exactly 10 entries (0--9), with no DVB-S2-specific modes. The bounds check at CODE:0866 rejects values >= 10. +2. No LDPC/BCH code rate values exist in any FEC lookup table. The XRAM tables at 0xE0B1, 0xE0B7, 0xE0BC, 0xE0BD, and 0xE0F9 contain only Viterbi rates (1/2 through 7/8), turbo rates, and DCII combined codes. +3. No DVB-S2-specific register addresses appear in any I2C traffic. The BCM4500 is programmed exclusively through indirect registers 0xA6/0xA7/0xA8 with page 0x00. + +**From Windows BDA driver source:** + +4. `SkyWalker1TunerFilter.cpp` (line 1070): `else if(ulNewInnerFecType == BDA_FEC_VITERBI)` -- only Viterbi FEC is accepted; any other type returns `STATUS_INVALID_PARAMETER`. +5. `SkyWalker1Control.cpp` (line 292): `ucCommand[8] = ADV_MOD_DVB_QPSK;` -- the driver hardcodes modulation type 0 (DVB-S QPSK) regardless of application request. +6. `SkyWalker1Control.h` (lines 64--74): modulation constants cap at `ADV_MOD_DVB_BPSK` (9). No value 10+ exists. + +**From datasheets:** + +7. The BCM4500 datasheet describes exactly two FEC paths: "an advanced modulation turbo decoder" and "a DVB/DIRECTV/DCII-compliant FEC decoder." No third path for LDPC/BCH. +8. BCM4500 specification: 128-pin MQFP, 3.3V I/O, 1.8V digital, symbol rate 256 Ksps to 30 Msps. No mention of LDPC, BCH, or DVB-S2. + +### 14.4 Broadcom DVB-S2 Chip Timeline + +| Chip | Year | DVB-S2? | Notes | +|------|------|---------|-------| +| BCM4500 | ~2003 | No | Turbo FEC + legacy Viterbi/RS | +| BCM4501 | 2006 | Yes | First dual-tuner DVB-S2; LDPC/BCH | +| BCM4505 | 2007 | Yes | Single-channel, 65nm | +| BCM4506 | 2007 | Yes | Dual-channel, 65nm | + +Broadcom restricted BCM4501/4505/4506 sales to set-top box manufacturers, preventing Genpix from using them. + +### 14.5 What Genpix Did + +Released the SkyWalker-3, replacing the BCM4500 with a different demodulator (likely STMicroelectronics STV0903). The trade-off: gained DVB-S2 LDPC/BCH support, lost proprietary turbo-FEC support (turbo codes are Broadcom/EchoStar proprietary). + +### 14.6 USB Data Path is Not the Bottleneck + +The GPIF/USB 2.0 path has approximately 5x headroom for DVB-S2 rates (~58 Mbps max vs ~280 Mbps USB practical throughput). The 8-bit transport stream interface uses the same MPEG-TS format (188-byte packets). The bottleneck is the demodulator silicon. + +--- + +## 15. Kernel Driver Notes + +### 15.1 Module Names + +- `dvb_usb_gp8psk` -- USB transport and device management +- `gp8psk_fe` -- DVB frontend (demodulation, tuning) + +### 15.2 Kernel Driver Race Condition + +The kernel module auto-loads via udev when VID:PID `09C0:0203` appears on the USB bus (every FX2 re-enumeration after firmware load). The driver races with test tools and sends its own BOOT_8PSK command. + +Symptoms: +- "resource busy" or "entity not found" errors from test scripts +- BCM4500 enters unexpected state from partial kernel initialization +- Kernel driver detaches mid-test + +**Fix**: Blacklist the module: + +``` +# /etc/modprobe.d/blacklist-gp8psk.conf +blacklist dvb_usb_gp8psk +blacklist gp8psk_fe +``` + +Then unload: `sudo modprobe -r dvb_usb_gp8psk gp8psk_fe` + +### 15.3 FPGA Version Failure + +``` +gp8psk: usb in 149 operation failed. +gp8psk: failed to get FPGA version +``` + +Command 0x95 (GET_FPGA_VERS, decimal 149) fails on some SkyWalker-1 units. The driver logs the failure but continues normally. + +### 15.4 Commands Used by Kernel Driver + +| Command | Usage | Notes | +|---------|-------|-------| +| 0x80 GET_8PSK_CONFIG | Boot check | Always | +| 0x83 I2C_WRITE | BCM4500 reg writes | Via frontend ops | +| 0x84 I2C_READ | BCM4500 reg reads | Via frontend ops | +| 0x85 ARM_TRANSFER | Stream start/stop | Always | +| 0x86 TUNE_8PSK | Frequency tuning | Via frontend ops | +| 0x87 GET_SIGNAL_STRENGTH | SNR readback | Via frontend ops | +| 0x88 LOAD_BCM4500 | BCM4500 FW load | Rev.1 Warm only (STALLs on SW-1) | +| 0x89 BOOT_8PSK | Power on/off | Always | +| 0x8A START_INTERSIL | LNB power | Always | +| 0x8B SET_LNB_VOLTAGE | 13V/18V | Via frontend ops | +| 0x8C SET_22KHZ_TONE | Tone control | Via frontend ops | +| 0x8D SEND_DISEQC | DiSEqC messages | Via frontend ops | +| 0x8F SET_DN_SWITCH | Legacy Dish switch | Via `send_legacy_dish_cmd` callback | +| 0x90 GET_SIGNAL_LOCK | Lock status | Via frontend ops | +| 0x92 GET_FW_VERS | Version check | Boot only | +| 0x94 USE_EXTRA_VOLT | +1V boost | Via `enable_high_lnb_voltage` callback | +| 0x95 GET_FPGA_VERS | Platform ID | Boot only | +| 0x9D CW3K_INIT | CW3K init | PID 0x0206 only | + +--- + +## 16. Firmware Storage Formats + +### 16.1 Cypress C2 EEPROM Boot Format + +The SkyWalker-1 firmware is stored in Cypress C2 IIC second-stage boot format, read by the FX2's internal boot ROM on power-up. + +**Header (8 bytes):** + +| Offset | Size | Field | SkyWalker-1 Value | +|--------|------|-------|-------------------| +| 0 | 1 | Marker | 0xC2 (external memory, large code model) | +| 1 | 2 | VID (LE) | 0x09C0 | +| 3 | 2 | PID (LE) | 0x0203 | +| 5 | 2 | DID (LE) | 0x0000 | +| 7 | 1 | Config | 0x40 (400 kHz I2C) | + +**Code segments**: 2-byte length (BE) + 2-byte target address (BE) + data. Maximum segment size: 1023 bytes (FX2 I2C boot ROM buffer limit). All SkyWalker-1 variants use 10 segments. + +**Terminator**: 0x80xx (high bit set) + 2-byte entry point address (0xE600 = CPUCS). + +**Segment layout (all SkyWalker-1 variants):** + +``` +Segment Address Length +------- ------- ------ +1 0x0000 1023 Contains reset vector, interrupt handlers +2 0x03FF 1023 +3 0x07FE 1023 +4 0x0BFD 1023 +5 0x0FFC 1023 +6 0x13FB 1023 +7 0x17FA 1023 +8 0x1BF9 1023 +9 0x1FF8 1023 +10 0x23F7 varies (115--265 bytes depending on version) +``` + +### 16.2 Decoded C2 Headers + +| File | VID | PID | Segments | Code Size | Entry | +|------|-----|-----|----------|-----------|-------| +| skywalker1_eeprom.bin (v2.06) | 0x09C0 | 0x0203 | 10 | 9,472 bytes | 0xE600 | +| sw1_v213_fw_1_c2.bin (v2.13.1) | 0x09C0 | 0x0203 | 10 | 9,322 bytes | 0xE600 | +| sw1_v213_fw_2_c2.bin (v2.13.2) | 0x09C0 | 0x0203 | 10 | 9,377 bytes | 0xE600 | +| sw1_v213_fw_3_c2.bin (v2.13.3) | 0x09C0 | 0x0203 | 10 | 9,369 bytes | 0xE600 | +| rev2_v210_fw_1_c2.bin (Rev.2) | 0x09C0 | 0x0202 | 9 | 8,843 bytes | 0xE600 | + +### 16.3 DVB-USB Binary Hexline Format (Kernel FW01) + +The format the kernel expects for `dvb-usb-gp8psk-01.fw` (only needed for Rev.1 Cold, PID 0x0200): + +``` +Record structure: + Offset Size Field + 0 1 len - Number of data bytes + 1 1 addr_lo - Target address low byte + 2 1 addr_hi - Target address high byte + 3 1 type - 0x00=data, 0x01=EOF, 0x04=extended addr + 4 len data[] - Payload bytes + 4+len 1 chk - Checksum byte +``` + +### 16.4 FW02 Chunk Format (BCM4500 Firmware) + +Only needed for Rev.1 Warm (PID 0x0201): + +``` +Chunk format: + Byte 0: payload_length (N) + Bytes 1-3: header/address bytes + Bytes 4..N+3: payload data + Terminator: single byte 0xFF + Maximum chunk size: 64 bytes (USB control transfer limit) +``` + +Command 0x88 (LOAD_BCM4500) initiates the transfer. Each chunk is sent via bulk endpoint 0x01. On the SkyWalker-1, 0x88 routes to STALL (BCM4500 firmware is in ROM). + +### 16.5 Format Incompatibility + +C2 (EEPROM) and hexline (kernel FW01) are structurally different containers. They cannot be used interchangeably, but the payload data is identical. A C2 file can be converted to hexline by stripping the 8-byte header, splitting segments into 16-byte records, and appending an EOF record. + +--- + +## 17. Debugging Reference + +### 17.1 I2C STOP Corruption Root Cause + +The root cause of the initial firmware hang was traced through incremental debug modes: + +| wValue | Action | Result | Diagnosis | +|--------|--------|--------|-----------| +| 0x82 | GPIO + power + `bmSTOP` + probe | Fails | bmSTOP corrupts controller | +| 0x85 | GPIO + power + probe (no bmSTOP) | Works | Confirms bmSTOP is the cause | +| 0x84 | I2C probe only (chip already powered) | Works | BCM4500 is alive; I2C function is correct | + +Key finding: mode 0x84 succeeds immediately after 0x82 fails, proving the BCM4500 was alive the whole time. The FX2 I2C controller was in a bad state, not the bus or slave. + +### 17.2 Boot Results After Fix + +| Metric | Value | +|--------|-------| +| Boot time | ~90 ms total | +| config_status | 0x03 (STARTED + FW_LOADED) | +| boot_stage | 0xFF (COMPLETE) | +| Direct registers 0xA2-0xA8 | All return 0x02 (powered, not locked) | +| Signal lock | 0x00 (no lock -- dish not aimed) | +| USB responsiveness | No hang; fully responsive throughout | + +### 17.3 Test Tools + +Located in `tools/` directory: + +| Script | Purpose | +|--------|---------| +| `test_boot_debug.py` | Sends debug modes 0x80--0x83 sequentially | +| `test_i2c_debug.py` | Powers on via 0x81, runs bus scans, tests probe timing | +| `test_i2c_isolate.py` | Tests re-reset and insufficient delay as failure causes | +| `test_i2c_pinpoint.py` | Definitive test: compares 0x84, 0x85, and 0x82 | +| `fw_load.py` | RAM firmware loader (halt CPU, write, restart) | + +### 17.4 FX2 Register Quick Reference + +| Address | Name | Notes | +|---------|------|-------| +| 0xE600 | CPUCS | CPU control/status; write 0x01 to halt, 0x00 to run | +| 0xE601 | IFCONFIG | Interface configuration (GPIF mode, clock) | +| 0xE60B | REVCTL | Revision control (NOAUTOARM, SKIPCOMMIT) | +| 0xE618 | EP2FIFOCFG | EP2 FIFO configuration (AUTOIN, 8-bit) | +| 0xE678 | I2CS | I2C control/status | +| 0xE679 | I2DAT | I2C data | +| 0xE67A | I2CTL | I2C speed control | +| 0xE6B8 | SETUPDAT[0] | bmRequestType | +| 0xE6B9 | SETUPDAT[1] | bRequest | +| 0xE6BA | SETUPDAT[2] | wValueL | +| 0xE6BB | SETUPDAT[3] | wValueH | +| 0xE6BC | SETUPDAT[4] | wIndexL | +| 0xE6BD | SETUPDAT[5] | wIndexH | +| 0xE6BE | SETUPDAT[6] | wLengthL | +| 0xE6BF | SETUPDAT[7] | wLengthH | +| 0xE68A | EP0BCH | EP0 byte count high | +| 0xE68B | EP0BCL | EP0 byte count low (write triggers transfer) | +| 0xE740 | EP0BUF | EP0 data buffer start | +| 0xE0B6 | (custom) | LNB voltage control register (XRAM) | + +--- + +## 18. Sources + +### Firmware Analysis + +- Ghidra decompilation/disassembly of five firmware images: + - v2.06.04 (Ghidra port 8193) -- extracted from SkyWalker-1 EEPROM + - Rev.2 v2.10.04 (Ghidra port 8197) -- extracted from Rev.2 hardware + - v2.13.01 FW1 (Ghidra port 8194) -- extracted from Windows updater + - v2.13.02 FW2 (Ghidra port 8195) -- extracted from Windows updater + - v2.13.03 FW3 (Ghidra port 8196) -- extracted from Windows updater +- Firmware dumps: `firmware-dump/` + +### Driver Source + +- Linux kernel 6.16.5: `drivers/media/usb/dvb-usb/gp8psk.c`, `gp8psk.h`, `gp8psk-fe.c`, `gp8psk-fe.h` +- Linux kernel: `drivers/media/usb/dvb-usb/dvb-usb-firmware.c` +- Windows BDA driver: `SkyWalker1_Final_Release/Source/SkyWalker1Control.cpp` +- Windows BDA driver: `SkyWalker1_Final_Release/Include/SkyWalker1Control.h`, `SkyWalker1CommonDef.h` + +### Hardware Documentation + +- BCM4500 Datasheet: [DatasheetQ](https://html.datasheetq.com/pdf-html/885700/Broadcom/2page/BCM4500.html), [Elcodis](https://elcodis.com/parts/5786421/BCM4500.html) +- BCM4501 Product Page: [Broadcom](https://www.broadcom.com/products/broadband/set-top-box/bcm4501) +- Cypress CY7C68013A (FX2LP) Technical Reference Manual +- Genpix Electronics: https://www.genpix-electronics.com/index.php?act=viewDoc&docId=9 +- Genpix SkyWalker-3 specifications: https://www.genpix-electronics.com/what-is-skywalker-3.html +- Device `dmesg` output from running SkyWalker-1 hardware + +### Analysis Reports (This Project) + +1. `gp8psk-driver-analysis.md` -- Linux kernel driver analysis +2. `firmware-analysis-v206-vs-v213.md` -- v2.06 vs v2.13 firmware comparison +3. `rev2-deep-analysis.md` -- Rev.2 deep function inventory (107 functions) +4. `gpif-streaming-analysis.md` -- GPIF/MPEG-2 streaming path +5. `tuning-protocol-analysis.md` -- TUNE_8PSK protocol deep dive +6. `vendor-commands-unknown.md` -- Vendor command decode (0x8F, 0x91--0x98) +7. `kernel-fw01-analysis.md` -- Kernel firmware format and EEPROM boot +8. `firmware-dump/fw_v213_comparison_report.md` -- v2.13 sub-variant comparison +9. `dvb-s2-investigation.md` -- DVB-S2 incompatibility investigation +10. `docs/boot-debug-findings.md` -- Boot/I2C debugging findings +11. `docs/diseqc/diseqc-skywalker-1.md` -- DiSEqC Windows BDA interface +12. `firmware/skywalker1.c` -- Custom firmware v3.01.0 source + +### Community References + +- [LinuxTV mailing list: BCM4500 and DVB-S2](https://www.mail-archive.com/linux-dvb@linuxtv.org/msg24808.html) +- [SatelliteGuys: Turbo 8PSK card reverse engineering](https://www.satelliteguys.us/xen/threads/another-turbo-8psk-card.246879/) +- [SatelliteGuys: Genpix SkyWalker-1 discussion](https://www.satelliteguys.us/xen/threads/genpix-skywalker-1.214196/) diff --git a/site/src/content/docs/tools/debugging.mdx b/site/src/content/docs/tools/debugging.mdx new file mode 100644 index 0000000..2d94259 --- /dev/null +++ b/site/src/content/docs/tools/debugging.mdx @@ -0,0 +1,259 @@ +--- +title: Debugging Tools +description: Hardware diagnostic tools for boot testing, I2C bus debugging, and firmware extraction. +--- + +import { Tabs, TabItem, Steps, Aside, Badge } from '@astrojs/starlight/components'; + +The `tools/` directory includes a suite of diagnostic scripts developed during the reverse engineering of the SkyWalker-1. These tools were instrumental in isolating the I2C STOP corruption bug in the FX2 controller and verifying correct BCM4500 initialization. + +All debugging tools require `pyusb`, root access, and the kernel `dvb_usb_gp8psk` module to be unloaded. + +```bash +pip install pyusb +sudo modprobe -r dvb_usb_gp8psk gp8psk_fe +``` + + + + +## Boot Testing Tools + +Two scripts test the BCM4500 boot sequence using debug modes in the custom v3.01.0 firmware. + +### test_boot.py -- Full Boot Verification + +Runs a complete BOOT_8PSK sequence and reports success or failure with detailed register readback. + +```bash +sudo python3 tools/test_boot.py +``` + +**What it does:** + + +1. Reads firmware version via `GET_FW_VERS` (0x92) +2. Reads config status via `GET_8PSK_CONFIG` (0x80) +3. Sends `BOOT_8PSK` (0x89, wValue=1) with a 10-second timeout +4. Decodes the 3-byte response: config status, boot stage, probe byte +5. On success: reads BCM4500 direct registers (0xA2--0xA8), indirect registers (pages 0x00--0x0F), I2C diagnostic data, signal strength, and lock status +6. On failure: runs I2C bus scan (0xB4), attempts raw I2C reads to BCM4500 + + +**Boot stage codes:** + +| Stage | Code | Meaning | +|-------|------|---------| +| `NOT_STARTED` | 0x00 | Boot not attempted | +| `GPIO_SETUP` | 0x01 | GPIO pins configured | +| `PWR_SETTLED` | 0x02 | Power-on delay complete | +| `I2C_PROBE` | 0x03 | Probing BCM4500 on I2C | +| `INIT_BLK0` | 0x04 | Writing init block 0 | +| `INIT_BLK1` | 0x05 | Writing init block 1 | +| `INIT_BLK2` | 0x06 | Writing init block 2 | +| `COMPLETE` | 0xFF | Boot finished | + +**Config status flags after successful boot:** + +| Flag | Bit | Expected | +|------|-----|----------| +| `bm8pskStarted` | 0x01 | | +| `bm8pskFW_Loaded` | 0x02 | | + +### test_boot_debug.py -- Incremental Stage Testing + +Sends debug boot modes (wValue=0x80 through 0x83) one at a time to isolate which stage of the boot sequence fails. Can test a single stage or run all sequentially. + +```bash title="Run all debug stages" +sudo python3 tools/test_boot_debug.py +``` + +```bash title="Test only stage 0x82" +sudo python3 tools/test_boot_debug.py 0x82 +``` + +**Debug modes:** + +| wValue | Action | Tests | +|--------|--------|-------| +| `0x80` | No-op: return current state | Firmware responsive? | +| `0x81` | GPIO setup + power + delays (no I2C) | Power rails working? | +| `0x82` | GPIO + I2C bus reset + BCM4500 probe | I2C communication working? | +| `0x83` | GPIO + I2C probe + write init block 0 | Register writes accepted? | + +Each mode returns a 3-byte response: config status, boot stage, and probe byte. The tool reports timing (ms) for each stage and checks if the device is still responsive after failures. + + + + +## I2C Debugging Suite + +Three scripts that implement a progressive isolation methodology to identify I2C bus faults. These were developed in sequence, each informed by the results of the previous one. + +### Methodology + + +1. **Broad scan** (`test_i2c_debug.py`) -- Power on the BCM4500 and probe the entire I2C bus. Does the chip respond at any address? +2. **Isolation** (`test_i2c_isolate.py`) -- Determine whether the fault is in the BCM4500, the I2C bus, or the FX2 controller. Test the chip when already powered vs. after a reset. +3. **Pinpoint** (`test_i2c_pinpoint.py`) -- Identify the exact operation that corrupts communication. Compare I2C read-only, GPIO+reset, and GPIO+bus-reset+probe modes. + + +### test_i2c_debug.py -- Bus Discovery + +Powers on the BCM4500 via GPIO-only mode (0x81), then runs progressively detailed diagnostics. + +```bash +sudo python3 tools/test_i2c_debug.py +``` + +**Test sequence:** + +| Step | Action | Purpose | +|------|--------|---------| +| 1 | Send mode 0x81 (GPIO power on) | Start BCM4500 without any I2C | +| 2 | I2C bus scan (0xB4) immediately | Check for devices right after power-on | +| 3 | Wait 500 ms, scan again | Maybe chip needs more time? | +| 4 | Raw I2C reads to candidate addresses | Try 0x08, 0x09, 0x0A, 0x0B, 0x10, 0x11, 0x68, 0x69, 0x60, 0x61 | +| 5 | Check I2C controller state | Observe bus health | +| 6 | Send mode 0x82 after 1s delay | Test probe with extra settling time | + +**Candidate addresses** cover different BCM4500 pin-strap configurations and common demodulator/tuner addresses. + +### test_i2c_isolate.py -- Fault Isolation + +Determines whether the failure is caused by `bcm_direct_read`, re-reset timing, or the I2C bus reset (bmSTOP). + +```bash +sudo python3 tools/test_i2c_isolate.py +``` + +**Test sequence:** + +| Test | Action | Question | +|------|--------|----------| +| **A** | Power on (0x81), wait 1s, raw read | Is BCM4500 alive from cold start? | +| **B** | Run mode 0x82 (re-resets + probe) | Does `bcm_direct_read` work after reset? | +| **C** | Immediately raw read after 0x82 | Is I2C function itself broken? | +| **D** | Raw reads at 100, 200, 500, 1000, 2000 ms | Is it a timing issue? | +| **E** | Re-power (0x81), wait, then 0x82 | Repeatable? | + +### test_i2c_pinpoint.py -- Root Cause Identification + +The definitive test that identified the I2C STOP corruption bug. Compares three modes on a chip that is already proven alive. + +```bash +sudo python3 tools/test_i2c_pinpoint.py +``` + +**Test sequence:** + + +1. Power on BCM4500 via mode 0x81, confirm alive with raw read +2. **Mode 0x84**: `bcm_direct_read` only (no GPIO, chip already powered) -- tests if the read function itself is broken +3. **Mode 0x85**: GPIO + reset + power but NO I2C bus reset (no `bmSTOP`) -- tests if re-reset breaks things +4. **Mode 0x82**: GPIO + I2C `bmSTOP` + reset + power + probe -- the mode that was failing + + +**Interpretation:** + +| Result Pattern | Diagnosis | +|----------------|-----------| +| 0x84 works, 0x85 works, 0x82 fails | `bmSTOP` (I2C bus reset) is the culprit | +| 0x84 fails | `bcm_direct_read` has a bug | +| 0x85 fails | Re-reset timing needs more delay | + + + + + + +## Windows Memory Dump (wine_memdump.py) + +Extracts firmware from the Genpix Windows driver/updater by running it under Wine and dumping process memory. The Windows updater executable contains embedded firmware images that are unpacked into memory at runtime. + + + +```bash +sudo python3 tools/wine_memdump.py SkyWalkerUpdater.exe +``` + +```bash title="Attach to an already-running Wine process" +sudo python3 tools/wine_memdump.py SkyWalkerUpdater.exe --skip-launch +``` + +```bash title="Custom output directory and wait time" +sudo python3 tools/wine_memdump.py SkyWalkerUpdater.exe -o dumps/ --wait 5 +``` + +### Options + +| Flag | Description | +|------|-------------| +| `EXE` | Windows PE executable to run under Wine (positional, required) | +| `-o, --output-dir DIR` | Output directory for dumps (default: `.`) | +| `--wait SECONDS` | Seconds to wait after launch for unpacking (default: `3`) | +| `--skip-launch` | Attach to an already-running Wine process | + +### How It Works + + +1. Launches the `.exe` under Wine with `WINEDEBUG=-all` to suppress noise +2. Waits for the process to unpack (configurable delay) +3. Finds the Wine process PID by scanning `/proc` +4. Reads `/proc/PID/maps` to identify readable memory regions +5. Reads each region from `/proc/PID/mem` into a contiguous dump +6. Saves the full dump (`wine_memdump.bin`) and region map (`wine_memdump_regions.txt`) +7. Searches the dump for firmware signatures + + +### Firmware Signature Search + +The tool searches for 7 categories of signatures: + +| Search | Pattern | Purpose | +|--------|---------|---------| +| C2 EEPROM headers | `C2 C0 09 03 02` | Find embedded firmware images | +| FX2 init sequence | `78 7F E4 F6 D8 FD 75 81` | FX2 RAM clear/init code | +| RAM clear pattern | `78 7F E4 F6 D8 FD` | Partial match variant | +| C2 load records | LEN + addr `0x0000` + `LJMP` | Record chain starts | +| VID references | `C0 09` near `03 02` | VID/PID byte pairs | +| Version strings | `2.13`, `SkyWalker`, `Genpix`, `8PSK`, etc. | Text markers | +| USB transfer setup | `0x40 0xA0`, `0x40 0x83`, `0x40 0x84` | WinUSB vendor request patterns | + +Each hit is reported with the dump offset, virtual address, containing memory region, and context bytes. + +### Output Files + +| File | Contents | +|------|----------| +| `wine_memdump.bin` | Full concatenated memory dump | +| `wine_memdump_regions.txt` | Region map with virtual addresses, permissions, and dump offsets | + + + + +## Diagnostic Command Reference + +The custom v3.01.0 firmware adds these diagnostic vendor commands used by the test scripts: + +| Command | Code | Direction | Purpose | +|---------|------|-----------|---------| +| `I2C_BUS_SCAN` | 0xB4 | IN | Probe all 128 I2C addresses, return 16-byte bitmap | +| `I2C_RAW_READ` | 0xB5 | IN | Read from any I2C device (wValue=addr, wIndex=reg) | +| `I2C_DIAG` | 0xB6 | IN | Step-by-step indirect register read with intermediate values | +| `RAW_DEMOD_READ` | 0xB1 | IN | Read any BCM4500 indirect register | +| `RAW_DEMOD_WRITE` | 0xB2 | OUT | Write any BCM4500 indirect register | + +These commands are only available when running the custom firmware. Stock firmware will STALL on these command codes. + +## See Also + +- [I2C STOP Corruption Bug](/i2c/stop-corruption-bug/) -- the bug these tools helped discover +- [Boot Sequence](/usb/boot-sequence/) -- the initialization flow being tested +- [Custom Firmware v3.01.0](/firmware/custom-v301/) -- the firmware that enables debug modes +- [I2C Bus Architecture](/i2c/bus-architecture/) -- I2C protocol and controller details +- [Firmware Loader](/tools/firmware-loader/) -- load custom firmware before running debug tools diff --git a/site/src/content/docs/tools/eeprom-utilities.mdx b/site/src/content/docs/tools/eeprom-utilities.mdx new file mode 100644 index 0000000..af64c15 --- /dev/null +++ b/site/src/content/docs/tools/eeprom-utilities.mdx @@ -0,0 +1,266 @@ +--- +title: EEPROM Utilities +description: EEPROM read, write, probe, and verification tools for the FX2 configuration EEPROM. +--- + +import { Tabs, TabItem, Steps, Aside, Badge } from '@astrojs/starlight/components'; + +Three tools manage the SkyWalker-1's I2C EEPROM (24Cxx-family at address `0x51`): `eeprom_write.py` for flashing firmware images, `eeprom_dump.py` for reading EEPROM contents, and `eeprom_probe.py` for testing I2C addressing methods. + +The EEPROM stores the Cypress FX2 boot firmware in C2 IIC format. The FX2 loads this firmware automatically on every power-up. Writing incorrect data to the EEPROM will prevent the device from enumerating on USB. + + + +```bash +pip install pyusb +``` + + + + +## EEPROM Flash Tool + +`eeprom_write.py` is the full-featured EEPROM management tool with four subcommands. + +### Subcommands + +| Subcommand | Purpose | +|------------|---------| +| `info` | Parse and display C2 header from a `.bin` file (offline, no device needed) | +| `backup` | Dump current EEPROM contents to a file | +| `verify` | Compare a `.bin` file against current EEPROM contents | +| `flash` | Write a C2 firmware image to the EEPROM | + +### info -- Inspect a C2 Image File + +Parse and display the C2 header and load records from a firmware binary without connecting to the device. + +```bash +python3 tools/eeprom_write.py info firmware.bin +``` + +``` +C2 Image: firmware.bin +File size: 9512 bytes +======================================== + +Header: + Format: C2 (Large EEPROM, code loads to internal RAM) + VID: 0x09C0 (Genpix) + PID: 0x0203 (SkyWalker-1) + DID: 0x0000 + Config: 0x40 (400kHz I2C) + +Load Records: + [0] 1023 bytes -> 0x0000-0x03FE [02 18 8d 78 7f e4 f6 d8...] + [1] 1023 bytes -> 0x03FF-0x07FD [...] + ... + [9] 115 bytes -> 0x23F7-0x2469 [...] + [10] END MARKER -> entry point: 0xE600 + + Total firmware: 9472 bytes in 10 segments + Entry point: 0xE600 (LJMP target after boot) + + EEPROM footprint: 9512 bytes (0x2528) +``` + +### backup -- Read EEPROM to File + +```bash +sudo python3 tools/eeprom_write.py backup -o my_backup.bin +``` + +```bash title="Specify read size" +sudo python3 tools/eeprom_write.py backup -o my_backup.bin --max-size 16384 +``` + +| Flag | Description | +|------|-------------| +| `-o, --output FILE` | Output file (default: `skywalker1_eeprom.bin`) | +| `--max-size BYTES` | Maximum bytes to read (default: `16384`) | + +### verify -- Compare Image Against EEPROM + +Read the EEPROM and compare byte-by-byte against a local `.bin` file. Reports any mismatches with offset and expected vs. actual values. + +```bash +sudo python3 tools/eeprom_write.py verify firmware.bin +``` + +Exit code `0` = match, `1` = mismatch. + +### flash -- Write Image to EEPROM + +The flash workflow includes built-in safety measures: image validation, VID/PID check, automatic backup, countdown timer, write verification. + + +1. **Validate** the C2 image file (header format, VID/PID match, record integrity) +2. **Connect** to the SkyWalker-1 and check device VID/PID against the image +3. **Backup** the current EEPROM contents to a timestamped file +4. **Wait** 3 seconds with a countdown (Ctrl-C to abort) +5. **Write** the image in 16-byte page-aligned chunks with 10 ms write cycle delays +6. **Verify** by reading back and comparing every byte + + +```bash title="Flash with all safety checks" +sudo python3 tools/eeprom_write.py flash firmware.bin +``` + +```bash title="Dry run (shows what would happen, writes nothing)" +sudo python3 tools/eeprom_write.py flash firmware.bin --dry-run +``` + +```bash title="Skip backup (not recommended)" +sudo python3 tools/eeprom_write.py flash firmware.bin --no-backup +``` + +```bash title="Force flash with VID/PID mismatch" +sudo python3 tools/eeprom_write.py flash firmware.bin --force +``` + +| Flag | Description | +|------|-------------| +| `FILE` | C2 firmware image (positional, required) | +| `--dry-run` | Validate and show plan without writing | +| `--no-backup` | Skip pre-flash EEPROM backup | +| `--force` | Override VID/PID mismatch check | + +### EEPROM Write Parameters + +| Parameter | Value | +|-----------|-------| +| I2C slave address | `0x51` (7-bit) | +| Vendor command (write) | `I2C_WRITE` (`0x83`) | +| Vendor command (read) | `I2C_READ` (`0x84`) | +| Page size | 16 bytes (conservative for 24Cxx) | +| Write cycle time | 10 ms per page | +| Maximum image size | 16,384 bytes (16 KB) | + + + + +## EEPROM Dump Tool + +`eeprom_dump.py` is a simpler read-only tool focused on extracting and analyzing EEPROM contents. + +```bash +sudo python3 tools/eeprom_dump.py -o eeprom.bin +``` + +```bash title="Extract flat binary + 64K Ghidra image" +sudo python3 tools/eeprom_dump.py -o eeprom.bin --extract +``` + +### Options + +| Flag | Description | +|------|-------------| +| `-o, --output FILE` | Output file (default: `skywalker1_eeprom.bin`) | +| `--extract` | Extract firmware as flat binary + full 64K image | +| `--max-size BYTES` | Maximum EEPROM size to read (default: `16384`) | + +### Auto-Detect End of Data + +The tool detects the end of valid data by watching for consecutive `0xFF` chunks (4 or more = end of programmed region). This avoids reading the entire EEPROM when only the first few KB contain firmware. + +### Extract Mode (--extract) + +When `--extract` is specified, the tool additionally produces: + +- **`*_flat.bin`** -- firmware code extracted from C2 records, stored as a flat binary covering only the used address range +- **`*_full64k.bin`** -- full 64 KB memory image (unused regions filled with `0xFF`), suitable for loading in Ghidra at base address `0x0000` + +### Output + +``` +Genpix SkyWalker-1 EEPROM Dump +======================================== +Found device: Bus 1 Addr 12 + +Reading EEPROM (max 16384 bytes)... + End of data at 0x2600 (0xFF padding) + Read 9728 bytes total + Saved raw EEPROM to: eeprom.bin + +======================================== +EEPROM Header: + Format: C2 (Large EEPROM, code loads to internal RAM) + VID: 0x09C0 (Genpix) + PID: 0x0203 (SkyWalker-1) + DID: 0x0000 + Config: 0x40 (400kHz I2C) + +Load Records: + [0] 1023 bytes -> 0x0000-0x03FE [02 18 8d 78 7f e4 f6 d8...] + ... + [10] END MARKER -> entry point: 0xE600 + + Total firmware: 9472 bytes in 10 records + Entry point: 0xE600 (LJMP target after boot) +``` + + + + +## EEPROM Address Probe + +`eeprom_probe.py` is a diagnostic script that tests different I2C addressing methods to determine how the Genpix firmware's `I2C_READ`/`I2C_WRITE` commands interpret `wValue` and `wIndex` parameters for EEPROM access. + +This is a developer tool used during reverse engineering. It runs 7 different addressing approaches and checks each result against known reference bytes from the EEPROM header. + +```bash +sudo python3 tools/eeprom_probe.py +``` + +### Test Approaches + +| Approach | Method | Description | +|----------|--------|-------------| +| 1 | `I2C_WRITE data=[addr_h, addr_l]` then `I2C_READ` | Set EEPROM offset via write data | +| 2 | `wValue=addr, wIndex=slave` | Reversed parameter mapping | +| 3 | `wValue=slave, wIndex=addr` | Standard Genpix mapping | +| 4 | `I2C_READ wIndex=offset` | Offset in wIndex field | +| 5 | `wValue=(slave<<8\|offset)` | Packed slave + offset | +| 6 | `wValue=offset (no slave)` | Offset only, no slave address | +| 7 | Larger reads (64 bytes) | Verify sequential data across page boundaries | + +### Known Reference Bytes + +The script compares against two known patterns: + +- **Offset 0x0000**: `C2 C0 09 03 02 00 00 40` (C2 header: marker, VID, PID, DID, config) +- **Offset 0x0008**: `03 FF 00 00 02 18 8D 30` (first load record) + + + + + + +## Cypress C2 Boot Format + +The EEPROM stores firmware in the Cypress C2 IIC second-stage boot format: + +| Field | Offset | Size | Description | +|-------|--------|------|-------------| +| Marker | 0 | 1 | `0xC2` (large EEPROM, external memory) | +| VID | 1 | 2 | USB Vendor ID, little-endian (`0x09C0`) | +| PID | 3 | 2 | USB Product ID, little-endian (`0x0203`) | +| DID | 5 | 2 | Device ID, little-endian | +| Config | 7 | 1 | Boot config (`0x40` = 400 kHz I2C) | +| Records | 8+ | var | Code segments: `[len_hi][len_lo][addr_hi][addr_lo][data...]` | +| End | last | 4 | `[0x80][0x01][entry_hi][entry_lo]` (entry point = `0xE600`) | + +For a full description of the storage format, see [Firmware Storage Formats](/firmware/storage-formats/). + +## See Also + +- [Firmware Loader](/tools/firmware-loader/) -- RAM-based firmware loading (non-destructive) +- [Storage Formats](/firmware/storage-formats/) -- C2 format, hexline, and FW02 chunk details +- [Version Comparison](/firmware/version-comparison/) -- differences across firmware versions +- [I2C Bus Architecture](/i2c/bus-architecture/) -- I2C protocol details diff --git a/site/src/content/docs/tools/firmware-loader.mdx b/site/src/content/docs/tools/firmware-loader.mdx new file mode 100644 index 0000000..a27d71a --- /dev/null +++ b/site/src/content/docs/tools/firmware-loader.mdx @@ -0,0 +1,255 @@ +--- +title: Firmware Loader +description: RAM firmware loader and firmware dump/probe utilities for the Genpix SkyWalker-1. +--- + +import { Tabs, TabItem, Steps, Aside, Badge } from '@astrojs/starlight/components'; + +Two complementary tools handle firmware on the SkyWalker-1: `fw_load.py` loads firmware into FX2 RAM for testing, and `fw_dump.py` extracts firmware and device information from a running device. + +Both tools require `pyusb` and typically need root access (or appropriate udev rules) to communicate with the USB device. + +```bash +pip install pyusb +``` + + + + + + +## RAM Firmware Loader + +`fw_load.py` loads firmware into the Cypress FX2 internal/external RAM via the standard `0xA0` vendor request built into the FX2 silicon boot ROM. This is the primary tool for firmware development: load, test, power-cycle to revert. + +### Subcommands + +| Subcommand | Purpose | +|------------|---------| +| `load` | Load a firmware file into FX2 RAM | +| `reset` | Halt and restart the FX2 CPU | +| `read` | Read and hex-dump FX2 RAM contents | + +### load -- Write Firmware to RAM + + +1. **Halt the CPU** -- writes `0x01` to the CPUCS register at `0xE600` +2. **Write code segments** into RAM in 64-byte chunks via vendor request `0xA0` +3. **Start the CPU** -- writes `0x00` to CPUCS, triggering USB re-enumeration + + +**Supported file formats:** + +| Extension | Format | Load Address | +|-----------|--------|-------------| +| `.ihx`, `.hex` | Intel HEX | Addresses embedded in file | +| `.bix`, `.bin` | Raw binary | `0x0000` (start of internal RAM) | + +**Options:** + +| Flag | Description | +|------|-------------| +| `FILE` | Firmware file path (positional, required) | +| `--no-reset` | Load segments without halting/starting the CPU | +| `--wait SECONDS` | Wait for USB re-enumeration after load | +| `-v, --verbose` | Show per-chunk transfer progress | +| `--force` | Allow loading to devices with unknown VID/PID | + +**Examples:** + +```bash title="Load custom firmware and wait for re-enumeration" +sudo python3 tools/fw_load.py load firmware/build/skywalker1.ihx --wait 3 +``` + +```bash title="Load raw binary with verbose output" +sudo python3 tools/fw_load.py load firmware.bix -v --wait 5 +``` + +```bash title="Load without CPU reset (write segments only)" +sudo python3 tools/fw_load.py load firmware.ihx --no-reset +``` + +**Typical output:** + +``` +SkyWalker-1 RAM Firmware Loader +======================================== + +Firmware: firmware/build/skywalker1.ihx + Segments: 3 + Total size: 3072 bytes + Address: 0x0000 - 0x0BFF + +Found SkyWalker-1: Bus 1 Addr 12 (VID 0x09C0 PID 0x0203) + +[1/3] Halting CPU (CPUCS = 0x01)... + CPU halted + +[2/3] Loading 3 segment(s) into RAM... + 0x0000-0x03FF (1024 bytes) + 0x0400-0x07FF (1024 bytes) + 0x0800-0x0BFF (1024 bytes) + + 3072 bytes loaded + +[3/3] Starting CPU (CPUCS = 0x00)... + CPU released + + Firmware is running. The device will re-enumerate + with new USB descriptors if the firmware does so. +``` + +### reset -- Restart the FX2 CPU + +Halts and restarts the CPU without loading new code. Useful for triggering USB re-enumeration when the device is in a bad state. + +```bash +sudo python3 tools/fw_load.py reset --wait 3 +``` + +| Flag | Description | +|------|-------------| +| `--wait SECONDS` | Wait for re-enumeration after reset | +| `--force` | Allow reset on unknown VID/PID | + +### read -- Hex-Dump FX2 RAM + +Read memory contents from a running FX2. Useful for verifying loaded firmware or inspecting register state. + +```bash title="Read first 256 bytes of internal RAM" +sudo python3 tools/fw_load.py read --addr 0x0000 --len 256 +``` + +```bash title="Check CPUCS register" +sudo python3 tools/fw_load.py read --addr 0xe600 --len 1 +``` + +```bash title="Dump to file" +sudo python3 tools/fw_load.py read --addr 0x0000 --len 8192 -o ram_dump.bin +``` + +| Flag | Description | +|------|-------------| +| `--addr ADDR` | Start address in hex (default: `0x0000`) | +| `--len LENGTH` | Bytes to read (default: `256`) | +| `-o, --output FILE` | Save raw bytes to file | +| `--force` | Allow read on unknown VID/PID | + +### Device Detection + +The loader searches for devices in this order: + +1. **SkyWalker-1** -- VID `0x09C0`, PID `0x0203` +2. **Bare Cypress FX2** -- VID `0x04B4`, PID `0x8613` (unprogrammed/blank EEPROM) + +Use `--force` to override VID/PID checks for devices with non-standard descriptors. + + + + + + +## Firmware Probe and Dump Tool + +`fw_dump.py` queries device information, dumps FX2 RAM contents, and scans for undocumented vendor commands. + +### Options + +| Flag | Description | +|------|-------------| +| `--info` | Query and display device information | +| `--dump FILE` | Dump FX2 RAM to a binary file | +| `--scan` | Brute-force scan all vendor commands (0x00--0xFF) | +| `--start ADDR` | RAM dump start address (default: `0x0000`) | +| `--size SIZE` | RAM dump size in bytes (default: `0x2000` = 8 KB) | +| `--external` | Attempt to dump external RAM (64 KB) | + +Running with no flags defaults to `--info --scan`. + +### Device Info (--info) + +Queries all known Genpix vendor commands and displays firmware version, build date, USB speed, serial number, and the 8PSK configuration status byte with decoded flags. + +```bash +sudo python3 tools/fw_dump.py --info +``` + +``` +=== Genpix SkyWalker-1 Device Info === + + FW Version: 2.06.4 (0x020604) + FW Build: 2007-07-13 + BCD Version: 0206 + Vendor: Genpix + Product: SkyWalker-1 + USB Speed: High (480Mbps) + Serial: 00000000 + Config: 0x03 + [ ON] 8PSK Started + [ ON] BCM4500 FW Loaded + [off] Intersil LNB On + [off] DVB Mode + [off] 22kHz Tone + [off] 18V Selected + [off] DC Tuned + [off] Armed (streaming) +``` + +### Vendor Command Scan (--scan) + +Sends vendor IN requests to every command index from `0x00` to `0xFF` and reports which ones return data. Commands already documented in the reference are labeled `[KNOWN]`; unexpected responses are flagged `[NEW!]`. + +```bash +sudo python3 tools/fw_dump.py --scan +``` + +### RAM Dump (--dump) + +Reads FX2 internal RAM (8 KB at `0x0000`--`0x1FFF`) or external RAM (up to 64 KB with `--external`) via the standard `0xA0` vendor request. + +```bash title="Dump internal RAM" +sudo python3 tools/fw_dump.py --dump internal_ram.bin +``` + +```bash title="Dump external RAM (64 KB)" +sudo python3 tools/fw_dump.py --dump external_ram.bin --external +``` + +```bash title="Dump specific range" +sudo python3 tools/fw_dump.py --dump region.bin --start 0x1000 --size 0x800 +``` + +The tool performs a quick analysis of the dump, reporting non-`0xFF` byte count and checking for the standard FX2 reset vector (`LJMP` at address `0x0000`). + + + + + + +## Kernel Driver Conflict + +The Linux `dvb_usb_gp8psk` module auto-loads when the SkyWalker-1 enumerates on USB. It will race with these tools for device access. + +**Before using any tool**, either blacklist the module or unload it: + +```bash title="Unload for current session" +sudo modprobe -r dvb_usb_gp8psk gp8psk_fe +``` + +```bash title="Permanent blacklist" +echo -e "blacklist dvb_usb_gp8psk\nblacklist gp8psk_fe" | \ + sudo tee /etc/modprobe.d/blacklist-gp8psk.conf +``` + +## See Also + +- [EEPROM Utilities](/tools/eeprom-utilities/) -- for permanent firmware flashing +- [Boot Sequence](/usb/boot-sequence/) -- what happens after firmware loads +- [Custom Firmware v3.01.0](/firmware/custom-v301/) -- the open-source replacement firmware +- [Vendor Commands](/usb/vendor-commands/) -- command reference used by these tools diff --git a/site/src/content/docs/tools/ts-analyzer.mdx b/site/src/content/docs/tools/ts-analyzer.mdx new file mode 100644 index 0000000..c7df1e3 --- /dev/null +++ b/site/src/content/docs/tools/ts-analyzer.mdx @@ -0,0 +1,262 @@ +--- +title: TS Analyzer +description: MPEG-2 Transport Stream analyzer for captured satellite data from the SkyWalker-1. +--- + +import { Tabs, TabItem, Steps, Aside, Badge } from '@astrojs/starlight/components'; + +`ts_analyze.py` parses and analyzes 188-byte MPEG-2 transport stream packets from `.ts` files captured by `tune.py`, piped from stdin, or any standard TS source. It covers PID distribution, PAT/PMT parsing, continuity counter verification, scrambling detection, bitrate estimation, and live stream monitoring. + +Reference: ISO/IEC 13818-1 (MPEG-2 Systems). + +## Subcommands + +| Subcommand | Purpose | +|------------|---------| +| `analyze` | Full stream analysis with PID table, CC errors, bitrate (default) | +| `pids` | Quick PID summary table | +| `pat` | Parse and display the Program Association Table | +| `pmt` | Parse and display Program Map Tables | +| `dump` | Hex dump of individual TS packets | +| `monitor` | Live stream monitoring with real-time statistics | + +Passing a filename without a subcommand defaults to `analyze`. + +## Global Options + +| Flag | Description | +|------|-------------| +| `-v, --verbose` | Show sync search details and debug info | + +--- + +## analyze -- Full Stream Analysis + +Comprehensive analysis of a TS file or stream: total packets, unique PIDs, TEI errors, scrambling, continuity counter errors, PCR-based bitrate, and a per-PID distribution table. + +```bash +python3 tools/ts_analyze.py capture.ts +``` + +```bash title="Analyze first 10000 packets only" +python3 tools/ts_analyze.py analyze capture.ts --max-packets 10000 +``` + +| Flag | Description | +|------|-------------| +| `INPUT` | TS file path or `-` for stdin | +| `--max-packets N` | Limit analysis to N packets (0 = all) | + +**Example output:** + +``` +MPEG-2 Transport Stream Analysis +============================================================ +File: capture.ts (52,428,800 bytes) + +Total packets: 278,876 +Total bytes: 52,428,688 +Unique PIDs: 12 +TEI errors: 0 +Scrambled: 0 +Duration: 5.23s (from PCR) +Bitrate: 80.21 Mbps (PCR-based) + +============================================================ +PID Distribution +============================================================ + PID Count % CC Err Name + --- ----- -- ------ ---- + 0x0000 1,394 0.50% - PAT + 0x0001 278 0.10% - CAT + 0x0010 556 0.20% - NIT/ST + 0x0011 556 0.20% - SDT/BAT/ST + 0x0100 139,438 50.00% - + 0x0101 83,663 29.99% - + 0x0102 5,576 2.00% - + 0x1FFF 47,415 17.01% - Null +``` + +### What It Detects + +| Metric | Description | +|--------|-------------| +| **PID count** | Packet count per Program ID | +| **TEI** | Transport Error Indicator flag in the TS header | +| **Scrambling** | Transport scrambling control bits (even/odd key) | +| **CC errors** | Continuity counter discontinuities per PID | +| **Bitrate** | Calculated from PCR timestamps when available | + +--- + +## pids -- Quick PID Table + +Faster variant of `analyze` that only counts packets per PID without CC checking or PCR extraction. + +```bash +python3 tools/ts_analyze.py pids capture.ts +``` + +--- + +## pat -- Program Association Table + +Parses PID 0x0000 to extract the PAT, showing the transport stream ID and which PMT PID corresponds to each program number. + +```bash +python3 tools/ts_analyze.py pat capture.ts +``` + +``` +Program Association Table (PAT) +================================================== + Transport Stream ID: 0x0001 (1) + Version: 3 + Programs: 2 + + Program PMT PID Note + ------- ------- ---- + 0 0x0010 NIT + 1 0x0100 +``` + +--- + +## pmt -- Program Map Tables + +Parses the PAT first to discover PMT PIDs, then parses each PMT to show the elementary streams (video, audio, data) in each program. + +```bash +python3 tools/ts_analyze.py pmt capture.ts +``` + +``` +Program Map Tables +============================================================ +Transport Stream ID: 0x0001 + + Program 1 (PMT PID 0x0100, version 2) + PCR PID: 0x0101 + Streams: + Type PID Description + ---- --- ----------- + 0x02 0x0101 MPEG-2 Video (13818-2) + 0x04 0x0102 MPEG-2 Audio (13818-3) + 0x06 0x0103 PES Private Data +``` + +### Known Stream Types + +The tool recognizes these standard stream type identifiers: + +| Code | Description | +|------|-------------| +| 0x01 | MPEG-1 Video | +| 0x02 | MPEG-2 Video | +| 0x03 | MPEG-1 Audio | +| 0x04 | MPEG-2 Audio | +| 0x06 | PES Private Data | +| 0x0F | MPEG-2 AAC Audio | +| 0x1B | H.264/AVC Video | +| 0x24 | H.265/HEVC Video | +| 0x81 | AC-3 Audio (ATSC) | + +--- + +## dump -- Hex Dump Packets + +Print detailed per-packet information including header fields, adaptation field flags, PCR values, and raw hex dump. + +```bash title="Dump first 5 packets" +python3 tools/ts_analyze.py dump capture.ts --count 5 +``` + +```bash title="Dump packets for a specific PID" +python3 tools/ts_analyze.py dump capture.ts --pid 0x0100 --count 3 +``` + +| Flag | Description | +|------|-------------| +| `--pid PID` | Filter by PID (hex `0x100` or decimal `256`) | +| `--count N` | Maximum packets to dump (default: `10`) | + +**Example output:** + +``` +Packet #1 + PID: 0x0000 (PAT) + TEI: 0 PUSI: 1 Priority: 0 + Scrambling: none Adaptation: payload only CC: 5 + Hex: + 0000: 47 40 00 15 00 00 B0 0D 00 01 C1 00 00 00 00 E0 G@.............. + 0010: 10 00 01 E1 00 78 A0 B4 FF FF FF FF FF FF FF FF .....x.......... + ... +``` + +--- + +## monitor -- Live Stream Monitoring + +Real-time monitoring of a TS stream, reporting new PIDs as they appear, continuity errors, TEI errors, and bitrate. + +```bash title="Monitor from a live stream pipe" +sudo python3 tools/tune.py stream --stdout | python3 tools/ts_analyze.py monitor - +``` + +```bash title="Monitor a growing file" +python3 tools/ts_analyze.py monitor capture.ts +``` + +The monitor prints events as they occur (new PIDs, errors) and updates a status line on stderr every second with running statistics. + +``` +MPEG-2 TS Live Monitor +============================================================ +Ctrl-C to stop + + [ 0.0s] New PID: 0x0000 (PAT) + [ 0.0s] New PID: 0x1FFF (Null) + [ 0.1s] New PID: 0x0100 + [ 0.1s] New PID: 0x0101 + [ 0.2s] New PID: 0x0102 + 278,876 pkts 52,428,688 bytes 80.21 Mbps PIDs: 12 CCerr:0 TEI:0 (5s) + +Monitor Summary +======================================== + Duration: 5.2s + Packets: 278,876 + Bytes: 52,428,688 + Unique PIDs: 12 + CC errors: 0 + TEI errors: 0 + Avg bitrate: 80.21 Mbps +``` + +--- + +## Capturing a Transport Stream + + + +## Sync Detection + +The analyzer requires at least 3 consecutive sync bytes (`0x47`) at 188-byte intervals to confirm alignment. If the file starts with non-TS data (e.g., leading garbage from a partial USB transfer), the tool will skip ahead until sync is found. + +When using `-v` (verbose), the sync search offset is reported. A non-zero sync offset may indicate that the capture started mid-packet or contains a non-TS preamble. + +## See Also + +- [Tuning Tool](/tools/tuning/) -- capture TS data from a transponder +- [GPIF Streaming](/bcm4500/gpif-streaming/) -- how TS data flows from BCM4500 through USB +- [Vendor Commands](/usb/vendor-commands/) -- ARM_TRANSFER (0x85) starts/stops the stream diff --git a/site/src/content/docs/tools/tuning.mdx b/site/src/content/docs/tools/tuning.mdx new file mode 100644 index 0000000..50793b9 --- /dev/null +++ b/site/src/content/docs/tools/tuning.mdx @@ -0,0 +1,293 @@ +--- +title: Tuning Tool +description: DVB-S tuning, signal monitoring, LNB control, DiSEqC switching, and transport stream capture. +--- + +import { Tabs, TabItem, Steps, Aside, Badge } from '@astrojs/starlight/components'; + +`tune.py` is the primary user-facing tool for operating the SkyWalker-1 as a satellite receiver. It handles the complete signal chain: powering the demodulator, configuring LNB voltage and tone, sending DiSEqC switch commands, tuning to a transponder, monitoring signal quality, and capturing MPEG-2 transport stream data. + +```bash +pip install pyusb +``` + +## Subcommands + +| Subcommand | Purpose | +|------------|---------| +| `status` | Show device config, firmware version, and signal info | +| `tune` | Tune to a transponder frequency | +| `stream` | Capture MPEG-2 transport stream data | +| `diseqc` | Send DiSEqC switch commands | +| `lnb` | Control LNB voltage and 22 kHz tone | + +Running with no subcommand defaults to `status`. + +## Global Options + +| Flag | Description | +|------|-------------| +| `-v, --verbose` | Show raw USB control transfer traffic | +| `--json` | Output machine-readable JSON (where supported) | + +--- + +## status -- Device Information + +Displays the current device state: firmware version, configuration status flags, signal lock, and SNR. + +```bash +sudo python3 tools/tune.py status +``` + +``` +Genpix SkyWalker-1 Status +================================================== + +USB: Bus 1 Addr 12 (VID 0x09C0, PID 0x0203) +FW: 2.06.4 (built 2007-07-13) + +Config: 0x07 + [ ON] 8PSK Started + [ ON] BCM4500 FW Loaded + [ ON] LNB Power On + [off] DVB Mode + [off] 22 kHz Tone + [off] 18V Selected + [off] DC Tuned + [off] Armed (streaming) + +Signal Lock: LOCKED +SNR: 8.2 dB (raw 0x0823) +Quality: [################------------------------] 42.3% +``` + +Use `--json` for programmatic access to all fields. + +--- + +## tune -- Transponder Tuning + +The 8-step tuning sequence: check status, boot demodulator, enable LNB power, set voltage (polarization), set extra voltage, set 22 kHz tone (band), send TUNE_8PSK command, wait for signal lock. + +### Required Arguments + +| Argument | Description | +|----------|-------------| +| `FREQ` | Transponder downlink frequency in MHz (e.g., `12520`) | +| `SR` | Symbol rate in ksps (e.g., `27500`) | + +### Options + +| Flag | Description | +|------|-------------| +| `--pol H/V/L/R` | Polarization: H (horizontal/18V), V (vertical/13V), L (left circular/18V), R (right circular/13V) | +| `--band low/high` | LNB band: low (tone off, 9750 MHz LO) or high (tone on, 10600 MHz LO) | +| `--lnb-lo MHZ` | Override LNB local oscillator frequency (default: 9750 low, 10600 high) | +| `--mod TYPE` | Modulation type (default: `qpsk`) | +| `--fec RATE` | FEC rate (default: `auto`) | +| `--timeout SECONDS` | Signal lock timeout (default: `10`) | +| `--extra-volt` | Enable +1V LNB voltage boost for long cables | +| `--json` | Output JSON result | + +### Modulation Types + +| Name | Description | FEC Group | +|------|-------------|-----------| +| `qpsk` | DVB-S QPSK | dvbs | +| `turbo-qpsk` | Turbo-coded QPSK | turbo | +| `turbo-8psk` | Turbo-coded 8PSK | turbo | +| `turbo-16qam` | Turbo-coded 16QAM | turbo-16qam | +| `dcii-combo` | Digicipher II Combo | dcii | +| `dcii-i` | Digicipher II I-stream | dcii | +| `dcii-q` | Digicipher II Q-stream | dcii | +| `dcii-oqpsk` | Digicipher II Offset QPSK | dcii | +| `dss` | DSS QPSK | dvbs | +| `bpsk` | DVB BPSK | dvbs | + +### FEC Rates by Group + +| Group | Available Rates | +|-------|----------------| +| **dvbs** | `1/2`, `2/3`, `3/4`, `5/6`, `7/8`, `auto`, `none` | +| **turbo** | `1/2`, `2/3`, `3/4`, `5/6`, `auto` | +| **turbo-16qam** | `3/4`, `auto` | +| **dcii** | `1/2`, `2/3`, `6/7`, `3/4`, `5/11`, `1/2+`, `2/3+`, `6/7+`, `3/4+`, `auto` | + + + + +```bash title="Standard DVB-S QPSK, Ku-band high" +sudo python3 tools/tune.py tune 12520 27500 --pol H --band high +``` + +```bash title="DVB-S with explicit FEC" +sudo python3 tools/tune.py tune 11836 27500 --pol V --band low --fec 3/4 +``` + +```bash title="C-band with custom LNB LO" +sudo python3 tools/tune.py tune 3960 26667 --pol V --lnb-lo 5150 +``` + + + + +```bash title="Turbo 8PSK" +sudo python3 tools/tune.py tune 12224 20000 --pol V --band high --mod turbo-8psk --fec 2/3 +``` + +```bash title="Turbo QPSK with auto FEC" +sudo python3 tools/tune.py tune 12090 20000 --pol H --band high --mod turbo-qpsk +``` + + + + +```bash title="Digicipher II Combo" +sudo python3 tools/tune.py tune 12224 20000 --pol V --band high --mod dcii-combo --fec auto +``` + +```bash title="DCII Split I-stream" +sudo python3 tools/tune.py tune 12224 20000 --pol V --band high --mod dcii-i --fec 6/7 +``` + + + + +### Tuning Output + +``` +Tuning SkyWalker-1 +================================================== + Downlink: 12520 MHz + LNB LO: 10600 MHz + IF Frequency: 1920.0 MHz (1920000 kHz) + Symbol Rate: 27500 ksps (27500000 sps) + Modulation: DVB-S QPSK (index 0) + FEC: auto (index 5) + Polarization: Horizontal (18V) + Band: high (22kHz on) + +[1/8] Config status: 0x07 +[2/8] Demodulator already running +[3/8] LNB power already on +[4/8] Setting LNB voltage: 18V +[5/8] Extra voltage: off +[6/8] 22 kHz tone: ON +[7/8] Sending TUNE_8PSK... +[8/8] Waiting for signal lock (timeout 10s)... +... + + LOCKED + SNR: 8.2 dB (raw 0x0823) + Quality: [################------------------------] 42.3% +``` + + + +--- + +## stream -- Transport Stream Capture + +Captures MPEG-2 transport stream data from EP2 bulk endpoint after the device is tuned and locked. Requires a prior successful `tune` command (signal must be locked). + +```bash title="Capture to file for 60 seconds" +sudo python3 tools/tune.py stream -o capture.ts --duration 60 +``` + +```bash title="Pipe directly to VLC" +sudo python3 tools/tune.py stream --stdout | vlc - +``` + +```bash title="Pipe to ffmpeg for recording" +sudo python3 tools/tune.py stream --stdout | ffmpeg -i pipe: -c copy output.mp4 +``` + +| Flag | Description | +|------|-------------| +| `-o, --output FILE` | Write TS data to file | +| `--stdout` | Write TS data to stdout (for piping) | +| `--duration SECONDS` | Capture duration (default: until Ctrl-C) | + +The stream status is written to stderr when using `--stdout`, so it does not contaminate the TS data pipe. + + + +--- + +## diseqc -- Switch Commands + +Send DiSEqC 1.0 port selection, mini-DiSEqC tone bursts, or raw DiSEqC messages. + +```bash title="Select DiSEqC 1.0 port 1" +sudo python3 tools/tune.py diseqc --port 1 +``` + +```bash title="Send tone burst A" +sudo python3 tools/tune.py diseqc --tone-burst A +``` + +```bash title="Send raw DiSEqC message" +sudo python3 tools/tune.py diseqc --raw E0 10 38 F0 +``` + +| Flag | Description | +|------|-------------| +| `--port 1-4` | DiSEqC 1.0 committed switch port | +| `--tone-burst A/B` | Mini-DiSEqC tone burst | +| `--raw HH HH ...` | Raw DiSEqC bytes in hex (3--6 bytes) | + +For details on the DiSEqC signaling implementation, see [DiSEqC Protocol](/lnb-diseqc/diseqc-protocol/). + +--- + +## lnb -- LNB Control + +Direct control of LNB voltage, 22 kHz tone, and power supply. Running with no flags shows the current LNB state. + +```bash title="Show LNB status" +sudo python3 tools/tune.py lnb +``` + +```bash title="Set voltage and tone" +sudo python3 tools/tune.py lnb --voltage 18 --tone on +``` + +```bash title="Power cycle the LNB" +sudo python3 tools/tune.py lnb --power off +sudo python3 tools/tune.py lnb --power on +``` + +| Flag | Description | +|------|-------------| +| `--voltage 13/18` | LNB voltage (13V = vertical, 18V = horizontal) | +| `--tone on/off` | 22 kHz tone (on = high band, off = low band) | +| `--extra-volt` | Enable +1V boost (13V becomes 14V, 18V becomes 19V) | +| `--power on/off` | LNB power supply on/off | + + + +--- + +## Signal Quality Metrics + +| Metric | Source | Description | +|--------|--------|-------------| +| **SNR** | `GET_SIGNAL_STRENGTH` (0x87) | Signal-to-noise ratio in dB, read as 16-bit value (dBu * 256 units) | +| **Lock** | `GET_SIGNAL_LOCK` (0x90) | BCM4500 register 0xA4, bit 5 indicates signal lock | +| **Quality %** | Computed | SNR scaled: `snr_raw * 17` maps to 0--100%, saturating at SNR >= `0x0F00` | + +For details on the signal monitoring protocol, see [Signal Monitoring](/bcm4500/signal-monitoring/). + +## See Also + +- [Tuning Protocol](/bcm4500/tuning-protocol/) -- firmware-level TUNE_8PSK command format +- [LNB Control](/lnb-diseqc/lnb-control/) -- hardware-level voltage and tone control +- [TS Analyzer](/tools/ts-analyzer/) -- analyze captured transport streams +- [Vendor Commands](/usb/vendor-commands/) -- complete USB command reference diff --git a/site/src/content/docs/usb/boot-sequence.mdx b/site/src/content/docs/usb/boot-sequence.mdx new file mode 100644 index 0000000..e551649 --- /dev/null +++ b/site/src/content/docs/usb/boot-sequence.mdx @@ -0,0 +1,135 @@ +--- +title: Boot Sequence +description: Complete power-on boot flow from USB enumeration through BCM4500 demodulator initialization. +--- + +import { Steps, Badge, Aside } from '@astrojs/starlight/components'; + +## EEPROM Boot (Hardware) + +The SkyWalker-1 firmware is stored in a 24Cxx-family I2C EEPROM in Cypress C2 format. On power-up, the FX2 boot ROM reads this firmware automatically -- no host interaction is required. + +### C2 EEPROM Format + +| Offset | Size | Field | SkyWalker-1 Value | +|--------|------|-------|-------------------| +| 0 | 1 | Marker | 0xC2 (external memory, large code model) | +| 1 | 2 | VID (LE) | 0x09C0 | +| 3 | 2 | PID (LE) | 0x0203 | +| 5 | 2 | DID (LE) | 0x0000 | +| 7 | 1 | Config | 0x40 (400 kHz I2C) | + +Code segments follow the header: 2-byte length (BE) + 2-byte target address (BE) + data. Maximum segment size is 1023 bytes (FX2 I2C boot ROM buffer limit). All SkyWalker-1 variants use 10 segments. + +The terminator is 0x80xx (high bit set) + 2-byte entry point address (0xE600 = CPUCS register). + +## Kernel Driver Boot Flow + +After USB enumeration, the Linux `dvb_usb_gp8psk` driver executes this initialization sequence: + + +1. **GET_8PSK_CONFIG (0x80)** -- Read the [configuration status byte](/usb/config-status/). Check bit 0 (`bm8pskStarted`). + +2. **BOOT_8PSK (0x89, wValue=1)** -- If not started, power on the BCM4500 demodulator. Then read the firmware version via **GET_FW_VERS (0x92)**. + +3. **LOAD_BCM4500 (0x88)** -- If bit 1 (`bm8pskFW_Loaded`) is clear, load BCM4500 firmware. This only applies to Rev.1 Warm (PID 0x0201). On SkyWalker-1, this bit is always set and 0x88 returns STALL. + +4. **START_INTERSIL (0x8A, wValue=1)** -- If bit 2 (`bmIntersilOn`) is clear, enable the LNB power supply. + +5. **SET_DVB_MODE (0x8E, wValue=1)** -- Attempt to set DVB mode. This STALLs on all SkyWalker-1 firmware versions (the command is a no-op). + +6. **ARM_TRANSFER (0x85, wValue=0)** -- Abort any pending MPEG-2 transfer to ensure a clean state. + +7. **Device ready for tuning** -- The kernel driver reports the frontend as available. + + +## BCM4500 Demodulator Boot (BOOT_8PSK, 0x89) + +The BOOT_8PSK command handler powers on the BCM4500 demodulator and writes three initialization register blocks via I2C. This sequence was reverse-engineered from stock v2.06 firmware (`FUN_CODE_1D4F` + `FUN_CODE_0ddd`) and re-implemented in custom firmware v3.01.0. + + +1. **Assert BCM4500 RESET** -- Drive P0.5 LOW. This holds the BCM4500's digital logic in reset while power is applied. + +2. **Power on** -- Set P0.1 HIGH (power enable), P0.2 LOW (power disable off). The SkyWalker-1 has complementary power control pins. + +3. **Wait for power settle** -- 30 ms delay. The power supply must reach regulation before releasing reset. + +4. **Release RESET** -- Drive P0.5 HIGH. The BCM4500 begins its internal power-on reset (POR) and mask ROM boot sequence. + +5. **Wait for BCM4500 POR** -- 50 ms delay. The chip needs time for its internal oscillator to stabilize and mask ROM to execute. + +6. **I2C probe** -- Read direct register 0xA2 (status) at I2C address 0x08 to verify the chip is alive and responding. If this fails, boot aborts. + +7. **Write init block 0** -- 7 bytes to indirect page 0, starting at register 0x06. Data: `{06 0b 17 38 9f d9 80}`. + +8. **Write init block 1** -- 8 bytes to indirect page 0, starting at register 0x07. Data: `{07 09 39 4f 00 65 b7 10}`. + +9. **Write init block 2** -- 3 bytes to indirect page 0, starting at register 0x0F. Data: `{0f 0c 09}`. + +10. **Set config_status** -- OR in `BM_STARTED | BM_FW_LOADED` (0x03). Subsequent vendor commands check this flag before operating. + + +Each init block is written using the BCM4500 [indirect register protocol](/bcm4500/demodulator/): page select (0xA6 = 0x00), data to 0xA7 (multi-byte with auto-increment), trailing zero to 0xA7, then commit (0xA8 = 0x03). The firmware polls 0xA8 until the command completes before proceeding. + +**Total boot time**: approximately 90 ms (30 ms power settle + 50 ms POR delay + ~10 ms I2C transactions). + +### Boot Results + +| Metric | Value | +|--------|-------| +| Boot time | ~90 ms total | +| config_status after boot | 0x03 (STARTED + FW_LOADED) | +| Direct registers 0xA2-0xA8 | All return 0x02 (powered, not locked -- expected without signal) | +| Signal lock | 0x00 (no lock -- no satellite signal present) | + + + +## Firmware Version Identification + +The kernel reads the firmware version on boot via GET_FW_VERS (0x92) and logs it: + +``` +gp8psk: FW Version = 2.06.4 (0x20604) Build 2007/07/13 +``` + +Kernel revision constants for hardware detection: + +```c title="gp8psk-fe.h" +GP8PSK_FW_REV1 = 0x020604 // v2.06.4 +GP8PSK_FW_REV2 = 0x020704 // v2.07.4 +``` + +If `fw_vers >= GP8PSK_FW_REV2`, the kernel enables Rev.2-specific code paths. The v2.10 and v2.13 firmwares are newer than either constant and trigger Rev.2 behavior. + +## FX2 CPUCS Recovery + +The FX2's CPUCS register at 0xE600 is accessible via the standard vendor request `bRequest=0xA0` (RAM read/write), which is handled by the FX2 boot ROM in silicon -- not by user firmware. This means firmware can be reloaded over a completely hung device without a physical USB unplug: + +```bash title="Recover a hung device" +sudo python3 tools/fw_load.py load firmware/build/skywalker1.ihx --wait 3 +``` + +Writing 0x01 to CPUCS halts the CPU. New code is written to RAM. Writing 0x00 restarts it. The device re-enumerates with the new firmware. + +## Custom Debug Boot Modes (v3.01.0) + +The custom firmware extends BOOT_8PSK (0x89) with incremental debug modes for isolating boot failures: + +| wValue | Action | Purpose | +|--------|--------|---------| +| 0x80 | No-op: return `config_status` and `boot_stage` | Status check without side effects | +| 0x81 | GPIO + power + delays only (no I2C) | Test power sequencing | +| 0x82 | GPIO + power + I2C probe | Test I2C after power-on | +| 0x83 | GPIO + power + probe + init block 0 | Test first register write | +| 0x84 | I2C probe only (chip already powered) | Isolate I2C from power sequencing | +| 0x85 | Same as 0x82 without bmSTOP | Confirmed the STOP corruption bug | +| 0x01 | Full boot (production) | Normal operation | +| 0x00 | Shutdown | Power down demodulator | + +These modes were instrumental in identifying the [I2C STOP corruption bug](/i2c/stop-corruption-bug/) -- mode 0x82 (with bmSTOP) failed while mode 0x85 (without bmSTOP) succeeded, pinpointing the exact cause. diff --git a/site/src/content/docs/usb/config-status.mdx b/site/src/content/docs/usb/config-status.mdx new file mode 100644 index 0000000..d8bf362 --- /dev/null +++ b/site/src/content/docs/usb/config-status.mdx @@ -0,0 +1,79 @@ +--- +title: Configuration Status Byte +description: Bit-field breakdown of the configuration status byte returned by GET_8PSK_CONFIG (0x80). +--- + +import { Badge, Aside } from '@astrojs/starlight/components'; + +The configuration status byte is returned by the GET_8PSK_CONFIG vendor command (0x80) and reflects the current device state. The kernel driver checks these bits during initialization to determine which boot steps have already completed. + +## Bit Field Map + +| Bit | Mask | Name | Meaning | +|-----|------|------|---------| +| 7 | 0x80 | bmArmed | MPEG-2 stream transfer armed / GPIF active | +| 6 | 0x40 | bmDCtuned | DC offset tuning complete (set for DCII modes) | +| 5 | 0x20 | bmSEL18V | 18V LNB voltage selected (else 13V) | +| 4 | 0x10 | bm22kHz | 22 kHz tone active | +| 3 | 0x08 | bmDVBmode | DVB mode enabled | +| 2 | 0x04 | bmIntersilOn | LNB power supply enabled | +| 1 | 0x02 | bm8pskFW_Loaded | BCM4500 firmware loaded | +| 0 | 0x01 | bm8pskStarted | Device booted and running | + +## IRAM Storage Address + +The status byte is stored at a different IRAM address depending on firmware version: + +| Firmware | IRAM Address | +|----------|-------------| +| v2.06 | 0x6D | +| Rev.2 v2.10.4 | 0x4E | +| v2.13 | 0x4F | + +## Bit Details + +### Bit 0: bm8pskStarted + +Set when BOOT_8PSK (0x89, wValue=1) completes successfully. The kernel driver checks this bit first. If clear, it sends BOOT_8PSK to power on the demodulator. + +### Bit 1: bm8pskFW_Loaded + +Indicates that the BCM4500 firmware has been loaded. On the SkyWalker-1, the BCM4500 runs from internal mask ROM, so this bit is **always set** after boot. The kernel driver checks this to decide whether to send LOAD_BCM4500 (0x88), which STALLs on the SkyWalker-1 since it is unnecessary. + +### Bit 2: bmIntersilOn + +Set when START_INTERSIL (0x8A, wValue=1) enables the LNB power supply. The name "Intersil" refers to the LNB voltage regulator IC manufacturer. + +### Bit 3: bmDVBmode + +Set when DVB-S mode is enabled via SET_DVB_MODE (0x8E). On SkyWalker-1, this command STALLs -- the bit is managed internally by the tuning dispatch logic. + +### Bit 4: bm22kHz + +Reflects the current state of the 22 kHz tone (SET_22KHZ_TONE, 0x8C). Set when the tone is active (high band), clear when inactive (low band). + +### Bit 5: bmSEL18V + +Reflects the current LNB voltage selection (SET_LNB_VOLTAGE, 0x8B). Set for 18V (horizontal/circular-left), clear for 13V (vertical/circular-right). + +### Bit 6: bmDCtuned + +Set when tuning to a Digicipher II (DCII) modulation mode. Cleared for all other modulation types (DVB-S, Turbo, DSS, BPSK). The tuning dispatch logic manages this bit during TUNE_8PSK (0x86) processing. + +### Bit 7: bmArmed + +Set when ARM_TRANSFER (0x85, wValue=1) starts the MPEG-2 transport stream. Cleared when ARM_TRANSFER (0x85, wValue=0) stops it. While set, the [GPIF engine](/bcm4500/gpif-streaming/) is continuously reading data from the BCM4500 into the EP2 FIFO. + +## Typical Values + +| State | Value | Bits Set | +|-------|-------|----------| +| After power-on (before boot) | 0x00 | None | +| After BOOT_8PSK | 0x03 | bm8pskStarted + bm8pskFW_Loaded | +| After LNB enable + 18V + tone | 0x37 | Started + FW + Intersil + 18V + 22kHz | +| Streaming DVB-S | 0xB7 | Above + bmArmed | +| Streaming DCII | 0xF7 | Above + bmDCtuned | + + diff --git a/site/src/content/docs/usb/interface.mdx b/site/src/content/docs/usb/interface.mdx new file mode 100644 index 0000000..e36e7ca --- /dev/null +++ b/site/src/content/docs/usb/interface.mdx @@ -0,0 +1,105 @@ +--- +title: USB Interface +description: USB VID/PID table, endpoint map, descriptors, and warm boot behavior for the SkyWalker-1. +--- + +import { Badge, Aside } from '@astrojs/starlight/components'; + +## VID/PID Table + +All Genpix products share USB Vendor ID `0x09C0`: + +| PID | Product | State | Notes | +|-----|---------|-------|-------| +| 0x0200 | 8PSK-to-USB2 Rev.1 | | Requires FW01 upload to RAM | +| 0x0201 | 8PSK-to-USB2 Rev.1 | | Requires FW02 (BCM4500 firmware) | +| 0x0202 | 8PSK-to-USB2 Rev.2 | | Boots from EEPROM | +| 0x0203 | **SkyWalker-1** | | Boots from EEPROM | +| 0x0204 | SkyWalker-1 (alternate) | | Boots from EEPROM | +| 0x0205 | SkyWalker-2 | -- | Not in kernel 6.16.5 | +| 0x0206 | SkyWalker CW3K | | Requires CW3K_INIT (0x9D) | + +PID `0x0203` was added to the Linux kernel `dvb_usb_gp8psk` device table after v6.6.1. + +## Endpoint Map + +| Property | Value | +|----------|-------| +| Control endpoint | EP0 (default pipe, vendor requests) | +| Bulk IN endpoint | EP2 (address 0x82) -- MPEG-2 transport stream | +| Generic bulk CTRL endpoint | 0x01 (BCM4500 FW02 upload, Rev.1 only) | + +## Streaming Properties + +| Property | Value | +|----------|-------| +| URB count | 7 | +| URB buffer size | 8192 bytes each | +| Stream type | USB_BULK | +| FX2 controller type | CYPRESS_FX2 | + +## EP2 Endpoint Configuration + +```c title="EP2CFG Register (0xE610)" +EP2CFG = 0xE2; // valid=1, dir=IN, type=BULK, size=512, buf=DOUBLE +``` + +| Bit | Value | Meaning | +|-----|-------|---------| +| 7 (VALID) | 1 | Endpoint enabled | +| 6 (DIR) | 1 | IN (device to host) | +| 5:4 (TYPE) | 10 | Bulk transfer | +| 3 (SIZE) | 0 | 512-byte packets | +| 1:0 (BUF) | 10 | Double-buffered | + +EP4, EP6, and EP8 are disabled (`&= ~bmVALID`). Only EP2 is used for data streaming. + +## Warm Boot Behavior + +The SkyWalker-1 (PID 0x0203) enumerates directly as a "warm" device. The DVB-USB framework skips firmware download when `cold_ids` is NULL. No host-side firmware files are required. + +| Device | PID | Needs FW01? | Needs FW02? | Boot Source | +|--------|-----|-------------|-------------|-------------| +| Rev.1 Cold | 0x0200 | Yes | -- | RAM (empty) | +| Rev.1 Warm | 0x0201 | No | Yes | RAM (FW01 loaded) | +| Rev.2 | 0x0202 | No | No | EEPROM | +| SkyWalker-1 | 0x0203 | No | No | EEPROM | +| SkyWalker CW3K | 0x0206 | No | No | EEPROM | + + + +## USB Control Transfer Protocol + +All vendor commands use USB control transfers with these common parameters: + +| Parameter | Value | +|-----------|-------| +| bmRequestType | `USB_TYPE_VENDOR` (0x40 for OUT, 0xC0 for IN) | +| Timeout | 2000 ms | +| Retry | Up to 3 attempts for IN operations if partial data received | +| Data buffer maximum | 80 bytes (kernel driver) | + +See [Vendor Commands](/usb/vendor-commands/) for the complete command reference. + +## Kernel Driver Modules + +The Linux kernel uses two modules for the SkyWalker-1: + +| Module | Function | +|--------|----------| +| `dvb_usb_gp8psk` | USB transport layer, device management, firmware loading | +| `gp8psk_fe` | DVB frontend operations (demodulation, tuning, signal status) | + + diff --git a/site/src/content/docs/usb/vendor-commands.mdx b/site/src/content/docs/usb/vendor-commands.mdx new file mode 100644 index 0000000..41cae21 --- /dev/null +++ b/site/src/content/docs/usb/vendor-commands.mdx @@ -0,0 +1,177 @@ +--- +title: Vendor Commands +description: Complete USB vendor command reference with bRequest codes, parameters, and firmware version compatibility. +--- + +import { Tabs, TabItem, Badge, Aside } from '@astrojs/starlight/components'; + +All vendor commands use USB control transfers with `USB_TYPE_VENDOR` (bmRequestType bit 6 set). The vendor command dispatcher at CODE:0056 validates `bRequest` in the range 0x80--0x9D (30 entries for v2.06/v2.13) or 0x80--0x9A (27 entries for Rev.2) and dispatches via an indexed jump table at CODE:0076. + + + + + + +## Stock Command Table (0x80--0x9D) + +| Cmd | Name | Dir | wValue | wIndex | wLength | Purpose | v2.06 | Rev.2 | v2.13 | +|-----|------|-----|--------|--------|---------|---------|-------|-------|-------| +| 0x80 | GET_8PSK_CONFIG | IN | 0 | 0 | 1 | Read [configuration status byte](/usb/config-status/) | | | | +| 0x81 | SET_8PSK_CONFIG | OUT | varies | 0 | 0 | Set config (reserved) | | | | +| 0x82 | (reserved) | -- | -- | -- | -- | Reserved | | | | +| 0x83 | I2C_WRITE | OUT | dev_addr | reg_addr | N | Write to I2C device | | | | +| 0x84 | I2C_READ | IN | dev_addr | reg_addr | N | Read from I2C device | | | | +| 0x85 | ARM_TRANSFER | OUT | 0/1 | 0 | 0 | Start (1) / stop (0) MPEG-2 stream | | | | +| 0x86 | TUNE_8PSK | OUT | 0 | 0 | 10 | Set [tuning parameters](/bcm4500/tuning-protocol/) | | | | +| 0x87 | GET_SIGNAL_STRENGTH | IN | 0 | 0 | 6 | Read [SNR and diagnostics](/bcm4500/signal-monitoring/) | | | | +| 0x88 | LOAD_BCM4500 | OUT | 1 | 0 | 0 | Initiate BCM4500 FW download | | | | +| 0x89 | BOOT_8PSK | IN | 0/1 | 0 | 1 | Power on (1) / off (0) demodulator | | | | +| 0x8A | START_INTERSIL | IN | 0/1 | 0 | 1 | Enable (1) / disable (0) LNB supply | | | | +| 0x8B | SET_LNB_VOLTAGE | OUT | 0/1 | 0 | 0 | 13V (0) or 18V (1) | | | | +| 0x8C | SET_22KHZ_TONE | OUT | 0/1 | 0 | 0 | Tone off (0) or on (1) | | | | +| 0x8D | SEND_DISEQC_COMMAND | OUT | msg[0] | 0 | len | DiSEqC message or tone burst | | | | +| 0x8E | SET_DVB_MODE | OUT | 1 | 0 | 0 | Enable DVB-S mode | | | | +| 0x8F | SET_DN_SWITCH | OUT | cmd7bit | 0 | 0 | Legacy Dish Network switch protocol | | | | +| 0x90 | GET_SIGNAL_LOCK | IN | 0 | 0 | 1 | Read [signal lock status](/bcm4500/signal-monitoring/) | | | | +| 0x92 | GET_FW_VERS | IN | 0 | 0 | 6 | Read firmware version + build date | | | | +| 0x93 | GET_SERIAL_NUMBER | IN | 0 | 0 | 4 | Read 4-byte serial from EEPROM | | | | +| 0x94 | USE_EXTRA_VOLT | OUT | 0/1 | 0 | 0 | Enable +1V LNB boost (14V/19V) | | | | +| 0x95 | GET_FPGA_VERS | IN | 0 | 0 | 1 | Read EEPROM hardware/platform ID | | | | + +### Detailed Parameter Formats + +**0x87 GET_SIGNAL_STRENGTH**: Returns 6 bytes. Bytes 0--1 contain a 16-bit SNR value (little-endian, dBu x 256 units). Bytes 2--5 are reserved/diagnostic BCM4500 registers. Version differences: v2.06 polls 3 registers (0xA2, 0xA8, 0xA4) up to 6 times; v2.13 consolidates to 1 register with a simplified poll. + +**0x8D SEND_DISEQC_COMMAND**: When `wLength > 0`, the payload is a standard DiSEqC message (3--6 bytes) with `wValue` set to `msg[0]` (framing byte, typically 0xE0 or 0xE1). When `wLength == 0` and `wValue == 0`, tone burst A is sent. When `wLength == 0` and `wValue != 0`, tone burst B is sent. + +**0x8F SET_DN_SWITCH**: `wValue` carries a 7-bit Dish Network switch command (LSB-first), bit-banged on GPIO P0.4 with specific timing. The 8th bit (0x80) of the original switch command selects LNB voltage and is sent separately via SET_LNB_VOLTAGE. + +**0x92 GET_FW_VERS**: Returns 6 bytes of hardcoded constants: + +```c title="GET_FW_VERS Response Format" +Byte 0: version minor_minor (e.g., 0x04) +Byte 1: version minor (e.g., 0x06) +Byte 2: version major (e.g., 0x02) +Byte 3: build day (e.g., 0x0D = 13) +Byte 4: build month (e.g., 0x07 = July) +Byte 5: build year - 2000 (e.g., 0x07 = 2007) + +Full version = byte[2] << 16 | byte[1] << 8 | byte[0] +Build date = (2000 + byte[5]) / byte[4] / byte[3] +``` + +**0x93 GET_SERIAL_NUMBER**: Returns 4 bytes read from I2C EEPROM at device address 0x51 (7-bit), extracted at 8-bit intervals using a shift/rotate routine. + +**0x94 USE_EXTRA_VOLT**: `wValue=1` writes 0x6A to XRAM 0xE0B6; `wValue=0` writes 0x62. The difference is bit 3 (0x08), which controls the voltage boost on the LNB power regulator. + +**0x95 GET_FPGA_VERS**: Reads from I2C EEPROM at 0x51. Despite the name, there is no FPGA on the SkyWalker-1 -- this returns a hardware platform ID. v2.06 reads EEPROM offset 0x31 (2 bytes); v2.13/Rev.2 read offset 0x00 (1 byte). + + + + +## Debug Commands (0x91, 0x96--0x98) + +These commands are not used by any driver (Linux or Windows). They appear to be manufacturing/debug interfaces. + +| Cmd | Name | Dir | wValue | wLength | Purpose | v2.06 | Rev.2 | v2.13 | +|-----|------|-----|--------|---------|---------|-------|-------|-------| +| 0x91 | I2C_ADDR_ADJUST | IN | 0=dec, 1=inc | 1 | Inc/dec internal IRAM counter | | | | +| 0x96 | SET_LNB_GPIO_MODE | OUT | 0/1 | 0 | Configure LNB GPIO output enables | | | | +| 0x97 | SET_GPIO_PINS | OUT | bitmap | 0 | Direct write to LNB GPIO pins | | | | +| 0x98 | GET_GPIO_STATUS | IN | 0 | 1 | Read LNB feedback GPIO pin | | | | + +### 0x91 I2C_ADDR_ADJUST + +Increments (`wValue != 0`) or decrements (`wValue == 0`) an internal IRAM counter and returns its current value (1 byte). The counter lives at IRAM 0x66 (v2.06) or IRAM 0x18 (v2.13/Rev.2). Likely used for I2C address or tuner register index adjustment during development. + +### 0x96 SET_LNB_GPIO_MODE + +Configures GPIO output enable registers for the LNB voltage regulator hardware: + +| Mode | v2.06/v2.13 | Rev.2 | +|------|-------------|-------| +| Default (wValue=0) | OEB=0xF0 | OEB=0xE7, OEA=0x9E | +| Active (wValue=1) | IOB=(IOB & 0xF7) OR 0x06; OEB=0xFE | IOB.4 clear; P0.6, P0.0 set; OEA OR= 0x41 | + +### 0x97 SET_GPIO_PINS + +Direct GPIO pin write for LNB control: + +| wValue Bit | v2.06/v2.13 Target | Rev.2 Target | +|-----------|-------------------|-------------| +| bit 1 | IOB.1 (Port B) | P0.6 (Port A) | +| bit 2 | IOB.2 (Port B) | P0.0 (Port A) | +| bit 3 | IOB.3 (Port B) | IOB.4 (Port B) | + +### 0x98 GET_GPIO_STATUS + +Returns 1 byte (0 or 1) from a single GPIO input pin -- likely an LNB overcurrent or power-good feedback signal: + +| Version | Pin Read | +|---------|----------| +| v2.06/v2.13 | IOB.0 (Port B bit 0) | +| Rev.2 | P0.5 (Port A bit 5) | + + + + +## Extended Commands (0x99--0x9D) + +| Cmd | Name | Dir | wValue | wLength | Purpose | v2.06 | Rev.2 | v2.13 | +|-----|------|-----|--------|---------|---------|-------|-------|-------| +| 0x99 | GET_DEMOD_STATUS | IN | 0 | 1 | Read BCM4500 register 0xF9 | | | | +| 0x9A | INIT_DEMOD | OUT | 0 | 0 | Trigger demod re-init (3 attempts) | | | | +| 0x9B | (reserved) | -- | -- | -- | Reserved | | | | +| 0x9C | DELAY_COMMAND | OUT | delay | 0 | Host-controlled tuning delay + poll | | | | +| 0x9D | CW3K_INIT / SET_MODE_FLAG | OUT | 0/1 | 0 | CW3K init or conditional demod reset | | | | + +### Driver Usage Notes + +- The Linux driver only sends LOAD_BCM4500 (0x88) for Rev.1 Warm (PID 0x0201). On SkyWalker-1, `bm8pskFW_Loaded` is already set and 0x88 routes to STALL. +- The Linux driver only sends CW3K_INIT (0x9D) for SkyWalker CW3K (PID 0x0206). +- Rev.2 supports only commands 0x80--0x9A (27 entries). Commands 0x9B--0x9D are out of range and produce undefined behavior. + + + + +## Custom Firmware Commands (0xB0--0xB6) + +Commands added in custom firmware v3.01.0 for development and diagnostics: + +| Cmd | Name | Dir | wValue | wIndex | wLength | Purpose | +|-----|------|-----|--------|--------|---------|---------| +| 0xB0 | SPECTRUM_SWEEP | OUT | 0 | 0 | 10 | Step through freq range, read SNR at each step | +| 0xB1 | RAW_DEMOD_READ | IN | reg | 0 | 1 | Read BCM4500 indirect register | +| 0xB2 | RAW_DEMOD_WRITE | OUT | reg | data | 0 | Write BCM4500 indirect register | +| 0xB3 | BLIND_SCAN | OUT | 0 | 0 | 16 | Try symbol rates at given freq, report lock | +| 0xB4 | I2C_BUS_SCAN | IN | 0 | 0 | 16 | Probe all 7-bit addresses, return 16-byte bitmap | +| 0xB5 | I2C_RAW_READ | IN | addr7 | reg | N | Combined write-read from any I2C device | +| 0xB6 | I2C_DIAG | IN | page | 0 | 8 | Step-by-step indirect register diagnostic | + +### Parameter Formats + +**0xB0 SPECTRUM_SWEEP**: 10-byte EP0 payload: `[start_freq(u32 LE kHz), stop_freq(u32 LE kHz), step_khz(u16 LE)]`. Programs BCM4500 at each frequency step, reads SNR, packs u16 LE results into EP2 bulk FIFO. + +**0xB3 BLIND_SCAN**: 16-byte EP0 payload: `[freq_khz(u32 LE), sr_min(u32 LE sps), sr_max(u32 LE sps), sr_step(u32 LE sps)]`. Returns 8 bytes on lock `[freq_khz(4) + sr_locked(4)]` or 1 byte 0x00 if no lock found. + +**0xB4 I2C_BUS_SCAN**: Returns a 16-byte bitmap (128 bits for addresses 0x00--0x77). Each bit set = ACK received at that 7-bit address. + + + + +## Vendor Command Dispatch Mechanism + +The dispatch logic at CODE:0056 (identical address across all stock versions): + +``` +1. Check bmRequestType bit 6 -> vendor request? +2. Read bRequest from SETUPDAT[1] +3. Subtract 0x80 (command base offset) +4. Compare against maximum: < 0x1E (v2.06/v2.13) or < 0x1B (Rev.2) +5. If in range: double the index (2 bytes per AJMP) -> JMP @A+DPTR +6. If out of range: route to STALL handler +``` + +The jump table at CODE:0076 contains 2-byte AJMP instruction targets, one per command from 0x80 upward. diff --git a/site/src/styles/custom.css b/site/src/styles/custom.css new file mode 100644 index 0000000..e634f0c --- /dev/null +++ b/site/src/styles/custom.css @@ -0,0 +1,69 @@ +/* Teal/Steel Engineering Theme for SkyWalker-1 Docs */ + +:root { + --sl-color-accent-low: #0d3b3b; + --sl-color-accent: #1a8a8a; + --sl-color-accent-high: #b8e6e6; + --sl-hue: 180; + --sl-color-white: #f0f4f5; + --sl-color-gray-1: #dde4e6; + --sl-color-gray-2: #b8c4c8; + --sl-color-gray-3: #7a8f96; + --sl-color-gray-4: #4a5c63; + --sl-color-gray-5: #2a3a40; + --sl-color-gray-6: #1a2a30; + --sl-color-black: #0e1519; +} + +:root[data-theme='light'] { + --sl-color-accent-low: #d0f0f0; + --sl-color-accent: #0d7377; + --sl-color-accent-high: #043d3f; + --sl-color-white: #1a2a30; + --sl-color-gray-1: #2a3a40; + --sl-color-gray-2: #4a5c63; + --sl-color-gray-3: #7a8f96; + --sl-color-gray-4: #b8c4c8; + --sl-color-gray-5: #dde4e6; + --sl-color-gray-6: #eef2f3; + --sl-color-black: #f5f8f9; +} + +/* Ensure link colors use teal */ +:root { + --sl-color-text-accent: var(--sl-color-accent); +} + +/* Table styling for hardware register tables */ +table { + font-size: 0.9rem; +} + +th { + background-color: var(--sl-color-gray-6); +} + +/* Code block enhancement */ +.expressive-code { + --ec-brdCol: var(--sl-color-gray-5); +} + +/* Badge color overrides for hardware status */ +.sl-badge--success { + --sl-color-bg-badge: #0d5e3a; + color: #a8e6cf; +} + +.sl-badge--danger { + --sl-color-bg-badge: #5e1a0d; + color: #e6b8a8; +} + +/* Mobile horizontal scroll for wide tables */ +@media (max-width: 50rem) { + table { + display: block; + overflow-x: auto; + -webkit-overflow-scrolling: touch; + } +} diff --git a/site/tsconfig.json b/site/tsconfig.json new file mode 100644 index 0000000..48285b0 --- /dev/null +++ b/site/tsconfig.json @@ -0,0 +1,3 @@ +{ + "extends": "astro/tsconfigs/base" +}