TCP Client

UiFlow2 Example

simple client

Open the cores3_tcp_client_example.m5f2 project in UiFlow2.

This example creates a TCP client that sends data to a server.

UiFlow2 Code Block:

Example output:

None

MicroPython Example

simple client

This example creates a TCP client that sends data to a server.

MicroPython Code Block:

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
import socket
import network
import time


title0 = None
label0 = None
label1 = None
label2 = None
label3 = None
label4 = None
label5 = None
label6 = None
label7 = None
label8 = None
label9 = None
tcpc = None
wlan = None


count = None
data = None


def setup():
    global \
        title0, \
        label0, \
        label1, \
        label2, \
        label3, \
        label4, \
        label5, \
        label6, \
        label7, \
        label8, \
        label9, \
        tcpc, \
        wlan, \
        count, \
        data

    M5.begin()
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title("TCP Client", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu24)
    label0 = Widgets.Label("Local IP:", 4, 32, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label1 = Widgets.Label("Server IP:", 4, 60, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label2 = Widgets.Label("Server Port", 4, 88, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label3 = Widgets.Label("Send:", 4, 118, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label4 = Widgets.Label("Recv:", 4, 144, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label5 = Widgets.Label("label5", 136, 32, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label6 = Widgets.Label("label6", 136, 60, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label7 = Widgets.Label("label7", 136, 88, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label8 = Widgets.Label("label8", 136, 118, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label9 = Widgets.Label("label9", 136, 144, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    wlan = network.WLAN(network.STA_IF)
    wlan.active(True)
    tcpc = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    tcpc.connect(("192.168.8.236", 8001))
    count = 0
    label5.setText(str(wlan.ifconfig()[0]))
    label6.setText(str("192.168.8.137"))
    label7.setText(str("8001"))


def loop():
    global \
        title0, \
        label0, \
        label1, \
        label2, \
        label3, \
        label4, \
        label5, \
        label6, \
        label7, \
        label8, \
        label9, \
        tcpc, \
        wlan, \
        count, \
        data
    tcpc.send(str(count))
    label8.setText(str(count))
    time.sleep_ms(100)
    data = tcpc.recv(1024)
    count = (count if isinstance(count, (int, float)) else 0) + 1
    if not len(data):
        pass
    label9.setText(str(data))
    time.sleep(1)
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

Example output:

None

API

socket.socket()

socket.connect(address)

Create a socket object and connect to the server.

Parameters:: address (tuple) – A tuple containing the server IP address and port number.
Returns:: A socket object.
Return type:: socket.socket

UiFlow2 Code Block:

MicroPython Code Block:

import socket

tcpc = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
tcpc.connect(('192.168.8.236', 8001))

socket.close()

Close the socket connection.

UiFlow2 Code Block:

MicroPython Code Block:

tcpc.close()

socket.recv(bufsize)

Receive data from the socket.

Parameters:: bufsize (int) – The maximum amount of data to be received at once.
Returns:: The received data.
Return type:: bytes

UiFlow2 Code Block:

MicroPython Code Block:

data = tcpc.recv(1024)
print(data)

socket.read()

Read data from the socket.

Returns:: The received data.
Return type:: bytes

UiFlow2 Code Block:

MicroPython Code Block:

data = tcpc.read()
print(data)

socket.readline()

Read a line, ending in a newline character.

Returns:: the line read.
Return type:: str

UiFlow2 Code Block:

MicroPython Code Block:

data = tcpc.readline()
print(data)

socket.send(data)

Send data to the socket. The socket must be connected to a remote socket.

Parameters:: data (bytes | str) – The data to be sent.
Returns:: The number of bytes sent.
Return type:: int

UiFlow2 Code Block:

MicroPython Code Block:

tcpc.send(b'Hello, World!')
tcpc.send('Hello, World!')

socket.write(data)

Write the buffer of bytes to the socket. This function will try to write all data to a socket (no “short writes”). This may be not possible with a non-blocking socket though, and returned value will be less than the length of buf.

Parameters:: data (bytes | str) – The data to be sent.
Returns:: The number of bytes sent.
Return type:: int

UiFlow2 Code Block:

MicroPython Code Block:

tcpc.write(b'Hello, World!')
tcpc.write('Hello, World!')

socket.setblocking(flag)

Set blocking or non-blocking mode of the socket: if flag is false, the socket is set to non-blocking, else to blocking mode.

This method is a shorthand for certain settimeout() calls:

sock.setblocking(True) is equivalent to sock.settimeout(None)
sock.setblocking(False) is equivalent to sock.settimeout(0)

param bool flag:

If True, the socket will be in blocking mode. If False, the socket will be in non-blocking mode.

return:

None

rtype:

None

UiFlow2 Code Block:

MicroPython Code Block:
tcpc.setblocking(True)
tcpc.setblocking(False)

socket.settimeout(timeout)

Set a timeout on blocking socket operations. The value argument can be a nonnegative floating point number expressing seconds, or None. If a non-zero value is given, subsequent socket operations will raise an OSError exception if the timeout period value has elapsed before the operation has completed. If zero is given, the socket is put in non-blocking mode. If None is given, the socket is put in blocking mode.

Parameters:: timeout (float) – The timeout value in seconds. If None, the socket is put in blocking mode.
Returns:: None
Return type:: None

UiFlow2 Code Block:

MicroPython Code Block:

tcpc.settimeout(5)
tcpc.settimeout(None)