PlusLib  2.9.0
Software library for tracked ultrasound image acquisition, calibration, and processing.
List of all members | Public Member Functions
ClariusBLE Class Reference

#include <src/PlusDataCollection/Clarius/ClariusBLE.h>

Public Member Functions

bool AwaitWifiInfoReady ()
 
 ClariusBLE ()
 
PlusStatus CloseConnection ()
 
PlusStatus ConfigureWifiAP ()
 
PlusStatus ConfigureWifiLAN (std::string ssid, std::string password)
 
PlusStatus Connect ()
 
PlusStatus Disconnect ()
 
PlusStatus FindBySerial (std::string serialNum)
 
std::string GetLastError ()
 
std::pair< PlusStatus, ClariusWifiInfoGetWifiInfo ()
 
bool IsProbeConnected ()
 
bool IsProbePowered ()
 
PlusStatus ReadWifiInfo ()
 
PlusStatus RequestProbeOff ()
 
PlusStatus RequestProbeOn ()
 
std::vector< std::string > RetrieveFoundProbeIds ()
 
 ~ClariusBLE ()
 

Detailed Description

Definition at line 72 of file ClariusBLE.h.

Constructor & Destructor Documentation

◆ ClariusBLE()

ClariusBLE::ClariusBLE ( )

Definition at line 722 of file ClariusBLE.cxx.

◆ ~ClariusBLE()

ClariusBLE::~ClariusBLE ( )

Definition at line 728 of file ClariusBLE.cxx.

Member Function Documentation

◆ AwaitWifiInfoReady()

bool ClariusBLE::AwaitWifiInfoReady ( )

Synchronously wait for probe wifi information to be available. Useful for blocking execution while the probe is booting.

WARNING: This function can block for ~10 seconds, and should therefore be called on a thread.

Returns
true if info available, false if timeout

Definition at line 972 of file ClariusBLE.cxx.

◆ CloseConnection()

PlusStatus ClariusBLE::CloseConnection ( )

Close the BLE connection.

Definition at line 844 of file ClariusBLE.cxx.

◆ ConfigureWifiAP()

PlusStatus ClariusBLE::ConfigureWifiAP ( )

Configure the probe wifi to access-point mode, where the user will directly connect to the probe's wifi network (DIRECT-**SN** SSID).

Definition at line 1045 of file ClariusBLE.cxx.

◆ ConfigureWifiLAN()

PlusStatus ClariusBLE::ConfigureWifiLAN ( std::string  ssid,
std::string  password 
)

Configure the probe wifi to LAN mode, where the probe will connect to a local wifi network

Parameters
ssid
password

Definition at line 1083 of file ClariusBLE.cxx.

◆ Connect()

PlusStatus ClariusBLE::Connect ( )

Connect to probe found by FindBySerial

Definition at line 776 of file ClariusBLE.cxx.

◆ Disconnect()

PlusStatus ClariusBLE::Disconnect ( )

Disconnect from the currently connected probe BLE

Definition at line 873 of file ClariusBLE.cxx.

◆ FindBySerial()

PlusStatus ClariusBLE::FindBySerial ( std::string  serialNum)

Search for probe BLE connection by serial number

Returns
PLUS_SUCCESS if probe BLE was found

Definition at line 735 of file ClariusBLE.cxx.

◆ GetLastError()

std::string ClariusBLE::GetLastError ( )

Get the last error message

Definition at line 1145 of file ClariusBLE.cxx.

◆ GetWifiInfo()

std::pair< PlusStatus, ClariusWifiInfo > ClariusBLE::GetWifiInfo ( )

Get the wifi information to connect to the probe over, this is only useful when the probe is configured in ACCESS_POINT mode

Returns
std::pair as C++ 11 compatible equivalent of std::optional first: status of function call second: if successful, probe wifi info

Definition at line 1133 of file ClariusBLE.cxx.

◆ IsProbeConnected()

bool ClariusBLE::IsProbeConnected ( )

Is there a currently connected probe?

Definition at line 770 of file ClariusBLE.cxx.

◆ IsProbePowered()

bool ClariusBLE::IsProbePowered ( )

Check if currently connected probe is powered

Definition at line 889 of file ClariusBLE.cxx.

◆ ReadWifiInfo()

PlusStatus ClariusBLE::ReadWifiInfo ( )

Read the current wifi state from the BLE characteristic.

Definition at line 1018 of file ClariusBLE.cxx.

◆ RequestProbeOff()

PlusStatus ClariusBLE::RequestProbeOff ( )

Initiate the power off process for the currently connected probe

Definition at line 929 of file ClariusBLE.cxx.

◆ RequestProbeOn()

PlusStatus ClariusBLE::RequestProbeOn ( )

Initiate the power on process for the currently connected probe

Definition at line 895 of file ClariusBLE.cxx.

◆ RetrieveFoundProbeIds()

std::vector< std::string > ClariusBLE::RetrieveFoundProbeIds ( )

If FindBySerial returns false, this method can be used to retrieve a list of serial numbers for available Clarius probes

Returns
list of nearby probe serial numbers

Definition at line 764 of file ClariusBLE.cxx.


The documentation for this class was generated from the following files: