ctl: elem-value: retrieve fixed-sized array by getter method for integer values

In UAPI of Linux sound subsystem, 'struct snd_ctl_elem_values' has
fixed-sized array. It's natural to retrieve the array as is.

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

ctl: elem-value: retrieve fixed-sized array by getter method for boolean values

In UAPI of Linux sound subsystem, 'struct snd_ctl_elem_values' has
fixed-sized array. It's natural to retrieve the array as is.

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

ctl: elem-value: fix casting for byte data

Fixed: 0fa1e17e3f96 ("ctl: elem_value: add APIs to set/get values of bytes type")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

update README

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

seq: remove-filter: rewrite as GObject-derived object

In UAPI of ALSA Sequencer, 'struct snd_seq_remove_events' has reserved
member for future use. In the case, the convention of this project lets
us to use class instead of structure.

Additionally, current implementation of ALSASeq.RemoveFilter doesn't
support multiple condition to query events for removal. It's not
necessarily convenient.

This commit rewrites ALSASeq.RemoveFilter.

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

seq: enums: add rest of entries for remove filter flags

It's planned to rewrite ALSASeq.RemoveFilter for flexible configuration of
filter condition.

This commit adds the reset of entries for the flags.

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

seq: event-cntr: remove obsoleted internal function

Fixes: 4bc8ea4b91d2 ("seq: event-cntr: rewrite as boxed structure")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

ci: separate libudev-dev installation from the other

The dependency on libudev-dev is specific to alsa-gobject libraries apart
from the other libraries under alsa gobject-introspection team.

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

all: replace 'represent' with 'express' in comments

For better text.

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

user-client/client-pool: update function comments about event scheduling

When scheduling events, the user client should take care of free cells in
own output memory pool. The number of free cells is available via property
of ClientPool class. The number of cells consumed by event is available
via method of Event boxed structure.

This commit adds comments about it.

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

client-pool: change signedness for size properties

The properties for size of pool and cells always have positive value.

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

event: add public API to compute pool consumption when scheduling event

In design of ALSA Sequencer, delivery of event consumes cell in client
pool. For usual event, it's one cell. For variable length of event, it's
multiple cells including the total length of event.

ALSASeq.ClientPool class has properties to express the number of cells
and free cells in client pool. When comparing to the properties,
applications get to know whether the scheduling operation is blocked or
not.

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

update README with compatibility note

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

ctl: elem-value: update class description

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

ctl: elem-value: rewrite getter for 64 bit signed integer values

This commit rewrites the getter method so that it returns a pointer to
internal storage for 64 bit signed integer values.

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

ctl: elem-value: rewrite getter for IEC 60958 user data

This commit rewrites the getter method so that it returns a pointer to
internal storage for IEC 60958 user data.

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

ctl: elem-value: rewrite getter for IEC 60958 channel status

This commit rewrites the getter method so that it returns a pointer to
internal storage for IEC 60958 channel status.

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

ctl: elem-value: rewrite getter for 8 bit unsigned integer values

This commit rewrites the getter method so that it returns a pointer to
internal storage for 8 bit unsigned integer values.

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

ctl: elem-value: rewrite getter for enumeration index values

This commit rewrites the getter method so that it returns a pointer to
internal storage for enumeration index values.

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

ctl: elem-value: rewrite getter for 32 bit signed integer values

This commit rewrites the getter method so that it returns a pointer to
internal storage for 32 bit signed integer values.

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

ctl: elem-value: rewrite getter for boolean values

This commit rewrites the getter method so that it returns a pointer to
internal storage for boolean values.

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

ctl: elem-value: clear value field at setter method

For safe at reuse of the boxed structure.

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

timer: fix entry in exported symbol map

Fixes: b4e62cdc0eac ("timer: instance-status: rename method with real time")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: event: fix description about methods relevant to time stamp

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

timer: query: rename to ALSATimer.get_real_time_clock_id()

For friendly name.

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

