seq: queue_timer: add accessor APIs for data of queue timer in ALSATimer case

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

seq: queue_timer: make properties read-only

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

seq: queue_timer_data_alsa: add documentation

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

seq: queue_timer_data_alsa: add accessor APIs for resolution

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

seq: queue_timer_data_alsa: add accessor APIs for device ID of ALSATimer

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

seq: queue_timer_data_alsa: add boxed object to represent data of queue timer in ALSATimer case

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

seq: scan ALSATimer-0.0 gir by g-ir-scanner for dependency

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

tests: fix a test for ALSASeqQueueTimer

Fixes: 4018fe02a4ea ("seq: queue_timer: add abstract object to represent timer attached to queue")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: fix segmentation fault due to uninitialized value

Fixes: 940885e0982b ("seq: add global method to get list of numerical ID of queue")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

timer: add global method to retrieve current source of timestamp

doc: hwdep: fix missing content of introduction element

Fixes: eb03ec0340b ("hwdep: fulfill documentation for ALSAHwdep")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: event: dismiss ALSASeqEvent

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

seq: event_fixed: dismiss ALSASeqEventFixed

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

seq: event_variable: dismiss ALSASeqEventVariable

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

seq: user_client: schedule events in ALSASeqEventCntr instead of ALSASeqEvent

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

seq: user_client: emit ALSASeqEventCntr instead of ALSASeqEventFixed/ALSASeqEventVariable

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

seq: user_client: use ALSASeqEventCntr to parse read data

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

doc: seq: add documentation for ALSASeqEventCntr

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

seq: event_cntr: add accesor APIs for result data of event pointed by index

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

seq: event_cntr: add accesor APIs for connect data of event pointed by index

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

seq: event_cntr: add accesor APIs for address data of event pointed by index

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

seq: event_cntr: add accesor APIs for timestamp data of event pointed by index

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

seq: event_cntr: add accesor APIs for queue data of event pointed by index

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

seq: event_cntr: add accesor APIs for blob data of event pointed by index

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

seq: event_cntr: add accesor APIs for quadlet data of event pointed by index

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

seq: event_cntr: add accesor APIs for byte data of event pointed by index

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

seq: event_cntr: add accesor APIs for control data of event pointed by index

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

seq: event_cntr: add accesor APIs for note data of event pointed by index

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

seq: event_cntr: add accesor APIs for the destination/source of event pointed by index

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

seq: event_cntr: add accesor APIs for the tstamp of event pointed by index

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

seq: event_cntr: add accesor APIs for the numerical ID of queue to deliver the event pointed by index

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

seq: event_cntr: add accesor APIs for the tag of event pointed by index

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

seq: event_cntr: add accesor APIs for the priority mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the length mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the time mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the timestamping mode of event pointed by index

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

seq: event_cntr: add accesor APIs for the type of event pointed by index

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

seq: event_cntr: add an API to calculate the amount of cells in pool consumed by a batch of event

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

seq: event_cntr: add an API to calculate the number of events

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

seq: add private structure and constructor

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

tests: add a test for ALSASeqEventCntr

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

seq: event_cntr: add GObject-derived object to represent container for a batch of events

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

seq: client_pool: update descriptions of properties

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

seq: fulfill documentation for ALSASeq

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

rawmidi; fulfill documentation for ALSARawmidi

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

timer: fulfill documentation for ALSATimer

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

hwdep: fulfill documentation for ALSAHwdep

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

ctl: improve documentation for ALSACtl

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

ctl: fulfill documentation for ALSACtl

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

seq: user_client: remove useless argument of delete_port()

In implementation of ALSA sequencer core, the port owned by client can
be deleted by userspace applications which opens the client, therefore
it's necessary and sufficient to have an argument just for the numerical
ID of port.

This commit removes the useless argument for port information.

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

seq: user_client: use constant qualifier for read-only parameter

The 'port_id' parameters of 'alsaseq_user_client_create_port()' is
a pointer to storage of unsigned char type, due to optional parameter
in g-i interface. It's read-only if having value and it's better to
have const qualifier.

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

Revert "seq: tstamp: use wrapper structure instead of union"

This reverts commit 20fdc2d893ccba609cc786ebac733bf6914f9874.

In the above commit, union type structure is wrapped with care of
language bindings in which union-compatible feature is not expected.
However, it's responsible for language bindings to parse gir and
the care is not necessarily required in shared library side. In first
place, ALSASeq.Tstamp is boxed type object.

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

seq: addr: add API to compare two instances

It's convenient to compare two instances of address in ALSA Sequencer.

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

seq: event_data_queue/event_fixed: improve annotations for quadlets methods

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

seq: event_data_queue/event_fixed: improve annotation for byte methods

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

seq: event_data_queue/queue_tempo: improve annotation for skew methods

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

seq: event_fixed: use 'not a variable length array type' for quadlets argument

The type of quadlets argument is fixed-sized array.

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

seq: event_data_queue: use 'not a variable length array type' for quadlets argument

