User space driver libraries for the Mac OSX operating system.
To learn about available kernel APIs, documentation will be be made available soon.
To see some example code on how various APIs are used, see the programs inside the demos folder.
Following the 🚀 Getting Started instructions.
[!INFO] Make sure you have installed the default conan profile for your mac OS before proceeding.
Profiles define which platform you mean to build your project against. These profiles are needed by the conan files to determine which files to build for demos and for libraries. In order to build binaries using libhal for the mac OS, run the following command.
conan config install -sf conan/profiles/v1 -tf profiles https://github.com/libhal/libhal-mac.gitThe mac-hal profile will be added to your conan profiles directory. Now
that you have that installed, you can build demos and libraries.
To build demos, start at the root of the repo and execute the following command:
conan build demos -pr mac-halIf you'd like to make a minimum sized binary or a debug binary use the following commands:
# For minimum sized binaries (optimized for small code size)
conan build demos -pr mac-hal -s build_type=MinSizeRel# For debug binaries (low optimization)
conan build demos -pr mac-hal -s build_type=DebugWe default to Release builds when building for Mac OSX.
By default the binaries will be built in the ./demos/build/mac/Release
directory. There you can find your executables and build artifacts.
For MinSizeRel the binaries will be in ./demos/build/mac/MinSizeRel.
For Debug the binaries will be in ./demos/build/mac/Debug.
To execute the program simply run the following:
For Release builds:
./demos/build/mac/Release/mac_demos_serialFor MinSizeRel builds:
./demos/build/mac/MinSizeRel/mac_demos_serialFor Debug builds:
./demos/build/mac/Debug/mac_demos_serialSee CONTRIBUTING.md for details.
Apache 2.0; see LICENSE for details.