alihan/jupyter_micropython_kernel
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update README.md

Browse Source 
update the installation functions
This commit is contained in:
Julian Todd
2021-03-28 10:32:07 +01:00
committed by GitHub
parent fe0a35dca3
commit 9f781d2e01
1 changed files with 39 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
README.md
View File

@@ -18,26 +18,29 @@ First install Jupyter: http://jupyter.org/install.html (the Python3 version).
pip install jupyter_micropython_kernel pip install jupyter_micropython_kernel
python -m jupyter_micropython_kernel.install python -m jupyter_micropython_kernel.install
``` ```
### Manual Installation
### Manual Installation (more maintainable)
Clone this repository to a directory using TortoiseGIT or with the shell command (ie on a command line): Clone this repository to a directory using TortoiseGIT or with the shell command (ie on a command line):
git clone https://github.com/goatchurchprime/jupyter_micropython_kernel.git git clone https://github.com/goatchurchprime/jupyter_micropython_kernel.git
Install this library (in editable mode) into Python3 using the shell command: On **Windows**, Install this library (in editable mode) into Python3 using the shell command:
pip install jupyter_micropython_kernel
On **Linux**, you can install this library in editable mode using symlinks, which makes it easy to `git pull` a debugged version later:
pip install -e jupyter_micropython_kernel pip install -e jupyter_micropython_kernel
This creates a small file pointing to this directory in the python/../site-packages Things can go wrong here, and you might need "pip3" or "sudo pip" if you have
directory, and makes it possible to "git update" the library later as it gets improved.
(Things can go wrong here, and you might need "pip3" or "sudo pip" if you have
numerous different versions of python installed numerous different versions of python installed
Install the kernel into jupyter itself using the shell command: Install the kernel into jupyter itself using the shell command:
python -m jupyter_micropython_kernel.install python -m jupyter_micropython_kernel.install
(This creates the small file ".local/share/jupyter/kernels/micropython/kernel.json" This creates the small file ".local/share/jupyter/kernels/micropython/kernel.json"
that jupyter uses to reference it's kernels that jupyter uses to reference it's kernels
### Post-Install ### Post-Install
@@ -46,6 +49,7 @@ To find out where your kernelspecs are stored, you can type:
jupyter kernelspec list jupyter kernelspec list
## Running ## Running
Now run Jupyter notebooks: Now run Jupyter notebooks:
@@ -55,21 +59,40 @@ Now run Jupyter notebooks:
In the notebook click the New notebook button in the upper right, you should see your In the notebook click the New notebook button in the upper right, you should see your
MicroPython kernel display name listed. MicroPython kernel display name listed.
The first cell will need to be something like: If you have an ESP32 or ESP8266 already running MicroPython, plug it in, put the following command into the first cell and run it:
%serialconnect %serialconnect
or something that matches the serial port and baudrate that If you are on **Linux** and don't have the correct permissions to access the Serial ports you will get a "permissions error". Fix it by adding yourself to the dialout and tty groups:
you connect to your MicroPython/ESP8266 with.
You should now be able to execute MicroPython commands sudo usermod -a -G tty your_user_name
by running the cells. sudo usermod -a -G dialout your_user_name
'''On Windows it can sometimes be difficult to find the Serial (COM-port) If you are on **Windows** you need to have the right driver for the USB chip on the ESP32/ESP8266 breakout board.
and the right driver. This is not unique to the jupyter_micropython_kernel Look for the USB connection in the Device List to identify the supplier and look for instructions relating to that supplier.
and is a function of the USB chip that is on the breakout board containing
your ESP32/ESP8266. Find the USB connection in the Device list to see what driver The notebook scans the serial ports (the COM-values in Windows) and tells you the possibilities and tries one of them. If it picks the wrong port you may need to be more specific and use the command:
it needs or look for instructions from the supplier of the board.'''
%serialconnect --port=COM5
## Uploading the MicroPython firmware onto a new board
This is done using the `esptool.py`. The Jupyter micropython kernel has features to help you execute this command.
%esptool erase
and
%esptool esp8266 /home/julian/executables/micropythonbins/esp8266-20200902-v1.13.bin
or
%esptool esp32 /home/julian/executables/micropythonbins/esp32-20191006-v1.11-406-g4a6974bea.bin
Download these Micropython firmware files from https://micropython.org/download
## Further notes
There is a micropythondemo.ipynb file in the directory you could There is a micropythondemo.ipynb file in the directory you could
look at with some of the features shown. look at with some of the features shown.