| 
    Zephyr Project API
    3.2.0
    
   A Scalable Open Source RTOS 
   | 
 
Media Control Service (MCS) More...
Media Control Service (MCS)
[Experimental] Users should note that the APIs can change as a part of ongoing development.
Definitions and types related to the Media Control Service and Media Control Profile specifications.
| #define BT_MCS_GROUP_OBJECT_GROUP_TYPE 0x01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_GROUP_OBJECT_TRACK_TYPE 0x00 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_MEDIA_STATE_INACTIVE 0x00 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Media states
| #define BT_MCS_MEDIA_STATE_LAST 0x04 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_MEDIA_STATE_PAUSED 0x02 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_MEDIA_STATE_PLAYING 0x01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_MEDIA_STATE_SEEKING 0x03 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_FAST_FORWARD 0x04 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_FAST_REWIND 0x03 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_FIRST_GROUP 0x42 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_FIRST_SEGMENT 0x22 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_FIRST_TRACK 0x32 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_GOTO_GROUP 0x44 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_GOTO_SEGMENT 0x24 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_GOTO_TRACK 0x34 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_LAST_GROUP 0x43 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_LAST_SEGMENT 0x23 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_LAST_TRACK 0x33 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_MOVE_RELATIVE 0x10 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NEXT_GROUP 0x41 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NEXT_SEGMENT 0x21 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NEXT_TRACK 0x31 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NTF_CANNOT_BE_COMPLETED 0x04 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NTF_NOT_SUPPORTED 0x02 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NTF_PLAYER_INACTIVE 0x03 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_NTF_SUCCESS 0x01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Media control point notification result codes
| #define BT_MCS_OPC_PAUSE 0x02 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_PLAY 0x01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Media control point opcodes
| #define BT_MCS_OPC_PREV_GROUP 0x40 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_PREV_SEGMENT 0x20 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_PREV_TRACK 0x30 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_STOP 0x05 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_FAST_FORWARD BIT(3) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_FAST_REWIND BIT(2) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_FIRST_GROUP BIT(18) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_FIRST_SEGMENT BIT(8) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_FIRST_TRACK BIT(13) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_GOTO_GROUP BIT(20) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_GOTO_SEGMENT BIT(10) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_GOTO_TRACK BIT(15) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_LAST_GROUP BIT(19) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_LAST_SEGMENT BIT(9) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_LAST_TRACK BIT(14) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_MOVE_RELATIVE BIT(5) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_NEXT_GROUP BIT(17) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_NEXT_SEGMENT BIT(7) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_NEXT_TRACK BIT(12) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_PAUSE BIT(1) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_PLAY BIT(0) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Media control point supported opcodes values
| #define BT_MCS_OPC_SUP_PREV_GROUP BIT(16) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_PREV_SEGMENT BIT(6) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_PREV_TRACK BIT(11) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPC_SUP_STOP BIT(4) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_OPCODES_SUPPORTED_LEN 4 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Media control point supported opcodes length
| #define BT_MCS_PLAYBACK_SPEED_DOUBLE 64 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYBACK_SPEED_HALF -64 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYBACK_SPEED_MAX 127 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYBACK_SPEED_MIN -128 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Playback speeds.
All values from -128 to 127 allowed, only some defined
| #define BT_MCS_PLAYBACK_SPEED_QUARTER -128 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYBACK_SPEED_UNITY 0 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_INORDER_ONCE 0x03 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_INORDER_REPEAT 0x04 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_NEWEST_ONCE 0x07 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_NEWEST_REPEAT 0x08 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_OLDEST_ONCE 0x05 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_OLDEST_REPEAT 0x06 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_SHUFFLE_ONCE 0x09 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_SHUFFLE_REPEAT 0x0a | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDER_SINGLE_ONCE 0X01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Playing orders
| #define BT_MCS_PLAYING_ORDER_SINGLE_REPEAT 0x02 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_INORDER_ONCE BIT(2) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_INORDER_REPEAT BIT(3) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_NEWEST_ONCE BIT(6) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_NEWEST_REPEAT BIT(7) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_OLDEST_ONCE BIT(4) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_OLDEST_REPEAT BIT(5) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_SHUFFLE_ONCE BIT(8) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_SHUFFLE_REPEAT BIT(9) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_SINGLE_ONCE BIT(0) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Playing orders supported.
A bitmap, in the same order as the playing orders above. Note that playing order 1 corresponds to bit 0, and so on.
| #define BT_MCS_PLAYING_ORDERS_SUPPORTED_SINGLE_REPEAT BIT(1) | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SCP_NTF_FAILURE 0x02 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SCP_NTF_SUCCESS 0x01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Search notification result codes
| #define BT_MCS_SEARCH_TYPE_ALBUM_NAME 0x03 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_ARTIST_NAME 0x02 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_EARLIEST_YEAR 0x05 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_GENRE 0x07 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_GROUP_NAME 0x04 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_LATEST_YEAR 0x06 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_ONLY_GROUPS 0x09 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_ONLY_TRACKS 0x08 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEARCH_TYPE_TRACK_NAME 0x01 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Search control point type values
| #define BT_MCS_SEEKING_SPEED_FACTOR_MAX 64 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Seeking speed.
The allowed values for seeking speed are the range -64 to -4 (endpoints included), the value 0, and the range 4 to 64 (endpoints included).
| #define BT_MCS_SEEKING_SPEED_FACTOR_MIN 4 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define BT_MCS_SEEKING_SPEED_FACTOR_ZERO 0 | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define SEARCH_LEN_MAX 64 /* Max total length of search, defined by spec */ | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define SEARCH_LEN_MIN | 
#include <include/zephyr/bluetooth/audio/mcs.h>
Search control point values
| #define SEARCH_PARAM_MAX | 
#include <include/zephyr/bluetooth/audio/mcs.h>
| #define SEARCH_SCI_LEN_MIN | 
#include <include/zephyr/bluetooth/audio/mcs.h>