Skip to content

carlos-nader/tms-dms-cms-usage-guide

TMS/DMS/CMS Usage Guide for Falcon BMS and other F-16 Flight Simulators

pages-build-deployment Travis CI CodeScene Average Code Health Documentation Status

Changelog Setup Guide

GitHub stars GitHub forks

A comprehensive guide documenting F-16 HOTAS switch systems (Target Management Switch, Display Management Switch, and Countermeasures Management Switch) for Falcon BMS and other F-16 flight simulators.

The author is not affiliated with or endorsed by Falcon BMS or any other flight sim developers. This is not an official guide or manual. It aims to help the flight sim community by consolidating information that is otherwise scattered across multiple manuals, training materials, and community resources into a single, structured reference.


🚀 Quick Start

  1. 📕 Read the Guide: See Main Guide Files Section below
  2. 🌐 Explore the Website: Project documentation site
  3. 📖 Read Online: Read the Docs
  4. 💬 Join Discussion: BMS Forum Thread
  5. ⭐ Star this repo if you find it useful!

📄 Main Guide Files

Version

Alpha

Format Link Description
📄 LaTeX Source guide.tex Editable source file
📕 Compiled PDF guide.pdf Ready-to-read document

👆 Click the links above to access the guide! 👆

⚠️ Style Revision in Progress (v0.4.2.0)
A dedicated style revision pass is currently underway to improve clarity and directness across all chapters. The guide, in its current version is fully accessible and technically accurate. Expected completion: 2026-03-20.


📊 Current Version — Official Guide

Metric Value
Guide Version v0.4.1.0
Phase Pre-publication (0.x.x.x)
Chapters Planned 6
Chapters with Content 4 (C1, C2, C3, C5)
Chapters with Style Revision Complete 0 (in progress: C5)
Next Target v0.4.2.0 — Style Full Revision

🗄️ WIP Snapshot — Active Work-in-Progress Files

Status File Name Last Modified
🟢 alpha chapter-C1-style-rev-alpha-2026-03-24.tex 2026-03-25
🟢 alpha chapter-C2-style-rev-alpha-2026-03-30.tex 2026-03-30
🟡 review chapter-C3-style-rev-review-2026-03-30.tex 2026-03-30
🟠 dev chapter-C4-tms-structure-dev-2026-02-13.tex 2026-03-25
🟢 alpha chapter-C5-style-rev-alpha-2026-03-30.tex 2026-03-30
🟡 review section-C4-S3-tms-aa-review-2026-02-17.tex 2026-03-25

Legend: 🟠 dev 🟡 review ⚪ final 🟢 alpha

For integrated files, see the archive/WIP/ folder.


📈 Development Activity (since Feb. 12th, 2026)

wakatime

Transparent accumulated time tracking via WakaTime specifically for this repository.


📖 About This Project

GitHub Pages Read the Docs Perplexity Claude GitHub Copilot Falcon BMS

This project develops a structured guide explaining the F-16 HOTAS TMS, DMS and CMS switch functionality, grounded in Falcon BMS manuals (Dash-34, Dash-1) and training materials.


📁 Project Structure

Project Overview

Open in ToDiagram

Files Tree

tms-dms-cms-usage-guide/
│
├── guide.tex                         # Current production version (.tex)
├── guide.pdf                         # Compiled PDF
├── INTEGRATED-FILES.md               # Auto-generated tracking report
├── CHANGELOG.md                      # Releases changelog tracking
├── SETUP.md                          # Infrastructure setup
├── mkdocs.yml                        # MkDocs configuration (web publication)
├── .readthedocs.yaml                 # Read the Docs build configuration
├── .gitbook.yaml                     # GitBook configuration
│
├── docs-web/                         # Markdown source for web publication (Read the Docs / GitBook)
│   ├── index.md                      # Landing page
│   └── c*-[chapter-title].md         # One file per chapter
│
├── docs/                             # Governance & tracking
│   ├── briefing.md
│   ├── wip-naming.md
│   ├── version-system.md
│   ├── project-tracking.md
│   ├── tex-preamble-consolidated.md
│   ├── guide-web.pdf                 # guide.pdf copy for GitHub Pages
│   ├── index.html                    # GitHub Pages landing page
│   ├── contributing.html             # Contributing page (GitHub Pages)
│   ├── WIP-Snapshot-Generator-v3.1.html
│   └── *.svg                         # Diagrams (repo overview, issue map, web publication flow)
│
├── wip/                              # Active work-in-progress files
│   ├── chapter-*.tex                 # Chapter drafts
│   ├── section-*.tex                 # Section drafts
│   └── guide/                        # Active guide snapshots
│
├── archive/                          # Historical & approved files
│   ├── WIP/                          # Integrated/deprecated WIP files
│   ├── GUIDE/                        # Older guide versions
│   └── GUIDE-STRUCTURE/              # Older structure-only files
│
├── template/                         # Templates & blueprints
│   └── template-wip.tex              # Canonical WIP template
│
├── fig/                              # Images used in the guide
├── misc/                             # Miscellaneous resources
│   └── STYLE-GUIDE.md
├── scripts/                          # Automation scripts
├── .github/                          # Issues, Actions, PR templates, community files
├── .vscode/                          # VSCode workspace settings
├── .devcontainer/                    # GitHub Codespaces configuration
│
├── LICENSE                           # CC BY-NC 4.0
└── README.md                         # This file