timer: instance-status: rename method with real time

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

timer: enums: rename to ALSATimer.RealTimeEventType

The set of events is used only for ALSATimer.RealTimeEvent.

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

timer: enums: rename to ALSATimer.EventType.TICK_TIME and REAL_TIME

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

timer: real-time-event: rename boxed structure

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

timer: tick-time-event: rename boxed structure

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

timer: move ALSATimer.TstampEvent files for future rename

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

timer: move ALSATimer.TickEvent files for future rename

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

utils: successfully parse the string teminated by '\n'

It requires to parse the literal from sysfs node.

Fixes: cc92f5ca9478 ("utils: add utility to compute integer value from string literal")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: user-client: add annotation to object properties

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

seq: system-info: add annotation to object properties

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

seq: queue-tempo: add annotation to object properties

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

seq: queue-status: add annotation to object properties

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

seq: queue-info: add annotation to object properties

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

seq: port-info: fix tag indentation

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

seq: client-pool: add annotation to object properties

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

seq: client-info: add annotation to object properties

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

seq: fix description of object properties in which enumerations are available

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

timer: instance-status: add annotation to object properties

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

timer: instance-params: add annotation to object properties

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

timer: instance-info: add annotation to object properties

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

timer: device-status: add annotation to object properties

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

timer: device-params: add annotation to object properties

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

timer: device-info: add annotation to object properties

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

hwdep: device-info: add annotation to object properties

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

rawmidi: substream-status: add annotation to object properties

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

rawmidi: substream-params: add annotation to object properties

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

rawmidi: substream-info: add annotation to object properties

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

rawmidi: stream-pair: add annotation to object properties

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

card: elem-value: add annotation to object properties

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

ctl: card-info: add annotation to object properties

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

ctl: card: add annotation to object properties

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

tests: add test scripts for namespace functions

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

tests: add test script for ALSASeq.QueueTimerCommon interface

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

tests: add test script for ALSAHwdep.DeviceCommon interface

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

tests: add test script for ALSACtl.ElemInfoSingleArray interface

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

tests: add test script for ALSACtl.ElemInfoCommon interface

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

tests: test virtual functions in object

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

tests: refine helper function to test object

When implementing GObject interface, available properties, virtual
methods, and signals are not referred by attributes of object, while
available methods are available.

This commit expands current helper function to test object interface.

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

tests: test object type instead of its instance

No need to instantiate object to test.

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

tests: add test script for ALSASeq.RemoveFilter boxed structure

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

tests: add test script for ALSASeq.EventDataResult boxed structure

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

tests: add test script for ALSASeq.EventDataQueue boxed structure

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

tests: add test script for ALSASeq.EventDataNote boxed structure

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

tests: add test script for ALSASeq.EventDataCtl boxed structure

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

tests: add test script for ALSASeq.EventDataConnect boxed object

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

tests: add test script for ALSASeq.Event boxed structure

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

tests: add test script for ALSASeq.EventCntr boxed structure

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

tests: add test script for ALSASeq.Addr boxed structure

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

tests: add test script for ALSATimer.TstampEvent boxed structure

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

tests: add test script for ALSATimer.TickEvent boxed structure

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

tests: add test script for ALSATimer.DeviceId boxed structure

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

tests: add test script for ALSACtl.ElemId boxed structure

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

tests: add helper function to test enumerations and flags

This commit adds helper function for enumerations and flags. All of
available enumerations and flags are available via object attributes.

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

tests: rename helper function to test object interface

It appears that some helper functions are required to test GObject
interface, enumerations, and flags.

This commit renames current helper function for objects.

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

seq: event-cntr: add internal API to serialize list of events

ALSASeq.EventCntr still handles batch of events, therefore it's good to
put serialization code into it.

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

seq: event-cntr: rewrite as boxed structure

The addition of ALSASeq.Event boxed structure obsoletes many methods of
ALSASeq.EventCntr.

This commit rewrite it for convenience.

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

