ESPHome 2025.10.4
Loading...
Searching...
No Matches
Data Structures | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes
esphome::api::APIFrameHelper Class Referenceabstract

#include <api_frame_helper.h>

Inheritance diagram for esphome::api::APIFrameHelper:
esphome::api::APINoiseFrameHelper esphome::api::APIPlaintextFrameHelper

Data Structures

struct  SendBuffer
 

Public Member Functions

 APIFrameHelper ()=default
 
 APIFrameHelper (std::unique_ptr< socket::Socket > socket, const ClientInfo *client_info)
 
virtual ~APIFrameHelper ()=default
 
virtual APIError init ()=0
 
virtual APIError loop ()
 
virtual APIError read_packet (ReadPacketBuffer *buffer)=0
 
bool can_write_without_blocking ()
 
std::string getpeername ()
 
int getpeername (struct sockaddr *addr, socklen_t *addrlen)
 
APIError close ()
 
APIError shutdown (int how)
 
virtual APIError write_protobuf_packet (uint8_t type, ProtoWriteBuffer buffer)=0
 
virtual APIError write_protobuf_packets (ProtoWriteBuffer buffer, std::span< const PacketInfo > packets)=0
 
uint8_t frame_header_padding () const
 
uint8_t frame_footer_size () const
 
bool is_socket_ready () const
 

Protected Types

enum class  State : uint8_t {
  INITIALIZE = 1 , CLIENT_HELLO = 2 , SERVER_HELLO = 3 , HANDSHAKE = 4 ,
  DATA = 5 , CLOSED = 6 , FAILED = 7 , EXPLICIT_REJECT = 8
}
 

Protected Member Functions

APIError write_raw_ (const struct iovec *iov, int iovcnt, uint16_t total_write_len)
 
APIError try_send_tx_buf_ ()
 
void buffer_data_from_iov_ (const struct iovec *iov, int iovcnt, uint16_t total_write_len, uint16_t offset)
 
APIError handle_socket_write_error_ ()
 
template<typename StateEnum >
APIError write_raw_ (const struct iovec *iov, int iovcnt, socket::Socket *socket, std::vector< uint8_t > &tx_buf, const std::string &info, StateEnum &state, StateEnum failed_state)
 
APIError init_common_ ()
 
APIError handle_socket_read_result_ (ssize_t received)
 

Protected Attributes

socket::Socket * socket_ {nullptr}
 
std::unique_ptr< socket::Socket > socket_owned_
 
std::array< std::unique_ptr< SendBuffer >, API_MAX_SEND_QUEUE > tx_buf_
 
std::vector< struct iovec > reusable_iovs_
 
std::vector< uint8_t > rx_buf_
 
const ClientInfo * client_info_ {nullptr}
 
uint16_t rx_buf_len_ = 0
 
State state_ {State::INITIALIZE}
 
uint8_t frame_header_padding_ {0}
 
uint8_t frame_footer_size_ {0}
 
uint8_t tx_buf_head_ {0}
 
uint8_t tx_buf_tail_ {0}
 
uint8_t tx_buf_count_ {0}
 

Detailed Description

Definition at line 83 of file api_frame_helper.h.

Member Enumeration Documentation

◆ State

enum class esphome::api::APIFrameHelper::State : uint8_t
strongprotected
Enumerator
INITIALIZE 
CLIENT_HELLO 
SERVER_HELLO 
HANDSHAKE 
DATA 
CLOSED 
FAILED 
EXPLICIT_REJECT 

Definition at line 164 of file api_frame_helper.h.

Constructor & Destructor Documentation

◆ APIFrameHelper() [1/2]

esphome::api::APIFrameHelper::APIFrameHelper ( )
default

◆ APIFrameHelper() [2/2]

esphome::api::APIFrameHelper::APIFrameHelper ( std::unique_ptr< socket::Socket > socket,
const ClientInfo * client_info )
inlineexplicit

Definition at line 86 of file api_frame_helper.h.

◆ ~APIFrameHelper()

virtual esphome::api::APIFrameHelper::~APIFrameHelper ( )
virtualdefault

Member Function Documentation

◆ buffer_data_from_iov_()

void esphome::api::APIFrameHelper::buffer_data_from_iov_ ( const struct iovec * iov,
int iovcnt,
uint16_t total_write_len,
uint16_t offset )
protected

Definition at line 104 of file api_frame_helper.cpp.

◆ can_write_without_blocking()

bool esphome::api::APIFrameHelper::can_write_without_blocking ( )
inline

Definition at line 94 of file api_frame_helper.h.

◆ close()

APIError esphome::api::APIFrameHelper::close ( )
inline

Definition at line 97 of file api_frame_helper.h.

◆ frame_footer_size()

uint8_t esphome::api::APIFrameHelper::frame_footer_size ( ) const
inline

Definition at line 121 of file api_frame_helper.h.

◆ frame_header_padding()

uint8_t esphome::api::APIFrameHelper::frame_header_padding ( ) const
inline

Definition at line 119 of file api_frame_helper.h.

◆ getpeername() [1/2]

std::string esphome::api::APIFrameHelper::getpeername ( )
inline

Definition at line 95 of file api_frame_helper.h.

◆ getpeername() [2/2]

int esphome::api::APIFrameHelper::getpeername ( struct sockaddr * addr,
socklen_t * addrlen )
inline

Definition at line 96 of file api_frame_helper.h.

