Pycom Basic Howto: Installing Mpy-Repl-Tool

PyCom basic HowTo - HackMD https://hackmd.io/@pmanzoni/HJhUcamxQ?type...
PyCom basic HowTo

This document describes:
1. the basic information required to set up a development environment, and

2. the programming workflow for a Pycom device, in our case the LoPys.
The main goal is to gain access to the REPL. REPL stands for Read Evaluate Print Loop, and is
the name given to the interactive MicroPython prompt that is accessible on the Pycom Devices.
Using the REPL is by far the easiest way to test out python code and run commands.
More infos about REPL can be found here: https://docs.pycom.io/chapter/gettingstarted
/programming/repl/ (https://docs.pycom.io/chapter/gettingstarted/programming/repl/)
You must have Python3 and pip installed in your computer.
installing Python3 -> https://www.python.org/download/releases/3.0/ (https://www.python.org

/download/releases/3.0/)
installing pip -> sudo apt-get install python3-pip
Installing mpy-repl-tool
mpy-repl-tool is the software tool that we will use to connect and control a LoPy (http://mpy-repl-
tool.readthedocs.io/en/latest/index.html (http://mpy-repl-tool.readthedocs.io/en/latest/index.html)).
To install it you have to execute:
$ python3 -m pip install mpy-repl-tool
Getting started with mpy-repl-tool
Plug-in your LoPy device in a USB port and wait a few seconds until the LED starts blinking in
blue.
NOTE: If you are using an OS inside a virtual machine, remember to tell the host machine to
associate the device with your VM
Then execute:
1 of 6 7/4/19, 8:31 PM
$ python3 -m there detect
This command will list the serial ports and “hopefully” will automatically find your LoPy board.
OK, now you are ready to start!
Some usage examples
to get a list of the files on the LoPy do: $ python3 -m there ls -l /flash/*
for example:
$ python3 -m there ls -l /flash/*

---------- 0 0 34B 1980-01-01 01:09:16 /flash/main.py
---------- 0 0 29B 1980-01-01 01:09:18 /flash/boot.py
The filesystem has / as the root directory and the available physical drives are accessible
from here. They are:
/flash – the internal flash filesystem
/sd – the SD card (if it exists)
read the contents of a file on the LoPy:

python3 -m there cat /flash/somefile
copy multiple files from your computer to the LoPy:

python3 -m there push *.py /flash
backup all the files on the LoPy to your computer

python3 -m there pull -r \* backup
finally, to start a serial terminal and get access to the REPL (https://docs.pycom.io/chapter
/toolsandfeatures/repl/) prompt add, exec:
python3 -m there -i
A detailed list of commands can be found here: http://mpy-repl-tool.readthedocs.io/en/latest

/commandline.html (http://mpy-repl-tool.readthedocs.io/en/latest/commandline.html)
Typical Lopy device workflow

A typical workflow is the following:
1. Create a folder on your computer

2. Plug your device into your USB port and exec:
$ python3 -m there detect
2 of 6 7/4/19, 8:31 PM
3. Write your code on your computer

4. Copy the code files from your computer to the LoPy
$ python3 -m there push *.py /flash
5. Start a serial terminal and get access to the REPL:

$ python3 -m there -i
6. Execute the code on the LoPy: e.g., >>> import file
Exercise: Let’s see if it works

Execute the following code on your LoPy
1 import pycom
2 import time
3
4 RED = 0xFF0000
5 YELLOW = 0xFFFF33
6 GREEN = 0x007F00
7 OFF = 0x000000
8
9 def set_led_to(color=GREEN):
10 pycom.heartbeat(False) # Disable the heartbeat LED
11 pycom.rgbled(color)
12
13 def flash_led_to(color=GREEN, t1=1):
14 set_led_to(color)
15 time.sleep(t1)
16 set_led_to(OFF)
17
18 flash_led_to(RED)
19 flash_led_to(YELLOW)
20 set_led_to(OFF)
Hint: save the code in a file named “test.py (http://test.py)” for example and, in the REPL
console, write import test
How to
Below you’ll find some generic information about how to connect and work with LoPys.
Connect to a LoPy via WiFi
You can have access to the REPL also via a WiFi connection. Your LoPy by default works as a
WiFi access point. Search an SSID that looks like lopy-wlan-XXXX ; the password is
www.pycom.io :
3 of 6 7/4/19, 8:31 PM
Then, you can access via telnet or via tools like Filezilla.
Accesing via telnet :
Simply execute:
telnet 192.168.4.1 and use as user/password the values micro/python.
Accesing via Filezilla

If you want to interchange files with your LoPy you can use a tool like Filezilla:
1. Connect to device’s WiFi (see above):
2. Go to top menu File > Site Manager... and use as the user/password pair the values
micro/python:
4 of 6 7/4/19, 8:31 PM
Resetting
They are different ways to reset your device. Pycom devices support both soft and hard resets.
A soft reset clears the state of the MicroPython virtual machine but leaves hardware peripherals
unaffected. To do a soft reset,
press Ctrl+D on the REPL or

execute:
>>> import sys

>>> sys.exit()
A hard reset is the same as performing a power cycle to the device. In order to hard reset the
device, press the reset switch or run:
>>> import machine

>>> machine.reset()
If a device’s filesystem gets corrupted, it can format it by running:
>>> import os
>>> os.mkfs('/flash')
5 of 6 7/4/19, 8:31 PM
then reboot.
More details here: https://docs.pycom.io/chapter/toolsandfeatures/bootmodes.html

(https://docs.pycom.io/chapter/toolsandfeatures/bootmodes.html)
6 of 6 7/4/19, 8:31 PM

Pycom Basic Howto: Installing Mpy-Repl-Tool

Uploaded by

Copyright:

Available Formats

Pycom Basic Howto: Installing Mpy-Repl-Tool

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Pycom Basic Howto: Installing Mpy-Repl-Tool

Uploaded by

Copyright:

Available Formats

PyCom basic HowTo - HackMD https://hackmd.io/@pmanzoni/HJhUcamxQ?type...

PyCom basic HowTo

1. the basic information required to set up a development environment, and

You must have Python3 and pip installed in your computer.

installing Python3 -> https://www.python.org/download/releases/3.0/ (https://www.python.org

installing pip -> sudo apt-get install python3-pip

To install it you have to execute:

$ python3 -m pip install mpy-repl-tool

Getting started with mpy-repl-tool

$ python3 -m there detect

OK, now you are ready to start!

Some usage examples

$ python3 -m there ls -l /flash/*

/flash – the internal flash filesystem

/sd – the SD card (if it exists)

read the contents of a file on the LoPy:

copy multiple files from your computer to the LoPy:

backup all the files on the LoPy to your computer

A detailed list of commands can be found here: http://mpy-repl-tool.readthedocs.io/en/latest

Typical Lopy device workflow

1. Create a folder on your computer

3. Write your code on your computer

5. Start a serial terminal and get access to the REPL:

6. Execute the code on the LoPy: e.g., >>> import file

Exercise: Let’s see if it works

Connect to a LoPy via WiFi

Accesing via telnet :

Accesing via Filezilla

1. Connect to device’s WiFi (see above):

press Ctrl+D on the REPL or

>>> import sys

>>> import machine

If a device’s filesystem gets corrupted, it can format it by running:

More details here: https://docs.pycom.io/chapter/toolsandfeatures/bootmodes.html

You might also like