15 Commits

Author SHA1 Message Date
dsbaha
98e48d9a34 docs: add Fedora CoreOS setup guide (#25)
New container-focused setup guide for Fedora CoreOS on the BC-250.
Covers ignition prerequisites, ACPI fix via dracut, Cyan Skillfish
governor via COPR, hardware monitor (nct6683), 40 CU unlock via UMR
systemd service, 14.75GB VRAM allocation with initramfs sync, and
Spectre mitigations toggle. Notes Zincati auto-upgrade persistence
and Podman GPU passthrough. Adds nav entry under Linux Setup.
Closes #25.
2026-06-01 10:33:58 -07:00
Naster
8961369398 linux: Alpine Setup guide (#20)
New Alpine guide covering kernel selection, AMDGPU/Vulkan stack,
extlinux/GRUB kargs, and a manual SMU governor build with an
OpenRC service + D-Bus policy. Adds nav entry, README/index
mentions, and an Alpine row in the distribution comparison.
Note: the "D-Bus AccessDenied Error" troubleshooting entry is
missing its solution paragraph will follow up in a small fix
commit after merge.

Closes #20.
2026-06-01 06:59:01 -07:00
Martin
1ee3e0b83c docs: add 40 CU unlock page
Dedicated page for duggasco's BC-250 40 CU unlock work
(github.com/duggasco/bc250-40cu-unlock), summarising the kernel patch,
the dual-register architecture (CC + SPI), install paths, verification,
and the governor and thermal context needed to actually run it.

Adds:
- step-by-step install via the upstream build script, manual patch, and
  Arch/CachyOS path
- Fedora-specific build notes (kernel-devel is incomplete and
  EXTRAVERSION + utsrelease.h need to be patched to avoid a vermagic
  mismatch), verified on kernel 7.0.9-105.fc43.x86_64
- real captured verification output (dmesg, sysfs, vulkaninfo) from a
  working install instead of paraphrased examples
- sustained 10-min llama-bench thermal data on dual P12 Max with the
  stock heatsink, framing why effective cooling matters for full-CU OC
- selective CU masking pointer to duggasco's health test workflow
- governor sweet-spot config (1500 MHz / 900 mV) and a recommended
  voltage curve

Linked from the System Configuration section of the nav.
Full credit to duggasco throughout, plus links to the technical report
and whitepaper.
2026-05-30 23:40:52 +02:00
martin dolez
8f9a5bf207 site: add GitHub star/Discussions CTA banner and home section (#27)
Two small additions to make it easier for readers to find their way back
to the GitHub side of the project (stars, Discussions, PRs):

- overrides/main.html: site-wide announce banner with links to the repo
  and Discussions. Uses Material's announce block, dismissable by the
  reader once they've seen it
- mkdocs.yml: enable custom_dir for the override and add
  announce.dismiss to theme features
- docs/index.md: replace the brief Contributing paragraph with a
  Get Involved card grid (Star, Discussions, PRs, Issues). Sits on the
  home page where most first-time visitors land

No content changes outside of these blocks.
2026-05-30 23:21:31 +02:00
Martin
ba56e4baa6 feat(cases): community cases catalogue with 145 designs
- Full searchable/filterable catalogue of BC-250 cases and enclosures
- 145 designs documented from Discord, Reddit, Printables, MakerWorld, Thingiverse
- Grid/list view toggle, PSU filter, availability filter, text search
- REMIX badges for derivative designs
- Discord section with visual separator for community-only projects
- Uniform card height with hover-expand for full description
- Real thumbnails fetched from public sources (72/145)
- All descriptions rewritten in English, sourced from platform pages and Discord
2026-03-16 01:52:36 +01:00
Martin
782b7cd208 remove footer copyright notice 2026-03-10 20:18:47 +01:00
Martin
a23e649dab Add hardware pinouts and update from upstream documentation
- Add new hardware pinouts page with detailed connector information
- Add J2000/J2001 power connector pinouts to power requirements
- Update VCN section to explain Sony is blocking firmware release
- Update kernel version info on index page (6.17.11+ now works)

Source: https://github.com/mothenjoyer69/bc250-documentation
Credits: mothenjoyer69, Segfault/TuxThePenguin0, neggles, yeyus
2025-12-19 22:14:56 +01:00
Martin
42c36c0d88 Remove outdated fedora-setup.sh script and update repository links
- Replace deprecated fedora-setup.sh with modern manual installation steps
  * Mesa 25.1+ now included in Fedora 43 repos (no COPR needed)
  * Governor installation via @exotic-soc/oberon-governor COPR
  * Updated in quick-start.md and troubleshooting/display.md

- Fix idle power specifications in prerequisites.md
  * Corrected minimum idle power: 70-85W (was incorrectly 50-80W)
  * Added note about GPU freq patch increasing max power to 250W+

- Update footer GitHub link to elektricM/amd-bc250-docs
  * Changed from mothenjoyer69/bc250-documentation
  * Updated in mkdocs.yml and introduction.md

All changes verified with mkdocs build --strict (no warnings).
2025-11-22 16:54:24 +01:00
Martin
007646a1ca Enable edit button and move Contribute to top of navigation
- Add edit_uri to enable GitHub edit button on all pages
- Enable content.action.edit and content.action.view features
- Move Contribute page to top of navigation (right after Home)
- Now users can easily click edit icon to contribute
2025-11-22 00:05:15 +01:00
Martin
7c9c0a67a7 Add contribution guidelines and clean up internal files
- Add CONTRIBUTING.md with detailed contribution guide
- Add docs/contribute.md page in documentation site
- Update README.md to emphasize community collaboration
- Remove internal project files from repository (DEV.md, PROJECT_STATUS.md, etc.)
- Update .gitignore to exclude internal working files
2025-11-21 23:59:59 +01:00
Martin
e6624a8791 Major documentation expansion from Discord forum analysis
Added 13 new comprehensive documentation pages (~200KB content):

Distribution Guides (4 pages):
- Bazzite: Standard and performance 'steroids' configurations
- CachyOS: Custom ISO builds, BORE scheduler, performance tuning
- Arch Linux: Including Manjaro with community automation scripts
- Debian: Including PikaOS, experimental repos, power efficiency

Troubleshooting Guides (3 pages):
- Boot Problems: Black screen, nomodeset, GRUB, kernel panics
- Performance Issues: GPU governor, frequency scaling, thermal
- Stability Problems: Crashes, voltage tuning, ZRAM conflicts

Drivers & Graphics Section (2 pages):
- RADV Driver: Mesa 25.1+ requirements, BC-250 configuration
- Environment Variables: RADV_DEBUG, AMD GPU vars, per-game settings

System Configuration (2 pages):
- Sensors & Monitoring: NCT6683/NCT6687, lm-sensors, CoolerControl
- Power Management: PSU requirements, undervolting, optimization

BIOS Documentation Updates:
- GPU Frequency Patch: ViRazY kernel patch (350-2230 MHz range)
  - Installation methods, performance gains (+50% some games)
  - Compatibility matrix for all distributions
- BIOS Flashing: P5.00_clv info, version differences, DP audio warning

Navigation Updates:
- Added Drivers & Graphics section
- Expanded Linux Setup from 4 to 8 pages
- Expanded Troubleshooting from 1 to 4 pages
- Expanded System Configuration from 1 to 3 pages

Source Material:
- 7 bc250-resources forum threads exported and analyzed
- 100+ Discord messages per thread
- Cross-referenced with parsed community content
- All technical info verified for accuracy

Total: 33 comprehensive documentation pages
Build: Passes strict mode with no warnings
2025-11-21 23:24:21 +01:00
Martin
8c4de755d7 Add comprehensive distribution setup guides
- Add Bazzite setup guide with standard and performance configurations
- Add CachyOS installation guide with custom ISO build methods
- Add Arch Linux and Manjaro setup with community scripts
- Add Debian and PikaOS setup guide
- Update navigation to include all distribution guides
- All content extracted from bc250-resources forum threads
- Cross-referenced with parsed Discord content for accuracy
2025-11-21 22:57:24 +01:00
Martin
87edbbfa2b Fix strict build: remove non-existent pages from nav and fix broken links 2025-11-21 22:20:25 +01:00
Martin
daf9cfaf6b Update GitHub URLs with correct username 2025-11-21 22:08:01 +01:00
Martin
b3bf9eb724 Initial commit: AMD BC250 Documentation
- MkDocs site with Material theme (teal/cyan, system theme matching)
- 20 comprehensive documentation pages
- Content from 9,716 Discord messages + GitHub sources
- GitHub Actions workflow for automated deployment
- Custom compact styling optimized for wide displays

Coverage:
- Getting Started (3 pages)
- Hardware (4 pages)
- BIOS & Firmware (4 pages)
- Linux Setup (4 pages)
- System Configuration (1 page)
- Gaming & Performance (1 page)
- Troubleshooting (1 page)
- Reference (1 page)
2025-11-21 21:59:00 +01:00