<!-- Canonical source: https://github.com/deancochran/ftms/blob/2586e33ac88d5d945d9658e063bb909cd58462bd/site/landing.md; revision: 2586e33ac88d5d945d9658e063bb909cd58462bd -->

# FTMS Protocol Libraries

## Your Bluetooth stack. Shared protocol foundations.

Replace handwritten Fitness Machine Service packet parsing with typed values,
explicit diagnostics, and bidirectional codecs. Build a fitness application,
embedded integration, or protocol tool without taking on another connection stack.

[Understand FTMS: from bytes to a workout](https://deancochran.github.io/ftms/start/ftms-explained/index.md). See how eight
bytes become speed, cadence and power, how control messages work, and why a shared
codec saves applications from maintaining the same protocol logic.

| Build with | What you get                                                               | Start                                                                              |
| ---------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| C          | Portable C99 with C++ consumers, fixed-point values, caller-owned memory   | [Install the source archive](https://deancochran.github.io/ftms/start/c/index.md)  |
| C#         | Managed .NET codecs and capability evidence                                | [C# package guide](https://deancochran.github.io/ftms/start/csharp/index.md)       |
| Dart       | Pure Dart codecs for Dart and Flutter applications                         | [Dart package guide](https://deancochran.github.io/ftms/start/dart/index.md)       |
| Go         | Raw codecs and capability evidence for Go applications                     | [Go package guide](https://deancochran.github.io/ftms/start/go/index.md)           |
| Kotlin/JVM | Independent Kotlin and Java codecs and capabilities                        | [Kotlin package guide](https://deancochran.github.io/ftms/start/kotlin/index.md)   |
| Python     | Synchronous codecs and static capability evidence                          | [Python package guide](https://deancochran.github.io/ftms/start/python/index.md)   |
| Rust       | Allocation-free `no_std` codecs and normalized views                       | [Rust package guide](https://deancochran.github.io/ftms/start/rust/index.md)       |
| Swift      | Native SwiftPM codecs and capabilities                                     | [Swift package guide](https://deancochran.github.io/ftms/start/swift/index.md)     |
| TypeScript | JavaScript/TypeScript ESM, normalized metrics, raw codecs and declarations | [Run the quickstart](https://deancochran.github.io/ftms/start/typescript/index.md) |

See [current releases](https://deancochran.github.io/ftms/project/releases/index.md) for verified versions and
prerelease status. The [planned 1.0 milestone](https://deancochran.github.io/ftms/project/release-one-zero/index.md) is not yet a
published family. [Choose a language](https://deancochran.github.io/ftms/start/choose-language/index.md) for a step-by-step entry point.

## A focused boundary

Decode measurements, features, ranges and statuses. Construct control messages.
Interpret capability evidence. Keep Bluetooth discovery, connections, permissions,
timeouts, procedure ownership and physical safety in your application.
The [consumer adapter seam](https://deancochran.github.io/ftms/project/architecture/index.md#consumer-adapter-seam) gives
the complete project-wide ownership split.

**A valid packet is not permission to control equipment.** Host tests and shared
fixtures are evidence of tested behavior, not universal device compatibility or
Bluetooth qualification.

## Integrate with confidence

* [TypeScript and C cookbook](https://deancochran.github.io/ftms/integration/cookbook/index.md): choose the right public API for the task.
* [Transport recipes](https://deancochran.github.io/ftms/integration/transports/index.md): JavaScript and C byte-boundary examples.
* [Consumer adapter seam](https://deancochran.github.io/ftms/project/architecture/index.md#consumer-adapter-seam): protocol-package and application ownership.
* [Releases and support](https://deancochran.github.io/ftms/project/releases/index.md): distinguish source from published packages.
* [Support profiles](https://deancochran.github.io/ftms/reference/support-profiles/index.md): select client and equipment wire directions.
* [Protocol coverage](https://deancochran.github.io/ftms/reference/coverage/index.md): inspect tested scope and evidence limits.
* [Contributing](https://deancochran.github.io/ftms/project/contributing/index.md): report problems and improve the project.

MIT licensed. Created and maintained by Dean Cochran.
