ESPHome 2026.1.0-dev
Loading...
Searching...
No Matches
socket.h
Go to the documentation of this file.
1#pragma once
2#include <memory>
3#include <string>
4
6#include "headers.h"
7
8#if defined(USE_SOCKET_IMPL_LWIP_TCP) || defined(USE_SOCKET_IMPL_LWIP_SOCKETS) || defined(USE_SOCKET_IMPL_BSD_SOCKETS)
9namespace esphome::socket {
10
11class Socket {
12 public:
13 Socket() = default;
14 virtual ~Socket();
15 Socket(const Socket &) = delete;
16 Socket &operator=(const Socket &) = delete;
17
18 virtual std::unique_ptr<Socket> accept(struct sockaddr *addr, socklen_t *addrlen) = 0;
21 virtual std::unique_ptr<Socket> accept_loop_monitored(struct sockaddr *addr, socklen_t *addrlen) {
22 return accept(addr, addrlen); // Default implementation for backward compatibility
23 }
24 virtual int bind(const struct sockaddr *addr, socklen_t addrlen) = 0;
25 virtual int close() = 0;
26 // not supported yet:
27 // virtual int connect(const std::string &address) = 0;
28#if defined(USE_SOCKET_IMPL_LWIP_SOCKETS) || defined(USE_SOCKET_IMPL_BSD_SOCKETS)
29 virtual int connect(const struct sockaddr *addr, socklen_t addrlen) = 0;
30#endif
31 virtual int shutdown(int how) = 0;
32
33 virtual int getpeername(struct sockaddr *addr, socklen_t *addrlen) = 0;
34 virtual std::string getpeername() = 0;
35 virtual int getsockname(struct sockaddr *addr, socklen_t *addrlen) = 0;
36 virtual std::string getsockname() = 0;
37 virtual int getsockopt(int level, int optname, void *optval, socklen_t *optlen) = 0;
38 virtual int setsockopt(int level, int optname, const void *optval, socklen_t optlen) = 0;
39 virtual int listen(int backlog) = 0;
40 virtual ssize_t read(void *buf, size_t len) = 0;
41 virtual ssize_t recvfrom(void *buf, size_t len, sockaddr *addr, socklen_t *addr_len) = 0;
42 virtual ssize_t readv(const struct iovec *iov, int iovcnt) = 0;
43 virtual ssize_t write(const void *buf, size_t len) = 0;
44 virtual ssize_t writev(const struct iovec *iov, int iovcnt) = 0;
45 virtual ssize_t sendto(const void *buf, size_t len, int flags, const struct sockaddr *to, socklen_t tolen) = 0;
46
47 virtual int setblocking(bool blocking) = 0;
48 virtual int loop() { return 0; };
49
51 virtual int get_fd() const { return -1; }
52
56 virtual bool ready() const { return true; }
57};
58
60std::unique_ptr<Socket> socket(int domain, int type, int protocol);
62std::unique_ptr<Socket> socket_ip(int type, int protocol);
63
70std::unique_ptr<Socket> socket_loop_monitored(int domain, int type, int protocol);
71std::unique_ptr<Socket> socket_ip_loop_monitored(int type, int protocol);
72
74socklen_t set_sockaddr(struct sockaddr *addr, socklen_t addrlen, const std::string &ip_address, uint16_t port);
75
77socklen_t set_sockaddr_any(struct sockaddr *addr, socklen_t addrlen, uint16_t port);
78
79#if defined(USE_ESP8266) && defined(USE_SOCKET_IMPL_LWIP_TCP)
82void socket_delay(uint32_t ms);
83
85void socket_wake();
86#endif
87
88} // namespace esphome::socket
89#endif
virtual ssize_t write(const void *buf, size_t len)=0
Socket(const Socket &)=delete
virtual int listen(int backlog)=0
virtual int bind(const struct sockaddr *addr, socklen_t addrlen)=0
virtual std::string getpeername()=0
virtual ssize_t recvfrom(void *buf, size_t len, sockaddr *addr, socklen_t *addr_len)=0
virtual int setblocking(bool blocking)=0
virtual ssize_t writev(const struct iovec *iov, int iovcnt)=0
virtual std::unique_ptr< Socket > accept(struct sockaddr *addr, socklen_t *addrlen)=0
virtual ssize_t read(void *buf, size_t len)=0
virtual int setsockopt(int level, int optname, const void *optval, socklen_t optlen)=0
virtual int getsockopt(int level, int optname, void *optval, socklen_t *optlen)=0
virtual ssize_t readv(const struct iovec *iov, int iovcnt)=0
virtual int shutdown(int how)=0
virtual ssize_t sendto(const void *buf, size_t len, int flags, const struct sockaddr *to, socklen_t tolen)=0
virtual int getpeername(struct sockaddr *addr, socklen_t *addrlen)=0
Socket & operator=(const Socket &)=delete
virtual int loop()
Definition socket.h:48
virtual int getsockname(struct sockaddr *addr, socklen_t *addrlen)=0
virtual std::unique_ptr< Socket > accept_loop_monitored(struct sockaddr *addr, socklen_t *addrlen)
Accept a connection and monitor it in the main loop NOTE: This function is NOT thread-safe and must o...
Definition socket.h:21
virtual int close()=0
virtual std::string getsockname()=0
virtual int get_fd() const
Get the underlying file descriptor (returns -1 if not supported)
Definition socket.h:51
virtual int connect(const struct sockaddr *addr, socklen_t addrlen)=0
virtual bool ready() const
Check if socket has data ready to read For loop-monitored sockets, checks with the Application's sele...
Definition socket.h:56
uint16_t type
uint16_t flags
uint16_t addr_len
uint32_t socklen_t
Definition headers.h:97
__int64 ssize_t
Definition httplib.h:178
std::unique_ptr< Socket > socket_ip(int type, int protocol)
Create a socket in the newest available IP domain (IPv6 or IPv4) of the given type and protocol.
Definition socket.cpp:13
void socket_wake()
Called by lwip callbacks to signal socket activity and wake delay.
std::unique_ptr< Socket > socket_ip_loop_monitored(int type, int protocol)
Definition socket.cpp:21
socklen_t set_sockaddr(struct sockaddr *addr, socklen_t addrlen, const std::string &ip_address, uint16_t port)
Set a sockaddr to the specified address and port for the IP version used by socket_ip().
Definition socket.cpp:29
socklen_t set_sockaddr_any(struct sockaddr *addr, socklen_t addrlen, uint16_t port)
Set a sockaddr to the any address and specified port for the IP version used by socket_ip().
Definition socket.cpp:68
std::unique_ptr< Socket > socket_loop_monitored(int domain, int type, int protocol)
Create a socket and monitor it for data in the main loop.
void socket_delay(uint32_t ms)
Delay that can be woken early by socket activity.
std::string size_t len
Definition helpers.h:533