timer: event_tick: add derived object to represent event with tick count

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: event_data: add properties

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: event_data: add abstract object to represent data of event

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add enumeration for the type of event

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to create GSource to dispatch event

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to get status of instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_status: add properies and access methods

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_status: add object to represent status of instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to configure instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_params: add properties

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_params: add object to represent parameter of instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to get information of instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_info: add properties

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: instance_info: add object to represent information of instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to attach user instance to another instance as slave

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to attach timer device to user instance

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add an API to open ALSA Timer character device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: user_instance: add object to represent user instance for timer device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to set parameters of timer device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_params: add properties

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_params: add object to represent parameters of timer device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to get status of timer device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_status: add properties

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_status: add object to represent status of timer device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to get information of timer device

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_info: add properties

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_info: add object to represent information of timer

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to get list of available timers

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_id: add accessor methods and constructors

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: device_id: add object to represent identifier of timer

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to get devnode of ALSA Timer

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to get sysname for ALSA Timer

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add Quark object to report any error

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add test script for ALSATimer enumerations

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: generate enumerations

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: generate alsatimer library

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

fix workflow of Github Actions to clone requested repository

Even if any pull request is triggered, in 'build_in_ubuntu_on_lxd' job
of 'Build test' workflow, upstream repository is cloned and requested
git hash is checked out. However this fails because the hash is in
requested repository.

This commit fixes the workflow so that requested repository is cloned.

Fixes: 8cb6715aab65 ('Add support workflow of Github Actions')
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

Add support workflow of Github Actions

Github Actions is tool to automate software development workflows for CI/CD.
This tool has a remarkable point to share 'action' in repositories in github,
which is a unit of processing defined by users. The users write and push
'workflow' with the 'action' into repository in github.com. When any workflow
file is added to 'default' branch, the automation runs[2].

The defined actions run on virtual machine in Microsoft Azure (Standard_DS2_v2
as of today[2]). Three types of operating system are available: Windows, MacOS
and Linux (Ubuntu). On the MacOS and Linux machine, 'sudo' is available to
setup host environment for CI/CD, as well as Docker container is supported on
the host.

This commit adds a workflow file to automate build test. In this automation,
Fedora 32 in Docker container and Ubuntu 19.10 in LXD container as build
environments in Linux host. The automation is triggered in each 'push' and
'pull_request' event. The result is available in 'Actions' tab of repository
page in github.com.

[1] https://help.github.com/en/actions/automating-your-workflow-with-github-actions/about-github-actions
[2] https://help.github.com/en/actions/automating-your-workflow-with-github-actions/configuring-a-workflow
[3] https://help.github.com/en/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: fix wrong operation for values in enumerated type of element

The 'snd_ctl_elem_value' structure includes union member for values.
Although it includes 'enumerated' member for values in enumerated type
of element, current implementation of alsactl library uses 'integer'
member to pick up the values. As a result, in any 64 bit System V ABI,
the library fails to get/set values for the enumerated type of
element. This commit fixes the bug.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: simplify event dispatching for element event

Formerly, GSource for card includes the list of ALSACtlElemId instances
since 'snd_ctl_elem_id' structure was wrapped by GObject class object.
However now it's GObject boxed object and emit signals without the class
object.

This commit removes useless list of ALSACtlElemId and dispatch the event
directly.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: rename element event mask

The 'snd_ctl_event' structure can be defined to deliver several types of
events. One of the event is for element and it includes bitflags of the
kind of event for the element. In this library, the bitflag is named so
that it represents generic event, however it should be something
specific to element event.

This commit renames the bitflag.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_value: add an API to check whether two instances have the same values

It's convenient for users to check whether two instances of elem_value
have the same values. This commit adds an API to satisfy the convenience.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_id: add an API to check whether two instances indicates the same element

It's convenient for users to check whether two instances of elem_id
indicates the same element. This commit adds an API to satisfy the
convenience.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: tests: fix a test template for elem_id

Although a test template for elem_id does not run actually, it's better
to keep it as prepared. This commit fixes the test template for the
latest implementation of elem_id.

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ctl: elem_info_int: fix wrong assignment to private value

ALSACtl::ElemInfoInt has properties for 'min', 'max' and 'step' but their
assignments are not proper. This commit fixes the bug.

Fixes: aac870451a89 ("ctl: elem_info_int: add properties for type-dependent parameters and constructor")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

add README

ctl: generate documentation

ctl: elem_value: add APIs to set/get value of integer64 type

ctl: elem_value: add APIs to set/get value of IEC 60958 type

ctl: elem_value: add APIs to set/get values of bytes type

ctl: elem_value: add APIs to set/get indexes of enumerated type

ctl: elem_value: add APIs to set/get values of integer type

ctl: elem_value: add APIs to set/get values of boolean type

ctl: card: add APIs to read/write value for element

ctl: elem_value: add properties and constructor

ctl: elem_value: add object to represent value for element

ctl: card: emit 'disconnection' signal when detecting disconnection of sound card

ctl: card: add virtual method to handle disconnection of sound card

ctl: card: add GObject signal to handle disconnection of sound card

ctl: card: emit 'handle-elem-event' GObject signal with elem_id

ctl: card: add virtual object to handle event for element

ctl: card: add GObject signal to handle event for element

ctl: card: subscribe event when creating GSource

ctl: card: add an API to create GSource for event dispatcher

ctl: card: add an API to remove user-defined elements

ctl: card: add an API to add/replace user-defined elements

ctl: card: add APIs to write/read/command Type-Length-Value data for element

ctl: card: add an API to get information of element

ctl: elem_info_int64: add properties and constructor

ctl: elem_info_int64: add object to represent information for integer64 type element

ctl: elem_info_iec60958: add constructor

ctl: elem_info_iec60958: add object to represent information for element of IEC60958 type

ctl: elem_info_bytes: add properties for specific information and constructor

ctl: elem_info_bytes: add object to represent information for element of bytes type

ctl: elem_info_enum: add properties and constructor

ctl: elem_info_enum: add object to represent information for element of enumerator type

ctl: elem_info_int: add properties for type-dependent parameters and constructor

ctl: elem_info_int: add object to represent information for integer type element

ctl: elem_info_bool: add properties for specific information and constructor

ctl: elem_info_bool: add object to represent information for boolean type element

ctl: elem_info: add properties for common information

ctl: elem_info: add object to represent information of element

ctl: card: add an API to lock element from writing

ctl: card: add a API to retrieve list of element ID

ctl: elem_id: add access methods and constructor

ctl: elem_id: add GObject derived object for identifier of control element

ctl: card: add an API to get information of sound card

ctl: card_info: add properties

ctl: card_info: add an object to represent information of card

ctl: card: add properties

ctl: card: add APIs to open ALSA control character devices

ctl: card: add object to represent sound card

ctl: add global method to get devnode string of control device for sound card

ctl: add global method to get sysname of control device for sound card

ctl: add global method to get sysname of sound card

ctl: add global method to get list of available sound cards

ctl: add Quark object to report any error

ctl: tests: add test script for enumerations in ALSACtl namespace

ctl: generate enumerations

ctl: generate alsactl library

This project produces 'alsactl' library for API to use some features
of ALSA control character device. The API is available for C language
natively as well as for gobject introspection.

This commit generates the library. At present, no API is public.