Class representing a list of devices. More...

#include <Device.hpp>

Public Member Functions
	DeviceList (ob_device_list_t *impl)
	~DeviceList () noexcept
uint32_t	getCount () const
	Get the number of devices in the list.
int	getPid (uint32_t index) const
	Get the PID of the device at the specified index.
int	getVid (uint32_t index) const
	Get the VID of the device at the specified index.
const char *	getUid (uint32_t index) const
	Get the UID of the device at the specified index.
const char *	getSerialNumber (uint32_t index) const
	Get the serial number of the device at the specified index.
const char *	getName (uint32_t index) const
	Get the name of the device at the specified index in the device list.
const char *	getConnectionType (uint32_t index) const
	Get device connection type.
const char *	getIpAddress (uint32_t index) const
	get the ip address of the device at the specified index
const char *	getSubnetMask (uint32_t index) const
	get the subnet mask of the device at the specified index
const char *	getGateway (uint32_t index) const
	get the gateway of the device at the specified index
const char *	getLocalMacAddress (uint32_t index) const
	Get the MAC address of the host network interface corresponding to the device at the specified index.
const char *	getLocalIP (uint32_t index) const
	Get the IP address of the host network interface corresponding to the device at the specified index.
uint8_t	getLocalSubnetLength (uint32_t index) const
	Get the subnet length of the host network interface corresponding to the device at the specified index.
const char *	getLocalGateway (uint32_t index) const
	Get the gateway of the host network interface corresponding to the device at the specified index.
std::shared_ptr< Device >	getDevice (uint32_t index) const
	Get the device object at the specified index.
std::shared_ptr< Device >	getDeviceBySN (const char *serialNumber) const
	Get the device object with the specified serial number.
std::shared_ptr< Device >	getDeviceByUid (const char *uid) const
	Get the specified device object from the device list by uid.
uint32_t	deviceCount () const
int	pid (uint32_t index) const
int	vid (uint32_t index) const
const char *	uid (uint32_t index) const
const char *	serialNumber (uint32_t index) const
const char *	name (uint32_t index) const
const char *	connectionType (uint32_t index) const
const char *	ipAddress (uint32_t index) const

Detailed Description

Class representing a list of devices.

Definition at line 1109 of file Device.hpp.

Constructor & Destructor Documentation

◆ DeviceList()

ob::DeviceList::DeviceList ( ob_device_list_t * impl )

inlineexplicit

Definition at line 1114 of file Device.hpp.

◆ ~DeviceList()

ob::DeviceList::~DeviceList ( )

inlinenoexcept

Definition at line 1115 of file Device.hpp.

Member Function Documentation

◆ getCount()

uint32_t ob::DeviceList::getCount ( ) const

inline

Get the number of devices in the list.

Returns: uint32_t the number of devices in the list

Definition at line 1126 of file Device.hpp.

Referenced by deviceCount().

◆ getPid()

int ob::DeviceList::getPid ( uint32_t index ) const

inline

Get the PID of the device at the specified index.

Parameters

index the index of the device

Returns: int the PID of the device

Definition at line 1139 of file Device.hpp.

Referenced by pid().

◆ getVid()

int ob::DeviceList::getVid ( uint32_t index ) const

inline

Get the VID of the device at the specified index.

Parameters

index the index of the device

Returns: int the VID of the device

Definition at line 1152 of file Device.hpp.

Referenced by vid().

◆ getUid()

const char * ob::DeviceList::getUid ( uint32_t index ) const

inline

Get the UID of the device at the specified index.

Parameters

index the index of the device

Returns: const char* the UID of the device

Definition at line 1165 of file Device.hpp.

Referenced by uid().

◆ getSerialNumber()

const char * ob::DeviceList::getSerialNumber ( uint32_t index ) const

inline

Get the serial number of the device at the specified index.

Parameters

index the index of the device

Returns: const char* the serial number of the device

Definition at line 1178 of file Device.hpp.

Referenced by serialNumber().

◆ getName()

const char * ob::DeviceList::getName ( uint32_t index ) const

inline

Get the name of the device at the specified index in the device list.

This function retrieves the name of the device at the given index in the device list. If an error occurs during the operation, it will be handled by the Error::handle function.

Parameters

index The index of the device in the device list.

Returns: const char* The name of the device at the specified index.

Definition at line 1194 of file Device.hpp.

Referenced by name().

◆ getConnectionType()

const char * ob::DeviceList::getConnectionType ( uint32_t index ) const

inline

Get device connection type.

Parameters

index device index

Returns: const char* returns connection type, currently supports: "USB", "USB1.0", "USB1.1", "USB2.0", "USB2.1", "USB3.0", "USB3.1", "USB3.2", "Ethernet"

Definition at line 1207 of file Device.hpp.

Referenced by connectionType().

◆ getIpAddress()

const char * ob::DeviceList::getIpAddress ( uint32_t index ) const

inline

get the ip address of the device at the specified index

Attention: Only valid for network devices, otherwise it will return "0.0.0.0".

Parameters

index the index of the device

Returns: const char* the ip address of the device

Definition at line 1222 of file Device.hpp.

Referenced by ipAddress().

◆ getSubnetMask()

const char * ob::DeviceList::getSubnetMask ( uint32_t index ) const

inline

get the subnet mask of the device at the specified index

Attention: Only valid for network devices, otherwise it will return "0.0.0.0".

Parameters

index the index of the device

Returns: const char* the subnet mask of the device

Definition at line 1237 of file Device.hpp.

◆ getGateway()

const char * ob::DeviceList::getGateway ( uint32_t index ) const

inline

