Fundamentals
Core concepts and foundational knowledge for using SimpleBLE.
Welcome to the Fundamentals section. Whether you are new to Bluetooth Low Energy or an experienced developer looking to understand SimpleBLE's internals, these guides cover the essential knowledge required to build robust applications.
In this section
Bluetooth LE Basics
A high-level introduction to how Bluetooth Low Energy works, including device roles (Central/Peripheral), the GATT hierarchy (Services/Characteristics), and UUIDs.
CMake Primer
A beginner-friendly guide to using CMake to configure, build, and install SimpleBLE in your own projects.
Permissions
A guide to the various permissions required by different operating systems (Windows, macOS, Linux, Android, and iOS) to access Bluetooth functionality.
Error Handling
SimpleBLE's exception taxonomy, which errors are worth retrying, what timeouts actually mean, and how in-flight operations behave when a device disconnects.
Concurrency
The threading and callback contract for SimpleBLE's synchronous API: which threads run your callbacks on each platform, what you can safely call from inside a callback, every timeout in the library, and how to integrate with UI frameworks like Qt, WinForms, or Unity.