You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mynewt.apache.org by ad...@apache.org on 2016/04/04 20:06:53 UTC

incubator-mynewt-site git commit: Added advertisement data field documentation to BLE User Guide

Repository: incubator-mynewt-site
Updated Branches:
  refs/heads/master c2d7ef3e9 -> 417f1957a


Added advertisement data field documentation to BLE User Guide


Project: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/commit/417f1957
Tree: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/tree/417f1957
Diff: http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/diff/417f1957

Branch: refs/heads/master
Commit: 417f1957a0f2597920e5f087abbc42cca95c981b
Parents: c2d7ef3
Author: aditihilbert <ad...@runtime.io>
Authored: Mon Apr 4 11:06:44 2016 -0700
Committer: aditihilbert <ad...@runtime.io>
Committed: Mon Apr 4 11:06:44 2016 -0700

----------------------------------------------------------------------
 docs/network/ble/bletiny/bletiny_advdata.md | 26 ++++++++++++++++++++++++
 mkdocs.yml                                  |  1 +
 2 files changed, 27 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/417f1957/docs/network/ble/bletiny/bletiny_advdata.md
----------------------------------------------------------------------
diff --git a/docs/network/ble/bletiny/bletiny_advdata.md b/docs/network/ble/bletiny/bletiny_advdata.md
new file mode 100644
index 0000000..215232e
--- /dev/null
+++ b/docs/network/ble/bletiny/bletiny_advdata.md
@@ -0,0 +1,26 @@
+
+## Advertisement Data Fields
+
+<br>
+
+This part defines the advertisement data fields used in the `bletiny` app. For a complete list of all data types and formats used for Extended Inquiry Response (EIR), Advertising Data (AD), and OOB data blocks, refer to the Supplement to the Bluetooth Core Specification, CSSv6, available for download [here](https://www.bluetooth.org/DocMan/handlers/DownloadDoc.ashx?doc_id=302735&_ga=1.133090766.1368218946.1444779486). 
+
+<br>
+|**Name** | **Definition** | **Details** ||----|---------|---------------|
+|  uuids16 |16-bit Bluetooth Service UUIDs | Indicates the Service UUID list is incomplete i.e. more 16-bit Service UUIDs available. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.  || uuids16_is_complete  | 16-bit Bluetooth Service UUIDs | Indicates the Service UUID list is complete. 16 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.  |
+|  uuids32 | 32-bit Bluetooth Service UUIDs   | Indicates the Service UUID list is incomplete i.e. more 32-bit Service UUIDs available. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG.   || uuids32_is_complete  | 32-bit Bluetooth Service UUIDs   |  Indicates the Service UUID list is complete. 32 bit UUIDs shall only be used if they are assigned by the Bluetooth SIG. |
+| uuids128  | Global 128-bit Service UUIDs   | More 128-bit Service UUIDs available.  || uuids128_is_complete  |  Global 128-bit Service UUIDs  | Complete list of 128-bit Service UUIDs  |
+| tx_pwr_lvl  | TX Power Level   | Indicates the transmitted power level of the packet containing the data type. The TX Power Level data type may be used to calculate path loss on a received packet using the following equation: <br> <br> pathloss = Tx Power Level – RSSI <br> <br> where “RSSI” is the received signal strength, in dBm, of the packet received.  |
+| device_class  |  Class of device  | Size: 3 octets  |
+| slave_itvl_range | Slave Connection Interval Range   | Contains the Peripheral’s preferred connection interval range, for all logical connections. Size: 4 Octets . The first 2 octets defines the minimum value for the connection interval in the following manner: <br> <br> connIntervalmin = Conn_Interval_Min * 1.25 ms <br> <br> Conn_Interval_Min range: 0x0006 to 0x0C80 <br> Value of 0xFFFF indicates no specific minimum. <br> <br> The other 2 octets defines the maximum value for the connection interval in the following manner: <br> <br> connIntervalmax = Conn_Interval_Max * 1.25 ms <br> Conn_Interval_Max range: 0x0006 to 0x0C80 <br> Conn_Interval_Max shall be equal to or greater than the Conn_Interval_Min. <br> Value of 0xFFFF indicates no specific maximum.|
+| svc_data_uuid16  |  Service Data - 16 bit UUID  | Size: 2 or more octets <br> The first 2 octets contain the 16 bit Service UUID followed by additional service data |
+| public_tgt_addr  |  Public Target Address  | Defines the address of one or more intended recipients of an advertisement when one or more devices were bonded using a public address. This data type shall exist only once. It may be sent in either the Advertising or Scan Response data, but not both. |
+| appearance  | Appearance   | Defines the external appearance of the device. The Appearance data type shall exist only once. It may be sent in either the Advertising or Scan Response data, but not both.  |
+| adv_itvl  | Advertising Interval   | Contains the advInterval value as defined in the Core specification, Volume 6, Part B, Section 4.4.2.2.  |
+| le_addr  |  LE Bluetooth Device Address  | Defines the device address of the local device and the address type on the LE transport.  |
+| le_role  | LE Role   | Defines the LE role capabilities of the device. <br> 0x00 Only Peripheral Role supported <br> 0x01 Only Central Role supported <br> 0x02 Peripheral and Central Role supported, Peripheral Role preferred for connection establishment <br> 0x03 Peripheral and Central Role supported, Central Role preferred for connection establishment <br> 0x04 – 0xFF Reserved for future use |
+| svc_data_uuid32  | Service Data - 32 bit UUID  | Size: 4 or more octets <br> The first 4 octets contain the 32 bit Service UUID followed by additional service data |
+| svc_data_uuid128  | Service Data - 128 bit UUID   | Size: 16 or more octets <br> The first 16 octets contain the 128 bit Service UUID followed by additional service data  |
+| uri  |  Uniform Resource Identifier (URI) | Scheme name string and URI as a UTF-8 string  |
+| mfg_data |   Manufacturer Specific data | Size: 2 or more octets <br> The first 2 octets contain the Company Identifier Code followed by additional manufacturer specific data |<br>
+
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/incubator-mynewt-site/blob/417f1957/mkdocs.yml
----------------------------------------------------------------------
diff --git a/mkdocs.yml b/mkdocs.yml
index 890a04b..139d4c1 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -314,6 +314,7 @@ pages:
             - toc: 'network/ble/bletiny_api.md'
             - 'GAP in bletiny': 'network/ble/bletiny/bletiny_GAP.md'
             - 'GATT in bletiny': 'network/ble/bletiny/bletiny_GATT.md'
+            - 'Advertisement Data Fields': 'network/ble/bletiny/bletiny_advdata.md'
 - Newt Tool Manual:
     - Introduction: 'newt/newt_intro.md'
     - Install: