1 /* SPDX-License-Identifier: BSD-3-Clause */ 2 /* 3 * Copyright (c) 2015-2016 Google Inc. 4 */ 5 /* 6 * This is a special protocol for configuring communication over the 7 * I2S bus between the DSP on the MSM8994 and APBridgeA. Therefore, 8 * we can predefine several low-level attributes of the communication 9 * because we know that they are supported. In particular, the following 10 * assumptions are made: 11 * - there are two channels (i.e., stereo) 12 * - the low-level protocol is I2S as defined by Philips/NXP 13 * - the DSP on the MSM8994 is the clock master for MCLK, BCLK, and WCLK 14 * - WCLK changes on the falling edge of BCLK 15 * - WCLK low for left channel; high for right channel 16 * - TX data is sent on the falling edge of BCLK 17 * - RX data is received/latched on the rising edge of BCLK 18 */ 19 20 #ifndef __AUDIO_APBRIDGEA_H 21 #define __AUDIO_APBRIDGEA_H 22 23 #define AUDIO_APBRIDGEA_TYPE_SET_CONFIG 0x01 24 #define AUDIO_APBRIDGEA_TYPE_REGISTER_CPORT 0x02 25 #define AUDIO_APBRIDGEA_TYPE_UNREGISTER_CPORT 0x03 26 #define AUDIO_APBRIDGEA_TYPE_SET_TX_DATA_SIZE 0x04 27 /* 0x05 unused */ 28 #define AUDIO_APBRIDGEA_TYPE_PREPARE_TX 0x06 29 #define AUDIO_APBRIDGEA_TYPE_START_TX 0x07 30 #define AUDIO_APBRIDGEA_TYPE_STOP_TX 0x08 31 #define AUDIO_APBRIDGEA_TYPE_SHUTDOWN_TX 0x09 32 #define AUDIO_APBRIDGEA_TYPE_SET_RX_DATA_SIZE 0x0a 33 /* 0x0b unused */ 34 #define AUDIO_APBRIDGEA_TYPE_PREPARE_RX 0x0c 35 #define AUDIO_APBRIDGEA_TYPE_START_RX 0x0d 36 #define AUDIO_APBRIDGEA_TYPE_STOP_RX 0x0e 37 #define AUDIO_APBRIDGEA_TYPE_SHUTDOWN_RX 0x0f 38 39 #define AUDIO_APBRIDGEA_PCM_FMT_8 BIT(0) 40 #define AUDIO_APBRIDGEA_PCM_FMT_16 BIT(1) 41 #define AUDIO_APBRIDGEA_PCM_FMT_24 BIT(2) 42 #define AUDIO_APBRIDGEA_PCM_FMT_32 BIT(3) 43 #define AUDIO_APBRIDGEA_PCM_FMT_64 BIT(4) 44 45 #define AUDIO_APBRIDGEA_PCM_RATE_5512 BIT(0) 46 #define AUDIO_APBRIDGEA_PCM_RATE_8000 BIT(1) 47 #define AUDIO_APBRIDGEA_PCM_RATE_11025 BIT(2) 48 #define AUDIO_APBRIDGEA_PCM_RATE_16000 BIT(3) 49 #define AUDIO_APBRIDGEA_PCM_RATE_22050 BIT(4) 50 #define AUDIO_APBRIDGEA_PCM_RATE_32000 BIT(5) 51 #define AUDIO_APBRIDGEA_PCM_RATE_44100 BIT(6) 52 #define AUDIO_APBRIDGEA_PCM_RATE_48000 BIT(7) 53 #define AUDIO_APBRIDGEA_PCM_RATE_64000 BIT(8) 54 #define AUDIO_APBRIDGEA_PCM_RATE_88200 BIT(9) 55 #define AUDIO_APBRIDGEA_PCM_RATE_96000 BIT(10) 56 #define AUDIO_APBRIDGEA_PCM_RATE_176400 BIT(11) 57 #define AUDIO_APBRIDGEA_PCM_RATE_192000 BIT(12) 58 59 #define AUDIO_APBRIDGEA_DIRECTION_TX BIT(0) 60 #define AUDIO_APBRIDGEA_DIRECTION_RX BIT(1) 61 62 /* The I2S port is passed in the 'index' parameter of the USB request */ 63 /* The CPort is passed in the 'value' parameter of the USB request */ 64 65 struct audio_apbridgea_hdr { 66 __u8 type; 67 __le16 i2s_port; 68 __u8 data[]; 69 } __packed; 70 71 struct audio_apbridgea_set_config_request { 72 struct audio_apbridgea_hdr hdr; 73 __le32 format; /* AUDIO_APBRIDGEA_PCM_FMT_* */ 74 __le32 rate; /* AUDIO_APBRIDGEA_PCM_RATE_* */ 75 __le32 mclk_freq; /* XXX Remove? */ 76 } __packed; 77 78 struct audio_apbridgea_register_cport_request { 79 struct audio_apbridgea_hdr hdr; 80 __le16 cport; 81 __u8 direction; 82 } __packed; 83 84 struct audio_apbridgea_unregister_cport_request { 85 struct audio_apbridgea_hdr hdr; 86 __le16 cport; 87 __u8 direction; 88 } __packed; 89 90 struct audio_apbridgea_set_tx_data_size_request { 91 struct audio_apbridgea_hdr hdr; 92 __le16 size; 93 } __packed; 94 95 struct audio_apbridgea_prepare_tx_request { 96 struct audio_apbridgea_hdr hdr; 97 } __packed; 98 99 struct audio_apbridgea_start_tx_request { 100 struct audio_apbridgea_hdr hdr; 101 __le64 timestamp; 102 } __packed; 103 104 struct audio_apbridgea_stop_tx_request { 105 struct audio_apbridgea_hdr hdr; 106 } __packed; 107 108 struct audio_apbridgea_shutdown_tx_request { 109 struct audio_apbridgea_hdr hdr; 110 } __packed; 111 112 struct audio_apbridgea_set_rx_data_size_request { 113 struct audio_apbridgea_hdr hdr; 114 __le16 size; 115 } __packed; 116 117 struct audio_apbridgea_prepare_rx_request { 118 struct audio_apbridgea_hdr hdr; 119 } __packed; 120 121 struct audio_apbridgea_start_rx_request { 122 struct audio_apbridgea_hdr hdr; 123 } __packed; 124 125 struct audio_apbridgea_stop_rx_request { 126 struct audio_apbridgea_hdr hdr; 127 } __packed; 128 129 struct audio_apbridgea_shutdown_rx_request { 130 struct audio_apbridgea_hdr hdr; 131 } __packed; 132 133 #endif /*__AUDIO_APBRIDGEA_H */ 134