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

#183 in FFI

Download history 5/week @ 2024-07-20 16/week @ 2024-07-27 14/week @ 2024-08-03 29/week @ 2024-08-10 50/week @ 2024-08-17 49/week @ 2024-08-24 39/week @ 2024-08-31 28/week @ 2024-09-07 39/week @ 2024-09-14 62/week @ 2024-09-21 42/week @ 2024-09-28 6/week @ 2024-10-05 23/week @ 2024-10-12 22/week @ 2024-10-19 24/week @ 2024-10-26 25/week @ 2024-11-02

94 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

~7–18MB
~262K SLoC