https://github.com/alsa-project/libhitaki
Library to abstract the access to the ALSA firewire hwdep device
https://github.com/alsa-project/libhitaki
Last synced: 3 months ago
JSON representation
Library to abstract the access to the ALSA firewire hwdep device
- Host: GitHub
- URL: https://github.com/alsa-project/libhitaki
- Owner: alsa-project
- License: lgpl-2.1
- Created: 2022-04-26T07:16:39.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-15T06:01:07.000Z (over 1 year ago)
- Last Synced: 2025-02-03T21:34:04.455Z (5 months ago)
- Language: C
- Size: 78.1 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: COPYING.LESSER
Awesome Lists containing this project
README
=====================
The libhitaki project
=====================
2024/02/16
Takashi Sakamoto
Introduction
============
This is a child project of libhinawa.
- https://github.com/alsa-project/libhinawa
Originally the function produced by ALSA firewire stack was operated via libhinawa API. Nowadays
libhitaki does the work instead.
I design the library for userspace applications to operate ALSA HwDep character device for
specific functions implemented in ALSA drivers for Audio and Music unit in IEEE 1394 bus.
The latest release is `0.2.1 `_.
License
=======
Released under GNU Lesser General Public License version 2.1 or later, including UAPI header of ALSA
firewire stack released under GNU General Public License version 2.0.
Repository
==========
- ``_
Documentation
=============
- ``_
Dependencies
============
* GLib ``_
* GObject introspection ``_
* Linux kernel version 4.5 or later
Requirements to build
=====================
* UAPI header of Linux kernel
* Meson build system ``_
* Ninja build system ``_
* PyGObject ``_ (optional to run unit tests)
* gi-docgen ``_ (optional to generate API documentation)
How to build and install
========================
Build and install ::
$ meson setup (--prefix=directory-to-install) build-directory
$ meson compile -C build-directory
$ meson install -C build-directory
After installed, C headers for APIs are available and pkg-config returns arguments for them.
For example ::
$ pkg-config --cflags --libs hitaki
-I/usr/include/hitaki -I/usr/include/glib-2.0 -I/usr/lib/x86_64-linux-gnu/glib-2.0/include -lhitaki
How to refer document
=====================
::
$ meson setup --prefix=directory-to-install -D doc=true build-directory
$ meson install -C build-directory
$ xdg-open directory-to-install/share/doc/hitaki/index.html
Supplemental information for language bindings
==============================================
* PyGObject ``_ is a dynamic loader for libraries compatible
with g-i.
* hitaki-rs ``_ includes crates to use these
libraries.
About Hitaki
============
``Hitaki`` is a family of bird in Japanese. The representative species of family is
``Joubitaki`` (``Phoenicurus auroreus`` in binary nomenclature), known as ``Daurian redstart``.
The small bird sings in several kind of voices, one of which is like the sound to strike flints
against steel to produce sparks in human perception. The name `Hitaki` might come from the voice
according to legend since the name was written by two successive Kanji characters in days past;
``Hi`` (U+2F55 |kanji-hi|) and ``Taki`` (U+713C |kanji-taki|). The former means
``fire``. The latter often means ``bake`` or ``burn`` something, however it means ``ignite`` in
the context. The name is written by one Kanji character (U+9DB2 |kanji-hitaki|) later.
.. |kanji-hi| unicode:: ⽕ .. Hi spelled in Kanji
.. |kanji-taki| unicode:: 焼 .. Taki spelled in Kanji
.. |kanji-hitaki| unicode:: 鶂 .. Hitaki spelled in Kanji
We can see ``Hitaki`` as a bird to sing in a voice like igniting fire. The bird definitely operates
our devices in IEEE 1394 bus to process audio.
End