btaudio2  2.1.0.0
btaudio2.h
Go to the documentation of this file.
1 /****************************************************************************
2 ** Copyright (C) 2020 MikroElektronika d.o.o.
3 ** Contact: https://www.mikroe.com/contact
4 **
5 ** Permission is hereby granted, free of charge, to any person obtaining a copy
6 ** of this software and associated documentation files (the "Software"), to deal
7 ** in the Software without restriction, including without limitation the rights
8 ** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 ** copies of the Software, and to permit persons to whom the Software is
10 ** furnished to do so, subject to the following conditions:
11 ** The above copyright notice and this permission notice shall be
12 ** included in all copies or substantial portions of the Software.
13 **
14 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
16 ** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
18 ** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
19 ** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20 ** USE OR OTHER DEALINGS IN THE SOFTWARE.
21 ****************************************************************************/
22 
28 #ifndef BTAUDIO2_H
29 #define BTAUDIO2_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
35 #include "mikrosdk_version.h"
36 
37 #ifdef __GNUC__
38 #if mikroSDK_GET_VERSION < 20800ul
39 #include "rcu_delays.h"
40 #else
41 #include "delays.h"
42 #endif
43 #endif
44 
45 #include "drv_digital_out.h"
46 #include "drv_digital_in.h"
47 #include "drv_uart.h"
48 
69 #define BTAUDIO2_CMD_MAKE_CALL 0x00
70 #define BTAUDIO2_CMD_MAKE_EXTENSION_CALL 0x01
71 #define BTAUDIO2_CMD_MMI_ACTION 0x02
72 #define BTAUDIO2_CMD_EVENT_MASK_SETTING 0x03
73 #define BTAUDIO2_CMD_MUSIC_CONTROL 0x04
74 #define BTAUDIO2_CMD_CHANGE_DEVICE_NAME 0x05
75 #define BTAUDIO2_CMD_CHANGE_PIN_CODE 0x06
76 #define BTAUDIO2_CMD_SET_BTM_PARAM 0x07
77 #define BTAUDIO2_CMD_GET_BTM_VERSION 0x08
78 #define BTAUDIO2_CMD_VENDOR_AT_CMD 0x0A
79 #define BTAUDIO2_CMD_AVRCP_SPEC_CMD 0x0B
80 #define BTAUDIO2_CMD_AVRCP_GROUP_NAVIGATION 0x0C
81 #define BTAUDIO2_CMD_READ_LINK_STATUS 0x0D
82 #define BTAUDIO2_CMD_READ_PAIRING_RECORD 0x0E
83 #define BTAUDIO2_CMD_READ_LOCAL_BD_ADDR 0x0F
84 #define BTAUDIO2_CMD_READ_LOCAL_DEVICE_NAME 0x10
85 #define BTAUDIO2_CMD_SEND_SPP_DATA 0x12
86 #define BTAUDIO2_CMD_BTM_UTILITY_FUNCTION 0x13
87 #define BTAUDIO2_CMD_EVENT_ACK 0x14
88 #define BTAUDIO2_CMD_ADDITIONAL_PROFILE_LINK_SETUP 0x15
89 #define BTAUDIO2_CMD_READ_LINKED_DEVICE_INFO 0x16
90 #define BTAUDIO2_CMD_PROFILE_LINK_BACK 0x17
91 #define BTAUDIO2_CMD_DISCONNECT 0x18
92 #define BTAUDIO2_CMD_USER_CONFIRM_SPP_REQ_REPLY 0x1A
93 #define BTAUDIO2_CMD_SET_HF_GAIN_LEVEL 0x1B
94 #define BTAUDIO2_CMD_EQ_MODE_SETTING 0x1C
95 #define BTAUDIO2_CMD_DSP_NR_CTRL 0x1D
96 #define BTAUDIO2_CMD_GPIO_CTRL 0x1E
97 #define BTAUDIO2_CMD_BT_MCU_UART_RX_BUFF_SIZE 0x1F
98 #define BTAUDIO2_CMD_VOICE_PROMPT_CMD 0x20
99 #define BTAUDIO2_CMD_SET_OVERALL_GAIN 0x23
100 #define BTAUDIO2_CMD_READ_BTM_SETTING 0x24
101 #define BTAUDIO2_CMD_READ_BTM_BATTERY_CHARGE_STATUS 0x25
102 #define BTAUDIO2_CMD_MCU_UPDATE 0x26
103 #define BTAUDIO2_CMD_REPORT_BATTERY_CAPACITY 0x27
104 #define BTAUDIO2_CMD_LE_ANCS_SERVICE 0x28
105 #define BTAUDIO2_CMD_LE_SIGNALING 0x29
106 #define BTAUDIO2_CMD_MSPK_VENDOR 0x2A
107 #define BTAUDIO2_CMD_READ_MSPK_LINK_STATUS 0x2B
108 #define BTAUDIO2_CMD_MSPK_SYNC_AUDIO_EFFECT 0x2C
109 #define BTAUDIO2_CMD_LE_GATT 0x2D
110 #define BTAUDIO2_CMD_LE_APP 0x2F
111 #define BTAUDIO2_CMD_DSP_RUNTIME_PROGRAM 0x30
112 #define BTAUDIO2_CMD_READ_VENDOR_EEPROM 0x31
113 #define BTAUDIO2_CMD_READ_IC_VERSION 0x32
114 #define BTAUDIO2_CMD_READ_LINK_MODE 0x34
115 #define BTAUDIO2_CMD_CONFIGURE_VENDOR_PARAM 0x35
116 #define BTAUDIO2_CMD_MSPK_EXCHANGE_LINK_INFO 0x37
117 #define BTAUDIO2_CMD_MSPK_SET_GIAC 0x38
118 #define BTAUDIO2_CMD_READ_FEATURE_LIST 0x39
119 #define BTAUDIO2_CMD_PERSONAL_MSPK_GROUP_CTRL 0x3A
120 #define BTAUDIO2_CMD_TEST_DEVICE 0x3B
121 #define BTAUDIO2_CMD_READ_EEPROM 0x3C
122 #define BTAUDIO2_CMD_WRITE_EEPROM 0x3D
123 #define BTAUDIO2_CMD_LE_SIGNALING_2 0x3E
124 #define BTAUDIO2_CMD_PBAPC 0x3F
125 #define BTAUDIO2_CMD_TWS 0x40
126 #define BTAUDIO2_CMD_AVRCP_BROWSING 0x41
127 #define BTAUDIO2_CMD_READ_PAIRED_LINK_KEY_INFO 0x42
128 #define BTAUDIO2_CMD_AUDIO_TRANSCEIVER 0x44
129 #define BTAUDIO2_CMD_BUTTON_MMI_SETTING 0x46
130 #define BTAUDIO2_CMD_BUTTON_OPERATION 0x47
131 #define BTAUDIO2_CMD_READ_BUTTON_MMI_SETTING 0x48
132 #define BTAUDIO2_CMD_DFU 0x49
133 #define BTAUDIO2_CMD_AVRCP_VENDOR_DEPENDENT 0x4A
134 #define BTAUDIO2_CMD_CONCERT_MODE_ENDLESS_GROUPING 0x4B
135 #define BTAUDIO2_CMD_READ_RUNTIME_LATENCY 0x4C
136 #define BTAUDIO2_CMD_TOGGLE_AUDIO_SOURCE 0xCC
137 
142 #define BTAUDIO2_EVT_CMD_ACK 0x00
143 #define BTAUDIO2_EVT_BTM_STATE 0x01
144 #define BTAUDIO2_EVT_CALL_STATUS 0x02
145 #define BTAUDIO2_EVT_CALL_ID 0x03
146 #define BTAUDIO2_EVT_SMS_INDICATION 0x04
147 #define BTAUDIO2_EVT_MISS_CALL_INDICATION 0x05
148 #define BTAUDIO2_EVT_PHONE_MAX_BATTERY_LEVEL 0x06
149 #define BTAUDIO2_EVT_PHONE_BATTERY_LEVEL 0x07
150 #define BTAUDIO2_EVT_PHONE_ROAMING_STATUS 0x08
151 #define BTAUDIO2_EVT_PHONE_MAX_SIGNAL_STRENGTH 0x09
152 #define BTAUDIO2_EVT_PHONE_SIGNAL_STRENGTH 0x0A
153 #define BTAUDIO2_EVT_PHONE_SERVICE_STATUS 0x0B
154 #define BTAUDIO2_EVT_BATTERY_LEVEL 0x0C
155 #define BTAUDIO2_EVT_CHARGER_STATUS 0x0D
156 #define BTAUDIO2_EVT_RESET_TO_DEFAULT 0x0E
157 #define BTAUDIO2_EVT_VOLUME_LEVEL 0x0F
158 #define BTAUDIO2_EVT_EQ_MODE 0x10
159 #define BTAUDIO2_EVT_LINKED_DEVICE_INFO 0x17
160 #define BTAUDIO2_EVT_BTM_VERSION 0x18
161 #define BTAUDIO2_EVT_CALL_LIST_REPORT 0x19
162 #define BTAUDIO2_EVT_AVRCP_SPEC_RSP 0x1A
163 #define BTAUDIO2_EVT_BTM_UTILITY_REQ 0x1B
164 #define BTAUDIO2_EVT_VENDOR_AT_CMD_RSP 0x1C
165 #define BTAUDIO2_EVT_UNKNOW_AT_RESULT 0x1D
166 #define BTAUDIO2_EVT_REPORT_LINK_STATUS 0x1E
167 #define BTAUDIO2_EVT_REPORT_PAIRING_RECORD 0x1F
168 #define BTAUDIO2_EVT_REPORT_LOCAL_BD_ADDR 0x20
169 #define BTAUDIO2_EVT_REPORT_LOCAL_DEVICE_NAME 0x21
170 #define BTAUDIO2_EVT_REPORT_SPP_DATA 0x22
171 #define BTAUDIO2_EVT_REPORT_LINK_BACK_STATUS 0x23
172 #define BTAUDIO2_EVT_RINGTONE_FINISH_INDICATION 0x24
173 #define BTAUDIO2_EVT_USER_CONFIRM_SSP_REQ 0x25
174 #define BTAUDIO2_EVT_REPORT_AVRCP_VOL_CTRL 0x26
175 #define BTAUDIO2_EVT_REPORT_INPUT_SIGNAL_LEVEL 0x27
176 #define BTAUDIO2_EVT_REPORT_IAP_INFO 0x28
177 #define BTAUDIO2_EVT_REPORT_AVRCP_ABS_VOL_CTRL 0x29
178 #define BTAUDIO2_EVT_REPORT_VOICE_PROMPT_STATUS 0x2A
179 #define BTAUDIO2_EVT_REPORT_TYPE_CODEC 0x2D
180 #define BTAUDIO2_EVT_REPORT_TYPE_BTM_SETTING 0x2E
181 #define BTAUDIO2_EVT_REPORT_MCU_UPDATE_REPLY 0x2F
182 #define BTAUDIO2_EVT_REPORT_BTM_INITIAL_STATUS 0x30
183 #define BTAUDIO2_EVT_REPORT_LE_ANCS_EVENT 0x31
184 #define BTAUDIO2_EVT_REPORT_LE_EVENT 0x32
185 #define BTAUDIO2_EVT_REPORT_MSPK_STATUS 0x33
186 #define BTAUDIO2_EVT_REPORT_MSPK_VENDOR_EVENT 0x34
187 #define BTAUDIO2_EVT_REPORT_MSPK_AUDIO_SETTING 0x35
188 #define BTAUDIO2_EVT_REPORT_MSPK_EFFECT_STATUS 0x36
189 #define BTAUDIO2_EVT_REPORT_VENDOR_EEPROM 0x37
190 #define BTAUDIO2_EVT_REPORT_IC_VERSION_INFO 0x38
191 #define BTAUDIO2_EVT_REPORT_CUSTOMER_GATT_ATTRIBUTE_DATA 0x39
192 #define BTAUDIO2_EVT_REPORT_LINK_MODE 0x3A
193 #define BTAUDIO2_EVT_REPORT_MSPK_EXCHANGE_LINK_INFO 0x3D
194 #define BTAUDIO2_EVT_REPORT_BT_CLK 0x3F
195 #define BTAUDIO2_EVT_REPORT_FEATURE_LIST 0x40
196 #define BTAUDIO2_EVT_REPORT_TEST_RESULT 0x41
197 #define BTAUDIO2_EVT_REPORT_READ_EEPROM_DATA 0x42
198 #define BTAUDIO2_EVT_PBAPC_EVENT 0x43
199 #define BTAUDIO2_EVT_AVRCP_BROWSING_EVENT 0x44
200 #define BTAUDIO2_EVT_REPORT_PAIRED_LINK_KEY_INFO 0x45
201 #define BTAUDIO2_EVT_REPORT_TWS_RX_VENDOR_EVENT 0x53
202 #define BTAUDIO2_EVT_REPORT_TWS_LOCAL_DEVICE_STATUS 0x54
203 #define BTAUDIO2_EVT_REPORT_TWS_VAD_DATA 0x55
204 #define BTAUDIO2_EVT_REPORT_TWS_RADIO_CONDITION 0x56
205 #define BTAUDIO2_EVT_REPORT_TWS_EAR_BUD_POSITION 0x57
206 #define BTAUDIO2_EVT_REPORT_TWS_SECONDARY_DEVICE_STATUS 0x58
207 #define BTAUDIO2_EVT_AUDIO_TRANSCEIVER_EVENT_STATUS 0x5A
208 #define BTAUDIO2_EVT_READ_BUTTON_MMI_SETTING_REPLY 0x5C
209 #define BTAUDIO2_EVT_AVRCP_VENDOR_DEPENDENT_RSP 0x5D
210 #define BTAUDIO2_EVT_RUNTIME_LATENCY 0x5E
211 
216 #define BTAUDIO2_MMI_ADD_REMOVE_SCO_LINK 0x01
217 #define BTAUDIO2_MMI_ENABLE_TEST_MODE 0x03
218 #define BTAUDIO2_MMI_ACCEPT_CALL 0x04
219 #define BTAUDIO2_MMI_REJECT_CALL 0x05
220 #define BTAUDIO2_MMI_ENDCALL_OR_TRANSFER_TO_HEADSET 0x06
221 #define BTAUDIO2_MMI_MIC_MUTE_TOGGLE 0x07
222 #define BTAUDIO2_MMI_MUTE_MIC 0x08
223 #define BTAUDIO2_MMI_UNMUTE_MIC 0x09
224 #define BTAUDIO2_MMI_VOICE_DIAL 0x0A
225 #define BTAUDIO2_MMI_CANCEL_VOICE_DIAL 0x0B
226 #define BTAUDIO2_MMI_LAST_NUMBER_REDIAL 0x0C
227 #define BTAUDIO2_MMI_ACTIVE_CALL_HOLD_ACCEPT_HELD_CALL 0x0D
228 #define BTAUDIO2_MMI_VOICE_TRANSFER 0x0E
229 #define BTAUDIO2_MMI_QUERY_CALL_LIST 0x0F
230 #define BTAUDIO2_MMI_THREE_WAY_CALL 0x10
231 #define BTAUDIO2_MMI_RELEASE_CALL 0x11
232 #define BTAUDIO2_MMI_ACCEPT_WAITING_HOLD_CALL_RLS_ACTIVE_CALL 0x12
233 #define BTAUDIO2_MMI_DISCONNECT_HF_LINK 0x17
234 #define BTAUDIO2_MMI_ENABLE_AEC 0x1E
235 #define BTAUDIO2_MMI_DISABLE_AEC 0x1F
236 #define BTAUDIO2_MMI_SWITCH_AEC 0x20
237 #define BTAUDIO2_MMI_ENABLE_AEC_RX_NOISE_REDUCTION 0x21
238 #define BTAUDIO2_MMI_DISABLE_AEC_RX_NOISE_REDUCTION 0x22
239 #define BTAUDIO2_MMI_SWITCH_AEC_RX_NOISE_REDUCTION 0x23
240 #define BTAUDIO2_MMI_INC_MIC_GAIN 0x24
241 #define BTAUDIO2_MMI_DEC_MIC_GAIN 0x25
242 #define BTAUDIO2_MMI_SWITCH_PRIMARY_SECONDARY_HF_DEVICE 0x26
243 #define BTAUDIO2_MMI_INCREASE_SPEAKER_GAIN 0x30
244 #define BTAUDIO2_MMI_DECREASE_SPEAKER_GAIN 0x31
245 #define BTAUDIO2_MMI_PLAY_PAUSE_MUSIC 0x32
246 #define BTAUDIO2_MMI_STOP_MUSIC 0x33
247 #define BTAUDIO2_MMI_NEXT_SONG 0x34
248 #define BTAUDIO2_MMI_PREVIOUS_SONG 0x35
249 #define BTAUDIO2_MMI_FAST_FORWARD 0x36
250 #define BTAUDIO2_MMI_REWIND 0x37
251 #define BTAUDIO2_MMI_EQ_MODE_UP 0x38
252 #define BTAUDIO2_MMI_EQ_MODE_DOWN 0x39
253 #define BTAUDIO2_MMI_LOCK_BUTTON 0x3A
254 #define BTAUDIO2_MMI_DISCONNECT_A2DP 0x3B
255 #define BTAUDIO2_MMI_NEXT_AUDIO_EFFECT 0x3C
256 #define BTAUDIO2_MMI_PREVIOUS_AUDIO_EFFECT 0x3D
257 #define BTAUDIO2_MMI_REPORT_CURRENT_EQ_MODE 0x3F
258 #define BTAUDIO2_MMI_REPORT_CURRENT_AUDIO_EFFECT_STATUS 0x40
259 #define BTAUDIO2_MMI_TOGGLE_AUDIO_PLAYBACK 0x41
260 #define BTAUDIO2_MMI_POWER_ON_BUTTON_PRESS 0x51
261 #define BTAUDIO2_MMI_POWER_ON_BUTTON_RELEASE 0x52
262 #define BTAUDIO2_MMI_POWER_OFF_BUTTON_PRESS 0x53
263 #define BTAUDIO2_MMI_POWER_OFF_BUTTON_RELEASE 0x54
264 #define BTAUDIO2_MMI_RESET_EEPROM_SETTING 0x56
265 #define BTAUDIO2_MMI_FORCE_SPEAKER_GAIN_TOGGLE 0x57
266 #define BTAUDIO2_MMI_TOGGLE_BUTTON_IND 0x58
267 #define BTAUDIO2_MMI_COMBINE_FUNCTION_0 0x59
268 #define BTAUDIO2_MMI_COMBINE_FUNCTION_1 0x5A
269 #define BTAUDIO2_MMI_COMBINE_FUNCTION_2 0x5B
270 #define BTAUDIO2_MMI_COMBINE_FUNCTION_3 0x5C
271 #define BTAUDIO2_MMI_ENTER_PAIRING_MODE 0x5D
272 #define BTAUDIO2_MMI_SWITCH_POWER_OFF 0x5E
273 #define BTAUDIO2_MMI_DISABLE_LED 0x5F
274 #define BTAUDIO2_MMI_BUZZER_TOGGLE 0x60
275 #define BTAUDIO2_MMI_DISABLE_BUZZER 0x61
276 #define BTAUDIO2_MMI_ENABLE_BUZZER 0x62
277 #define BTAUDIO2_MMI_TONE_CHANGE 0x63
278 #define BTAUDIO2_MMI_SHS_SEND_USER_DATA_1 0x72
279 #define BTAUDIO2_MMI_SHS_SEND_USER_DATA_2 0x73
280 #define BTAUDIO2_MMI_SHS_SEND_USER_DATA_3 0x74
281 #define BTAUDIO2_MMI_SHS_SEND_USER_DATA_4 0x75
282 #define BTAUDIO2_MMI_SHS_SEND_USER_DATA_5 0x76
283 #define BTAUDIO2_MMI_REPORT_CURRENT_RX_NR_STATUS 0x77
284 #define BTAUDIO2_MMI_REPORT_CURRENT_TX_NR_STATUS 0x78
285 #define BTAUDIO2_MMI_CANCEL_ALL_BT_PAGING 0x7A
286 #define BTAUDIO2_MMI_DISCONNECT_SPP_LINK 0x7D
287 #define BTAUDIO2_MMI_ENABLE_A2DP_MIX_LINE_IN 0x80
288 #define BTAUDIO2_MMI_DISABLE_A2DP_MIX_LINE_IN 0x81
289 #define BTAUDIO2_MMI_INCREASE_LINE_IN_INPUT_GAIN 0x82
290 #define BTAUDIO2_MMI_DECREASE_LINE_IN_INPUT_GAIN 0x83
291 #define BTAUDIO2_MMI_TRIGGER_MSPK_CENTRAL 0xE0
292 #define BTAUDIO2_MMI_TRIGGER_MSPK_PERIPHERAL 0xE1
293 #define BTAUDIO2_MMI_MSPK_ONE_KEY_CONNECT 0xE2
294 #define BTAUDIO2_MMI_CANCEL_MSPK_CREATION 0xE3
295 #define BTAUDIO2_MMI_TERMINATE_MSPK_LINK 0xE4
296 #define BTAUDIO2_MMI_TERMINATE_MSPK_CONNECTION 0xE5
297 #define BTAUDIO2_MMI_MSPK_CENTRAL_ENTER_AUX_IN_44p1K_PCM_MODE 0xE6
298 #define BTAUDIO2_MMI_MSPK_CENTRAL_ENTER_AUX_IN_48K_PCM_MODE 0xE7
299 #define BTAUDIO2_MMI_MSPK_CENTRAL_EXIT_AUX_IN_PCM_MODE 0xE8
300 #define BTAUDIO2_MMI_MSPK_SWITCH_CHANNEL 0xEC
301 #define BTAUDIO2_MMI_MSPK_POWER_OFF_ALL_SPEAKERS 0xED
302 #define BTAUDIO2_MMI_MSPK_ERASE_CONCERT_MODE_RECORD 0xEF
303 #define BTAUDIO2_MMI_MSPK_ENTER_STEREO_MODE 0xF4
304 #define BTAUDIO2_MMI_MSPK_ENTER_CONCERT_MODE 0xF5
305 #define BTAUDIO2_MMI_MSPK_ADD_THIRD_SPK 0xF6
306 #define BTAUDIO2_MMI_MSPK_SOUND_SYNC 0xF7
307 #define BTAUDIO2_MMI_MSPK_CSB_CONNECTED_MODE_SWITCH 0xF8
308 #define BTAUDIO2_MMI_MSPK_BACK_TO_LAST_MODE 0xF9
309 #define BTAUDIO2_MMI_MSPK_ONE_KEY_CONNECT_WITH_LINK_BACK 0xFA
310 #define BTAUDIO2_MMI_MSPK_ONE_KEY_OP_STEREO_MODE 0xFB
311 #define BTAUDIO2_MMI_MSPK_ONE_KEY_OP_CONCERT_MODE 0xFC
312 
317 #define BTAUDIO2_ACK_STATUS_CMD_COMPLETE 0x00
318 #define BTAUDIO2_ACK_STATUS_CMD_DISALLOW 0x01
319 #define BTAUDIO2_ACK_STATUS_CMD_UNKNOWN 0x02
320 #define BTAUDIO2_ACK_STATUS_CMD_PARAM_ERR 0x03
321 #define BTAUDIO2_ACK_STATUS_CMD_BTM_BUSY 0x04
322 #define BTAUDIO2_ACK_STATUS_CMD_BTM_FULL 0x05
323 
328 #define BTAUDIO2_BTM_STATE_POWER_OFF 0x00
329 #define BTAUDIO2_BTM_STATE_PAIRING_STATE 0x01
330 #define BTAUDIO2_BTM_STATE_POWER_ON 0x02
331 #define BTAUDIO2_BTM_STATE_PAIRING_SUCCESSFULL 0x03
332 #define BTAUDIO2_BTM_STATE_PAIRING_FAILED 0x04
333 #define BTAUDIO2_BTM_STATE_HFHS_LINK_ESTABLISHED 0x05
334 #define BTAUDIO2_BTM_STATE_A2DP_LINK_ESTABLISHED 0x06
335 #define BTAUDIO2_BTM_STATE_HF_LINK_DISCONNECTED 0x07
336 #define BTAUDIO2_BTM_STATE_A2DP_LINK_DISCONNECTED 0x08
337 #define BTAUDIO2_BTM_STATE_SCO_LINK_CONNECTED 0x09
338 #define BTAUDIO2_BTM_STATE_SCO_LINK_DISCONNECTED 0x0A
339 #define BTAUDIO2_BTM_STATE_AVRCP_LINK_ESTABLISHED 0x0B
340 #define BTAUDIO2_BTM_STATE_AVRCP_LINK_DISCONNECTED 0x0C
341 #define BTAUDIO2_BTM_STATE_STANDARD_SPP_CONNECTED 0x0D
342 #define BTAUDIO2_BTM_STATE_STANDARD_SPP_IAP_DISCONNECTED 0x0E
343 #define BTAUDIO2_BTM_STATE_STANDBY_STATE 0x0F
344 #define BTAUDIO2_BTM_STATE_IAP_CONNECTED 0x10
345 #define BTAUDIO2_BTM_STATE_ACL_DISCONNECTED 0x11
346 #define BTAUDIO2_BTM_STATE_MAP_CONNECTED 0x12
347 #define BTAUDIO2_BTM_STATE_MAP_OPERATION_FORBIDDEN 0x13
348 #define BTAUDIO2_BTM_STATE_MAP_DISCONNECTED 0x14
349 #define BTAUDIO2_BTM_STATE_ACL_CONNECTED 0x15
350 #define BTAUDIO2_BTM_STATE_SPP_IAP_DISCONNECTED_NO_PROFILE 0x16
351 #define BTAUDIO2_BTM_STATE_LINK_BACK_ACL 0x17
352 #define BTAUDIO2_BTM_STATE_INQUIRY_STATE 0x18
353 #define BTAUDIO2_BTM_STATE_UNKNOWN_AUDIO_SOURCE 0x80
354 #define BTAUDIO2_BTM_STATE_AUX_IN_AUDIO_SOURCE 0x81
355 #define BTAUDIO2_BTM_STATE_A2DP_AUDIO_SOURCE 0x82
356 
361 #define BTAUDIO2_VOLUME_MASK_A2DP 0x01
362 #define BTAUDIO2_VOLUME_MASK_HF 0x02
363 #define BTAUDIO2_VOLUME_MASK_LINE_IN 0x04
364 #define BTAUDIO2_VOLUME_MASK_PCM 0x08
365 #define BTAUDIO2_VOLUME_MASK_LINE_IN_INPUT 0x10
366 
371 #define BTAUDIO2_START_HEADER 0xAA
372 
377 #define BTAUDIO2_MODE_FLASH_APPLICATION 0
378 #define BTAUDIO2_MODE_ROM_APPLICATION 1
379 #define BTAUDIO2_MODE_FLASH_IBDK 2
380 #define BTAUDIO2_MODE_ROM_IBDK 3
381 #define BTAUDIO2_MODE_BOOT 4
382 
388 #define BTAUDIO2_RX_DRV_BUFFER_SIZE 300
389 #define BTAUDIO2_TX_DRV_BUFFER_SIZE 300
390 #define BTAUDIO2_PARAM_BUFFER_SIZE 256
391  // btaudio2_cmd
393 
408 #define BTAUDIO2_MAP_MIKROBUS( cfg, mikrobus ) \
409  cfg.tx_pin = MIKROBUS( mikrobus, MIKROBUS_TX ); \
410  cfg.rx_pin = MIKROBUS( mikrobus, MIKROBUS_RX ); \
411  cfg.ean = MIKROBUS( mikrobus, MIKROBUS_AN ); \
412  cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
413  cfg.sc1 = MIKROBUS( mikrobus, MIKROBUS_CS ); \
414  cfg.mfb = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
415  cfg.sc2 = MIKROBUS( mikrobus, MIKROBUS_INT );
416  // btaudio2_map // btaudio2
419 
424 typedef struct
425 {
426  uint8_t opcode; // Command opcode
427  uint8_t param_buf[ BTAUDIO2_PARAM_BUFFER_SIZE ]; // Parameter buffer
428  uint8_t param_len; // Parameter length
429 
431 
436 typedef struct
437 {
438  // Output pins
439  digital_out_t ean;
440  digital_out_t rst;
441  digital_out_t sc1;
442  digital_out_t mfb;
443  digital_out_t sc2;
445  // Modules
446  uart_t uart;
448  // Buffers
449  uint8_t uart_rx_buffer[ BTAUDIO2_RX_DRV_BUFFER_SIZE ];
450  uint8_t uart_tx_buffer[ BTAUDIO2_TX_DRV_BUFFER_SIZE ];
452  btaudio2_packet_t cmd_packet; // Command packet structure
453  btaudio2_packet_t event_packet; // Event packet structure
454 
455 } btaudio2_t;
456 
461 typedef struct
462 {
463  // Communication gpio pins
464  pin_name_t rx_pin;
465  pin_name_t tx_pin;
467  // Additional gpio pins
468  pin_name_t ean;
469  pin_name_t rst;
470  pin_name_t sc1;
471  pin_name_t mfb;
472  pin_name_t sc2;
474  // Static variable
475  uint32_t baud_rate;
477  uart_data_bits_t data_bit;
478  uart_parity_t parity_bit;
479  uart_stop_bits_t stop_bit;
482 
487 typedef enum
488 {
490  BTAUDIO2_ERROR = -1
491 
493 
498 typedef enum
499 {
509 
511 
516 typedef enum
517 {
529 
531 
548 
563 
577 
590 err_t btaudio2_generic_write ( btaudio2_t *ctx, uint8_t *data_in, uint16_t len );
591 
604 err_t btaudio2_generic_read ( btaudio2_t *ctx, uint8_t *data_out, uint16_t len );
605 
615 void btaudio2_set_mfb_pin ( btaudio2_t *ctx, uint8_t state );
616 
626 void btaudio2_set_rst_pin ( btaudio2_t *ctx, uint8_t state );
627 
641 void btaudio2_set_mode ( btaudio2_t *ctx, uint8_t mode );
642 
652 
662 
675 
688 
699 err_t btaudio2_wait_for_event ( btaudio2_t *ctx, uint8_t opcode );
700 
711 
724 err_t btaudio2_send_mmi_action ( btaudio2_t *ctx, uint8_t database_index, uint8_t action );
725 
737 
749 
761 
773 
785 err_t btaudio2_set_device_name ( btaudio2_t *ctx, uint8_t *device_name );
786 
800 
813 err_t btaudio2_make_call ( btaudio2_t *ctx, uint8_t database_index, uint8_t *phone_number );
814 
827 err_t btaudio2_volume_up ( btaudio2_t *ctx, uint8_t database_index, uint8_t mask );
828 
841 err_t btaudio2_volume_down ( btaudio2_t *ctx, uint8_t database_index, uint8_t mask );
842 
854 
866 
880 
881 #ifdef __cplusplus
882 }
883 #endif
884 #endif // BTAUDIO2_H
885  // btaudio2
887 
888 // ------------------------------------------------------------------------ END
BTAUDIO2_PLAY
@ BTAUDIO2_PLAY
Definition: btaudio2.h:505
btaudio2_default_cfg
err_t btaudio2_default_cfg(btaudio2_t *ctx)
BT Audio 2 default configuration function.
BTAUDIO2_REWIND
@ BTAUDIO2_REWIND
Definition: btaudio2.h:503
BTAUDIO2_EQ_MODE_DANCE
@ BTAUDIO2_EQ_MODE_DANCE
Definition: btaudio2.h:526
btaudio2_t::event_packet
btaudio2_packet_t event_packet
Definition: btaudio2.h:453
BTAUDIO2_EQ_MODE_CLASSIC
@ BTAUDIO2_EQ_MODE_CLASSIC
Definition: btaudio2.h:522
btaudio2_set_mfb_pin
void btaudio2_set_mfb_pin(btaudio2_t *ctx, uint8_t state)
BT Audio 2 set MFB pin function.
btaudio2_cfg_setup
void btaudio2_cfg_setup(btaudio2_cfg_t *cfg)
BT Audio 2 configuration object setup function.
btaudio2_clear_events
void btaudio2_clear_events(btaudio2_t *ctx)
BT Audio 2 clear events function.
BTAUDIO2_STOP_FAST_FORWARD_OR_REWIND
@ BTAUDIO2_STOP_FAST_FORWARD_OR_REWIND
Definition: btaudio2.h:500
btaudio2_cfg_t
BT Audio 2 Click configuration object.
Definition: btaudio2.h:462
btaudio2_enable_advertising
err_t btaudio2_enable_advertising(btaudio2_t *ctx)
BT Audio 2 enable advertising function.
btaudio2_power_off_device
err_t btaudio2_power_off_device(btaudio2_t *ctx)
BT Audio 2 power OFF device function.
btaudio2_cfg_t::rx_pin
pin_name_t rx_pin
Definition: btaudio2.h:464
BTAUDIO2_REWIND_WITH_REPEAT
@ BTAUDIO2_REWIND_WITH_REPEAT
Definition: btaudio2.h:504
btaudio2_cfg_t::data_bit
uart_data_bits_t data_bit
Definition: btaudio2.h:477
BTAUDIO2_OK
@ BTAUDIO2_OK
Definition: btaudio2.h:489
BTAUDIO2_EQ_MODE_SOFT
@ BTAUDIO2_EQ_MODE_SOFT
Definition: btaudio2.h:519
btaudio2_send_cmd_with_ack
err_t btaudio2_send_cmd_with_ack(btaudio2_t *ctx)
BT Audio 2 send command with ack check function.
btaudio2_t::sc2
digital_out_t sc2
Definition: btaudio2.h:443
btaudio2_init
err_t btaudio2_init(btaudio2_t *ctx, btaudio2_cfg_t *cfg)
BT Audio 2 initialization function.
BTAUDIO2_EQ_MODE_JAZZ
@ BTAUDIO2_EQ_MODE_JAZZ
Definition: btaudio2.h:524
btaudio2_make_call
err_t btaudio2_make_call(btaudio2_t *ctx, uint8_t database_index, uint8_t *phone_number)
BT Audio 2 make call function.
btaudio2_eq_mode_t
btaudio2_eq_mode_t
BT Audio 2 Click equalizer mode selection values.
Definition: btaudio2.h:517
btaudio2_t::mfb
digital_out_t mfb
Definition: btaudio2.h:442
BTAUDIO2_PARAM_BUFFER_SIZE
#define BTAUDIO2_PARAM_BUFFER_SIZE
Definition: btaudio2.h:390
btaudio2_send_mmi_action
err_t btaudio2_send_mmi_action(btaudio2_t *ctx, uint8_t database_index, uint8_t action)
BT Audio 2 send MMI action function.
BTAUDIO2_FAST_FORWARD_WITH_REPEAT
@ BTAUDIO2_FAST_FORWARD_WITH_REPEAT
Definition: btaudio2.h:502
btaudio2_cfg_t::parity_bit
uart_parity_t parity_bit
Definition: btaudio2.h:478
btaudio2_return_value_t
btaudio2_return_value_t
BT Audio 2 Click return value data.
Definition: btaudio2.h:488
btaudio2_volume_up
err_t btaudio2_volume_up(btaudio2_t *ctx, uint8_t database_index, uint8_t mask)
BT Audio 2 volume up function.
btaudio2_reset_device
void btaudio2_reset_device(btaudio2_t *ctx)
BT Audio 2 reset device function.
btaudio2_enter_pairing_mode
err_t btaudio2_enter_pairing_mode(btaudio2_t *ctx)
BT Audio 2 enter pairing mode function.
btaudio2_packet_t::param_len
uint8_t param_len
Definition: btaudio2.h:428
btaudio2_wait_for_event
err_t btaudio2_wait_for_event(btaudio2_t *ctx, uint8_t opcode)
BT Audio 2 wait for event function.
btaudio2_cfg_t::baud_rate
uint32_t baud_rate
Definition: btaudio2.h:475
BTAUDIO2_PLAY_PAUSE_TOGGLE
@ BTAUDIO2_PLAY_PAUSE_TOGGLE
Definition: btaudio2.h:507
btaudio2_t::ean
digital_out_t ean
Definition: btaudio2.h:439
BTAUDIO2_PAUSE
@ BTAUDIO2_PAUSE
Definition: btaudio2.h:506
btaudio2_cfg_t::rst
pin_name_t rst
Definition: btaudio2.h:469
btaudio2_disable_advertising
err_t btaudio2_disable_advertising(btaudio2_t *ctx)
BT Audio 2 disable advertising function.
BTAUDIO2_EQ_MODE_POP
@ BTAUDIO2_EQ_MODE_POP
Definition: btaudio2.h:525
btaudio2_packet_t
BT Audio 2 Click command/event packet structure object.
Definition: btaudio2.h:425
btaudio2_set_eq_mode
err_t btaudio2_set_eq_mode(btaudio2_t *ctx, btaudio2_eq_mode_t eq_mode)
BT Audio 2 set equalizer mode function.
btaudio2_set_mode
void btaudio2_set_mode(btaudio2_t *ctx, uint8_t mode)
BT Audio 2 set mode function.
btaudio2_send_cmd
void btaudio2_send_cmd(btaudio2_t *ctx)
BT Audio 2 send command function.
btaudio2_volume_down
err_t btaudio2_volume_down(btaudio2_t *ctx, uint8_t database_index, uint8_t mask)
BT Audio 2 volume down function.
btaudio2_cfg_t::tx_pin
pin_name_t tx_pin
Definition: btaudio2.h:465
btaudio2_generic_read
err_t btaudio2_generic_read(btaudio2_t *ctx, uint8_t *data_out, uint16_t len)
BT Audio 2 data reading function.
btaudio2_cfg_t::mfb
pin_name_t mfb
Definition: btaudio2.h:471
btaudio2_reset_to_default
err_t btaudio2_reset_to_default(btaudio2_t *ctx)
BT Audio 2 reset to default function.
btaudio2_cfg_t::stop_bit
uart_stop_bits_t stop_bit
Definition: btaudio2.h:479
btaudio2_music_control_t
btaudio2_music_control_t
BT Audio 2 Click music control values.
Definition: btaudio2.h:499
btaudio2_power_on_device
err_t btaudio2_power_on_device(btaudio2_t *ctx)
BT Audio 2 power ON device function.
btaudio2_cfg_t::sc1
pin_name_t sc1
Definition: btaudio2.h:470
btaudio2_t::uart
uart_t uart
Definition: btaudio2.h:446
BTAUDIO2_EQ_MODE_TREBLE
@ BTAUDIO2_EQ_MODE_TREBLE
Definition: btaudio2.h:521
btaudio2_cfg_t::sc2
pin_name_t sc2
Definition: btaudio2.h:472
BTAUDIO2_STOP
@ BTAUDIO2_STOP
Definition: btaudio2.h:508
BTAUDIO2_RX_DRV_BUFFER_SIZE
#define BTAUDIO2_RX_DRV_BUFFER_SIZE
BT Audio 2 driver buffer size.
Definition: btaudio2.h:388
BTAUDIO2_EQ_MODE_ROCK
@ BTAUDIO2_EQ_MODE_ROCK
Definition: btaudio2.h:523
btaudio2_music_control
err_t btaudio2_music_control(btaudio2_t *ctx, btaudio2_music_control_t action)
BT Audio 2 music control function.
BTAUDIO2_EQ_MODE_USER1
@ BTAUDIO2_EQ_MODE_USER1
Definition: btaudio2.h:528
BTAUDIO2_EQ_MODE_BASS
@ BTAUDIO2_EQ_MODE_BASS
Definition: btaudio2.h:520
btaudio2_generic_write
err_t btaudio2_generic_write(btaudio2_t *ctx, uint8_t *data_in, uint16_t len)
BT Audio 2 data writing function.
btaudio2_cfg_t::ean
pin_name_t ean
Definition: btaudio2.h:468
btaudio2_cfg_t::uart_blocking
bool uart_blocking
Definition: btaudio2.h:476
BTAUDIO2_EQ_MODE_RNB
@ BTAUDIO2_EQ_MODE_RNB
Definition: btaudio2.h:527
btaudio2_t::cmd_packet
btaudio2_packet_t cmd_packet
Definition: btaudio2.h:452
btaudio2_t::rst
digital_out_t rst
Definition: btaudio2.h:440
BTAUDIO2_FAST_FORWARD
@ BTAUDIO2_FAST_FORWARD
Definition: btaudio2.h:501
BTAUDIO2_TX_DRV_BUFFER_SIZE
#define BTAUDIO2_TX_DRV_BUFFER_SIZE
Definition: btaudio2.h:389
BTAUDIO2_ERROR
@ BTAUDIO2_ERROR
Definition: btaudio2.h:490
btaudio2_set_device_name
err_t btaudio2_set_device_name(btaudio2_t *ctx, uint8_t *device_name)
BT Audio 2 set device name function.
btaudio2_read_event
err_t btaudio2_read_event(btaudio2_t *ctx)
BT Audio 2 read event function.
btaudio2_t
BT Audio 2 Click context object.
Definition: btaudio2.h:437
btaudio2_packet_t::opcode
uint8_t opcode
Definition: btaudio2.h:426
BTAUDIO2_EQ_MODE_OFF
@ BTAUDIO2_EQ_MODE_OFF
Definition: btaudio2.h:518
btaudio2_t::sc1
digital_out_t sc1
Definition: btaudio2.h:441
btaudio2_set_rst_pin
void btaudio2_set_rst_pin(btaudio2_t *ctx, uint8_t state)
BT Audio 2 set RST pin function.