get the gateway of the device at the specified index

Attention: Only valid for network devices, otherwise it will return "0.0.0.0".

Parameters

index the index of the device

Returns: const char* the gateway of the device

Definition at line 1252 of file Device.hpp.

◆ getLocalMacAddress()

const char * ob::DeviceList::getLocalMacAddress ( uint32_t index ) const

inline

Get the MAC address of the host network interface corresponding to the device at the specified index.

Attention: Only valid for network devices, otherwise it will return "0:0:0:0:0:0".

Parameters

index the index of the device

Returns: const char* The MAC address of the host network interface associated with the device.

Definition at line 1267 of file Device.hpp.

◆ getLocalIP()

const char * ob::DeviceList::getLocalIP ( uint32_t index ) const

inline

Get the IP address of the host network interface corresponding to the device at the specified index.

Attention: Only valid for network devices, otherwise it will return "0.0.0.0".

Parameters

index The index of the device

Returns: const char* The IP address of the host network interface associated with the device.

Definition at line 1282 of file Device.hpp.

◆ getLocalSubnetLength()

uint8_t ob::DeviceList::getLocalSubnetLength ( uint32_t index ) const

inline

Get the subnet length of the host network interface corresponding to the device at the specified index.

Attention: Only valid for network devices, otherwise it will return 0.

Parameters

index The index of the device

Returns: uint8_t The subnet length (0~32) of the host network interface associated with the device.

Definition at line 1297 of file Device.hpp.

◆ getLocalGateway()

const char * ob::DeviceList::getLocalGateway ( uint32_t index ) const

inline

Get the gateway of the host network interface corresponding to the device at the specified index.

Attention: Only valid for network devices, otherwise it will return "0.0.0.0".

Parameters

index The index of the device

Returns: const char* The gateway of the host network interface associated with the device.

Definition at line 1312 of file Device.hpp.

◆ getDevice()

std::shared_ptr< Device > ob::DeviceList::getDevice ( uint32_t index ) const

inline

Get the device object at the specified index.

Attention: If the device has already been acquired and created elsewhere, repeated acquisition will throw an exception

Parameters

index the index of the device to create

Returns: std::shared_ptr<Device> the device object

Definition at line 1327 of file Device.hpp.

◆ getDeviceBySN()

std::shared_ptr< Device > ob::DeviceList::getDeviceBySN ( const char * serialNumber ) const

inline

Get the device object with the specified serial number.

Attention: If the device has already been acquired and created elsewhere, repeated acquisition will throw an exception

Parameters

serialNumber the serial number of the device to create

Returns: std::shared_ptr<Device> the device object

Definition at line 1342 of file Device.hpp.

◆ getDeviceByUid()

std::shared_ptr< Device > ob::DeviceList::getDeviceByUid ( const char * uid ) const

inline

Get the specified device object from the device list by uid.

On Linux platform, for usb device, the uid of the device is composed of bus-port-dev, for example 1-1.2-1. But the SDK will remove the dev number and only keep the bus-port as the uid to create the device, for example 1-1.2, so that we can create a device connected to the specified USB port. Similarly, users can also directly pass in bus-port as uid to create device.

For GMSL device, the uid is GMSL port with "gmsl2-" prefix, for example gmsl2-1.

Attention: If the device has been acquired and created elsewhere, repeated acquisition will throw an exception

Parameters

uid	The uid of the device to be created

Returns: std::shared_ptr<Device> returns the device object

Definition at line 1361 of file Device.hpp.

◆ deviceCount()

uint32_t ob::DeviceList::deviceCount ( ) const

inline

Definition at line 1370 of file Device.hpp.

◆ pid()

int ob::DeviceList::pid ( uint32_t index ) const

inline

Definition at line 1374 of file Device.hpp.

Referenced by getPid().

◆ vid()

int ob::DeviceList::vid ( uint32_t index ) const

inline

Definition at line 1378 of file Device.hpp.

Referenced by getVid().

◆ uid()

const char * ob::DeviceList::uid ( uint32_t index ) const

inline

Definition at line 1382 of file Device.hpp.

Referenced by getDeviceByUid(), and getUid().

◆ serialNumber()

const char * ob::DeviceList::serialNumber ( uint32_t index ) const

inline

Definition at line 1386 of file Device.hpp.

Referenced by getDeviceBySN().

◆ name()

const char * ob::DeviceList::name ( uint32_t index ) const

inline

Definition at line 1390 of file Device.hpp.

Referenced by getName().

◆ connectionType()

const char * ob::DeviceList::connectionType ( uint32_t index ) const

inline

Definition at line 1394 of file Device.hpp.

◆ ipAddress()

const char * ob::DeviceList::ipAddress ( uint32_t index ) const

inline

Definition at line 1398 of file Device.hpp.

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

E:/jenkins/workspace/OrbbecSDK/build_sdk/OpenOrbbecSDK/include/libobsensor/hpp/Device.hpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ DeviceList()

◆ ~DeviceList()

Member Function Documentation

◆ getCount()

◆ getPid()

◆ getVid()

◆ getUid()

◆ getSerialNumber()

◆ getName()

◆ getConnectionType()

◆ getIpAddress()

◆ getSubnetMask()

◆ getGateway()

◆ getLocalMacAddress()

◆ getLocalIP()

◆ getLocalSubnetLength()

◆ getLocalGateway()

◆ getDevice()

◆ getDeviceBySN()

◆ getDeviceByUid()

◆ deviceCount()

◆ pid()

◆ vid()

◆ uid()

◆ serialNumber()

◆ name()

◆ connectionType()

◆ ipAddress()