blob: 9feb8d3168973f37a3e39a4490f6eb50250607a9 [file] [log] [blame] [view]
# hinoko crate
Rust API bindings and wrappers for [hinoko library](https://github.com/takaswie/libhinoko) to
operate Linux FireWire character device for isochronous packets and resources
in IEEE 1394 bus.
The hinoko library version 0.7.1 is the minimum supported version for underlying library.
The hinoko crate is automatically generated by [gir tool](https://gtk-rs.org/gir/book/) provided
by [gtk-rs project](https://gtk-rs.org/). Hinoko-0.0 file from hinoko library is used for the
generation. But some functions are implemented manually.
## Usage
Add the following line to your Cargo.toml file:
```toml
[dependencies]
hinoko = "0.0.91"
```
The API documentation is available in <https://docs.rs/hinoko/>.
## License
The hinoko crate is released under [MIT license](https://spdx.org/licenses/MIT.html).
## Dependency
The hinoko crate depends on API crates provided by [gtk-rs project](https://gtk-rs.org/) for
type/object system, event loop, and dispacher.
## Features
* dox
* Suppress probing hinoko library. It's automatically enabled when generating documentation
in docs.rs.
## Repository
The hinoko-sys crate is maintained by Takashi Sakamoto.
The remote repository is located in <https://github.com/takaswie/hinoko-rs/>.
## Support
If finding issue, please file it in <https://github.com/takaswie/hinoko-rs/>.
## Sample programs
Some programs are available under `examples` directory.
* `fw-iso-resource`
* demonstration to allocate and deallocate isochronous resources
* `fw-iso-rx-single`
* demonstration to receive isochronous packets at single channel
* `fw-iso-rx-multiple`
* demonstration to receive isochronous packets at multiple channels
* `fw-iso-tx`
* demonstration to transmit isochronous packets at single channel