Find My Network Accessory
Specification
Developer Preview
Release R3
Developer
Contents
!
1. Introduction 8
1.1. Requirements, recommendations, and permissions 8 .............................................
1.2. Terminology 9 ..........................................................................................................
2. Core Concepts 10
2.1. Overview 10 .............................................................................................................
2.2. Find My app 10 .........................................................................................................
2.3. Transport 10 .............................................................................................................
2.4. Operation 10 ............................................................................................................
2.5. Roles 10 ...................................................................................................................
2.5.1. Owner device 10 ............................................................................................
2.5.2.Accessory 11 ..................................................................................................
2.5.3.Find My network 11 ........................................................................................
2.5.4.Apple server 12 ..............................................................................................
2.6. Features 12 ..............................................................................................................
2.6.1. Unwanted tracking detection 12 ....................................................................
2.6.2.Lost mode 12 .................................................................................................
2.6.3.Play sound 12 .................................................................................................
2.7. States 12 ..................................................................................................................
2.7.1. Unpaired 13 ...................................................................................................
2.7.2. Connected 14 ................................................................................................
2.7.3. Nearby 14 ......................................................................................................
2.7.4.Separated 14 .................................................................................................
3. Requirements 15
3.1. Overview 15 .............................................................................................................
3.2. General 15 ................................................................................................................
3.3. Hardware 15 .............................................................................................................
3.3.1. Bluetooth 15 ..................................................................................................
3.3.1.1.Pair before use 15 ...............................................................................
3.3.2.Product-specific requirements 16 .................................................................
3.3.3.Find My mark 16 ............................................................................................
3.3.4.Serial number lookup 16 ................................................................................
2020-10-06 | Copyright © 2020 Apple Inc. All Rights Reserved.
2
3.3.5.Find My network disable 17 ...........................................................................
3.3.6.Find My network pairing mode 17 ..................................................................
3.3.7. Reset 17 .........................................................................................................
3.3.8.Clock accuracy 17 .........................................................................................
3.4. Cryptography 17 ......................................................................................................
3.4.1. Operations 17 ................................................................................................
3.4.2.Implementation 18 .........................................................................................
3.4.2.1.Endianness and wire format 18 ..........................................................
3.4.2.2.Random scalar generation 18 ...........................................................
3.4.2.3.Scalar validation 19 ...........................................................................
3.4.2.4.Elliptic curve point validation 19 ........................................................
3.4.2.5.ECDSA signature verification 19 .......................................................
3.4.2.6.ECIES encryption 20 .........................................................................
3.4.2.7.AES-GCM decryption 20 ...................................................................
3.4.2.8.Random generation 20 .....................................................................
3.5. Software authentication 21 ......................................................................................
3.6. Apple server public keys 21 .....................................................................................
3.7. Power cycle 21 .........................................................................................................
3.8. Firmware updates 22 ...............................................................................................
4. Bluetooth Requirements 23
4.1. Overview 23 .............................................................................................................
4.2. Bluetooth advertising 23 ..........................................................................................
4.3. Bluetooth connection 23 ..........................................................................................
4.4. Bluetooth host 23 ....................................................................................................
4.4.1.Services 23 ....................................................................................................
4.4.2.MTU size 23 ..................................................................................................
4.4.3.Link encryption key 24 ..................................................................................
4.4.4.Handling concurrent operations 24 ...............................................................
4.4.5.Time-out 24 ...................................................................................................
4.5. Accessory information service 24 ............................................................................
4.5.1. Service 24 ......................................................................................................
4.5.2.Byte transmission order 24 ............................................................................
4.5.3.Characteristics 24 .........................................................................................
4.5.3.1.Product data 25 .................................................................................
2020-10-06 | Copyright © 2020 Apple Inc. All Rights Reserved.
3
4.5.3.2.Manufacturer name 26 ......................................................................
4.5.3.3.Model name 26 .................................................................................
4.5.3.4.Accessory category 26 .....................................................................
4.5.3.5.Accessory capability 26 ....................................................................
4.5.3.6.Firmware version 27 ..........................................................................
4.5.3.7.Find My network version 27 ...............................................................
4.5.3.8.Battery type 28 .................................................................................
4.5.3.9.Battery state 28 ................................................................................
4.6. Find My network service 28 .....................................................................................
4.6.1. Service 28 ......................................................................................................
4.6.2.Byte transmission order 29 ...........................................................................
4.6.3.Characteristics 29 .........................................................................................
4.6.3.1.Pairing control point 29 .....................................................................
4.6.3.2.Pairing control point procedures 30 ..................................................
4.6.3.2.1.Initiate pairing 30 .................................................................................
4.6.3.2.2.Send pairing data 30 ...........................................................................
4.6.3.2.3.Finalize pairing 31 ................................................................................
4.6.3.2.4.Send pairing status 31 .........................................................................
4.6.3.2.5.Pairing complete 32 ............................................................................
4.6.3.3.Configuration control point 32 ..........................................................
4.6.3.4.Configuration control point procedures 33 .......................................
4.6.3.4.1.Play sound—owner control point 33 ...................................................
4.6.3.4.2.Persistent connection status 33 .........................................................
4.6.3.4.3.Set nearby timeout 34 .........................................................................
4.6.3.4.4.Unpair 34 ............................................................................................
4.6.3.4.5.Configure separated state 34 .............................................................
4.6.3.4.6.Latch separated key 35 .......................................................................
4.6.3.4.7.Set max connections 35 ......................................................................
4.6.3.4.8.Set UTC 35 ..........................................................................................
4.6.3.4.9.Keyroll indication 36 ............................................................................
4.6.3.4.10.Command response 36 .....................................................................
4.6.3.4.11.Get multi status response 36 .............................................................
4.6.3.5.Non-owner control point 37 ..............................................................
4.6.3.6.Non-owner control point procedures 37 ...........................................
4.6.3.6.1.Play sound—non-owner control point 37 ............................................
4.6.3.7.Paired owner information control point 38 ........................................
2020-10-06 | Copyright © 2020 Apple Inc. All Rights Reserved.
4
4.6.3.8.Paired owner information control point procedures 39 .....................
4.6.3.8.1.Get Current Primary Key 39 .................................................................
4.6.3.8.2.Get iCloud Identifier 39 .......................................................................
4.6.3.8.3.Get Serial Number 39 ..........................................................................
4.6.3.8.4.Command Response 39 ......................................................................
4.6.3.9.Debug control point 40 .....................................................................
4.6.3.10.Debug control point procedures 40 ................................................
4.6.3.10.1.Set key rotation time-out 40 ..............................................................
4.6.3.10.2.Retrieve logs 40 .................................................................................
4.6.3.10.3.Reset 41 .............................................................................................
4.7. Firmware update service 41 .....................................................................................
4.7.1. Service 41 ......................................................................................................
4.7.2.Byte transmission order 41 ............................................................................
4.7.3. Characteristics 41 ..........................................................................................
4.7.3.1.Data control point 41 ..........................................................................
4.8. Fragmentation and reassembly 42 ..........................................................................
4.9. Service availability 42 ..............................................................................................
4.10.Serial number payload information 43 ....................................................................
4.10.1.Encrypted serial number payload 44 ............................................................
5. Advertisements 45
5.1. Bluetooth LE advertising 45 .....................................................................................
5.1.1. Payload for pairing 45 ....................................................................................
5.1.2. Payload for nearby state 45 ...........................................................................
5.1.3. Payload for separated state 46 .....................................................................
5.1.4. Advertisement in low battery state 47 ...........................................................
6. Pairing and Key Management 48
6.1. Overview 48 .............................................................................................................
6.2. Pairing 49 .................................................................................................................
6.2.1. Pairing mode 49 ............................................................................................
6.2.2.Generate pairing data 49 ...............................................................................
6.2.3.Send pairing data 49 .....................................................................................
6.2.4.Finalize pairing 50 .........................................................................................
6.2.5.Validate and confirm pairing 50 .....................................................................
6.2.6.Send pairing status 51 ...................................................................................
2020-10-06 | Copyright © 2020 Apple Inc. All Rights Reserved.
5
- 1
- 2
- 3
- 4
- 5
前往页