mirror of
https://github.com/h2zero/esp-nimble-cpp.git
synced 2024-12-26 04:30:46 +01:00
428 lines
25 KiB
HTML
428 lines
25 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.9.0"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
<title>esp-nimble-cpp / NimBLE-Arduino: NimBLERemoteService Class Reference</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="navtree.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="resize.js"></script>
|
|
<script type="text/javascript" src="navtreedata.js"></script>
|
|
<script type="text/javascript" src="navtree.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td id="projectalign" style="padding-left: 0.5em;">
|
|
<div id="projectname">esp-nimble-cpp / NimBLE-Arduino
|
|
 <span id="projectnumber">1.3.1</span>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.9.0 -->
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
|
|
/* @license-end */
|
|
</script>
|
|
<script type="text/javascript" src="menudata.js"></script>
|
|
<script type="text/javascript" src="menu.js"></script>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
$(function() {
|
|
initMenu('',true,false,'search.php','Search');
|
|
$(document).ready(function() { init_search(); });
|
|
});
|
|
/* @license-end */</script>
|
|
<div id="main-nav"></div>
|
|
</div><!-- top -->
|
|
<div id="side-nav" class="ui-resizable side-nav-resizable">
|
|
<div id="nav-tree">
|
|
<div id="nav-tree-contents">
|
|
<div id="nav-sync" class="sync"></div>
|
|
</div>
|
|
</div>
|
|
<div id="splitbar" style="-moz-user-select:none;"
|
|
class="ui-resizable-handle">
|
|
</div>
|
|
</div>
|
|
<script type="text/javascript">
|
|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
|
|
$(document).ready(function(){initNavTree('class_nim_b_l_e_remote_service.html',''); initResizable(); });
|
|
/* @license-end */
|
|
</script>
|
|
<div id="doc-content">
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
<div class="header">
|
|
<div class="summary">
|
|
<a href="#pub-methods">Public Member Functions</a> |
|
|
<a href="class_nim_b_l_e_remote_service-members.html">List of all members</a> </div>
|
|
<div class="headertitle">
|
|
<div class="title">NimBLERemoteService Class Reference</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
|
|
<p>A model of a remote BLE service.
|
|
<a href="class_nim_b_l_e_remote_service.html#details">More...</a></p>
|
|
<table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
|
|
Public Member Functions</h2></td></tr>
|
|
<tr class="memitem:a2803aa5cdfdb622ae8fe255dc939cb1d"><td class="memItemLeft" align="right" valign="top"><a id="a2803aa5cdfdb622ae8fe255dc939cb1d"></a>
|
|
virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a2803aa5cdfdb622ae8fe255dc939cb1d">~NimBLERemoteService</a> ()</td></tr>
|
|
<tr class="memdesc:a2803aa5cdfdb622ae8fe255dc939cb1d"><td class="mdescLeft"> </td><td class="mdescRight">When deleting the service make sure we delete all characteristics and descriptors. <br /></td></tr>
|
|
<tr class="separator:a2803aa5cdfdb622ae8fe255dc939cb1d"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a49bb3134b570db877fac67e6ed077aa2"><td class="memItemLeft" align="right" valign="top">std::vector< <a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * >::iterator </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a49bb3134b570db877fac67e6ed077aa2">begin</a> ()</td></tr>
|
|
<tr class="memdesc:a49bb3134b570db877fac67e6ed077aa2"><td class="mdescLeft"> </td><td class="mdescRight">Get iterator to the beginning of the vector of remote characteristic pointers. <a href="class_nim_b_l_e_remote_service.html#a49bb3134b570db877fac67e6ed077aa2">More...</a><br /></td></tr>
|
|
<tr class="separator:a49bb3134b570db877fac67e6ed077aa2"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a10fe635fe9a0661d26c33021faaec53b"><td class="memItemLeft" align="right" valign="top">std::vector< <a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * >::iterator </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a10fe635fe9a0661d26c33021faaec53b">end</a> ()</td></tr>
|
|
<tr class="memdesc:a10fe635fe9a0661d26c33021faaec53b"><td class="mdescLeft"> </td><td class="mdescRight">Get iterator to the end of the vector of remote characteristic pointers. <a href="class_nim_b_l_e_remote_service.html#a10fe635fe9a0661d26c33021faaec53b">More...</a><br /></td></tr>
|
|
<tr class="separator:a10fe635fe9a0661d26c33021faaec53b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ab12d195a2239a3808d60457184f0c487"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#ab12d195a2239a3808d60457184f0c487">getCharacteristic</a> (const char *uuid)</td></tr>
|
|
<tr class="memdesc:ab12d195a2239a3808d60457184f0c487"><td class="mdescLeft"> </td><td class="mdescRight">Get the remote characteristic object for the characteristic UUID. <a href="class_nim_b_l_e_remote_service.html#ab12d195a2239a3808d60457184f0c487">More...</a><br /></td></tr>
|
|
<tr class="separator:ab12d195a2239a3808d60457184f0c487"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a7ff4fc7bfb77adc33003dd6eb8e16957"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a7ff4fc7bfb77adc33003dd6eb8e16957">getCharacteristic</a> (const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> &uuid)</td></tr>
|
|
<tr class="memdesc:a7ff4fc7bfb77adc33003dd6eb8e16957"><td class="mdescLeft"> </td><td class="mdescRight">Get the characteristic object for the UUID. <a href="class_nim_b_l_e_remote_service.html#a7ff4fc7bfb77adc33003dd6eb8e16957">More...</a><br /></td></tr>
|
|
<tr class="separator:a7ff4fc7bfb77adc33003dd6eb8e16957"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a221069047193f8d25f7112b44bbcb28f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a221069047193f8d25f7112b44bbcb28f">deleteCharacteristics</a> ()</td></tr>
|
|
<tr class="memdesc:a221069047193f8d25f7112b44bbcb28f"><td class="mdescLeft"> </td><td class="mdescRight">Delete the characteristics in the characteristics vector. <a href="class_nim_b_l_e_remote_service.html#a221069047193f8d25f7112b44bbcb28f">More...</a><br /></td></tr>
|
|
<tr class="separator:a221069047193f8d25f7112b44bbcb28f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a15b3b750b073f334c3be680a99ce2e02"><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a15b3b750b073f334c3be680a99ce2e02">deleteCharacteristic</a> (const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> &uuid)</td></tr>
|
|
<tr class="memdesc:a15b3b750b073f334c3be680a99ce2e02"><td class="mdescLeft"> </td><td class="mdescRight">Delete characteristic by UUID. <a href="class_nim_b_l_e_remote_service.html#a15b3b750b073f334c3be680a99ce2e02">More...</a><br /></td></tr>
|
|
<tr class="separator:a15b3b750b073f334c3be680a99ce2e02"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a3d1e7db457a9f3774eaa5e641dcc716e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_nim_b_l_e_client.html">NimBLEClient</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a3d1e7db457a9f3774eaa5e641dcc716e">getClient</a> (void)</td></tr>
|
|
<tr class="memdesc:a3d1e7db457a9f3774eaa5e641dcc716e"><td class="mdescLeft"> </td><td class="mdescRight">Get the client associated with this service. <a href="class_nim_b_l_e_remote_service.html#a3d1e7db457a9f3774eaa5e641dcc716e">More...</a><br /></td></tr>
|
|
<tr class="separator:a3d1e7db457a9f3774eaa5e641dcc716e"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a565ed7d306645772d4e03ca65a07f7e5"><td class="memItemLeft" align="right" valign="top"><a id="a565ed7d306645772d4e03ca65a07f7e5"></a>
|
|
<a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a565ed7d306645772d4e03ca65a07f7e5">getUUID</a> (void)</td></tr>
|
|
<tr class="memdesc:a565ed7d306645772d4e03ca65a07f7e5"><td class="mdescLeft"> </td><td class="mdescRight">Get the service UUID. <br /></td></tr>
|
|
<tr class="separator:a565ed7d306645772d4e03ca65a07f7e5"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a4a9b63b4e5cedb51a7748a88daeb518b"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a4a9b63b4e5cedb51a7748a88daeb518b">getValue</a> (const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> &characteristicUuid)</td></tr>
|
|
<tr class="memdesc:a4a9b63b4e5cedb51a7748a88daeb518b"><td class="mdescLeft"> </td><td class="mdescRight">Read the value of a characteristic associated with this service. <a href="class_nim_b_l_e_remote_service.html#a4a9b63b4e5cedb51a7748a88daeb518b">More...</a><br /></td></tr>
|
|
<tr class="separator:a4a9b63b4e5cedb51a7748a88daeb518b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a4bb8c7c85580d86fd9ab7be5c3933b72"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a4bb8c7c85580d86fd9ab7be5c3933b72">setValue</a> (const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> &characteristicUuid, const std::string &value)</td></tr>
|
|
<tr class="memdesc:a4bb8c7c85580d86fd9ab7be5c3933b72"><td class="mdescLeft"> </td><td class="mdescRight">Set the value of a characteristic. <a href="class_nim_b_l_e_remote_service.html#a4bb8c7c85580d86fd9ab7be5c3933b72">More...</a><br /></td></tr>
|
|
<tr class="separator:a4bb8c7c85580d86fd9ab7be5c3933b72"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aaf106a37f24a51b967dd0984c973750f"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#aaf106a37f24a51b967dd0984c973750f">toString</a> (void)</td></tr>
|
|
<tr class="memdesc:aaf106a37f24a51b967dd0984c973750f"><td class="mdescLeft"> </td><td class="mdescRight">Create a string representation of this remote service. <a href="class_nim_b_l_e_remote_service.html#aaf106a37f24a51b967dd0984c973750f">More...</a><br /></td></tr>
|
|
<tr class="separator:aaf106a37f24a51b967dd0984c973750f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a2c9e91c842598a6a9576c7b87af0863a"><td class="memItemLeft" align="right" valign="top">std::vector< <a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * > * </td><td class="memItemRight" valign="bottom"><a class="el" href="class_nim_b_l_e_remote_service.html#a2c9e91c842598a6a9576c7b87af0863a">getCharacteristics</a> (bool refresh=false)</td></tr>
|
|
<tr class="memdesc:a2c9e91c842598a6a9576c7b87af0863a"><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to the vector of found characteristics. <a href="class_nim_b_l_e_remote_service.html#a2c9e91c842598a6a9576c7b87af0863a">More...</a><br /></td></tr>
|
|
<tr class="separator:a2c9e91c842598a6a9576c7b87af0863a"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
|
|
<div class="textblock"><p>A model of a remote BLE service. </p>
|
|
</div><h2 class="groupheader">Member Function Documentation</h2>
|
|
<a id="a49bb3134b570db877fac67e6ed077aa2"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a49bb3134b570db877fac67e6ed077aa2">◆ </a></span>begin()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">std::vector< <a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * >::iterator NimBLERemoteService::begin </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get iterator to the beginning of the vector of remote characteristic pointers. </p>
|
|
<dl class="section return"><dt>Returns</dt><dd>An iterator to the beginning of the vector of remote characteristic pointers. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a15b3b750b073f334c3be680a99ce2e02"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a15b3b750b073f334c3be680a99ce2e02">◆ </a></span>deleteCharacteristic()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">size_t NimBLERemoteService::deleteCharacteristic </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> & </td>
|
|
<td class="paramname"><em>uuid</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Delete characteristic by UUID. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">uuid</td><td>The UUID of the characteristic to be removed from the local database. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Number of characteristics left. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a221069047193f8d25f7112b44bbcb28f"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a221069047193f8d25f7112b44bbcb28f">◆ </a></span>deleteCharacteristics()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void NimBLERemoteService::deleteCharacteristics </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Delete the characteristics in the characteristics vector. </p>
|
|
<p>We maintain a vector called m_characteristicsVector that contains pointers to BLERemoteCharacteristic object references. Since we allocated these in this class, we are also responsible for deleting them. This method does just that. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a10fe635fe9a0661d26c33021faaec53b"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a10fe635fe9a0661d26c33021faaec53b">◆ </a></span>end()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">std::vector< <a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * >::iterator NimBLERemoteService::end </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get iterator to the end of the vector of remote characteristic pointers. </p>
|
|
<dl class="section return"><dt>Returns</dt><dd>An iterator to the end of the vector of remote characteristic pointers. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="ab12d195a2239a3808d60457184f0c487"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#ab12d195a2239a3808d60457184f0c487">◆ </a></span>getCharacteristic() <span class="overload">[1/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * NimBLERemoteService::getCharacteristic </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"><em>uuid</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get the remote characteristic object for the characteristic UUID. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">uuid</td><td>Remote characteristic uuid. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>A pointer to the remote characteristic object. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a7ff4fc7bfb77adc33003dd6eb8e16957"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a7ff4fc7bfb77adc33003dd6eb8e16957">◆ </a></span>getCharacteristic() <span class="overload">[2/2]</span></h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * NimBLERemoteService::getCharacteristic </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> & </td>
|
|
<td class="paramname"><em>uuid</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get the characteristic object for the UUID. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">uuid</td><td>Characteristic uuid. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>A pointer to the characteristic object, or nullptr if not found. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a2c9e91c842598a6a9576c7b87af0863a"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a2c9e91c842598a6a9576c7b87af0863a">◆ </a></span>getCharacteristics()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">std::vector< <a class="el" href="class_nim_b_l_e_remote_characteristic.html">NimBLERemoteCharacteristic</a> * > * NimBLERemoteService::getCharacteristics </td>
|
|
<td>(</td>
|
|
<td class="paramtype">bool </td>
|
|
<td class="paramname"><em>refresh</em> = <code>false</code></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get a pointer to the vector of found characteristics. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">refresh</td><td>If true the current characteristics vector will cleared and all characteristics for this service retrieved from the peripheral. If false the vector will be returned with the currently stored characteristics of this service. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>A pointer to the vector of descriptors for this characteristic. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a3d1e7db457a9f3774eaa5e641dcc716e"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a3d1e7db457a9f3774eaa5e641dcc716e">◆ </a></span>getClient()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="class_nim_b_l_e_client.html">NimBLEClient</a> * NimBLERemoteService::getClient </td>
|
|
<td>(</td>
|
|
<td class="paramtype">void </td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get the client associated with this service. </p>
|
|
<dl class="section return"><dt>Returns</dt><dd>A reference to the client associated with this service. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a4a9b63b4e5cedb51a7748a88daeb518b"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a4a9b63b4e5cedb51a7748a88daeb518b">◆ </a></span>getValue()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">std::string NimBLERemoteService::getValue </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> & </td>
|
|
<td class="paramname"><em>characteristicUuid</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Read the value of a characteristic associated with this service. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">characteristicUuid</td><td>The characteristic to read. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>a string containing the value or an empty string if not found or error. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="a4bb8c7c85580d86fd9ab7be5c3933b72"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#a4bb8c7c85580d86fd9ab7be5c3933b72">◆ </a></span>setValue()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">bool NimBLERemoteService::setValue </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const <a class="el" href="class_nim_b_l_e_u_u_i_d.html">NimBLEUUID</a> & </td>
|
|
<td class="paramname"><em>characteristicUuid</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const std::string & </td>
|
|
<td class="paramname"><em>value</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Set the value of a characteristic. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">characteristicUuid</td><td>The characteristic to set. </td></tr>
|
|
<tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The value to set. </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>true on success, false if not found or error </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a id="aaf106a37f24a51b967dd0984c973750f"></a>
|
|
<h2 class="memtitle"><span class="permalink"><a href="#aaf106a37f24a51b967dd0984c973750f">◆ </a></span>toString()</h2>
|
|
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">std::string NimBLERemoteService::toString </td>
|
|
<td>(</td>
|
|
<td class="paramtype">void </td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Create a string representation of this remote service. </p>
|
|
<dl class="section return"><dt>Returns</dt><dd>A string representation of this remote service. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
</div><!-- contents -->
|
|
</div><!-- doc-content -->
|
|
<!-- start footer part -->
|
|
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
|
|
<ul>
|
|
<li class="navelem"><a class="el" href="class_nim_b_l_e_remote_service.html">NimBLERemoteService</a></li>
|
|
<li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.0 </li>
|
|
</ul>
|
|
</div>
|
|
</body>
|
|
</html>
|