Struct rubble::l2cap::Channel

pub struct Channel(u16);

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.

Tuple Fields

0: u16

Implementations

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 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 Debug for Channel

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

Formats the value using the given formatter.

impl Format for Channel

fn format(&self, fmt: Formatter<'_>)

Writes the defmt representation of self to fmt.

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 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.

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 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 Copy for Channel

impl Eq for Channel

impl StructuralEq for Channel

impl StructuralPartialEq for Channel