12 releases

0.1.11 Jun 5, 2024
0.1.10 Apr 15, 2024
0.1.5 Feb 10, 2024
0.1.4 Jan 16, 2024
0.0.0 Sep 4, 2023

#112 in FFI

Download history 3/week @ 2024-07-01 21/week @ 2024-07-08 17/week @ 2024-07-15 3/week @ 2024-07-22 18/week @ 2024-07-29 14/week @ 2024-08-05 37/week @ 2024-08-12 55/week @ 2024-08-19 50/week @ 2024-08-26 25/week @ 2024-09-02 41/week @ 2024-09-09 32/week @ 2024-09-16 70/week @ 2024-09-23 25/week @ 2024-09-30 8/week @ 2024-10-07 29/week @ 2024-10-14

134 downloads per month
Used in 14 crates (via playdate-sys)

MIT/Apache and maybe GPL-3.0+

83KB
2K SLoC

Playdate Bindings Generator

Util to generate bindings to Playdate with additional code-gen features like in-code documentation directly by official c-reference.

Requirements

  1. Rust nightly toolchain
  2. Playdate SDK
    • Ensure that env var PLAYDATE_SDK_PATH points to the SDK root
  3. Follow the official documentation
    • Ensure that arm-none-eabi-gcc or gcc-arm-none-eabi in your PATH
  4. Requirements inherited by bindgen, follow official documentation.

Configuration

Inherited configuration by bindgen: follow bindgen official documentation.

Env var PLAYDATE_SDK_PATH as described in playdate official documentation.

Optional env var ARM_GCC_PATH to help to find arm-none-eabi-gcc (or gcc-arm-none-eabi) with entire toolchain. Useful only for troubleshooting.

Usage

Cargo.toml:

[build-dependencies.bindgen]
package = "playdate-bindgen"
version = "*"

Add this to build-dependencies and add to your build-script something like this:

let cfg = bindgen::cfg::Config::default();
let generator = bindgen::Generator::new(cfg).expect("Couldn't create bindings generator.");
let out_path = bindgen::env_var("OUT_DIR").map(PathBuf::from)
	                                       .map(|p| p.join(&generator.filename.to_string()))
	                                       .unwrap();
let bindings = generator.generate().expect("Couldn't generate bindings.");
bindings.write_to_file(&out_path).expect("Couldn't write bindings.");

For complex examples see build-script in the playdate-sys crate.


This software is not sponsored or supported by Panic.

Dependencies

~8–19MB
~281K SLoC