| /* |
| * Driver for Digigram miXart soundcards |
| * |
| * low level interface with interrupt handling and mail box implementation |
| * |
| * Copyright (c) 2003 by Digigram <alsa@digigram.com> |
| * |
| * This program is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU General Public License as published by |
| * the Free Software Foundation; either version 2 of the License, or |
| * (at your option) any later version. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| * You should have received a copy of the GNU General Public License |
| * along with this program; if not, write to the Free Software |
| * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| */ |
| |
| #ifndef __SOUND_MIXART_CORE_H |
| #define __SOUND_MIXART_CORE_H |
| |
| |
| enum mixart_message_id { |
| MSG_CONNECTOR_GET_AUDIO_INFO = 0x050008, |
| MSG_CONNECTOR_GET_OUT_AUDIO_LEVEL = 0x050009, |
| MSG_CONNECTOR_SET_OUT_AUDIO_LEVEL = 0x05000A, |
| |
| MSG_CONSOLE_MANAGER = 0x070000, |
| MSG_CONSOLE_GET_CLOCK_UID = 0x070003, |
| |
| MSG_PHYSICALIO_SET_LEVEL = 0x0F0008, |
| |
| MSG_STREAM_ADD_INPUT_GROUP = 0x130000, |
| MSG_STREAM_ADD_OUTPUT_GROUP = 0x130001, |
| MSG_STREAM_DELETE_GROUP = 0x130004, |
| MSG_STREAM_START_STREAM_GRP_PACKET = 0x130006, |
| MSG_STREAM_START_INPUT_STAGE_PACKET = 0x130007, |
| MSG_STREAM_START_OUTPUT_STAGE_PACKET = 0x130008, |
| MSG_STREAM_STOP_STREAM_GRP_PACKET = 0x130009, |
| MSG_STREAM_STOP_INPUT_STAGE_PACKET = 0x13000A, |
| MSG_STREAM_STOP_OUTPUT_STAGE_PACKET = 0x13000B, |
| MSG_STREAM_SET_INPUT_STAGE_PARAM = 0x13000F, |
| MSG_STREAM_SET_OUTPUT_STAGE_PARAM = 0x130010, |
| MSG_STREAM_SET_IN_AUDIO_LEVEL = 0x130015, |
| MSG_STREAM_SET_OUT_STREAM_LEVEL = 0x130017, |
| |
| MSG_SYSTEM_FIRST_ID = 0x160000, |
| MSG_SYSTEM_ENUM_PHYSICAL_IO = 0x16000E, |
| MSG_SYSTEM_ENUM_PLAY_CONNECTOR = 0x160017, |
| MSG_SYSTEM_ENUM_RECORD_CONNECTOR = 0x160018, |
| MSG_SYSTEM_WAIT_SYNCHRO_CMD = 0x16002C, |
| MSG_SYSTEM_SEND_SYNCHRO_CMD = 0x16002D, |
| |
| MSG_SERVICES_TIMER_NOTIFY = 0x1D0404, |
| MSG_SERVICES_REPORT_TRACES = 0x1D0700, |
| |
| MSG_CLOCK_CHECK_PROPERTIES = 0x200001, |
| MSG_CLOCK_SET_PROPERTIES = 0x200002, |
| }; |
| |
| |
| typedef struct mixart_msg mixart_msg_t; |
| struct mixart_msg |
| { |
| u32 message_id; |
| mixart_uid_t uid; |
| void* data; |
| size_t size; |
| }; |
| |
| /* structs used to communicate with miXart */ |
| |
| typedef struct mixart_enum_connector_resp mixart_enum_connector_resp_t; |
| struct mixart_enum_connector_resp |
| { |
| u32 error_code; |
| u32 first_uid_offset; |
| u32 uid_count; |
| u32 current_uid_index; |
| mixart_uid_t uid[MIXART_MAX_PHYS_CONNECTORS]; |
| } __attribute__((packed)); |
| |
| |
| /* used for following struct */ |
| #define MIXART_FLOAT_P_22_0_TO_HEX 0x41b00000 /* 22.0f */ |
| #define MIXART_FLOAT_M_20_0_TO_HEX 0xc1a00000 /* -20.0f */ |
| #define MIXART_FLOAT____0_0_TO_HEX 0x00000000 /* 0.0f */ |
| |
| typedef struct mixart_audio_info_req mixart_audio_info_req_t; |
| struct mixart_audio_info_req |
| { |
| u32 line_max_level; /* float */ |
| u32 micro_max_level; /* float */ |
| u32 cd_max_level; /* float */ |
| } __attribute__((packed)); |
| |
| typedef struct mixart_analog_hw_info mixart_analog_hw_info_t; |
| struct mixart_analog_hw_info |
| { |
| u32 is_present; |
| u32 hw_connection_type; |
| u32 max_level; /* float */ |
| u32 min_var_level; /* float */ |
| u32 max_var_level; /* float */ |
| u32 step_var_level; /* float */ |
| u32 fix_gain; /* float */ |
| u32 zero_var; /* float */ |
| } __attribute__((packed)); |
| |
| typedef struct mixart_digital_hw_info mixart_digital_hw_info_t; |
| struct mixart_digital_hw_info |
| { |
| u32 hw_connection_type; |
| u32 presence; |
| u32 clock; |
| u32 reserved; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_analog_info mixart_analog_info_t; |
| struct mixart_analog_info |
| { |
| u32 type_mask; |
| mixart_analog_hw_info_t micro_info; |
| mixart_analog_hw_info_t line_info; |
| mixart_analog_hw_info_t cd_info; |
| u32 analog_level_present; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_digital_info mixart_digital_info_t; |
| struct mixart_digital_info |
| { |
| u32 type_mask; |
| mixart_digital_hw_info_t aes_info; |
| mixart_digital_hw_info_t adat_info; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_audio_info mixart_audio_info_t; |
| struct mixart_audio_info |
| { |
| u32 clock_type_mask; |
| mixart_analog_info_t analog_info; |
| mixart_digital_info_t digital_info; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_audio_info_resp mixart_audio_info_resp_t; |
| struct mixart_audio_info_resp |
| { |
| u32 txx_status; |
| mixart_audio_info_t info; |
| } __attribute__((packed)); |
| |
| |
| /* used for nb_bytes_max_per_sample */ |
| #define MIXART_FLOAT_P__4_0_TO_HEX 0x40800000 /* +4.0f */ |
| #define MIXART_FLOAT_P__8_0_TO_HEX 0x41000000 /* +8.0f */ |
| |
| typedef struct mixart_stream_info mixart_stream_info_t; |
| struct mixart_stream_info |
| { |
| u32 size_max_byte_frame; |
| u32 size_max_sample_frame; |
| u32 nb_bytes_max_per_sample; /* float */ |
| } __attribute__((packed)); |
| |
| /* MSG_STREAM_ADD_INPUT_GROUP */ |
| /* MSG_STREAM_ADD_OUTPUT_GROUP */ |
| |
| typedef struct mixart_streaming_group_req mixart_streaming_group_req_t; |
| struct mixart_streaming_group_req |
| { |
| u32 stream_count; |
| u32 channel_count; |
| u32 user_grp_number; |
| u32 first_phys_audio; |
| u32 latency; |
| mixart_stream_info_t stream_info[32]; |
| mixart_uid_t connector; |
| u32 flow_entry[32]; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_stream_desc mixart_stream_desc_t; |
| struct mixart_stream_desc |
| { |
| mixart_uid_t stream_uid; |
| u32 stream_desc; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_streaming_group mixart_streaming_group_t; |
| struct mixart_streaming_group |
| { |
| u32 status; |
| mixart_uid_t group; |
| u32 pipe_desc; |
| u32 stream_count; |
| mixart_stream_desc_t stream[32]; |
| } __attribute__((packed)); |
| |
| /* MSG_STREAM_DELETE_GROUP */ |
| |
| /* request : mixart_uid_t group */ |
| |
| typedef struct mixart_delete_group_resp mixart_delete_group_resp_t; |
| struct mixart_delete_group_resp |
| { |
| u32 status; |
| u32 unused[2]; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_STREAM_START_INPUT_STAGE_PACKET = 0x130000 + 7, |
| MSG_STREAM_START_OUTPUT_STAGE_PACKET = 0x130000 + 8, |
| MSG_STREAM_STOP_INPUT_STAGE_PACKET = 0x130000 + 10, |
| MSG_STREAM_STOP_OUTPUT_STAGE_PACKET = 0x130000 + 11, |
| */ |
| |
| typedef struct mixart_fx_couple_uid mixart_fx_couple_uid_t; |
| struct mixart_fx_couple_uid |
| { |
| mixart_uid_t uid_fx_code; |
| mixart_uid_t uid_fx_data; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_txx_stream_desc mixart_txx_stream_desc_t; |
| struct mixart_txx_stream_desc |
| { |
| mixart_uid_t uid_pipe; |
| u32 stream_idx; |
| u32 fx_number; |
| mixart_fx_couple_uid_t uid_fx[4]; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_flow_info mixart_flow_info_t; |
| struct mixart_flow_info |
| { |
| mixart_txx_stream_desc_t stream_desc; |
| u32 flow_entry; |
| u32 flow_phy_addr; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_stream_state_req mixart_stream_state_req_t; |
| struct mixart_stream_state_req |
| { |
| u32 delayed; |
| u64 scheduler; |
| u32 reserved4np[3]; |
| u32 stream_count; /* set to 1 for instance */ |
| mixart_flow_info_t stream_info; /* could be an array[stream_count] */ |
| } __attribute__((packed)); |
| |
| /* MSG_STREAM_START_STREAM_GRP_PACKET = 0x130000 + 6 |
| MSG_STREAM_STOP_STREAM_GRP_PACKET = 0x130000 + 9 |
| */ |
| |
| typedef struct mixart_group_state_req mixart_group_state_req_t; |
| struct mixart_group_state_req |
| { |
| u32 delayed; |
| u64 scheduler; |
| u32 reserved4np[2]; |
| u32 pipe_count; /* set to 1 for instance */ |
| mixart_uid_t pipe_uid[1]; /* could be an array[pipe_count] */ |
| } __attribute__((packed)); |
| |
| typedef struct mixart_group_state_resp mixart_group_state_resp_t; |
| struct mixart_group_state_resp |
| { |
| u32 txx_status; |
| u64 scheduler; |
| } __attribute__((packed)); |
| |
| |
| |
| /* Structures used by the MSG_SERVICES_TIMER_NOTIFY command */ |
| |
| typedef struct mixart_sample_pos mixart_sample_pos_t; |
| struct mixart_sample_pos |
| { |
| u32 buffer_id; |
| u32 validity; |
| u32 sample_pos_high_part; |
| u32 sample_pos_low_part; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_timer_notify mixart_timer_notify_t; |
| struct mixart_timer_notify |
| { |
| u32 stream_count; |
| mixart_sample_pos_t streams[MIXART_MAX_STREAM_PER_CARD * MIXART_MAX_CARDS]; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_CONSOLE_GET_CLOCK_UID = 0x070003, |
| */ |
| |
| /* request is a uid with desc = MSG_CONSOLE_MANAGER | cardindex */ |
| |
| typedef struct mixart_return_uid mixart_return_uid_t; |
| struct mixart_return_uid |
| { |
| u32 error_code; |
| mixart_uid_t uid; |
| } __attribute__((packed)); |
| |
| /* MSG_CLOCK_CHECK_PROPERTIES = 0x200001, |
| MSG_CLOCK_SET_PROPERTIES = 0x200002, |
| */ |
| |
| enum mixart_clock_generic_type { |
| CGT_NO_CLOCK, |
| CGT_INTERNAL_CLOCK, |
| CGT_PROGRAMMABLE_CLOCK, |
| CGT_INTERNAL_ENSLAVED_CLOCK, |
| CGT_EXTERNAL_CLOCK, |
| CGT_CURRENT_CLOCK |
| }; |
| |
| enum mixart_clock_mode { |
| CM_UNDEFINED, |
| CM_MASTER, |
| CM_SLAVE, |
| CM_STANDALONE, |
| CM_NOT_CONCERNED |
| }; |
| |
| |
| typedef struct mixart_clock_properties mixart_clock_properties_t; |
| struct mixart_clock_properties |
| { |
| u32 error_code; |
| u32 validation_mask; |
| u32 frequency; |
| u32 reference_frequency; |
| u32 clock_generic_type; |
| u32 clock_mode; |
| mixart_uid_t uid_clock_source; |
| mixart_uid_t uid_event_source; |
| u32 event_mode; |
| u32 synchro_signal_presence; |
| u32 format; |
| u32 board_mask; |
| u32 nb_callers; /* set to 1 (see below) */ |
| mixart_uid_t uid_caller[1]; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_clock_properties_resp mixart_clock_properties_resp_t; |
| struct mixart_clock_properties_resp |
| { |
| u32 status; |
| u32 clock_mode; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_STREAM_SET_INPUT_STAGE_PARAM = 0x13000F */ |
| /* MSG_STREAM_SET_OUTPUT_STAGE_PARAM = 0x130010 */ |
| |
| enum mixart_coding_type { |
| CT_NOT_DEFINED, |
| CT_LINEAR, |
| CT_MPEG_L1, |
| CT_MPEG_L2, |
| CT_MPEG_L3, |
| CT_MPEG_L3_LSF, |
| CT_GSM |
| }; |
| enum mixart_sample_type { |
| ST_NOT_DEFINED, |
| ST_FLOATING_POINT_32BE, |
| ST_FLOATING_POINT_32LE, |
| ST_FLOATING_POINT_64BE, |
| ST_FLOATING_POINT_64LE, |
| ST_FIXED_POINT_8, |
| ST_FIXED_POINT_16BE, |
| ST_FIXED_POINT_16LE, |
| ST_FIXED_POINT_24BE, |
| ST_FIXED_POINT_24LE, |
| ST_FIXED_POINT_32BE, |
| ST_FIXED_POINT_32LE, |
| ST_INTEGER_8, |
| ST_INTEGER_16BE, |
| ST_INTEGER_16LE, |
| ST_INTEGER_24BE, |
| ST_INTEGER_24LE, |
| ST_INTEGER_32BE, |
| ST_INTEGER_32LE |
| }; |
| |
| typedef struct mixart_stream_param_desc mixart_stream_param_desc_t; |
| struct mixart_stream_param_desc |
| { |
| u32 coding_type; /* use enum mixart_coding_type */ |
| u32 sample_type; /* use enum mixart_sample_type */ |
| |
| union { |
| struct { |
| u32 linear_endian_ness; |
| u32 linear_bits; |
| u32 is_signed; |
| u32 is_float; |
| } linear_format_info; |
| |
| struct { |
| u32 mpeg_layer; |
| u32 mpeg_mode; |
| u32 mpeg_mode_extension; |
| u32 mpeg_pre_emphasis; |
| u32 mpeg_has_padding_bit; |
| u32 mpeg_has_crc; |
| u32 mpeg_has_extension; |
| u32 mpeg_is_original; |
| u32 mpeg_has_copyright; |
| } mpeg_format_info; |
| } format_info; |
| |
| u32 delayed; |
| u64 scheduler; |
| u32 sample_size; |
| u32 has_header; |
| u32 has_suffix; |
| u32 has_bitrate; |
| u32 samples_per_frame; |
| u32 bytes_per_frame; |
| u32 bytes_per_sample; |
| u32 sampling_freq; |
| u32 number_of_channel; |
| u32 stream_number; |
| u32 buffer_size; |
| u32 differed_time; |
| u32 reserved4np[3]; |
| u32 pipe_count; /* set to 1 (array size !) */ |
| u32 stream_count; /* set to 1 (array size !) */ |
| mixart_txx_stream_desc_t stream_desc[1]; /* only one stream per command, but this could be an array */ |
| |
| } __attribute__((packed)); |
| |
| |
| /* MSG_CONNECTOR_GET_OUT_AUDIO_LEVEL = 0x050009, |
| */ |
| |
| |
| typedef struct mixart_get_out_audio_level mixart_get_out_audio_level_t; |
| struct mixart_get_out_audio_level |
| { |
| u32 txx_status; |
| u32 digital_level; /* float */ |
| u32 analog_level; /* float */ |
| u32 monitor_level; /* float */ |
| u32 mute; |
| u32 monitor_mute1; |
| u32 monitor_mute2; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_CONNECTOR_SET_OUT_AUDIO_LEVEL = 0x05000A, |
| */ |
| |
| /* used for valid_mask below */ |
| #define MIXART_AUDIO_LEVEL_ANALOG_MASK 0x01 |
| #define MIXART_AUDIO_LEVEL_DIGITAL_MASK 0x02 |
| #define MIXART_AUDIO_LEVEL_MONITOR_MASK 0x04 |
| #define MIXART_AUDIO_LEVEL_MUTE_MASK 0x08 |
| #define MIXART_AUDIO_LEVEL_MUTE_M1_MASK 0x10 |
| #define MIXART_AUDIO_LEVEL_MUTE_M2_MASK 0x20 |
| |
| typedef struct mixart_set_out_audio_level mixart_set_out_audio_level_t; |
| struct mixart_set_out_audio_level |
| { |
| u32 delayed; |
| u64 scheduler; |
| u32 valid_mask1; |
| u32 valid_mask2; |
| u32 digital_level; /* float */ |
| u32 analog_level; /* float */ |
| u32 monitor_level; /* float */ |
| u32 mute; |
| u32 monitor_mute1; |
| u32 monitor_mute2; |
| u32 reserved4np; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_SYSTEM_ENUM_PHYSICAL_IO = 0x16000E, |
| */ |
| |
| #define MIXART_MAX_PHYS_IO (MIXART_MAX_CARDS * 2 * 2) /* 4 * (analog+digital) * (playback+capture) */ |
| |
| typedef struct mixart_uid_enumeration mixart_uid_enumeration_t; |
| struct mixart_uid_enumeration |
| { |
| u32 error_code; |
| u32 first_uid_offset; |
| u32 nb_uid; |
| u32 current_uid_index; |
| mixart_uid_t uid[MIXART_MAX_PHYS_IO]; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_PHYSICALIO_SET_LEVEL = 0x0F0008, |
| MSG_PHYSICALIO_GET_LEVEL = 0x0F000C, |
| */ |
| |
| typedef struct mixart_io_channel_level mixart_io_channel_level_t; |
| struct mixart_io_channel_level |
| { |
| u32 analog_level; /* float */ |
| u32 unused[2]; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_io_level mixart_io_level_t; |
| struct mixart_io_level |
| { |
| s32 channel; /* 0=left, 1=right, -1=both, -2=both same */ |
| mixart_io_channel_level_t level[2]; |
| } __attribute__((packed)); |
| |
| |
| /* MSG_STREAM_SET_IN_AUDIO_LEVEL = 0x130015, |
| */ |
| |
| typedef struct mixart_in_audio_level_info mixart_in_audio_level_info_t; |
| struct mixart_in_audio_level_info |
| { |
| mixart_uid_t connector; |
| u32 valid_mask1; |
| u32 valid_mask2; |
| u32 digital_level; |
| u32 analog_level; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_set_in_audio_level_req mixart_set_in_audio_level_req_t; |
| struct mixart_set_in_audio_level_req |
| { |
| u32 delayed; |
| u64 scheduler; |
| u32 audio_count; /* set to <= 2 */ |
| u32 reserved4np; |
| mixart_in_audio_level_info_t level[2]; |
| } __attribute__((packed)); |
| |
| /* response is a 32 bit status */ |
| |
| |
| /* MSG_STREAM_SET_OUT_STREAM_LEVEL = 0x130017, |
| */ |
| |
| /* defines used for valid_mask1 */ |
| #define MIXART_OUT_STREAM_SET_LEVEL_LEFT_AUDIO1 0x01 |
| #define MIXART_OUT_STREAM_SET_LEVEL_LEFT_AUDIO2 0x02 |
| #define MIXART_OUT_STREAM_SET_LEVEL_RIGHT_AUDIO1 0x04 |
| #define MIXART_OUT_STREAM_SET_LEVEL_RIGHT_AUDIO2 0x08 |
| #define MIXART_OUT_STREAM_SET_LEVEL_STREAM_1 0x10 |
| #define MIXART_OUT_STREAM_SET_LEVEL_STREAM_2 0x20 |
| #define MIXART_OUT_STREAM_SET_LEVEL_MUTE_1 0x40 |
| #define MIXART_OUT_STREAM_SET_LEVEL_MUTE_2 0x80 |
| |
| typedef struct mixart_out_stream_level_info mixart_out_stream_level_info_t; |
| struct mixart_out_stream_level_info |
| { |
| u32 valid_mask1; |
| u32 valid_mask2; |
| u32 left_to_out1_level; |
| u32 left_to_out2_level; |
| u32 right_to_out1_level; |
| u32 right_to_out2_level; |
| u32 digital_level1; |
| u32 digital_level2; |
| u32 mute1; |
| u32 mute2; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_set_out_stream_level mixart_set_out_stream_level_t; |
| struct mixart_set_out_stream_level |
| { |
| mixart_txx_stream_desc_t desc; |
| mixart_out_stream_level_info_t out_level; |
| } __attribute__((packed)); |
| |
| typedef struct mixart_set_out_stream_level_req mixart_set_out_stream_level_req_t; |
| struct mixart_set_out_stream_level_req |
| { |
| u32 delayed; |
| u64 scheduler; |
| u32 reserved4np[2]; |
| u32 nb_of_stream; /* set to 1 */ |
| mixart_set_out_stream_level_t stream_level; /* could be an array */ |
| } __attribute__((packed)); |
| |
| /* response to this request is a u32 status value */ |
| |
| |
| /* exported */ |
| void snd_mixart_init_mailbox(mixart_mgr_t *mgr); |
| void snd_mixart_exit_mailbox(mixart_mgr_t *mgr); |
| |
| int snd_mixart_send_msg(mixart_mgr_t *mgr, mixart_msg_t *request, int max_resp_size, void *resp_data); |
| int snd_mixart_send_msg_wait_notif(mixart_mgr_t *mgr, mixart_msg_t *request, u32 notif_event); |
| int snd_mixart_send_msg_nonblock(mixart_mgr_t *mgr, mixart_msg_t *request); |
| |
| irqreturn_t snd_mixart_interrupt(int irq, void *dev_id, struct pt_regs *regs); |
| void snd_mixart_msg_tasklet( unsigned long arg); |
| |
| void snd_mixart_reset_board(mixart_mgr_t *mgr); |
| |
| #endif /* __SOUND_MIXART_CORE_H */ |
