ta1394-avc-stream-format

Crates.iota1394-avc-stream-format
lib.rsta1394-avc-stream-format
version0.2.0
sourcesrc
created_at2022-07-29 10:47:32.290653
updated_at2023-04-18 11:34:30.428977
descriptionA pure-Rust implementation of AV/C commands for stream format defined by 1394 Trading Association
homepagehttps://alsa-project.github.io/gobject-introspection-docs/
repositoryhttps://github.com/alsa-project/snd-firewire-ctl-services
max_upload_size
id634937
size58,329
GObject Introspection (github:alsa-project:gobject-introspection)

documentation

https://docs.rs/ta1394-avc-stream-format/

README

The crate includes Rust elements for the part of protocol defined by 1394 Trading Association (1394 TA).

Protocol documentation

The protocol is documented in:

  • AV/C Stream Format Information Specification 1.0 (May 24, 2002, 1394 Trading Association, TA Document 2001002)
  • AV/C Stream Format Information Specification 1.1 Revision 0.5 (April 15, 2005, 1394 Trading Association, TA Document 2004008) - unpublished

1394 TA was formed 1994 and decided to close its official operation 2015. As of 2021, it has been dissolved and close its web site under URL http://1394ta.org in the end of year.

The published document is itself available at Internet Archive service when URL http://1394ta.org/specifications/ with enough care of cached date.

Usage

Add the following line to your Cargo.toml file:

[dependencies]
ta1394-avc-stream-format = "0.2"

Some documented AV/C commands are available:

  • ExtendedStreamFormatSingle (clause "6.2.3 SINGLE subfunction" in specification v1.1)
  • ExtendedStreamFormatList (clause "6.2.4 LIST subfunction" in specification v1.1)

The commands should be given to implementation of Ta1394Avc trait provided in ta1394-avc-general crate to perform AV/C operation.

License

The crate is released under MIT license.

Support

If finding issue, please file it in https://github.com/alsa-project/snd-firewire-ctl-services/.

Contribution

If intending for code contribution, I would like the user and developer to take care of some points before working.

It's well-known that the association promoted by several vendors tends to publishes specifications and documentations with over-engineering for several reasons; e.g. rat race in business or market. Beside the risk to include bug is exponentially increased when the code base is larger and larger. It's not preferable for your work just to fulfill whole the specifications and documentations.

The point is that there is actual requirement for the new code. For example, the crate includes some AV/C commands to satisfy requirement of snd-firewire-ctl-services project. It's preferable for you to have actual application using the new code.

Commit count: 2656

cargo fmt