xref: /nrf52832-nimble/packages/NimBLE-latest/nimble/host/src/ble_ibeacon.c (revision 042d53a763ad75cb1465103098bb88c245d95138)
1*042d53a7SEvalZero /*
2*042d53a7SEvalZero  * Licensed to the Apache Software Foundation (ASF) under one
3*042d53a7SEvalZero  * or more contributor license agreements.  See the NOTICE file
4*042d53a7SEvalZero  * distributed with this work for additional information
5*042d53a7SEvalZero  * regarding copyright ownership.  The ASF licenses this file
6*042d53a7SEvalZero  * to you under the Apache License, Version 2.0 (the
7*042d53a7SEvalZero  * "License"); you may not use this file except in compliance
8*042d53a7SEvalZero  * with the License.  You may obtain a copy of the License at
9*042d53a7SEvalZero  *
10*042d53a7SEvalZero  *  http://www.apache.org/licenses/LICENSE-2.0
11*042d53a7SEvalZero  *
12*042d53a7SEvalZero  * Unless required by applicable law or agreed to in writing,
13*042d53a7SEvalZero  * software distributed under the License is distributed on an
14*042d53a7SEvalZero  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15*042d53a7SEvalZero  * KIND, either express or implied.  See the License for the
16*042d53a7SEvalZero  * specific language governing permissions and limitations
17*042d53a7SEvalZero  * under the License.
18*042d53a7SEvalZero  */
19*042d53a7SEvalZero 
20*042d53a7SEvalZero #include <string.h>
21*042d53a7SEvalZero #include "host/ble_hs_adv.h"
22*042d53a7SEvalZero #include "ble_hs_priv.h"
23*042d53a7SEvalZero 
24*042d53a7SEvalZero #define BLE_IBEACON_MFG_DATA_SIZE       25
25*042d53a7SEvalZero 
26*042d53a7SEvalZero /**
27*042d53a7SEvalZero  * Configures the device to advertise iBeacons.
28*042d53a7SEvalZero  *
29*042d53a7SEvalZero  * @param uuid                  The 128-bit UUID to advertise.
30*042d53a7SEvalZero  * @param major                 The major version number to include in
31*042d53a7SEvalZero  *                                  iBeacons.
32*042d53a7SEvalZero  * @param minor                 The minor version number to include in
33*042d53a7SEvalZero  *                                  iBeacons.
34*042d53a7SEvalZero  * @param measured_power        The Measured Power (RSSI value at 1 Meter).
35*042d53a7SEvalZero  *
36*042d53a7SEvalZero  * @return                      0 on success;
37*042d53a7SEvalZero  *                              BLE_HS_EBUSY if advertising is in progress;
38*042d53a7SEvalZero  *                              Other nonzero on failure.
39*042d53a7SEvalZero  */
40*042d53a7SEvalZero int
ble_ibeacon_set_adv_data(void * uuid128,uint16_t major,uint16_t minor,int8_t measured_power)41*042d53a7SEvalZero ble_ibeacon_set_adv_data(void *uuid128, uint16_t major,
42*042d53a7SEvalZero                          uint16_t minor, int8_t measured_power)
43*042d53a7SEvalZero {
44*042d53a7SEvalZero     struct ble_hs_adv_fields fields;
45*042d53a7SEvalZero     uint8_t buf[BLE_IBEACON_MFG_DATA_SIZE];
46*042d53a7SEvalZero     int rc;
47*042d53a7SEvalZero 
48*042d53a7SEvalZero     /** Company identifier (Apple). */
49*042d53a7SEvalZero     buf[0] = 0x4c;
50*042d53a7SEvalZero     buf[1] = 0x00;
51*042d53a7SEvalZero 
52*042d53a7SEvalZero     /** iBeacon indicator. */
53*042d53a7SEvalZero     buf[2] = 0x02;
54*042d53a7SEvalZero     buf[3] = 0x15;
55*042d53a7SEvalZero 
56*042d53a7SEvalZero     /** UUID. */
57*042d53a7SEvalZero     memcpy(buf + 4, uuid128, 16);
58*042d53a7SEvalZero 
59*042d53a7SEvalZero     /** Version number. */
60*042d53a7SEvalZero     put_be16(buf + 20, major);
61*042d53a7SEvalZero     put_be16(buf + 22, minor);
62*042d53a7SEvalZero 
63*042d53a7SEvalZero     /* Measured Power ranging data (Calibrated tx power at 1 meters). */
64*042d53a7SEvalZero     if (measured_power < -126 || measured_power > 20) {
65*042d53a7SEvalZero         return BLE_HS_EINVAL;
66*042d53a7SEvalZero     }
67*042d53a7SEvalZero     buf[24] = measured_power;
68*042d53a7SEvalZero 
69*042d53a7SEvalZero     memset(&fields, 0, sizeof fields);
70*042d53a7SEvalZero     fields.mfg_data = buf;
71*042d53a7SEvalZero     fields.mfg_data_len = sizeof buf;
72*042d53a7SEvalZero 
73*042d53a7SEvalZero     /* Advertise two flags:
74*042d53a7SEvalZero      *     o Discoverability in forthcoming advertisement (general)
75*042d53a7SEvalZero      *     o BLE-only (BR/EDR unsupported).
76*042d53a7SEvalZero      */
77*042d53a7SEvalZero     fields.flags = BLE_HS_ADV_F_DISC_GEN |
78*042d53a7SEvalZero                    BLE_HS_ADV_F_BREDR_UNSUP;
79*042d53a7SEvalZero 
80*042d53a7SEvalZero     rc = ble_gap_adv_set_fields(&fields);
81*042d53a7SEvalZero     return rc;
82*042d53a7SEvalZero }
83