📋 Documentation & Governance

The project uses five governance documents and an auto-generated tracking report:

Document Location Purpose
BRIEFING /docs/ Project scope, content outline, layout standards
STYLE-GUIDE /misc/ Prose style, voice, formatting policies, and prohibited patterns
WIP-NAMING /docs/ Rules for WIP file naming (alpha parallel flow also supported), status lifecycle
VERSION-SYSTEM /docs/ Guide version numbering (0.x.x.x pre-publication, x.y.z post-publication)
PROJECT-TRACKING /docs/ Session log, WIP status snapshot, milestones, current priorities
SETUP / (root) Local infrastructure configuration
INTEGRATED-FILES / (root) Auto-generated report: tracked files, commits, issues, milestones (updated by GitHub Action)

🔄 Workflow

WIP File Lifecycle

  1. Create — Copy template from template/ to wip/
  2. Develop — First draft, status dev
  3. Review — Review work, status review
  4. Finalize — Approved content, status final 4A. Alpha (optional, parallel) — Integrated into pre-release snapshot, status alpha; WIP stays in wip/ pending official integration
  5. Integrate — Merge into guide, move to archive/, status approved

Status Codes

Status Meaning
dev Draft stage, not ready for review
review Under review
final Approved, ready for integration
alpha Integrated into pre-release snapshot (parallel flow only)
approved Integrated and archived
deprecated Retired or superseded

🛠️ Tools & Utilities

Development Environment

  • TeXstudio + MiKTeX — Primary LaTeX IDE for guide compilation and PDF generation
  • Visual Studio Code — Multi-purpose editor for LaTeX, Markdown, scripts, and Copilot/Claude AI integration
  • Git / GitHub Desktop — Version control and repository management
  • GitHub Codespaces — Cloud development environment with LaTeX and tooling pre-configured (Open a Codespace)

Web Publication

  • Read the Docs — Automated web builds from docs-web/ on every push (tms-dms-cms-usage-guide.readthedocs.io)
  • GitBook — Web reading channel and visual Markdown editor, synced with docs-web/

AI Collaboration

  • Perplexity Pro (Perplexity AI) — Research organization, project structuring, governance framework design, initial draft content generation, and review
  • Claude Pro (Anthropic) — Research, initial draft content generation, review, and governance framework; used via web interface and VSCode (Claude Code)
  • GitHub Copilot Pro (GitHub / Microsoft) — Documentation, repository management, issue and pull request coordination, and collaborative development; used via GitHub web interface and VSCode

Project Utilities

  • WIP Snapshot Generator — Interactive HTML tool (WIP Generator v3.1) for generating compliant WIP file names

📚 Sources & References

This guide is grounded in official Falcon BMS documentation:

  • TO 1F-16CMAM-34-1-1 — Falcon BMS Simulator F-16 Avionics & Weapons Manual (Dash-34)
  • TO 1F-16CMAM-1 — Falcon BMS Simulator F-16C/D Flight Manual (Dash-1)
  • Falcon BMS 4.38.1 Training Manual — Training missions guide
  • F-16 Combat Aircraft Fundamentals Handbook (MCH 11-F16 Vol 5) — USAF Multi-Command guidelines

All technical claims are cross-referenced to these sources.

📂 The research documents used in this guide (manuals and other reference materials) are available for download at the Research Sources — MEGA.

✈️ New to Falcon BMS? Visit the official website to download the simulator (free with Falcon 4.0 ownership).


🗺️ Roadmap

Resource Description
Milestones Planned releases
Issues Current tasks
Tags Version history
Issues Dependency Map

Next milestones:

  • v0.4.2.0 — Style Full Revision
  • v0.5.0.0 — Chapter 4 (TMS) integration

🤝 Contributing & Community

Forum Views

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Ways to contribute:

  • Content corrections and accuracy improvements
  • Structural and clarity suggestions
  • New sections or expanded coverage
  • LaTeX compilation or PDF rendering feedback

Community: 💬 Join the discussion on Falcon BMS Forum • ⭐ Star this repo if you find it useful • 👍 Drop a vote or comment on the forum thread


📜 License

License: CC BY-NC 4.0

This project is released under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

You are free to: share, translate, adapt, and enhance this guide with attribution.

Restrictions: No commercial use. Attribution required.

For full legal details, see the LICENSE file.


👥 Credits & Acknowledgments

Project Development:

  • Carlos "Metal" Nader — Project lead, content author
  • AI Assistants for structural guidance, governance framework, Dash-34 research, and initial content drafting — Perplexity Pro and Claude Pro
  • AI Assistant for GitHub coding and repository maintenance — Copilot Pro

Technical References:

  • Falcon BMS (official manuals & training materials)
  • F-16 community knowledge & subject-matter experts

📞 Contact

For questions, suggestions, or feedback:


License: CC BY-NC 4.0 | Guide Status: Pre-publication v0.4.1.0

Alpha pre-release available: v0.4.2.0-alpha.3

About

Structured online and PDF guide for Falcon BMS and other F-16 flight simulators covering TMS, DMS and CMS HOTAS switch functionality and usage

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors

Languages