tizen-audio.h

   1 #ifndef footizenaudiofoo
   2 #define footizenaudiofoo
   3
   4 /*
   5  * audio-hal
   6  *
   7  * Copyright (c) 2015 - 2016 Samsung Electronics Co., Ltd. All rights reserved.
   8  *
   9  * Licensed under the Apache License, Version 2.0 (the "License");
  10  * you may not use this file except in compliance with the License.
  11  * You may obtain a copy of the License at
  12  *
  13  * http://www.apache.org/licenses/LICENSE-2.0
  14  *
  15  * Unless required by applicable law or agreed to in writing, software
  16  * distributed under the License is distributed on an "AS IS" BASIS,
  17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  * See the License for the specific language governing permissions and
  19  * limitations under the License.
  20  *
  21  */
  22
  23 #include <stdint.h>
  24
  25 /* Error code */
  26 typedef enum audio_return {
  27     AUDIO_RET_OK                        = 0,
  28     AUDIO_ERR_UNDEFINED                 = (int32_t)0x80001000,
  29     AUDIO_ERR_RESOURCE                  = (int32_t)0x80001001,
  30     AUDIO_ERR_PARAMETER                 = (int32_t)0x80001002,
  31     AUDIO_ERR_IOCTL                     = (int32_t)0x80001003,
  32     AUDIO_ERR_INVALID_STATE             = (int32_t)0x80001004,
  33     AUDIO_ERR_INTERNAL                  = (int32_t)0x80001005,
  34
  35     AUDIO_ERR_NOT_IMPLEMENTED           = (int32_t)0x80001100,
  36 } audio_return_t ;
  37
  38 typedef enum audio_direction {
  39     AUDIO_DIRECTION_IN,                 /**< Capture */
  40     AUDIO_DIRECTION_OUT,                /**< Playback */
  41 } audio_direction_t;
  42
  43 typedef struct device_info {
  44     const char *type;
  45     uint32_t direction;
  46     uint32_t id;
  47 } device_info_t;
  48
  49 typedef struct audio_volume_info {
  50     const char *type;
  51     const char *gain;
  52     uint32_t direction;
  53 } audio_volume_info_t ;
  54
  55 typedef struct audio_route_info {
  56     const char *role;
  57     device_info_t *device_infos;
  58     uint32_t num_of_devices;
  59 } audio_route_info_t;
  60
  61 typedef struct audio_route_option {
  62     const char *role;
  63     const char *name;
  64     int32_t value;
  65 } audio_route_option_t;
  66
  67 typedef struct audio_stream_info {
  68     const char *role;
  69     uint32_t direction;
  70     uint32_t idx;
  71 } audio_stream_info_t ;
  72
  73 /* Overall */
  74 typedef struct audio_interface {
  75     /* Initialization & de-initialization */
  76     audio_return_t (*init)(void **audio_handle);
  77     audio_return_t (*deinit)(void *audio_handle);
  78     /* Volume */
  79     audio_return_t (*get_volume_level_max)(void *audio_handle, audio_volume_info_t *info, uint32_t *level);
  80     audio_return_t (*get_volume_level)(void *audio_handle, audio_volume_info_t *info, uint32_t *level);
  81     audio_return_t (*set_volume_level)(void *audio_handle, audio_volume_info_t *info, uint32_t level);
  82     audio_return_t (*get_volume_value)(void *audio_handle, audio_volume_info_t *info, uint32_t level, double *value);
  83     audio_return_t (*get_volume_mute)(void *audio_handle, audio_volume_info_t *info, uint32_t *mute);
  84     audio_return_t (*set_volume_mute)(void *audio_handle, audio_volume_info_t *info, uint32_t mute);
  85     /* Routing */
  86     audio_return_t (*update_route)(void *audio_handle, audio_route_info_t *info);
  87     audio_return_t (*update_route_option)(void *audio_handle, audio_route_option_t *option);
  88     /* Stream */
  89     audio_return_t (*notify_stream_connection_changed)(void *audio_handle, audio_stream_info_t *info, uint32_t is_connected);
  90     /* PCM */
  91     audio_return_t (*pcm_open)(void *audio_handle, void **pcm_handle, uint32_t direction, void *sample_spec, uint32_t period_size, uint32_t periods);
  92     audio_return_t (*pcm_start)(void *audio_handle, void *pcm_handle);
  93     audio_return_t (*pcm_stop)(void *audio_handle, void *pcm_handle);
  94     audio_return_t (*pcm_close)(void *audio_handle, void *pcm_handle);
  95     audio_return_t (*pcm_avail)(void *audio_handle, void *pcm_handle, uint32_t *avail);
  96     audio_return_t (*pcm_write)(void *audio_handle, void *pcm_handle, const void *buffer, uint32_t frames);
  97     audio_return_t (*pcm_read)(void *audio_handle, void *pcm_handle, void *buffer, uint32_t frames);
  98     audio_return_t (*pcm_get_fd)(void *audio_handle, void *pcm_handle, int *fd);
  99     audio_return_t (*pcm_recover)(void *audio_handle, void *pcm_handle, int revents);
 100     audio_return_t (*pcm_get_params)(void *audio_handle, void *pcm_handle, uint32_t direction, void **sample_spec, uint32_t *period_size, uint32_t *periods);
 101     audio_return_t (*pcm_set_params)(void *audio_handle, void *pcm_handle, uint32_t direction, void *sample_spec, uint32_t period_size, uint32_t periods);
 102 } audio_interface_t;
 103
 104 audio_return_t audio_init(void **audio_handle);
 105 audio_return_t audio_deinit(void *audio_handle);
 106 audio_return_t audio_get_volume_level_max(void *audio_handle, audio_volume_info_t *info, uint32_t *level);
 107 audio_return_t audio_get_volume_level(void *audio_handle, audio_volume_info_t *info, uint32_t *level);
 108 audio_return_t audio_set_volume_level(void *audio_handle, audio_volume_info_t *info, uint32_t level);
 109 audio_return_t audio_get_volume_value(void *audio_handle, audio_volume_info_t *info, uint32_t level, double *value);
 110 audio_return_t audio_get_volume_mute(void *audio_handle, audio_volume_info_t *info, uint32_t *mute);
 111 audio_return_t audio_set_volume_mute(void *audio_handle, audio_volume_info_t *info, uint32_t mute);
 112 audio_return_t audio_update_route(void *audio_handle, audio_route_info_t *info);
 113 audio_return_t audio_update_route_option(void *audio_handle, audio_route_option_t *option);
 114 audio_return_t audio_notify_stream_connection_changed(void *audio_handle, audio_stream_info_t *info, uint32_t is_connected);
 115 audio_return_t audio_pcm_open(void *audio_handle, void **pcm_handle, uint32_t direction, void *sample_spec, uint32_t period_size, uint32_t periods);
 116 audio_return_t audio_pcm_start(void *audio_handle, void *pcm_handle);
 117 audio_return_t audio_pcm_stop(void *audio_handle, void *pcm_handle);
 118 audio_return_t audio_pcm_close(void *audio_handle, void *pcm_handle);
 119 audio_return_t audio_pcm_avail(void *audio_handle, void *pcm_handle, uint32_t *avail);
 120 audio_return_t audio_pcm_write(void *audio_handle, void *pcm_handle, const void *buffer, uint32_t frames);
 121 audio_return_t audio_pcm_read(void *audio_handle, void *pcm_handle, void *buffer, uint32_t frames);
 122 audio_return_t audio_pcm_get_fd(void *audio_handle, void *pcm_handle, int *fd);
 123 audio_return_t audio_pcm_recover(void *audio_handle, void *pcm_handle, int revents);
 124 audio_return_t audio_pcm_get_params(void *audio_handle, void *pcm_handle, uint32_t direction, void **sample_spec, uint32_t *period_size, uint32_t *periods);
 125 audio_return_t audio_pcm_set_params(void *audio_handle, void *pcm_handle, uint32_t direction, void *sample_spec, uint32_t period_size, uint32_t periods);
 126 #endif