Tools to support VGkits Vanguard ESP8266 python-programmable board.
Project description
VGkits' Vanguard Tools
The vgkits-vanguard package is published via Pip3 giving users simple short commands for configuring Vanguard boards and connecting to a Vanguard board's built-in python shell.
Once pip3 (part of Python3) is installed on your laptop, run the following from a terminal to install the tools.
pip3 install vgkits-vanguard
After installing, see the available commands listed below.
shell: send python commands over USB
Connect to the python shell prompt on the Vanguard board over USB on Windows, MacOS or Linux, by running...
vanguard shell
This auto-detects the Vanguard's USB device and your operating system's Terminal configuration. Then it launches miniterm with the proper parameters to connect your terminal to the python shell on the Vanguard board. You can then start learning by running python commands on the board.
brainwash: upgrade your board
After some experiments, you can wipe your Vanguard board to get a clean start by running...
vanguard brainwash
By default, this installs the Vanguard build - the latest version of Micropython but with a collection of pre-installed libraries. However, you can use brainwash to wipe and install a different 'operating system' on your Vanguard board such as a clean Micropython build, CircuitPython, Espruino (to write code in Javascript) or Punyforth (to write code in the Forth language).
There are even Basic and LISP interpreters designed to run on this processor!
vanguard brainwash python
- installs default python firmware (equivalent to vanguard brainwash micropython
)
vanguard brainwash javascript
- the default javascript firmware (equivalent to vanguard brainwash espruino
)
vanguard brainwash lua
- the default lua firmware (equivalent to vanguard brainwash nodemcu
)
vanguard brainwash basic
- the default basic firmware (equivalent to vanguard brainwash esp8266basic
)
vanguard brainwash forth
- the default forth firmware (equivalent to vanguard brainwash punyforth
)
vanguard brainwash micropython
- latest micropython firmware release from the firmwares folder
vanguard brainwash circuitpython
- latest circuitpython firmware release from the firmwares folder
vanguard brainwash espruino
- latest espruino firmware release found in 'flash/firmwares' folder
vanguard brainwash esp8266basic
- latest ESP8266Basic firmware release found in 'flash/firmwares' folder
vanguard brainwash nodemcu
- latest NodeMCU (eLua) firmware release found in 'flash/firmwares' folder
vanguard brainwash punyforth
- latest punyforth firmware release found in 'flash/firmwares' folder. N.B. To connect to Punyforth try vanguard shell --line --echo --eol CRLF
as per this issue
Troubleshooting
The vgkits-vanguard Pypi package (installed via pip) should install a 'vanguard' command into a local folder, which can be run on Windows, Mac OS or Linux using just vanguard.
If for any reason vanguard is not available you can run instead...
python -m vgkits.vanguard
...or to force the use of Python3...
python3 -m vgkits.vanguard
If you encounter this issue, probably your path is not properly set up to include the files installed by pip3. Try following these instructions to fix it.
v0.2.0
Original release, restructuring scripts which were originally under ShrimpingIt/cockle and vgkits/vanguard into click-controlled command line utilities.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.