For Windows users

The installation of the tools is similar as for Ubuntu. You must install realterm as terminal emulator instead of minicom and you must install Python for Windows. Please install the stable version (3.7.3 at the time of writing). Then install the Python modules using pip (pip install PyQt5 ...)

PyQt5, pyserial, pyflakes, sip, qscintilla, esptool, pyparsing, pyinstaller, thonny, thonny-esp

With these you should be able to run uPyCraft and thonny. There is a Windows binary in the uPyCraft repository in the directory dist, which you may want to try,

When running uPyCraft for the first time, you must run it in administrator mode. Then click on "workspace" to define the directory where your micropython programs will be located. Once this is done, you may quit and re-run uPyCraft as normal user.

To edit your micropython files you may use idle, which can be started with idle.bat located in your Python_installation_dir\lib\idlelib. Create a shortcut to easily access the the command.

• a modified version based on Qt5

• gtkterm

Installing uPyCraft and burning micropython into the WeMos D1 mini flash

git clone https://github.com/uraich/uPyCraft-Qt5.git_

cd uPyCraft-Qt5

./uPyCraft.py

It should ask you if you want the examples to be installed to which you answer "yes"

If it comes up as expected, please check that the hidden directory ~/.uPyCraft is created in your home directory. If all is well, exit uPyCraft again.

Connect the WeMos D1 mini to the PC and make sure that /dev/ttyUSB0 comes up in the /dev directory.

Restart uPyCraft

Tools -> BurnFirmware

board: select esp8266

erase_flash: select yes

Keep uPyCraft ticked.

Say ok.

This will hopefully flash micropython, downloaded from my github repository

For the esp32 change the burn_addr to 0x1000

Accessing micropython over WiFi

Getting the tools to work starting from a freshly installed Ubuntu

Quite a few packages must be installed on Ubuntu before you can use the tools needed. The terminal emulators I installed where

• minicom
• cutecom
• seyon

To get the basic configuration ready for minicom, start it with sudo minicom -s. Use /dev/ttyUSB0 as serial port and set it to 115200 baud. Save this configuration as default.

In order to get the Python programs to work you must first install pip3:

sudo apt install python3-pip

Once you have pip3 running you can install the Python packages needed to run the tools:

sudo pip3 install package name. I had to install the following packages:

PyQt5, pyserial, pyflakes, sip, qscintilla, esptool, thonny

In addition I needed to install python3-tk with apt to have access to tkinter in Python.

Here is the complete list of additional modules I installed with apt:

emacs, vlc,audacity, gimp, git, subversion,mercurial,build-essentials, qtcreator, qt5-default, qt5-doc, qt5-doc-html, qtbase5-doc-html, qtbase5-examples

qt4-dev-tools, qt4-doc, qt4-qt-config, qt4-demos, qt4-designer, libqwt5-qt4 libqwt5-qt4-dev

skype for linux, apache2, gdebi, mysql-server php-mysql

language support for the languages you use (english, german, french, russian in my case)

tkdiff,meld

... and I probably missed quite a few

Accessing micro Python over WiFi

Accessing Micro Python on the IoT Node

Introduction

Once micro Python is running on the node we must be able to upload Python programs on the node and execute them there. In case of processor board with a micro-USB connector it is easy to connect to the micro Python REPL loop through a simple serial interface and a terminal emulator like minicom. In addition you can use ampy to up - and download files. A standard editor like emacs or a specify Python editor like idle can be used to edit the Python code.

More comfortable though is the use of an IDE like uPyCraft which has editing, up and download features, library functions and a collection of examples built in. uPyCraft can be found as binaries for Windows, Mac and Linux.

When trying to install the Linux binary I got problems with library version incompatibilities on zlib but even when solving this problem the program did not work as expected (the Windows version worked fine). uPyCraft is a Python program whose source is available on github. In fact I found 2 versions:

• the original version based on Qt4
• a modified version based on QT5

new version.

Accessing micro Python over WiFi

Unfortunately uPyCraft relies on the serial connection between the PC on which it runs and micro Python on the IoT node. When taking the ESP01 off its "programmer" this serial connection will be cut and uPyCraft, in its current state, cannot be used any longer. It is however possible to enable webrepl on the micro Python node, allowing access to the REPL loop through a websocket interface.

In order for this to work we first must enable the webrepl server:

Connect the node to the programmer to get access through the serial interface and type

import webrepl-setup

and follow the instructions.

Then install the webrepl client on your PC. Start the browser and enter the URL file://directory_of_webrepl/webrepl.html. In the window coming up enter the websocket server consisting of ws://IP_of_your_IoT_node:8266, where 8266 is the port number. After entering the password you defined during the webrepl_setup step you should get connected to the REPL loop of your micro Python IoT node. For more information please consult the micro Python tutorial.

As you can see, There are also buttons available to transfer files from and to the IoT node.

-- Uli Raich - 2019-03-01

Comments

<--/commentPlugin-->