Struct rubble::l2cap::Channel

pub struct Channel(_);

An L2CAP channel identifier (CID).

Channels are basically like TCP ports. A Protocol can listen on a channel and is connected to a channel on the other device to which all responses are addressed.

A number of channel identifiers are reserved for predefined functions:

• 0x0000: The null identifier. Must never be used as a destination endpoint.
• 0x0001: L2CAP signaling channel (Classic Bluetooth only).
• 0x0002: Connectionless channel (Classic Bluetooth only).
• 0x0003: AMP manager (not relevant for Classic and LE Bluetooth).
• 0x0004: Attribute protocol (ATT). BLE only.
• 0x0005: LE L2CAP signaling channel.
• 0x0006: LE Security Manager protocol.
• 0x0007: Classic Bluetooth Security Manager protocol.
• 0x0008-0x003E: Reserved.
• 0x003F: AMP test manager (not relevant for Classic and LE Bluetooth).

For BLE, channels 0x0040-0x007F are dynamically allocated, while 0x0080 and beyond are reserved and should not be used (as of Bluetooth 4.2).

For classic Bluetooth, all channels 0x0040-0xFFFF are available for dynamic allocation.

Methods

impl Channel

pub const NULL: Self

The null channel identifier. Must not be used as a destination endpoint.

pub const ATT: Self

The channel used by the Attribute Protocol (ATT).

pub const LE_SIGNALING: Self

LE L2CAP signaling channel (connectionless).

pub const LE_SECURITY_MANAGER: Self

LE Security Manager channel.

pub fn as_raw(&self) -> u16

Returns the channel identifier (CID) as a raw u16.

pub fn is_connection_oriented(&self) -> bool

Returns whether this channel is connection-oriented.

L2CAP PDUs addressed to connection-oriented channels are called B-frames if the channel is in "Basic Mode", and can be either S-frames or I-frames if the channel is in retransmission/flow control/streaming modes.

pub fn is_connectionless(&self) -> bool

Returns whether this channel is connectionless.

L2CAP PDUs addressed to connectionless channels are called G-frames.

Trait Implementations

impl ToBytes for Channel

fn to_bytes(&self, writer: &mut ByteWriter) -> Result<(), Error>

Converts self to bytes and writes them into writer, advancing writer to point past the encoded value.

impl<'_> FromBytes<'_> for Channel

fn from_bytes(bytes: &mut ByteReader) -> Result<Self, Error>

Decode a Self from a byte slice, advancing bytes to point past the data that was read.

impl PartialEq<Channel> for Channel

fn eq(&self, other: &Channel) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Channel) -> bool

This method tests for !=.

impl Eq for Channel

impl Clone for Channel

fn clone(&self) -> Channel

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Channel

impl Debug for Channel

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Hash for Channel

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].