USB Serial Converter
When you do not own an expansion board, it is possible to connect to your device using a USB to Serial adapter. Make sure your USB to Serial converter is able to communicate at baudrates of 115200 and 921600. We do not recommend this setup for beginners.
To connect to your device using a USB to Serial adapter, connect the following pins:
Note: Please ensure the signal and voltage level of your UART adapter does not exceed 3.3V. When possible, change the settings on your adapter.
- Connect the
RX
andTX
of your USB converter to theTX
andRX
of the device respectively. - To put the device into bootloader mode to update the firmware, you will need to connect
P2
toGND
. We recommend to connect a button for this.
By far the easiest way to access the USB UART REPL is via the our Pymakr plug-in for Atom and Visual Studio Code, though you might want to use one of the options listed below. Note that you can also use these methods when using one of the shields.
macOS and Linux
To open a serial USB connection from macOS, any serial tool may be used; in this example, the terminal tool screen
will be used. Open a terminal instance and run the following commands:
screen /dev/tty.usbmodem* 115200
To exit screen
, press CTRL-A CTRL-\
.
On Linux,
picocom
orminicom
may be used instead ofscreen
. The usb serial address might also be listed as/dev/ttyUSB01
or a higher increment forttyUSB
. Additionally, the elevated permissions to access the device (e.g. group uucp/dialout or usesudo
) may be required.
Windows
A terminal emulator is needed to open the connection from Windows. Te easiest option is to download the free program, PuTTY.
COM Port
To use PuTTY the serial port (COM port) in which the Pycom device is connected, must be located. In Windows, this information can be found from the ‘Device Manager’ program.
- Open the Windows start menu and search for ‘Device Manager’
- The COM port for the Pycom device will be listed as ‘USB Serial Device’ or a similar name
- Copy/Write down the associated COM port (e.g.
COM4
)
Using Putty
With PuTTY open, click on
Session
in the left-hand panelNext click the
Serial
radio button on the right and enter the associatedCOM port (e.g.
COM4
) in theSerial Line
box and115200
for the Speed.Finally, click the
Open
button