History

microDev a52eb88031 run code formatting script		2021-03-15 19:27:36 +05:30
..
cpy-client.py	run code formatting script	2021-03-15 19:27:36 +05:30
host-server.py	run code formatting script	2021-03-15 19:27:36 +05:30
readme.md	Fix file ends for CI	2021-02-18 16:26:14 -05:00

readme.md

Circuitpython as Client

This example demonstrates the use of Socket as a client, accessing a server on a host development machine. This Circuitpython sketch uses the Connect, Send, and Recv_Into methods.

Prerequisites

Circuitpython V6.2.0 minimum. Neither the host or client sketch has installed module prerequisites.

Setup

Find a viable IP address for the host machine first and insert it in both sketches as HOST. On mac, this can be done by going to System Preferences/Network and checking the IP address used to connect to the local wireless network. Make sure that both devices are using the same WIFI!

Each sketch can have Timeout values changed. The host sketch usually needs a value above 0, or the recv() will fail. Currently, Circuitpython's Connect function is always blocking, so changing the client timeout will not cause much change in behavior.

Start the Server on the host PC first, within this folder:

python host-server.py

Then, reload the client sketch in Circuitpython.

Expected Behavior

The example should connect to a server running on the host machine. The client will send a "Hello world" string to the server, which will return it.

Expected client output:

Connecting to wifi
Creating Socket
Connecting
Sending
Receiving
bytearray(b'Hello, world')

Expected Server output (IP/port values will vary):

Create Socket
Accepting connections
Connected by ('192.168.10.128', 64509)
got: b'Hello, world'
sent: b'Hello, world'