.. highlight:: javascript

iBeacon
=======
iBeacon is a protocol developed by Apple. The main purpose of Beacons (which are simply Bluetooth advertisers - not connectable) is for location-data and proximity marketing. 

The MetaWear firmware supports the iBeacon format and can advertise itself as an iBeacon.  

To enable iBeacon mode, all you need to do is call 
`mbl_mw_ibeacon_enable <https://mbientlab.com/docs/metawear/cpp/latest/ibeacon_8h.html#a29227024839d419f2d536b6b3cc42481>`_ and disconnect from the 
board.  

The other functions in the `ibeacon.h <https://mbientlab.com/docs/metawear/cpp/latest/ibeacon_8h.html>`_ header file configure the 
advertisement parameters. ::

    MetaWear.mbl_mw_ibeacon_set_major(device.board, 78);
    MetaWear.mbl_mw_ibeacon_set_minor(device.board, 7453);
    MetaWear.mbl_mw_ibeacon_set_period(device.board, 15027);
    MetaWear.mbl_mw_ibeacon_set_rx_power(device.board, -55);
    MetaWear.mbl_mw_ibeacon_set_tx_power(device.board, -12);
    MetaWear.mbl_mw_ibeacon_set_uuid(device.board, up);
    MetaWear.mbl_mw_ibeacon_enable(device.board);