feat(gameboot-windows): add Windows dual-boot orchestration scripts for FWS gaming

Add PowerShell scripts to manage dual-boot transitions between FWS and Windows 11 for gaming sessions with Valorant.

Includes:
- fws-return.ps1: Arms firmware boot-next (one-shot) to target OS via bcdedit
- fws-play.ps1: Orchestrates Valorant session with robust crash recovery
- Install-FwsGameboot.ps1: Deploys scripts, disables hibernation, creates ONSTART task
- README.md: Documentation on dual-boot workflow and prerequisites

Design principles:
- Minimal footprint, no Vanguard interference (no injection/kernel hooks)
- Permanent fallback: BootOrder[0]=FWS catches unmanaged reboots
- Robust locale-independent bcdedit parsing via EFI paths and GUIDs
- Crash-proof game session: ONSTART task disabled during play to prevent mid-match boot changes
This commit is contained in:
2026-07-08 02:39:27 +02:00
parent 3cb4132727
commit beec38a899
4 changed files with 221 additions and 0 deletions
@@ -0,0 +1,50 @@
# FWS Gameboot — composant Windows
Composant à déployer **dans le Windows 11 gaming** (partition bare-metal dédiée)
pour le dual-boot orchestré « hibernate-swap » de FWS. Il gère le **retour vers
FWS** après une session de jeu.
> ⚠️ **Statut : v1 non validée sur matériel réel.** La sémantique
> `bcdedit /set {fwbootmgr} bootsequence` et le retour au boot dépendent du
> firmware de la carte mère. À tester avant de s'y fier. Voir le plan complet :
> `docs/hibernate-swap-dualboot.md`.
## Fichiers
| Fichier | Rôle |
|---|---|
| `fws-return.ps1` | Arme le boot suivant (one-shot) vers `FWS` ou `Windows`. |
| `fws-play.ps1` | Lance Valorant, attend sa fin/crash, puis rebascule vers FWS. |
| `Install-FwsGameboot.ps1` | Installe le tout + tâche ONSTART + `powercfg /h off`. |
## Installation (dans Windows, PowerShell **admin**)
```powershell
Set-ExecutionPolicy -Scope Process Bypass -Force
.\Install-FwsGameboot.ps1
```
Ces fichiers sont livrés par FWS dans
`/usr/local/share/fws/gameboot-windows/` ; l'outillage d'installation Windows de
FWS (à venir, cf. plan §6) les copiera sur la partition Windows. En attendant,
copie ce dossier à la main sur le Windows cible.
## Comment ça marche
1. Depuis FWS : `fws-gameboot to-windows` hiberne FWS et arme le boot suivant
vers Windows.
2. Windows démarre en **bare-metal** → Vanguard voit un vrai Windows natif.
3. Au démarrage, la tâche **ONSTART** arme le boot suivant vers FWS (filet
anti-crash).
4. `fws-play.ps1` (auto au login gaming, ou manuel) ré-arme Windows le temps du
jeu, puis, à la fermeture/crash de Valorant, arme FWS et redémarre.
5. FWS reprend sa session hibernée via `resume=`.
Filet permanent : côté FWS, `BootOrder[0] = FWS` est ré-affirmé à chaque
démarrage — tout reboot non géré retombe sur FWS.
## Rappels
- **BitLocker** : ne pas l'activer sans sauvegarder la clé (le flip Secure Boot
côté FWS change PCR7 → écran de récupération). `manage-bde -status` pour vérifier.
- Ne pas désactiver **Secure Boot / TPM / VBS-HVCI** : Vanguard les exige.