◆ handle_socket_read_result_()

APIError esphome::api::APIFrameHelper::handle_socket_read_result_ ( ssize_t received)
protected

Definition at line 249 of file api_frame_helper.cpp.

◆ handle_socket_write_error_()

APIError esphome::api::APIFrameHelper::handle_socket_write_error_ ( )
protected

Definition at line 94 of file api_frame_helper.cpp.

◆ init()

virtual APIError esphome::api::APIFrameHelper::init ( )
pure virtual

Implemented in esphome::api::APINoiseFrameHelper, and esphome::api::APIPlaintextFrameHelper.

◆ init_common_()

APIError esphome::api::APIFrameHelper::init_common_ ( )
protected

Definition at line 227 of file api_frame_helper.cpp.

◆ is_socket_ready()

bool esphome::api::APIFrameHelper::is_socket_ready ( ) const
inline

Definition at line 123 of file api_frame_helper.h.

◆ loop()

APIError esphome::api::APIFrameHelper::loop ( )
virtual

Reimplemented in esphome::api::APINoiseFrameHelper, and esphome::api::APIPlaintextFrameHelper.

Definition at line 83 of file api_frame_helper.cpp.

◆ read_packet()

virtual APIError esphome::api::APIFrameHelper::read_packet ( ReadPacketBuffer * buffer)
pure virtual

Implemented in esphome::api::APINoiseFrameHelper, and esphome::api::APIPlaintextFrameHelper.

◆ shutdown()

APIError esphome::api::APIFrameHelper::shutdown ( int how)
inline

Definition at line 104 of file api_frame_helper.h.

◆ try_send_tx_buf_()

APIError esphome::api::APIFrameHelper::try_send_tx_buf_ ( )
protected

Definition at line 196 of file api_frame_helper.cpp.

◆ write_protobuf_packet()

virtual APIError esphome::api::APIFrameHelper::write_protobuf_packet ( uint8_t type,
ProtoWriteBuffer buffer )
pure virtual

Implemented in esphome::api::APINoiseFrameHelper, and esphome::api::APIPlaintextFrameHelper.

◆ write_protobuf_packets()

virtual APIError esphome::api::APIFrameHelper::write_protobuf_packets ( ProtoWriteBuffer buffer,
std::span< const PacketInfo > packets )
pure virtual

Implemented in esphome::api::APINoiseFrameHelper, and esphome::api::APIPlaintextFrameHelper.

◆ write_raw_() [1/2]

template<typename StateEnum >
APIError esphome::api::APIFrameHelper::write_raw_ ( const struct iovec * iov,
int iovcnt,
socket::Socket * socket,
std::vector< uint8_t > & tx_buf,
const std::string & info,
StateEnum & state,
StateEnum failed_state )
protected

◆ write_raw_() [2/2]

APIError esphome::api::APIFrameHelper::write_raw_ ( const struct iovec * iov,
int iovcnt,
uint16_t total_write_len )
protected

Definition at line 144 of file api_frame_helper.cpp.

Field Documentation

◆ client_info_

const ClientInfo* esphome::api::APIFrameHelper::client_info_ {nullptr}
protected

Definition at line 182 of file api_frame_helper.h.

◆ frame_footer_size_

uint8_t esphome::api::APIFrameHelper::frame_footer_size_ {0}
protected

Definition at line 188 of file api_frame_helper.h.

◆ frame_header_padding_

uint8_t esphome::api::APIFrameHelper::frame_header_padding_ {0}
protected

Definition at line 187 of file api_frame_helper.h.

◆ reusable_iovs_

std::vector<struct iovec> esphome::api::APIFrameHelper::reusable_iovs_
protected

Definition at line 177 of file api_frame_helper.h.

◆ rx_buf_

std::vector<uint8_t> esphome::api::APIFrameHelper::rx_buf_
protected

Definition at line 178 of file api_frame_helper.h.

◆ rx_buf_len_

uint16_t esphome::api::APIFrameHelper::rx_buf_len_ = 0
protected

Definition at line 185 of file api_frame_helper.h.

◆ socket_

socket::Socket* esphome::api::APIFrameHelper::socket_ {nullptr}
protected

Definition at line 153 of file api_frame_helper.h.

◆ socket_owned_

std::unique_ptr<socket::Socket> esphome::api::APIFrameHelper::socket_owned_
protected

Definition at line 154 of file api_frame_helper.h.

◆ state_

State esphome::api::APIFrameHelper::state_ {State::INITIALIZE}
protected

Definition at line 186 of file api_frame_helper.h.

◆ tx_buf_

std::array<std::unique_ptr<SendBuffer>, API_MAX_SEND_QUEUE> esphome::api::APIFrameHelper::tx_buf_
protected

Definition at line 176 of file api_frame_helper.h.

◆ tx_buf_count_

uint8_t esphome::api::APIFrameHelper::tx_buf_count_ {0}
protected

Definition at line 191 of file api_frame_helper.h.

◆ tx_buf_head_

uint8_t esphome::api::APIFrameHelper::tx_buf_head_ {0}
protected

Definition at line 189 of file api_frame_helper.h.

◆ tx_buf_tail_

uint8_t esphome::api::APIFrameHelper::tx_buf_tail_ {0}
protected

Definition at line 190 of file api_frame_helper.h.

The documentation for this class was generated from the following files:
Generated by doxygen 1.12.0