AppleAccessory DesignGuidelines
AppleAccessory DesignGuidelines
AppleAccessory DesignGuidelines
Introduction 11
1. Introduction 12
1.1 Purpose of This Specification 12
1.2 Requirements, Recommendations, and Permissions 12
1.3 Terminology 13
1.3.1 Accessory, Device, and Product 13
Accessories 14
2. All Accessories 15
2.1 Attachments 15
2.2 Magnetic Interference 15
2.3 Radio Frequency (RF) Performance 15
2.3.1 Materials and Coatings 15
2.3.2 Antenna Keep-Out 16
2.3.3 Over The Air (OTA) 16
2.3.4 Near Field Communication (NFC) 17
2.4 Qi Wireless Power 17
3. Cases 18
3.1 Product Design 18
3.1.1 Device Protection 18
3.1.2 Access to Inputs and Interconnects 19
3.1.3 Dock Compatibility 21
3.2 Acoustics 21
3.2.1 Call Quality 21
3.2.2 Speaker to Microphone Coupling 21
3.2.3 Speaker/Microphone Openings 22
3.3 Ambient Light Sensor and Proximity Sensor Interference 24
3.4 Taptic Engine 24
3.5 Magnetic Interference 25
3.6 Home Button / Touch ID Sensor 25
2
Contents
3.7 Camera 25
3.7.1 Geometry 25
3.7.2 Color 26
3.7.3 Surface Finish 26
3.7.4 Image Degradation Examples 26
3.8 Reliability 27
3.8.1 Device Insertion and Removal 27
3.8.2 Colorfastness 27
3.9 Environmental 28
3.10 Test Procedures 28
3.10.1 Required Apple Device Models 28
3.10.2 Product Design 32
3.10.3 Taptic Engine 34
3.10.4 Home Button / Touch ID Sensor Overlays 35
3.10.5 Acoustics 36
4. Covers 38
4.1 Magnetic Interference 38
4.2 Smart Covers 38
5. Screen Overlays 39
5.1 Product Design 39
5.2 Edge Swipe Gestures 39
5.3 Edge Press Gestures 40
6. Camera Attachments 41
6.1 Magnetic Interference 41
Bluetooth 44
8. Bluetooth Introduction 45
8.1 Apple Bluetooth Development Mailing List 45
9. Bluetooth 46
9.1 Enhanced Data Rate 46
9.2 Adaptive Frequency Hopping 46
3
Contents
4
Contents
14. Siri 72
14.1 Enabling Custom Siri Commands 72
14.2 Obtaining Siri Availability Information 72
14.2.1 Obtaining Status Information at Connection 72
14.2.2 Receiving Siri Availability Updates from the Apple Device 73
14.3 Initiating a Siri Session 74
14.3.1 Initiating a Session from the Accessory 74
14.3.2 Initiating a Session from the Apple Device 75
14.3.3 Ending a Session from the Accessory 75
14.4 Siri Eyes Free Mode 76
14.4.1 HFP Command AT+APLEFM 76
14.5 Improving Voice Recognition 77
14.5.1 Wide Band Speech Support 77
14.6 Optimizing the Siri Experience 78
14.7 Common Siri Applications 78
14.7.1 Initialization Procedure After Connection is Established 78
14.7.2 Phone Dialing Using Siri 79
14.7.3 Audio Routing and Media Playback Using Siri 79
14.7.4 Turn-By-Turn Directions Using Siri 80
14.8 User Interaction with Siri Eyes Free in a Vehicle 80
14.9 Enabling/Disabling Siri from the Apple Device 82
14.10 Test Procedures 83
14.10.1 Siri Eyes Free 83
5
Contents
References 88
6
Contents
7
Figures and Tables
3. Cases 18
Figure 3-1 Device Protection 19
Figure 3-2 Touchscreen keep-out area 20
Figure 3-3 Microphone/speaker opening recommendations for thin cases 22
Figure 3-4 Thick case acoustic channels 23
Figure 3-5 Thick case microphone and speaker exit separation 23
Figure 3-6 Improper thick case seal 24
Figure 3-7 Sample image degradation by image blocking in ambient condition 26
Figure 3-8 Sample image degradation by color shift through accessory with strong color 27
Figure 3-9 Sample image degradation by flash interference 27
Figure 3-10 Apple device proudness test 33
Figure 3-11 Apple device gap test 33
Figure 3-12 Apple device touchscreen keep-out test 34
Table 3-1 iPhone X Case Testing Matrix 28
Table 3-2 iPhone 8 Plus/iPhone 7 Plus Case Testing Matrix 28
Table 3-3 iPhone 8/iPhone 7 Case Testing Matrix 29
Table 3-4 iPhone 6s Plus/iPhone 6 Plus Case Testing Matrix 29
Table 3-5 iPhone 6s/iPhone 6 Case Testing Matrix 29
Table 3-6 iPhone 5/iPhone 5s/iPhone SE Case Testing Matrix 29
Table 3-7 iPhone 5c Case Testing Matrix 30
Table 3-8 iPad Pro (10.5-inch) Case Testing Matrix 30
Table 3-9 iPad Pro (12.9-inch) 2nd Generation Case Testing Matrix 30
Table 3-10 iPad (5th and 6th generation) Case Testing Matrix 30
Table 3-11 iPad Pro (9.7-inch) Case Testing Matrix 30
Table 3-12 iPad Pro (12.9-inch) 1st Generation Case Testing Matrix 30
Table 3-13 iPad mini 4 Case Testing Matrix 31
Table 3-14 iPad mini/iPad mini 2/iPad mini 3 Case Testing Matrix 31
Table 3-15 iPad Air 2 Case Testing Matrix 31
Table 3-16 iPad Air Case Testing Matrix 31
Table 3-17 iPad (4th generation) Case Testing Matrix 31
Table 3-18 iPod touch (5th generation)/iPod touch (6th generation) Case Testing Matrix 31
8
Figures and Tables
9. Bluetooth 46
Figure 9-1 Initiate Audio Playback (e.g. music) 57
Figure 9-2 Initiate System Sound (e.g. turn-by-turn directions) 57
14. Siri 72
Figure 14-1 Siri is Disabled/Enabled from the Apple Device's Settings 73
Figure 14-2 Initiating a Siri Session from the Accessory 74
Figure 14-3 Initiating a Siri Session from the Apple Device 75
Figure 14-4 Ending a Siri Session from the Accessory 76
Figure 14-5 Siri Initialization Procedure 79
Figure 14-6 Siri Initialization Procedure with Siri Eyes Free 79
Figure 14-7 Siri Eyes Free User Interaction 81
Figure 14-8 Siri is Deactivated - Launching Voice Control 82
Figure 14-9 Siri is Deactivated - Displaying a Warning Message 82
9
Figures and Tables
Figure 16-17 iPad Pro (12.9-inch) 2nd Generation with Wi-Fi Dimensional Drawing 107
Figure 16-18 iPad Pro (12.9-inch) 2nd Generation with Wi-Fi + Cellular Dimensional Drawing 108
Figure 16-19 iPad Pro (12.9-inch) 2nd Generation Magnet/Hall Effect Sensors 1 of 2 Dimensional Drawing
109
Figure 16-20 iPad Pro (12.9-inch) 2nd Generation Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing
110
Figure 16-21 iPad (5th and 6th generation) with Wi-Fi + Cellular Dimensional Drawing 111
Figure 16-22 iPad (5th and 6th generation) Magnet/Hall Effect Sensors 1 of 2 Dimensional Drawing 112
Figure 16-23 iPad (5th and 6th generation) Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing 113
Figure 16-24 iPad Pro (9.7-inch) with Wi-Fi Dimensional Drawing 114
Figure 16-25 iPad Pro (9.7-inch) with Wi-Fi + Cellular Dimensional Drawing 115
Figure 16-26 iPad Pro (9.7-inch) Magnet/Hall Effect Sensors 1 of 2 Dimensional Drawing 116
Figure 16-27 iPad Pro (9.7-inch) Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing 117
Figure 16-28 iPad Pro (12.9-inch) 1st Generation with Wi-Fi Dimensional Drawing 118
Figure 16-29 iPad Pro (12.9-inch) 1st Generation with Wi-Fi + Cellular Dimensional Drawing 119
Figure 16-30 iPad Pro (12.9-inch) 1st Generation Magnet/Hall Effect Sensors 1 of 2 Dimensional Drawing
120
Figure 16-31 iPad Pro (12.9-inch) 1st Generation Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing
121
Figure 16-32 iPad mini 4 with Wi-Fi Dimensional Drawing 122
Figure 16-33 iPad mini 4 with Wi-Fi + Cellular Dimensional Drawing 123
Figure 16-34 iPad mini 4 Magnet/Hall Effect Sensors Dimensional Drawing 124
Figure 16-35 iPad Air 2 with Wi-Fi Dimensional Drawing 125
Figure 16-36 iPad Air 2 with Wi-Fi + Cellular Dimensional Drawing 126
Figure 16-37 iPad mini 2 & iPad mini 3 with Wi-Fi Dimensional Drawing 127
Figure 16-38 iPad mini 2 & iPad mini 3 with Wi-Fi + Cellular Dimensional Drawing 128
Figure 16-39 iPad Air with Wi-Fi Dimensional Drawing 129
Figure 16-40 iPad Air with Wi-Fi + Cellular Dimensional Drawing 130
Figure 16-41 iPad mini with Wi-Fi Dimensional Drawing 131
Figure 16-42 iPad mini with Wi-Fi + Cellular Dimensional Drawing 132
Figure 16-43 iPad (4th generation) with Wi-Fi Dimensional Drawing 133
Figure 16-44 iPad (4th generation) with Wi-Fi + Cellular Dimensional Drawing 134
Figure 16-45 iPod touch (6th generation) Dimensional Drawing 135
Figure 16-46 iPod touch (5th generation) Dimensional Drawing 136
10
Introduction
1. Introduction
Note: These Accessory Design Guidelines for Apple Devices ('Guidelines') are subject to the terms
and conditions set forth on the final page of this document. By downloading, accessing, or otherwise
utilizing these Guidelines, you agree to be bound by, and only utilize the Guidelines in accordance
with, such terms and conditions.
● The physical design of cases, covers, screen overlays, and camera attachments for Apple devices.
● The specifications for hardware accessories that use the Bluetooth transport to communicate with Apple
products including Mac, iPhone, iPad, and iPod touch models.
● The design of wireless power transmitters for Apple devices.
These guidelines do not address other aspects of accessory communication with Apple devices. Instead, see
the MFi Program (https://developer.apple.com/programs/mfi/).
12
1. Introduction
1.3 Terminology
The absence of requirements, recommendations, or permissions for a specific accessory design in this
specification must not be interpreted as implied approval of that design. Developers are strongly encouraged
to ask Apple for feedback on accessory designs that are not explicitly mentioned in this specification.
1.3 Terminology
Statements that explicitly mention iOS, watchOS, tvOS, or macOS / OS X apply only to products running those
operating systems.
13
Accessories
2. All Accessories
The requirements in this section apply to all accessories regardless of their feature sets.
2.1 Attachments
Accessories must remain compliant with the specification when connected to any attachments designed for
that accessory.
All accessories claiming compatibility with Apple devices that contain a digital compass (magnetometer) must
minimize interference with the digital compass and must not repeatedly trigger compass recalibration.
All accessories claiming compatibility with Apple devices that contain rear camera autofocus (AF) and/or optical
image stabilization (OIS) features must not affect the operation of these features.
● Metals
● Conductive materials or coatings
15
2. All Accessories
2.3 Radio Frequency (RF) Performance
Such materials absorb radio frequency energy and may impair or degrade the performance of antennas for
cellular communication, GPS, Wi-Fi, Bluetooth, and NFC.
Accessory materials or coatings that absorb radio frequency energy (see Materials and Coatings (page 15)) in
the antenna keep-out region have a higher risk of degrading Apple device wireless performance.
Accessories must not excessively degrade the Apple device's RF reception sensitivity. This can be quantified
by measuring Effective Isotropic Sensitivity (EIS) across all of the device's operating bands.
Accessories may have a higher risk of excessively degrading Apple device RF performance if they:
● Contain magnets.
● Intrude on Apple device antenna keep-out zones (see Antenna Keep-Out (page 16)).
All accessory configurations must be taken into account when designing for maximum RF compatibility.
Examples include, but are not limited to:
● Accessory on/off
● Accessory open/closed
● Attachment present/not present (see Attachments (page 15))
16
2. All Accessories
2.4 Qi Wireless Power
● iPhone X
● iPhone 8 Plus
● iPhone 8
● iPhone 7 Plus
● iPhone 7
● iPhone SE
● iPhone 6s Plus
● iPhone 6s
● iPhone 6 Plus
● iPhone 6
17
3. Cases
Accessories that substantially enclose Apple devices must comply with the requirements stated in this chapter
unless the accessory supports other features in this specification whose requirements conflict with the
requirements in this chapter.
If the accessory has multiple user-detachable components that substantially enclose the Apple device, the
requirements and/or overrides must be applied to each component separately.
Care should be given to the design of the bottom of the case to achieve both device protection and access to
device speakers, microphones, and connectors. For instance, the bottom of iPhone X cases should:
● Not have an opening wider than 50 mm (see dimension A in Figure 3-1 (page 19)).
● Be made of polycarbonate (PC) at least 1.15 mm thick (see dimension B in Figure 3-1 (page 19)).
18
3. Cases
3.1 Product Design
B B
A
● Volume buttons
● Ring/Silent switch
● Side button
● Home/Touch ID sensor
● Home button
● Sleep/Wake button
19
3. Cases
3.1 Product Design
The accessory must also provide unobstructed access to the Lightning connector.
If the accessory is for an Apple device with the Lightning connector, the opening (i.e., keep-out area) must be
at least 12.05 mm by 6.30 mm with full radii rounded edges. 13.65 mm by 6.85 mm is recommended for best
compatibility with a range of cables and docks.
In addition, the headset jack and Lightning connector openings must be designed with enough margin to
compensate for shifting or dimensional changes of the accessory material.
3.1.2.4 Touchscreen
The accessory should not have any edges that can collect water on the touchscreen area when the Apple
device is held at a 30° angle relative to the horizon.
Accessories must allow a 120° opening along the edges of the active area of the touchscreen to ensure
compatibility with the Apple device touchscreen features. See Figure 3-2 (page 20) for more information on
the keep-out and Device Dimensional Drawings (page 89) device specific active display areas.
20
3. Cases
3.2 Acoustics
● iPhone X
● iPhone 8 Plus
● iPhone 8
● iPhone 7 Plus
● iPhone 7
● iPhone 6s Plus
● iPhone 6s
● iPhone 6 Plus
● iPhone 6
3.2 Acoustics
The accessory must not impair or degrade the acoustic performance of an Apple device.
The accessory must not obstruct any microphones during a phone call. Note that occluding any microphones
can result in call quality degradation.
21
3. Cases
3.2 Acoustics
● Be offset at least 2.0 mm from the edge of any Apple device speaker/microphone port.
● Be at most 1.5 mm thick along their inner diameter.
● Have a maximum 45° incoming angle to their inner diameter.
● Maintain a proper seal against the Apple device between speaker/microphone ports.
Offset from port opening ≥ 2.0mm Case edge incoming angle ≤ 45º
Case ≤ 2.25mm
Device
Housing
22
3. Cases
3.2 Acoustics
Device
Housing
Thick cases should maximize exit separation between speaker and microphone channels.
Case
> 2.25mm Separation does not occlude port
Device
Housing
Thick case channels may act as a resonant chamber and detune microphone/speaker frequency response. The
resulting frequency response may vary according to channel size/shape.
If a thick case does not maintain a proper seal against the Apple device between microphone/speaker channels,
the case itself may become an acoustic chamber.
23
3. Cases
3.3 Ambient Light Sensor and Proximity Sensor Interference
Case
> 2.25mm
Device
Housing
● iPhone X
● iPhone 8 Plus
● iPhone 8
● iPhone 7 Plus
● iPhone 7
● iPhone 6s Plus
● iPhone 6s
24
3. Cases
3.5 Magnetic Interference
Home button / Touch ID sensor keep-outs for Apple devices can be found in Device Dimensional Drawings (page
89).
Additionally, accessories that overlay the iPhone 8 Plus, iPhone 8, iPhone 7 Plus, and iPhone 7 Home button /
Touch ID sensor may cause users to have difficulty using the Home button / Touch ID sensor.
3.7 Camera
The field of view (FOV) of the camera and the illumination provided by the flash are designed for each Apple
product camera. It is imperative that manufacturers consult technical specifications released for each product
and do not assume these parameters are shared between products.
Images from the camera may be affected by the geometry, color, and surface finish of the accessory openings
for camera and applicable flash.
3.7.1 Geometry
The camera lens FOV must not be blocked. Making the accessory opening too small around the camera and
flash may block the FOV of the lens and the illumination from the flash. Blocking the FOV may cause vignetting
in the image, where one or more corners of the image reproduced are darker than the center. Blocking marginal
rays just outside the FOV of the lens may also reduce the sharpness and contrast of the image. Blocking the
illumination from the flash may cause haze in the image, which resulting in reduced contrast. See Device
Dimensional Drawings (page 89) for the camera keep-out.
The accessory opening must not be designed in a way that directs stray light into the camera. If the opening
is too narrow or too steep, it may reflect light into the camera, washing out the image or adding an unwanted
color cast. Adding a chamfer to the accessory opening trim may help to direct stray light away from the camera.
Additionally, where the product is equipped with a flash, a narrow or steep opening may reflect light from the
accessory opening back into the camera. This may cause the image to appear washed out or contain unwanted
25
3. Cases
3.7 Camera
artifacts. Designers should ensure that the mechanical keep-outs outlined in the device dimensional drawings
(Device Dimensional Drawings (page 89)) are maintained with worst-case X-Y placement tolerances to minimize
the risk of haze.
3.7.2 Color
Any light reflected from the accessory may pick up the color of the accessory. Black material or black coating
may help avoid color bleeding into the camera from an external light source or the flash. The darker the color,
the less light may be reflected from the source into the camera.
Note: Apple recommends a semi-gloss black material or coating around the camera and flash
opening.
Reference Degraded
26
3. Cases
3.8 Reliability
Figure 3-8 Sample image degradation by color shift through accessory with strong color
Reference Degraded
Reference Degraded
3.8 Reliability
Cases for Apple devices must be tested to verify that they will withstand long-term use under typical use
conditions, and that they do not impair or degrade the functionality of the device, damage it or its immediate
surroundings, or adversely affect the user.
3.8.2 Colorfastness
Any dyes, inks, or coatings in or on the case must not bleed color onto either the device or its user, particularly
while the case is in contact with common substances, such as water or sunscreen.
27
3. Cases
3.9 Environmental
3.9 Environmental
Accessories for Apple devices must comply with applicable environmental regulations in the regions in which
such accessories are to be sold, and any applicable substance or material restrictions, including applicable
restrictions on the following substances:
● Organic tin compounds, PFOS, PFOA, phthalates, azo dyes, polybrominated biphenyls (PBBs) and PAHs,
per requirements of the EU REACh regulation EC 1907/2006.
● Nickel leach rate on surfaces in prolonged skin contact, per requirements of the EU REACh regulation EC
1907/2006.
● Cadmium, lead, hexavalent chromium, and nickel, per requirements of EU Directive 2009/48/EC.
● Natural rubber latex, per requirements of EU Directive EC 93/42/EEC.
● Dimethylfumarate (DMFu), per requirements of EU Regulation 412/2012.
● pH and Formaldehyde, per requirements of China GB 18401 for textiles and China GB 20400 for leather.
● Endangered species of flora and fauna in products or packaging (US Lacey Act).
● Polybrominated diphenyl ethers (PBDE).
3.10.1.1 iPhone X
Table 3-1 iPhone X Case Testing Matrix
28
3. Cases
3.10 Test Procedures
It is not possible for a case to claim compatibility with only the iPhone 8 Plus or only the iPhone 7 Plus.
It is not possible for a case to claim compatibility with only the iPhone 8 or only the iPhone 7.
It is not possible for a case to claim compatibility with only the iPhone 6s Plus or only the iPhone 6 Plus.
It is not possible for a case to claim compatibility with only the iPhone 6s or only the iPhone 6.
29
3. Cases
3.10 Test Procedures
It is not possible for a case to claim compatibility with only the iPhone 5 or only the iPhone 5s or only the
iPhone SE.
3.10.1.7 iPhone 5c
Table 3-7 iPhone 5c Case Testing Matrix
30
3. Cases
3.10 Test Procedures
It is not possible for a case to claim compatibility with only the iPad mini or only the iPad mini 2 or only the
iPad mini 3.
31
3. Cases
3.10 Test Procedures
It is not possible for a case to claim compatibility with only the iPod touch (5th generation) or only the iPod
touch (6th generation).
3.10.2.1 Equipment
● Apple device.
● Apple Lightning Digital AV Adapter
● Vernier calipers
● 0.85 mm plastic feeler gauge
● EarPods with 3.5 mm Headphone Plug
● Touchscreen test block (provided by Apple)
3.10.2.2 Procedure
1. Insert the Apple device into the case.
2. Verify that the Apple device completely fits inside the case. The Apple device must not be loose.
3. Verify that all buttons are accessible.
4. Inspect for button feel. The buttons must not be too hard to press or take a lot of effort to press.
5. For Apple devices that have an Apple Lightning connector:
a. Insert the Apple Lightning Digital AV Adapter into the Lightning receptacle and verify that it fits.
b. Using vernier calipers, measure the Lightning connector opening on the case. Verify that the opening
is measured to be at least 12.05 mm by 6.30 mm.
6. For Apple devices that have a 3.5 mm headset jack:
a. Insert EarPods with 3.5 mm Headphone Plug into the headset jack of the Apple device and verify it
fits.
b. Using vernier calipers, measure the headset jack opening on the case. Verify that the opening is
measured to be at least 6 mm in diameter and no more than 14 mm deep.
7. For Apple devices with Touch ID, use vernier calipers to verify that the case is at least 2 mm away from the
Touch ID sensor.
32
3. Cases
3.10 Test Procedures
8. Verify that the case is always proud of the feeler gauge when the gauge is placed at each corner of the
Apple device. See Figure 3-10 (page 33).
9. Set the Apple device flat on its face (screen facing down).
10. Roll the device towards any side that is not enclosed by the case until the gap between the Apple device's
exposed glass and flat surface is smallest.
11. Verify that the feeler gauge fits into the gap between the Apple device's exposed glass and flat surface.
33
3. Cases
3.10 Test Procedures
12. Place the touchscreen test block onto the touchscreen of the Apple device. Verify the test block is sitting
flush on the touchscreen.
13. If the case has an overlay, verify that there are no air gaps introduced between it and the touchscreen.
3.10.3.1 Equipment
● Two Apple devices A and B, same model
● Table
3.10.3.2 Procedure
1. Attach the case to Apple device B
2. Place Apple device A on top of the table.
3. Place Apple device B on top of the table next to Apple device A.
4. Compare the Taptic Engine feedback between Apple device A and Apple device B for each of the following
tasks:
a. Go to: Settings ->Sound & Haptics, set "Vibrate on Silent"to the on position.
b. Toggle the Ring/Silent switch.
c. Connect a charger to both Apple devices.
d. Go to: Settings ->Notifications ->Phone ->Sounds, select Reflection (Default).
e. Go to: Settings ->Notifications ->Messages ->Sounds, select Note (Default).
f. Go to the Home screen.
g. Trigger a Quick Actions menu by applying pressure to the Settings app. Continue applying pressure.
h. Slide your finger across the Quick Actions menu and release when Wi-Fi is selected.
34
3. Cases
3.10 Test Procedures
3.10.4.1 Equipment
● Nitrile gloves (e.g. Ansell TNT Blue)
● Ethyl alcohol hand sanitizer (e.g. Purell)
● Scissors
3.10.4.2 Procedure
1. Cut off a square of material from the nitrile glove's wrist portion.
2. Install the accessory onto the Apple device.
3. Press the sleep/wake or side button to place the Apple device into a sleep state (display off ).
4. Place the square of nitrile glove material over the Apple device's Home button / Touch ID sensor with the
glove's outer side facing away from the Apple device.
5. Apply a small amount of hand sanitizer (approximately dime-sized) to the nitrile over the Home button /
Touch ID sensor.
6. Repeat the following steps 10 times:
a. Press the Home button / Touch ID sensor with a thumb.
b. Verify that the Apple device wakes (display on).
c. Press the sleep/wake or side button to place the Apple device into a sleep state (display off ).
7. Repeat the following steps 10 times:
a. Press the Home button / Touch ID sensor with an index finger.
b. Verify that the Apple device wakes (display on).
c. Press the sleep/wake or side button to place the Apple device into a sleep state (display off ).
35
3. Cases
3.10 Test Procedures
3.10.5 Acoustics
The following test procedures apply to Apple devices with a built in speaker and/or microphone.
Room A:
● Operator A
● The Apple device (with cellular service) used to evaluate the case
● The Apple device should have at least two out of five bars of cellular reception within the room.
Room B:
● Operator B
● Landline speakerphone
● Digital audio recorder (e.g., an Apple device with the Voice Memo app)
The pass/fail threshold for these two categories should be established by performing the test procedure using:
There should be no perceivable difference between the reference and the test conducted with the case on
the Apple device.
3.10.5.1.3 Procedure
1. Operator A: Use the Apple device (without a case) in Room A to call the landline phone in Room B.
36
3. Cases
3.10 Test Procedures
Note: The phrases used for this test procedure are from "IEEE Recommended Practice for Speech
Quality Measurements,"in IEEE Transactions on Audio and Electroacoustics, vol. 17, no. 3, pp. 225-246,
September 1969.
37
4. Covers
38
5. Screen Overlays
The touch interface in an Apple device senses the presence of one or more fingers on its surface. Any material
between the surface and the user's hand, even a very thin sheet of plastic, may affect the performance of the
touch interface.
The screen overlay thickness must not exceed 0.3 mm for all other Apple devices.
39
5. Screen Overlays
5.3 Edge Press Gestures
An edge press gesture is used to bring up the task switcher in iOS 9.0 and later.
40
6. Camera Attachments
This chapter is applicable to accessories that intentionally alter the images captured by Apple device cameras.
41
7. Apple AirPods Attachments
7.1 Interference
Accessory AirPods attachments must not interfere with the keep-out areas specified in Figure 7-1 (page 43).
42
7. Apple AirPods Attachments
7.1 Interference
43
Bluetooth
8. Bluetooth Introduction
To be compatible with Apple products, both current and future, Bluetooth accessories should follow the
guidelines in this specification. An Apple product may make feature availability contingent on the Bluetooth
accessory following these specifications.
Engineers on the Apple Bluetooth development team monitor this mailing list and will try to answer your
questions. Apple recommends searching the archives to see if a topic has already been discussed before starting
a new thread.
45
9. Bluetooth
Accessories that integrate Bluetooth technology must comply with the requirements stated in this chapter.
Every accessory that is compatible with an Apple product must support the Bluetooth Core Specification Version
2.1 + EDR or higher. This specification introduced the important security feature Secure Simple Pairing as well
as Extended Inquiry Response.
46
9. Bluetooth
9.4 Role and Topology Management
● Max Interval: 15 ms
● Min Interval: 15 ms
● Sniff Attempt: 1
● Sniff Timeout: 0
● Must not renegotiate sniff after being established.
● Must support sniff subrating.
Accessories that are compatible with Apple products should also use sniff mode as much as possible, especially
when there is little or no data being transmitted over the Bluetooth link. Besides its power consumption
advantages, sniff mode enables better antenna sharing with Wi-Fi.
The sniff mode parameters are specific to the usage model and Bluetooth profile. The Apple product expects
the accessory to request sniff mode with appropriate parameters for a specific usage. If the accessory does not
send such a request, the Apple product may send a sniff mode request. When the Apple product sends a
request for sniff mode, the remote device must accept the request and its parameters without negotiation.
If the accessory sets the sniff mode parameters, the accessory must set the sniff interval to less than a third of
the Bluetooth baseband Link Supervision Timeout, see Link Supervision Timeout (page 49). This makes the
Bluetooth link less susceptible to interference. To improve link robustness, the accessory should use a shorter
sniff interval instead of multiple sniff attempts.
Links with a sniff interval of 1 second or more make the slave device open up a large correlation window, which
has to be taken into account when calculating the number of sniff attempts. With sniff intervals shorter than
1 second, multiple sniff attempts can improve link robustness but will increase power consumption.
In a Bluetooth connection, one device is the master and the other the slave. The master can have multiple
slaves, thus forming a piconet. The master can also be a slave to another master, creating a scatternet.
Such a scenario creates complications since the device has to alternate between the two piconets and thus
wastes valuable bandwidth. Managing the topology of the network is therefore important for maximum
performance. The Apple product may request a Role Switch, depending on its current topology, and the remote
device must accept the request. The Apple product may also reject a request for a Role Switch because of
topology concerns. Having a suboptimal topology may degrade the audio quality and the user's experience.
47
9. Bluetooth
9.5 Extended Inquiry Response
The accessory should avoid requesting to be the master as the Apple product will need to be the master in
more frequently occurring scenarios. Accessories that always insist on being the master may impact the overall
user experience.
Accessories that connect to multiple Apple products simultaneously must support creating a scatternet.
During the Bluetooth discovery process, the Apple product prefers to display the Friendly Name of discovered
accessories. Before the 2.1 version of the Bluetooth specification the Apple product would have to set up a
connection to the accessory and do a Remote Name Request, which takes power, antenna time, and user's
time. The Extended Inquiry Response feature, introduced in Bluetooth 2.1, lets an accessory send its Local
Name and other information as part of the Inquiry Response and thereby increase the speed and efficiency of
the discovery process.
The Local Name should match the accessory's markings and packaging and not contain ':'or ';'.
Secure Simple Pairing greatly increases security and is a mandatory security feature introduced in the Bluetooth
2.1 specification. To protect against a man-in-the-middle attack, the Numerical Comparison association model
should be used whenever feasible. See Volume 1, Section 5.4 in the Bluetooth Core Specification, Version 2.1 +
EDR.
48
9. Bluetooth
9.8 Class of Device (CoD)
Every accessory that is compatible with an Apple product must accurately set its Class of Device using the
Bluetooth SIG defined Major Device Class and Minor Device Class. See Volume 3, Part C, Section 3.2.4 in the
Bluetooth Core Specification, Version 5.0.
For example, an audio/video accessory intended to operate in a vehicle should set Major Device Class to
audio/video and Minor Device Class to car-audio.
The accessory must set the link supervision timeout to 2 seconds or greater when it is the master to account
for the unpredictable nature of RF signals as well as the Apple device's need to service other concurrent wireless
systems.
9.11 Profiles
The Apple knowledge base article https://support.apple.com/kb/ht3647 provides a complete list of the Bluetooth
profiles that certain Apple devices support. The Bluetooth specifications are the starting point for designing
accessories that are compatible with these products. The following sections add information and requirements
for some profiles, which can help accessory developers achieve superior results.
49
9. Bluetooth
9.11 Profiles
● Use the company identifier from the Assigned Numbers specification assigned by the Bluetooth SIG as its
Vendor ID value (VID). See http://www.bluetooth.org/Technical/AssignedNumbers/identifiers.htm (requires
login). Bluetooth HID Profile accessories may use a VID assigned by the USB Implementers Forum (USB-IF
at http://www.usb.org) if the manufacturer does not have a Bluetooth SIG company identifier.
● Use its VID value for the end product manufacturer.
● Not use the Company ID assigned to Apple by the Bluetooth SIG or the Vendor ID assigned to Apple by
the USB Implementers Forum.
● Use the Vendor ID Source field to identify which organization assigned the value used in Vendor ID field
value. See Section 5.6 of the Bluetooth Device ID Profile Specification.
● Use a ProductID value that uniquely identities the product.
● Use a Version value that uniquely identifies the software version.
The Device ID record lets the Apple product identify the implementation of the remote accessory. This is
valuable information and can be used to bridge alternate interpretations of the Bluetooth specification when
communicating with a remote accessory. Therefore it is important that the information in the Device ID record
uniquely identify the implementation.
In the case of Bluetooth car kit devices, for instance, the same car kit might go into two different car models.
Ideally the two car kits should have different ProductIDs. However, it is acceptable for them to have the same
ProductID as long as they have identical hardware, software, and features. If the implementations differ at all,
they should have different ProductIDs. The accessory can also use a secondary Device ID record to uniquely
identify the product ID or model number.
50
9. Bluetooth
9.11 Profiles
Remote accessories can use the Bluetooth Hands-Free Profile for phone communications. To achieve the best
user experience, the remote accessory should support the following features, which are optional in the Bluetooth
specification.
● Support Remote Audio Volume Control so the speaker volume on the Hands-Free accessory can be controlled
from the Apple product as described in Section 4.28 in the Bluetooth Hands-Free Profile Specification version
1.5.
● Set the Remote volume control bit in the Supported Features bitmap sent with the AT+BRSF= command.
In some situations it is easier for the user to control the output volume through the Apple product instead of
directly on the remote accessory. For example, a passenger (or-if the car is parked-the driver) in a car could
use the volume slider on the phone to control the audio volume. Volume control synchronization is outlined
in Section 4.48.2 in the Bluetooth Hands-Free Profile Specification version 1.5.
Apple products support all mandatory and optional indicators specified in HFP version 1.5 (service, call, callsetup,
callheld, signal, roam, battchg). To minimize unnecessary polling of status using the AT+CIND? command, the
remote accessory should enable indicator events reporting by sending an AT+CMER command. The Apple
product will then send a +CIEV event when there is a change in status of an indicator. The remote accessory
should request the initial status using the AT+CIND=? and AT+CIND? commands, according to the HFP
specification.
● Support Voice Recognition Activation, both AG and HF initiated as described in Section 4.25 in the Bluetooth
Hands-Free Profile Specification version 1.5.
● Set the Voice Recognition Activation bit in the "SupportedFeatures"bitmap sent with the AT+BRSF=
command.
Apple products support voice recognition initiated by remote (Hands-Free) accessories and iOS (Audio Gateway)
accessories.
51
9. Bluetooth
9.11 Profiles
Apple products support echo cancellation and noise reduction; these features are active by default. If a
Hands-Free accessory also does echo cancellation and noise reduction it needs to turn these features off on
the Apple product (the Audio Gateway). This avoids unnecessary degradation of audio quality due to double
audio processing.
● Support eSCO parameter set S2 and S3 and accept requests for these settings. See Section 5.6 of the
Bluetooth Hands-Free Profile Specification version 1.5.
● Request eSCO parameter set S2 or S3 when setting up a Synchronous Connection. Note that eSCO parameter
set S1 should not be requested.
● Render audio within 40 ms after the SCO/eSCO connection has been set up.
The eSCO packet types offers retransmission of packets; traditional SCO packets are not retransmitted. This
improves audio quality and the user's experience. The eSCO packet types 2-EV3 and 3-EV3 offer a greater time
interval between packets, which can improve Wi-Fi performance and allow time for other concurrent Bluetooth
connections to send data. Apple strongly recommends the use of 2-EV3 and 3-EV3 packets for SCO connections.
Using HV3 packets is highly discouraged. HV3 packets require more link time and does not allow for
retransmission of audio packets which impacts the audio performance in presence of RF interference.
All Apple devices running iOS 5 or later support Wide Band Speech. If both the Apple device and the accessory
support Wide Band Speech then Wide Band Speech link will be used for eSCO connection for use cases like
cellular calls, FaceTime and Siri.
52
9. Bluetooth
9.11 Profiles
● Support Message Notification as described in Section 4.1 of the Bluetooth Message Access Profile Specification,
version 1.0.
● Register for notifications immediately after the connection is established, as described in Section 4.5 in
the Message Access Profile Specification, version 1.0.
● Not expect the TEL property to be present in the originator VCARD (the properties N and FN will be included).
See Section 3.1.3 in the Message Access Profile Specification, version 1.0.
● Not provide a user interface for sending messages. Apple devices do not support sending messages using
MAP.
● Play
● Stop
● Pause
● Fast Forward
● Rewind
● Forward
● Backward
53
9. Bluetooth
9.11 Profiles
9.11.5.3 Notifications
Every accessory that is compatible with an Apple product and supports AVRCP should register for notifications
and not perform repetitive polling to determine the status of the Apple product.
Every Apple device supports registering for notifications in the role of an AVRCP Target, as described in Section
6.7 of the Bluetooth Audio/Video Remote Control Profile Specification version 1.4. The commands
RegisterNotification and GetPlayStatus are supported for these notifications:
● EVENT_PLAYBACK_STATUS_CHANGED
● EVENT_TRACK_CHANGED
● EVENT_NOW_PLAYING_CONTENT_CHANGED
● EVENT_AVAILABLE_PLAYERS_CHANGED
● EVENT_ADDRESSED_PLAYER_CHANGED
● EVENT_VOLUME_CHANGED
● If the Apple device has notified the accessory that it is paused, pressing the accessory's Play/Pause button
should send a Play command.
● If the Apple device has notified the accessory that it is playing, pressing the accessory's Play/Pause button
should send a Pause command.
● The accessory should not infer Apple device playback status based on the number of times the Play/Pause
button has been pressed.
Every Apple device supports volume handling in the role of AVRCP Controller.
9.11.5.6 Browsing
Every accessory that is compatible with an Apple product and supports Browsing (in controller role) as part of
AVRCP must:
● Not try to index or cache the entire library upon connection. The Apple product may contain tens of
thousands of media items, each present multiple times in the hierarchy.
54
9. Bluetooth
9.12 Audio Routing
● When browsing a specific folder, do not fetch all its items. Only fetch those that are displayed to the user.
It may prefetch a few items to improve the responsiveness of the user interface.
● Not reorder items (e.g. alphabetically).
● Not assume UIDs to be statically defined, especially in the root folder. The ordering and UIDs of folders
and items may change at any point in future releases.
● Send the SetBrowsedPlayer command after receiving an EVENT_UIDS_CHANGED notification.
● Not assume that the UID passed to the PlayItem command will result in the media player playing that UID.
Currently only the built-in Music app supports browsing. When switching between players, an
EVENT_AVAILABLE_PLAYERS_CHANGED notification and an EVENT_ADDRESSED_PLAYER_CHANGED notification
will be generated. The UI then needs to look at the feature bit mask of the listed player to determine whether
browsing is currently available.
All Apple devices running iOS 6.0 or later support AVRCP Browsing.
An accessory can receive audio data from the Apple device via either of two Bluetooth profiles:
The Apple device picks which channel to use depending on how the audio content is used. An audio path
created for two way communication (such as phone calls or FaceTime) always uses the HFP (eSCO) route for
sending audio data. Music and similar content uses the A2DP route. In the absence of a defined route, audio
playback will default to the Apple device.
55
9. Bluetooth
9.12 Audio Routing
For any audio content that is being received via the HFP (eSCO) route, it is expected that both the speaker and
the microphone of the accessory are dedicated to the Bluetooth link and should not handle any other audio
content.
When an Apple device initiates audio playback over an A2DP channel for playing music content, an AVRCP
notification EVENT_PLAYBACK_STATUS_CHANGED is sent to indicate that playback status has changed to play
state. See Section 6.7.2 of the Audio/Video Remote Control Profile specification, version 1.4. This indicates that
audio data via the A2DP profile contains music. When an Apple device initiates audio playback over an A2DP
channel for playing system sound, no AVRCP notification is sent.
Figure 9-1 (page 57) and Figure 9-2 (page 57) show the difference between the notifications for music playback
and for system sounds.
56
9. Bluetooth
9.12 Audio Routing
AVDTP_Start_Req
Audio mlayback ptarts
AVDTP_Start_Cfm
iocal media is activeI prepare to mix in AOam audio.
EVENT_PLAYBACK_STATUS_CHANGED: Play
pwitch pource Audio to Bluetooth Audio
keeds rf update to indicate Bluetooth audio is playing.
AVDTP_Suspend_Req
Audio mlayback bnds
AVDTP_Suspend_Cfm
AVDTP_Start_Req
pystem pound ptarts
AVDTP_Start_Cfm
iocal media is activeI prepare to mix in AOam audio.
AVDTP_Suspend_Req
pystem pound bnds
AVDTP_Suspend_Cfm
ptop AOam audio mixingI continue local media playback.
If audio data contains music, then it is expected that the accessory speakers are dedicated to audio data coming
via the Bluetooth link and any other audio playback is paused. If audio data contains system sound, then it is
expected that the accessory can render audio as desired. If the accessory is playing audio from a different
source, then system sound data can be mixed with the existing track for playback; it is not necessary to pause
existing audio playback on the device.
57
9. Bluetooth
9.13 HID
9.13 HID
When implementing HID over Bluetooth, the accessory:
58
10. Bluetooth Low Energy
The Bluetooth 4.0 specification introduces Bluetooth Low Energy, a wireless technology targeted for accessories
with limited battery resources. If Bluetooth Low Energy is supported, the accessory should follow the guidelines
in this section.
10.1 Role
The accessory should implement either the Peripheral role as defined in the Bluetooth 4.0 specification, Volume
3, Part C, Section 2.2.2.3 or the Broadcaster role, as defined in Section 2.2.2.1.
● ADV_IND
● ADV_NOCONN_IND
● ADV_SCAN_IND
ADV_DIRECT_IND should not be used. See the Bluetooth 4.0 specification, Volume 6, Part B, Section 2.3.1.
● Flags
● TX Power Level
59
10. Bluetooth Low Energy
10.5 Advertising Interval
● Local Name
● Services
The Local Name should match the accessory's markings and packaging and not contain ':'or ';'.
The accessory may put the Local Name and the TX Power Level data in the SCAN_RSP PDU if, for example, it
needs to reduce power consumption or not all of the advertising data fit into the advertising PDU. Note that,
depending on its state, the Apple product may not always perform active scanning.
The primary services should always be advertised in the advertising PDU. Secondary services should not be
advertised. Services not significant to the primary use case of the accessory may be omitted if space is limited
in the Advertising PDU.
The advertising data and the scan response data in the SCAN_RSP PDU should comply with the formatting
guidelines in the Bluetooth 4.0 specification, Volume 3, Part C, Section 18: it starts with a length field, followed
by AD Type and AD Data.
To be discovered by the Apple product, the accessory should first use the recommended advertising interval
of 20 ms for at least 30 seconds. If it is not discovered within the initial 30 seconds, Apple recommends using
one of the following longer intervals to increase chances of discovery by the Apple product:
● 152.5 ms
● 211.25 ms
● 318.75 ms
● 417.5 ms
● 546.25 ms
● 760 ms
● 852.5 ms
● 1022.5 ms
● 1285 ms
Note: Longer advertising intervals usually result in longer discovery and connect times.
60
10. Bluetooth Low Energy
10.6 Connection Parameters
The connection parameter request may be rejected if it does not comply with all of these rules:
Slave Latency ≤ 30
●
Note that if an accessory requests Interval Min == Interval Max == 15 ms, some Apple devices will scale the
interval to 30 ms to balance power and performance constraints.
If Bluetooth Low Energy HID is one of the connected services of an accessory, connection interval down to
11.25 ms may be accepted by the Apple product.
The Apple product will not read or use the parameters in the Peripheral Preferred Connection Parameters
characteristic. See the Bluetooth 4.0 specification, Volume 3, Part C, Section 12.5.
61
10. Bluetooth Low Energy
10.8 Privacy
Accessories should support Data Packet Length Extension for best performance with Apple devices.
Apple products operating as master will negotiate optimal data packet lengths based on various factors, such
as connection event length, system topology, and protocol.
10.8 Privacy
The accessory should be able to resolve a Resolvable Private Address in all situations. Due to privacy concerns,
the Apple product will use a Random Device Address as defined in the Bluetooth 4.0 specification, Volume 3,
Part C, Section 10.8.
10.9 Permissions
The accessory should not require special permissions, such as pairing, authentication, or encryption to discover
services and characteristics. It may require special permissions only for access to a characteristic value or a
descriptor value. See the Bluetooth 4.0 specification, Volume 3, Part G, Section 8.1, fifth paragraph.
10.10 Pairing
The accessory should not request pairing until an ATT request is rejected using the Insufficient Authentication
error code. See the Bluetooth 4.0 specification, Volume 3, Part F, Section 4 for details.
If, for security reasons, the accessory requires a bonded relationship with the Central, the Peripheral should
reject the ATT request using the Insufficient Authentication error code, as appropriate. As a result, the Apple
product may proceed with the necessary security procedures.
62
10. Bluetooth Low Energy
10.11 MTU Size
Similarly, if the Apple device acts as a Central and a GATT server, it may reject an ATT request using the
Insufficient Authentication error code. The accessory should initiate the security procedure for pairing in
response.
Pairing may require user authorization depending on Apple product. Once an accessory is paired with an Apple
product, it must retain the distributed keys of both central and peripheral for future use. If the pairing is no
longer required, the accessory must delete both sets of keys.
Apple devices will support and request an MTU size larger than the default during the Exchange MTU Request
handshake. See the Bluetooth 4.0 specification, Volume 3, Part F, Section 3.2.8.
When operating as ATT client, the Apple device will request the optimal MTU size based on factors such as the
Bluetooth topology, connection event length, maximum data length, and protocol (GATT or connection-oriented
L2CAP).
An accessory operating as ATT server should select an MTU that is equal to or greater than the Apple device's
MTU request.
10.12 Services
The Apple product may use the Service Changed characteristic to determine if it can rely on previously read
(cached) information from the device. See the Bluetooth 4.0 specification, Volume 3, Part G, Section 7.1.
63
10. Bluetooth Low Energy
10.13 GATT Server
These services are not guaranteed to be available immediately after connection and the accessory must support
Characteristic Value Indication of the Service Changed characteristic (see Bluetooth 4.0 specification, Volume
3, Part G, Section 7.1) to be notified when the services become available. The Apple device will maintain a
connection to an accessory as long as it is paired and uses one of the available services.
The following services are implemented internally by iOS and must not be published by third party iOS
applications:
The Apple device implements the GAP Service Changed characteristic, because the database contents can
change at any time. The accessory should therefore support the Characteristic Value Indication of this
characteristic and, upon receiving indications, invalidate its database cache accordingly. See the Bluetooth 4.0
specification, Volume 3, Part G, Section 7.1.
64
10. Bluetooth Low Energy
10.13 GATT Server
The accessory should minimize the use of ATT/GATT requests and commands and only send what is necessary.
For example, do not use GATT Discover All Services when the accessory is looking for specific services. Use
Discover Primary Service By Service UUID instead. Less airtime equals less power consumption and better
performance for both the accessory and the Apple device.
When third party iOS applications discover services on the accessory, the following services are used internally
by iOS and are filtered out from the list of discovered services:
The accessory should be robust enough to handle any error gracefully. Pairing and Characteristic Value
reads/writes may fail if the application that owns the service is not in the foreground and is not entitled to run
in the background.
If an ATT Prepare Write Request is used, all queued attributes are contained within the same GATT Service.
65
11. Advanced Audio Distribution Profile (A2DP)
Accessories may implement the Advanced Audio Distribution Profile (A2DP) over Bluetooth (see Bluetooth (page
46)) to receive audio from Apple products.
The audio content from the Apple product can be broadly classified into two categories:
Accessories that implement A2DP must satisfy all requirements stated in Bluetooth (page 46).
Element Value
Sampling Frequency 44,100 Hz
Channel Mode Stereo
Block Length 16
66
11. Advanced Audio Distribution Profile (A2DP)
11.3 MPEG 2/4 AAC Codecs
Element Value
Subbands 8
Allocation Method Loudness
Bitpool range 2 to 53. Accessories for Apple products should support 53.
Note: The following specifications provide details of Apple's implementation of the MPEG-2/4 AAC
codec. In case of conflicts, the A2DP specification governs.
The MPEG 2/4 AAC Codec Specific Information Elements, defined in Section 4.5 of the A2DP specification, that
are applicable to Apple devices are listed in Table 11-2 (page 67).
Table 11-2 MPEG-2/4 AAC Codec Information Elements for Apple devices
Element Value
Object Type MPEG-2 AAC LC
Sampling Frequency 44,100 Hz
Channels 2
Bit rate 264,630 bps
VBR 0
AAC audio stream packets in Apple devices have the structure shown in Table 11-3 (page 67).
The AAC Media Payload Format, as defined in Section 4.5.4 of the A2DP specification, is formatted using LATM,
as defined in Section 4 of IETF RFC 3016. The following notes apply to the packet fields shown in Table 11-3 (page
67).
● The recommended L2CAP MTU value for each Apple device's AAC streaming channel is 885 bytes.
● The AVDTP Header is shown as the RTP header in Figure 4 of RFC 3016, and is the header defined in Section
7.2.1 of the Bluetooth Audio/Video Distribution Transport Protocol, Version 1.2.
67
11. Advanced Audio Distribution Profile (A2DP)
11.4 Test Procedures
● The AudioMuxElement is the same as the RTP payload in RFC 3016. It is defined in Section 1.7.3, Table
1.41 in ISO/IEC 14496-3:2009, subpart 1. The muxConfigPresent argument to the AudioMuxElement
is set to 1 (in-band mode), as recommended in Section 4.1 of RFC 3016. As recommended in Section 4.3
of RFC 3016, only one AudioMuxElement is put into each AVDTP packet.
● The audio payload is encoded using MPEG-4, as recommended in Section 4.5.4 of the A2DP specification.
● For AAC-LC support, the accessory should support VBR capability. The Apple device will be varying AAC
bit rate depending on the content and the accessory should be able to handle the variation without causing
gap in the audio.
11.4.4 Siri
1. Trigger Siri during A2DP.
2. Audio should be resumed after the Siri session.
68
12. Bluetooth Accessory Identification
This chapter describes Apple-specific Bluetooth commands that extend accessory capabilities beyond those
supported by standard Bluetooth profiles.
To enable Apple-specific features, the accessory must support HFP Command AT+XAPL (page 69), which
provides accurate information about the accessory's supported features. The Apple device will use the
information sent by this command to enable and disable custom commands.
The accessory must send the following AT+XAPL command after making a successful HFP Service Level
Connection (SLC) to the Apple device. The accessory should send an AT+XAPL command first, before sending
any of the additional Apple-specific commands described below.
Format: AT+XAPL=vendorID-productID-version,features
Parameters:
● vendorID: A string representation of the hex value of the vendor ID from the manufacturer, without the 0x
prefix.
● productID: A string representation of the hex value of the product ID from the manufacturer, without the
0x prefix.
● version: The revision of the software.
● features: A base-10 representation of a bit field. Available features are:
● Bit 0 = reserved
● Bit 1 = The accessory supports battery reporting (reserved only for battery operated accessories).
● Bit 2 = The accessory is docked or powered (reserved only for battery operated accessories).
● Bit 3 = The accessory supports Siri status reporting.
● Bit 4 = the accessory supports noise reduction (NR) status reporting.
● All other values are reserved.
69
12. Bluetooth Accessory Identification
12.1 HFP Command AT+XAPL
Response: +XAPL=iPhone,features
70
13. Bluetooth Headset Battery Level Indication
Any Hands-Free Bluetooth headset accessory can show its battery level to the user as an indicator icon in the
Apple device status bar. This feature is supported on all Apple devices that support the Hands-Free Profile,
including iPhone, iPod touch, and iPad.
Headset battery indication is implemented by two Apple-specific Bluetooth HFP AT commands, HFP Command
AT+XAPL (page 69) and HFP Command AT+IPHONEACCEV (page 71)
Parameters:
Example: AT+IPHONEACCEV=1,1,3
71
14. Siri
Siri enables a user to have rich interactions with an Apple device by primarily using their voice.
Accessories supporting Siri must not use an icon that resembles the Siri microphone icon.
The rest of this chapter is applicable to accessories that support Siri over Bluetooth.
To receive Siri status events, the accessory must send the AT+XAPL command after making a successful HFP
Service Level Connection (SLC) to the Apple device. The accessory should send an AT+XAPL command first,
before sending any of the additional Siri-specific commands described below.
Initiator: accessory
Format: AT+APLSIRI?
Response: +APLSIRI:value
72
14. Siri
14.2 Obtaining Siri Availability Information
Defined Values:
Format: +APLSIRI:value
Defined Values:
+APLSIRI:2
kotify that piri was disabled
by sending unsolicited HAmipfof:O
Esoice Control is active insteadF
+APLSIRI:1
kotify that piri was enabled
by sending unsolicited HAmipfof:N
73
14. Siri
14.3 Initiating a Siri Session
While a Siri session is active, the accessory must let the user continue the conversation and ask follow up
questions within the current context. In order to do so, the accessory must be able to send an AT+BVRA=1
command to the Apple device even after Siri has been already activated and before +BVRA:0 is received.
Figure 14-2 (page 74) shows an overview of the interaction when Siri is triggered from the accessory, the
running session was continued twice and once Siri was finished, the device dismissed the session.
AT+BVRA=1
ptart a piri session by sending ATHBsoA=N
OK
ecm pCl connection is open
AT+BVRA=1
Continue a piri session by sending ATHBsoA=N
OK
AT+BVRA=1
Continue a piri session by sending ATHBsoA=N
OK
+BVRA:0
piri session finishes; notify by sending HBsoA:0
ecm pCl connection is closed
74
14. Siri
14.3 Initiating a Siri Session
+BVRA=1
ptart a piri session; sending HBsoA=N to notify
ecm pCl connection is open
+BVRA=0
bnd a piri session; sending HBsoA=0 to notify
ecm pCl connection is closed
75
14. Siri
14.4 Siri Eyes Free Mode
AT+BVRA=1
ptart a piri session by sending ATHBsoA=N
OK
ecm pCl connection is open
AT+BVRA=1
Continue a piri session by sending ATHBsoA=N
OK
AT+BVRA:0
bnd a piri session by sending ATHBsoA=0
OK
ecm pCl connection is closed
The Apple device will listen for the HFP AT command AT+APLEFM to enable or disable Eyes Free mode.
This command is used by the Apple device to modify Siri responses that contain visual information or require
user interaction. Suitable audio feedback and voice commands will be available to the user based on the Siri
use case that was initiated.
Eyes Free mode is disabled by default. Once the accessory has enabled Eyes Free mode, it remains enabled for
all subsequent Siri sessions initiated from the accessory until the accessory disables it or the Bluetooth connection
is disconnected.
Initiator: accessory
Format: AT+APLEFM=value
Response: OK
76
14. Siri
14.5 Improving Voice Recognition
Defined Values:
Example: AT+APLEFM=1
To provide the best possible audio quality as Siri input, the accessory must observe the following
recommendations:
● Echo cancellation and noise suppression (EC/NR): Directional microphones and linear beamforming with
microphone arrays giving improved SNR are recommended. Linear echo cancellation for reducing unwanted
audio sources (such as audio output from the system) without having any other effect on the speech signal
are also recommended. However, single channel noise reduction methods (such as spectrum subtraction)
must not be applied, as they will be detrimental to the speech recognition accuracy. Similarly, automatic
gain control, residual echo suppression and attempts to blank out non-speech periods in the waveform
must not be applied.
● Signal gain: When adjusting signal levels, the accessory must avoid artifacts, dropouts, and clipping in all
circumstances. Automatic Gain Control is not recommended. If the accessory adjusts signal gain, the gain
should be held constant across each spoken utterance. The nominal level measured at the uplink output
of the accessory should be A-weighted -30 dB ±2 dB root-mean-square (RMS), expressed in units relative
to full-scale (dBFS(A)). Alternatively, the nominal level may be 13 dB ±2 dB SLR if using the ITU measurement
procedure.
● Signal-to-noise ratio (SNR): An average SNR greater than 20 dB is recommended. Below 20 dB, recognition
rates will be impacted.
● Reverberation: Maintaining RT60 time at less than 200 ms is recommended.
77
14. Siri
14.6 Optimizing the Siri Experience
● The start of a Siri session should not be accompanied by local beeps or verbal indications (such as an
announcement of "...voice dialing...") from the accessory. When a Siri session becomes active, the Apple
device sends two beeps indicating that Siri is ready to receive instructions. Adding extra audible notifications
only inserts delays in the system.
● The accessory should wait for the Apple device to end each Siri session. The accessory should not send an
AT+BVRA=0 command unless it is prompted to do so by user interaction.
● The Apple device expects that the accessory is capable of rendering audio as soon as the SCO connection
is active. This is necessary to make sure that the user always hears the Siri introductory beeps with minimum
delay. The delay should be within 200 ms.
Vehicles with Bluetooth-enabled infotainment systems can also enable Siri Eyes Free Mode during initialization.
This is detailed in Figure 14-6 (page 79).
78
14. Siri
14.7 Common Siri Applications
AT+XAPL=ABCD-1234-0001,8
bnable custom piri commands
+XAPL=iPhone,8
Acknowledge reception
AT+APLSIRI?
lbtain piri availability
+APLSIRI=2
oespond with piriDs availabilityI
e.g. Eavailable and enabledF
AT+XAPL=ABCD-1234-0001,8
bnable custom piri commands
+XAPL=iPhone,8
Acknowledge reception
AT+APLSIRI?
lbtain piri availability
+APLSIRI=2
oespond with piriDs availabilityI
e.g. Eavailable and enabledF
AT+APLEFM=1
bnable piri byes cree mode
OK
The accessory must not force a change in the playback state after a Siri session is ended. If music was playing
before Siri was started, it must continue playing, if it was paused, it must remain paused.
79
14. Siri
14.8 User Interaction with Siri Eyes Free in a Vehicle
After Siri starts music playback the accessory must set its current audio route to match the audio source,
depending on how audio is being received from the Apple device (via Bluetooth or by a wired connection).
The available media playback notifications depend on the audio route being used:
● For a Bluetooth audio route, use the approach described in Notifications (page 54) and Audio Data Received
via A2DP Profile (page 56).
● For a wired audio route, use the iPod Accessory Protocol.
The Apple device will notify the accessory to play turn-by-turn directions only over Bluetooth. Detailed
information on how to distinguish between music playback and turn-by-turn notifications is available in
Notifications (page 54).
80
14. Siri
14.8 User Interaction with Siri Eyes Free in a Vehicle
(*) If the accessory wishes to indicate that Siri is active, it must do one of the following:
(**) If the vehicle is equipped with steering wheel controls, a dedicated button or a long-press on a button on
the vehicle's steering wheel is required to start, continue and end a Siri session. The button long-press must
be 600 ms or less. If no steering wheel controls are available, a soft button must be available within the in-vehicle
user interface to start, continue or end a Siri session.
81
14. Siri
14.9 Enabling/Disabling Siri from the Apple Device
When a vehicle enables Siri Eyes Free mode, the Apple device will not display any onscreen Siri content. If the
device was locked at the time the Siri session was activated from the vehicle, it will remain locked and the
screen will not turn on. If the user unlocks or manually activates the device while in an Eyes Free Session there
will be a notification that the device is in an active Siri session but there will be no visual Siri content displayed.
82
14. Siri
14.10 Test Procedures
For the following spoken tests, the speaker should ideally be a native speaker of North American English. If
the tester's native language is not English, set Siri to your native language and translate the phrases to be
spoken below into your native language.
14.10.1.1 General
1. Pair and establish a Bluetooth Handsfree Profile (HFP) connection between the iPhone and the head unit.
Activate Siri from the vehicle steering wheel button (e.g. by press hold):
a. Observe that the iPhone screen remains inactive after a Siri session has started (a visual indicator will
be visible on the Apple device if the screen is activated manually).
b. Ensure that Siri opening chime is heard completely through the vehicle speakers.
c. Observe a visual notification in the in-car User Interface (UI) that a Siri session is active (textual
notification, on-screen UI, etc.).
2. Activate Siri from the vehicle steering wheel button and say "Send a message to Peter. How are you?".
While still saying the message, press the vehicle steering wheel button to cancel Siri (e.g. by press):
a. Ensure the iPhone screen remains inactive (if manually activated, the visual indicator on the phone
will disappear).
b. Verify that the in-car UI for Siri interaction dismisses and the head unit resumes the state before Siri's
interaction.
3. Activate Siri from the vehicle steering wheel button and say "How is the weather in San Francisco?". Wait
for Siri to respond with the weather forecast. Once the weather forecast is complete, resume Siri from the
vehicle steering wheel button and say "What about New York?":
a. Observe that the visual indicator is still active on the phone.
b. Listen for the Siri opening chime.
c. The vehicle UI should be displaying an on-going Siri session.
d. Verify that Siri responds with the weather forecast for New York.
4. In case the vehicle UI offers on-screen controls to activate/cancel/resume Siri, repeat steps (1) to (3) for all
on-screen controls.
5. Activate Siri from the steering wheel button and say "What's the time". Listen to the current time and do
not interact with Siri or the iPhone. After 5 seconds have expired:
a. Observe that the visual indicator on the phone is no longer visible.
b. The in-car UI for Siri interaction should be dismissed.
c. The head unit should resume the state before Siri's interaction.
6. Listen to FM radio from the car speakers (no A2DP streaming active). Press and hold phone's Home button
to activate Siri from the phone:
83
14. Siri
14.10 Test Procedures
a. Observe a visual notification in the in-car UI that a Siri session is active (textual notification, on-screen
UI, etc.).
b. Observe Siri's interaction on the phone's screen and ask "What's the time?"
c. After Siri has responded, lock the phone again to dismiss the Siri session by pressing the phone's
sleep/wake or side button.
7. On the phone go to Settings and turn off Siri. Activate Siri from the head unit. Observe one of the following
depending on the actual implementation (a) Voice Control starts instead of Siri (b) The head unit displays
a warning that Siri Eyes Free is not available.
8. On the phone go to Settings and turn Siri back on. Verify that Siri can be activated/cancelled from the head
unit and from the Home button on the phone.
9. Turn Bluetooth off from the Settings on the phone. Verify that Siri cannot be started.
10. Turn Bluetooth back on from the Settings on the phone. Verify that Bluetooth HFP profile reconnects and
that Siri can be activated/cancelled from the head unit and from the Home button on the phone.
11. Make sure there is no accessory battery status level indicator icon displayed on the phone's status bar.
84
14. Siri
14.10 Test Procedures
14.10.1.4 Call
1. Activate Siri and call a contact with more than one phone number (home and mobile). Wait for Siri's
response to ask for which phone number to call. Answer with "home". Verify that call transition is handled
correctly by the head unit and any Siri UI displayed on the vehicle screen is dismissed.
2. While iPhone music is playing, activate Siri and say "Call insert contact name to call". Verify that call
transition is handled correctly by the head unit. Verify that iPhone music playback resumes after the call
has been answered and terminated on the far end. Verify that the Siri in-car UI is dismissed and the head
unit goes back to its initial state.
3. While iPhone music is playing, start Siri and say "Call insert contact name to call". Verify that call transition
is handled correctly by the head unit. Verify that iPhone music playback resumes after the call has been
answered and terminated on the near end (i.e. on the head unit). Verify that the Siri in-car UI is dismissed
and the head unit goes back to its initial state.
4. While in a Siri session, receive an incoming call on the head unit. Verify that head unit handles call-signaling
correctly and transitions to phone UI once the call has been accepted. Verify that the Siri in-car UI is
dismissed and the head unit goes back to its initial state.
85
14. Siri
14.10 Test Procedures
86
15. iPod Accessory Protocol
Third-party accessories can use the iPod Accessory Protocol (iAP) to access advanced features of Apple devices.
One such feature is the ability to communicate securely with third-party iOS applications via the iOS External
Accessory Framework. For information about the External Accessory Framework, see http://developer.ap-
ple.com/library/ios/#featuredarticles/ExternalAccessoryPT/Introduction/Introduction.html.
To incorporate iAP into an accessory design, the accessory developer must be a member of the Apple MFi
licensing program and integrate specific MFi hardware into the accessory. For further information about MFi,
see https://developer.apple.com/programs/mfi.
87
References
16. Device Dimensional Drawings
89
16. Device Dimensional Drawings
● iPad mini 2 & iPad mini 3 with Wi-Fi + Cellular (page 128)
● iPad Air with Wi-Fi (page 129)
● iPad Air with Wi-Fi + Cellular (page 130)
● iPad mini with Wi-Fi (page 131)
● iPad mini with Wi-Fi + Cellular (page 132)
● iPad (4th generation) with Wi-Fi (page 133)
● iPad (4th generation) with Wi-Fi + Cellular (page 134)
● iPod touch (6th generation) (page 135)
● iPod touch (5th generation) (page 136)
90
16. Device Dimensional Drawings
16.1 iPhone X
16.1 iPhone X
Figure 16-1 iPhone X Dimensional Drawing
91
16. Device Dimensional Drawings
16.2 iPhone 8 Plus
92
16. Device Dimensional Drawings
16.3 iPhone 8
16.3 iPhone 8
Figure 16-3 iPhone 8 Dimensional Drawing
93
16. Device Dimensional Drawings
16.4 iPhone 7 Plus
94
16. Device Dimensional Drawings
16.5 iPhone 7
16.5 iPhone 7
Figure 16-5 iPhone 7 Dimensional Drawing
95
16. Device Dimensional Drawings
16.6 iPhone 6s Plus
96
16. Device Dimensional Drawings
16.7 iPhone 6s
16.7 iPhone 6s
Figure 16-7 iPhone 6s Dimensional Drawing
97
16. Device Dimensional Drawings
16.8 iPhone 6 Plus
98
16. Device Dimensional Drawings
16.9 iPhone 6
16.9 iPhone 6
Figure 16-9 iPhone 6 Dimensional Drawing
99
16. Device Dimensional Drawings
16.10 iPhone 5s & iPhone SE
100
16. Device Dimensional Drawings
16.11 iPhone 5c
16.11 iPhone 5c
Figure iPhone 5c Dimensional Drawing
16-11
101
16. Device Dimensional Drawings
16.12 iPhone 5
16.12 iPhone 5
Figure iPhone 5 Dimensional Drawing
16-12
102
16. Device Dimensional Drawings
16.13 iPad Pro (10.5-inch) with Wi-Fi
103
16. Device Dimensional Drawings
16.14 iPad Pro (10.5-inch) with Wi-Fi + Cellular
104
16. Device Dimensional Drawings
16.15 iPad Pro (10.5-inch) Magnet/Hall Effect Sensors
105
16. Device Dimensional Drawings
16.15 iPad Pro (10.5-inch) Magnet/Hall Effect Sensors
106
16. Device Dimensional Drawings
16.16 iPad Pro (12.9-inch) 2nd Generation with Wi-Fi
107
16. Device Dimensional Drawings
16.17 iPad Pro (12.9-inch) 2nd Generation with Wi-Fi + Cellular
108
16. Device Dimensional Drawings
16.18 iPad Pro (12.9-inch) 2nd Generation Magnet/Hall Effect Sensors
109
16. Device Dimensional Drawings
16.18 iPad Pro (12.9-inch) 2nd Generation Magnet/Hall Effect Sensors
Figure iPad Pro (12.9-inch) 2nd Generation Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing
16-20
110
16. Device Dimensional Drawings
16.19 iPad (5th and 6th generation) with Wi-Fi + Cellular
111
16. Device Dimensional Drawings
16.20 iPad (5th and 6th generation) Magnet/Hall Effect Sensors
112
16. Device Dimensional Drawings
16.20 iPad (5th and 6th generation) Magnet/Hall Effect Sensors
Figure iPad (5th and 6th generation) Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing
16-23
113
16. Device Dimensional Drawings
16.21 iPad Pro (9.7-inch) with Wi-Fi
114
16. Device Dimensional Drawings
16.22 iPad Pro (9.7-inch) with Wi-Fi + Cellular
115
16. Device Dimensional Drawings
16.23 iPad Pro (9.7-inch) Magnet/Hall Effect Sensors
116
16. Device Dimensional Drawings
16.23 iPad Pro (9.7-inch) Magnet/Hall Effect Sensors
117
16. Device Dimensional Drawings
16.24 iPad Pro (12.9-inch) 1st Generation with Wi-Fi
118
16. Device Dimensional Drawings
16.25 iPad Pro (12.9-inch) 1st Generation with Wi-Fi + Cellular
119
16. Device Dimensional Drawings
16.26 iPad Pro (12.9-inch) 1st Generation Magnet/Hall Effect Sensors
120
16. Device Dimensional Drawings
16.26 iPad Pro (12.9-inch) 1st Generation Magnet/Hall Effect Sensors
Figure iPad Pro (12.9-inch) 1st Generation Magnet/Hall Effect Sensors 2 of 2 Dimensional Drawing
16-31
121
16. Device Dimensional Drawings
16.27 iPad mini 4 with Wi-Fi
!
!
!
!
!
!
!
122
16. Device Dimensional Drawings
16.28 iPad mini 4 with Wi-Fi + Cellular
!
!
!
!
!
!
!
123
16. Device Dimensional Drawings
16.29 iPad mini 4 Magnet/Hall Effect Sensors
124
16. Device Dimensional Drawings
16.30 iPad Air 2 with Wi-Fi
125
16. Device Dimensional Drawings
16.31 iPad Air 2 with Wi-Fi + Cellular
126
16. Device Dimensional Drawings
16.32 iPad mini 2 & iPad mini 3 with Wi-Fi
127
16. Device Dimensional Drawings
16.33 iPad mini 2 & iPad mini 3 with Wi-Fi + Cellular
128
16. Device Dimensional Drawings
16.34 iPad Air with Wi-Fi
129
16. Device Dimensional Drawings
16.35 iPad Air with Wi-Fi + Cellular
130
16. Device Dimensional Drawings
16.36 iPad mini with Wi-Fi
131
16. Device Dimensional Drawings
16.37 iPad mini with Wi-Fi + Cellular
132
16. Device Dimensional Drawings
16.38 iPad (4th generation) with Wi-Fi
133
16. Device Dimensional Drawings
16.39 iPad (4th generation) with Wi-Fi + Cellular
134
16. Device Dimensional Drawings
16.40 iPod touch (6th generation)
135
16. Device Dimensional Drawings
16.41 iPod touch (5th generation)
136
Revision History
This chapter describes changes to the Accessory Design Guidelines for Apple Devices from the previous revision.
Added Content
● Qi Wireless Power (page 17)
● HID (page 58)
Updated Content
● Purpose of This Specification (page 12)
● Magnetic Interference (page 15)
● Over The Air (OTA) (page 16)
● Access to Controls (page 19)
● iPad (5th and 6th generation) (page 30)
● Product Design (page 39)
● Siri Eyes Free (page 83)
● Device Dimensional Drawings (page 89)
137
Apple Inc.
Copyright © 2018 Apple Inc.
All rights reserved