net - TCP-сокети

Функції для роботи з TCP-з’єднаннями на низькому рівні.

Модуль net надає доступ до сирих TCP-сокетів — як у ролі клієнта (підключення до сервера), так і у ролі сервера (очікування вхідних підключень). Для роботи з мережею Лілка повинна бути підключена до WiFi (див. wifi - Робота з WiFi-мережами).

Примітка

Для роботи з HTTP-запитами використовуйте модуль http - Робота з HTTP запитами. Для побудови HTTP-сервера зручніше використовувати httpserver - HTTP-сервер. Модуль net корисний, коли потрібно реалізувати власний протокол поверх TCP.

Приклад клієнтського підключення:

wifi.connect("MyWifi", "password")

local fd, err = net.connect("example.com", 80)
if fd == nil then
    error("Помилка підключення: " .. err)
end

net.send(fd, "GET / HTTP/1.0\r\nHost: example.com\r\n\r\n")

local data, err = net.receive(fd, 1024)
if data then
    print(data)
end

net.close(fd)

Приклад TCP-сервера:

wifi.connect("MyWifi", "password")

local server_fd = net.listen(1234)

function lilka.update(delta)
    local client_fd, client_ip = net.accept(server_fd, 0)
    if client_fd == nil then
        return
    end

    print("Підключився:", client_ip)
    local data = net.receive(client_fd, 256)
    if data then
        net.send(client_fd, "Отримано: " .. data)
    end
    net.close(client_fd)
end

function lilka.draw()
    display.fill_screen(display.color565(0, 0, 0))
    display.set_cursor(0, 16)
    display.print("TCP-сервер запущено")
end

class net

static connect(host, port, timeout_ms?)

Connects to a TCP server.

Parameters:

• host (str) – Server hostname or IP address

• port (integer) – Port number

• timeout_ms? (integer) – Connect and I/O timeout in milliseconds (default: 5000)

Returns:

fd Socket file descriptor, or nil on error

Return type:

integer or nil

Returns:

? errmsg Error message on failure

Return type:

str

static send(fd, data)

Sends data over a socket.

Parameters:

• fd (integer) – Socket file descriptor

• data (str) – Data to send

Returns:

bytes_sent Number of bytes sent, or nil on error

Return type:

integer or nil

Returns:

? errmsg Error message on failure

Return type:

str

static receive(fd, max_bytes?, timeout_ms?)

Receives data from a socket (blocks until data arrives or timeout).

Parameters:

• fd (integer) – Socket file descriptor

• max_bytes? (integer) – Maximum bytes to read (default: 1024)

• timeout_ms? (integer) – Override receive timeout in ms; -1 keeps the current setting

Returns:

data Received data, or nil on timeout/close/error

Return type:

str or nil

Returns:

? errmsg «timeout» | «connection closed» | error description

Return type:

str

static close(fd)

Closes a socket.

Parameters:

fd (integer) – Socket file descriptor

static settimeout(fd, timeout_ms)

Sets the send and receive timeout for a socket.

Parameters:

• fd (integer) – Socket file descriptor

• timeout_ms (integer) – Timeout in milliseconds

static listen(port, backlog?)

Creates a TCP server socket bound to the given port and starts listening.

Parameters:

• port (integer) – Port to listen on

• backlog? (integer) – Connection backlog (default: 5)

Returns:

fd Server socket file descriptor, or nil on error

Return type:

integer or nil

Returns:

? errmsg Error message on failure

Return type:

str

static accept(server_fd, timeout_ms?)

Accepts an incoming connection on a server socket.

Returns the client socket fd and the client’s IP address string.

Parameters:

• server_fd (integer) – Server socket file descriptor

• timeout_ms? (integer) – How long to wait for a connection in ms; -1 = no timeout

Returns:

client_fd Client socket fd, or nil on timeout/error

Return type:

integer or nil

Returns:

client_ip_or_errmsg Client IP address on success, or error message

Return type:

str