The type of quadlets argument is fixed-sized array.

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

seq: event_fixed: use 'not a variable length array type' for bytes argument

The bytes argument is fixed-sized array.

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

seq: event_data_queue: use 'not a variable length array type' for bytes argument

The type of bytes argument is fixed-sized array.

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

seq: queue_tempo: use 'not a variable length array type' for skew argument

The type of skew argument is fixed-sized array.

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

seq: event_data_queue: use 'not a variable length array type' for skew argument

The type of skew argument is fixed-sized array.

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

seq: event_data_queue: fix annotation for method name

In annotation, method name for 'alsaseq_event_data_queue_set_quadlet_param'
is wrong.

Fixes: a272b5d0e727 ("seq: event_data_queue: add accessor methods")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: user_client: fix annotation for GObject signal handler

Any object from ALSASeqEvent is passed to the second argument for handler
of 'handle-event' GObject signal, and it's not ALSASeqEvent itself.

Fixes: 89b631bd3e25 ("seq: user_client: add GObject signal to handle event")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: tstamp: add missing const qualifier for ALSASeq.Tstamp.get_real_time()

The const qualifier was lost in a previous commit.

Fixes: 72d8062b80ff: ("seq: tstamp: rename argument for real time")
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

seq: queue_status: rename argument for real time

This commit renames argument for real time so that the name is
consistent within the library.

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

seq: tstamp: rename argument for real time

This commit renames argument for real time so that the name is
consistent within the library.

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

seq: tstamp: use wrapper structure instead of union

In UAPI for ALSA Sequencer, snd_seq_timestamp is union with
snd_seq_tick_time_t and struct snd_seq_real_time types. The
libalsaseq has GLib Boxed object for the union, named as
ALSASeqTstamp.

```
$ cat build/src/seq/ALSASeq-0.0.gir
    ...
    <union name="Tstamp"
           c:type="ALSASeqTstamp"
           glib:type-name="ALSASeqTstamp"
           glib:get-type="alsaseq_tstamp_get_type"
           c:symbol-prefix="tstamp">
      <source-position filename="../src/seq/tstamp.h" line="14"/>
      ...
    </union>
    ...
```

Although this is valid in a view of GObject
Introspection, it's not nesessarily convenient to language
bindings because some programming language doesn't support
union type. In this case, the type is not available.

This commit adds an alternative structure to wrap the union.
As a result, ALSASeqTstamp is GLib Boxed object for the
wrapper structure.

```
$ cat build/src/seq/ALSASeq-0.0.gir
    ...
    <record name="Tstamp"
            c:type="ALSASeqTstamp"
            glib:type-name="ALSASeqTstamp"
            glib:get-type="alsaseq_tstamp_get_type"
            c:symbol-prefix="tstamp">
      <source-position filename="../src/seq/tstamp.h" line="18"/>
      <field name="tstamp" writable="1">
        <type name="gpointer" c:type="snd_seq_timestamp"/>
      </field>
      ...
    </record>
    ...
```

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

update README

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

rawmidi: doc: generate documentation of ALSARawmidi library

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

rawmidi: stream_pair: emit 'handle_disconnection' signal

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

rawmidi: stream_pair: add class virtual method to handle disconnection of sound card

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

rawmidi: stream_pair: add GObject signal to handle disconnection of sound card

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

rawmidi: stream_pair: emit 'receive-msgs'

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

rawmidi: stream_pair: add virtual function to notify receipt of messages

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

rawmidi: stream_pair: add GObject signal to notify receipt of messages

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

rawmidi: stream_pair: add an API to create GSource

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

rawmidi: stream_pair: add an API to drop queued data for attached substream

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

rawmidi: stream_pair: add an API to drain queued data for attached substream

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

rawmidi: stream_pair: add APIs to read/write data for attached substeam

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

rawmidi: stream_pair: add an API to get status of attached substream

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

rawmidi: substream_status: add properties

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

rawmidi: substream_status: add object to represent status of attached substream

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

rawmidi: stream_pair: add an API to set parameters for attached substream

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

rawmidi: substream_params: add properties

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

rawmidi: substream_params: add object to represent parameters of attached substream

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

rawmidi: stream_pair: add a API to get information of attached substream

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

rawmidi: stream_pair: add properties

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

rawmidi: stream_pair: add APIs to open ALSA Rawmidi character device

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

rawmidi: stream_pair: add object to represent a pair of data stream

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

rawmidi: add global method to get information of substream for rawmidi device

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

rawmidi: substream_info: add properties

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

rawmidi: substream_info: add object to represent information of substream

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

rawmidi: add global method to get list of directional subdevices for rawmidi device

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

rawmidi: add global method to get devnode string for rawmidi device

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

rawmidi; add global method to get sysname for rawmidi device of sound card

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

rawmidi; add global method to get list of rawmidi device for sound card

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

rawmidi: add Quark object to report any error

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

rawmidi: tests: add test script for enumerators in ALSARawmidi namespace

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

rawmidi: generate enumerations

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