seq: user-client: rewrite public API to schedule single event

This commit rewrite ALSASeq.schedule_event() to get an instance of
ALSASeq.Event.

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

seq: user-client: add public API to schedule list of events

This commit adds ALSASeq.schedule_events() to schedule the list of
events.

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

seq: event: add boxed structure for event

Current implementation has ALSASeq.EventCntr for user applications to
handle batch of events. The properties of event is directly retrieved
from it by index number, however it's necessarily useful.

This commit adds boxed structure specific to each event.

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

seq: enums: obsolete ALSASeqSubscribeFlag enumerations

ALSASeq.SubscribeFlag is defined but it's more convenient to add the
flags as properties in ALSASeq.SubscribeData.

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

seq: port-info: rename properties for time stamp

ALSASeq.PortInfo has :timestamp-overwrite and :timestamp-mode.

This commit renames them according to convention. Additionally, property
annotations are added as well.

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

seq: enums: rename to tstamp mode

Some stuffs are named with 'timestamp', however 'tstamp' seems to be
preferable for consistency.

This commit renames them.

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

seq: remove-filter: remove unused error arguments

ALSASeq.RemoveFilter class has some constructors according to
the filter condition. These are defined as throw function, however error
argument is not used at all.

This commit removes the unused argument.

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

seq: tstamp: remove unused boxed structure

The boxed structure for time stamp union is not used anymore.

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

seq: event-cntr/event-data-queue: obsolete timestamp functions by adding alternatives

In UAPI of ALSA Sequencer, time stamp is defined as union which has
tick time member and real time member. There is no tag to select two
members, thus user applications should judge which member is used. In
this meaning, exposing the union is not necessarily useful.

This commit is a preparation to obsolete the union. The methods to
retrieve the union are rewrite to retrieve either tick time or real time
explicitly.

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

update README

The command line examples are updated to use '-c' option of meson
instead of cd command.

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

timer: tstamp-event: rename from event-data-tstamp

The name of EventDataTstamp is redundant.

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

timer: tick-event: rename from event-data-tick

The name of EventDataTick is a bit redundant.

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

timer: enum: rename EventType from EventDataType

ALSATimer.EventDataType is used to distinguish the type of event from
either tick or timestamp.

This commit renames the enumerations with explicit name.

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

timer: enums: rename TstampEventType from EventType

ALSATimer.EventType is for the type of tstamp event, thus it's not for
tick event.

This commit renames the enumerations with explicit name.

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

timer: event: remove unused structure

ALSATimer.Event is obsoleted and unused now.

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

timer: user_instance: use two signals to dispatch events explicitly

Current implementation uses one signal to dispatch events. The user
application should distinguish actual type of event when handling the
evet. Nevertheless the type of event is decided by call of choose API,
before starting timer instance, therefore the application knows the
type of event in advance.

This commit adds two signals to dispatch the events to obsolete the
existent one signal.

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

hwdep: device-info: allow to set property at instantiation

ALSAHwdep.DeviceCommon interface allows subclass to implement
get_device_info() virtual function. In the function, DeviceInfo should
be instantiated with correct properties for device information. However,
current implementation of DeviceInfo doesn't have setter function for
the properties.

This commit adds setter function for the purpose. It's allowed to set
them at construction only.

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

hwdep: add error domain for implementators of DeviceCommon interface

The implementator of DeviceCommon interface should operate character
device for ALSA HwDep interface, thus it can receive any type of error
as a result of system call. Some of the error may be common.

This commit adds error domain for the case.

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

hwdep: device-common: add interface for common feature of ALSA HwDep device

The protocol in ALSA HwDep character device has common feature. It's
suitable for userspace implementation to have GObject interface for such
features.

This commit adds the interface. The implementation of interface should
have four methods; open, get_protocol_version, get_device_info, and
create_source. Additionally, it should emit handle-disconnection signal
when detecting ENODEV error in the interation of source. It requires to
notify userspace application since the application should release
character device immediately.

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