michal-narajowski commented on a change in pull request #213: Updated bletiny 
docs and added btshell docs
URL: https://github.com/apache/mynewt-site/pull/213#discussion_r126093524
 
 

 ##########
 File path: docs/network/ble/btshell/btshell_api.md
 ##########
 @@ -0,0 +1,120 @@
+## API for btshell app
+
+"btshell" is one of the sample applications that come with Mynewt. It is a 
shell application which provides a basic interface to the host-side of the BLE 
stack. "btshell" includes all the possible roles (Central/Peripheral) and they 
may be run simultaneously. You can run btshell on a board and issue commands 
that make it behave as a central or a peripheral with different peers. 
+
+"btshell" is a new application that uses new shell features and has updated 
command and parameter names. If you want to use legacy BLE application pleas go 
to [bletiny app](../bletiny/bletiny_api.md).
+
+Highlighted below are some of the ways you can use the API to establish 
connections and discover services and characteristics from peer devices. For 
descriptions of the full API, go to the next sections on [GAP in 
btshell](btshell_GAP.md) and [GATT in btshell](btshell_GATT.md).
+
+<br>
+
+### Set device address.
+
+On startup, btshell has the following identity address configuration:
+
+* Public address: None
+* Random address: None
+
+The below `set` commands can be used to change the address configuration:
+
+```
+set addr_type=public addr=<device-address>
+set addr_type=random addr=<device-address>
+```
+
+For example:
+
+```
+set addr_type=public addr=01:02:03:04:05:06
 
 Review comment:
   Yes, my bad. I already merged a pull request with fixes for this issue.
 
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to