sascha_hemi/pycom-documentation
1
0
Fork 0
mirror of https://github.com/sascha-hemi/pycom-documentation.git synced 2026-03-21 05:06:35 +01:00
Code Issues Packages Projects Releases Wiki Activity

Pylife (#498)

Browse Source 
* added assets

* feat: pylife documentation getting started, alerts, groups

* fix: moving to separate folders

* feat: add pylife to menu config

* feat: add static pictures

* fix: add static pictures, update device text

* added assets

* feat: pylife documentation getting started, alerts, groups

* fix: moving to separate folders

* feat: add pylife to menu config

* feat: add static pictures

* fix: add static pictures, update device text

* Update config.toml

* Create _index.md

Add template for firmware update instructions

* Update PyLife instructions and adding devices instructions

* Add warning and update menu to include firmware update

* Update the getting started and devices section

* Add firmware update instructions

* Add firmware update images

* Add messaging

* Move images to correct location

* fix: resolve suggestions

* Update PyLife documentation to clarify Devices, add more data, and improve the firmware update instructions

* Reduce size of age warning image so it isn't the whole screen on a computer

* Add the PC update section

* Fix a merge typo

* Resize images to be smaller on big monitors

* Add pin numbers to bottom view of PyGo

* Fix typo in instructions

* Expand manual fw update process from computer


Co-authored-by: njilrem <antoinekucher@gmail.com>
Co-authored-by: njilrem <anton.kucher@chisw.com>
Co-authored-by: Pete Allen <pete@pycom.io>
Co-authored-by: PetePycom <105786769+PetePycom@users.noreply.github.com>
This commit is contained in:
Christian Ehlers
2022-06-27 15:36:14 +02:00
committed by GitHub
parent a095a2a384
commit 46c90e8995
3 changed files with 39 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
content/pylife/fwupdate/_index.md
View File

@@ -44,17 +44,34 @@ The immediate firmware update resolves this issue, but if you do encounter pleas
## Manual firmware update from computer
For most people, firmware update through the app is the best option. However it is possible to update through a computer if you have the USB cradle or can connect to the PyGo's serial port through a computer.
If you want to do this, do the following:
1) Download the relevant firmware for your PyGo. Click on the relevant link below, and download the firmware in the URL field
* [PyGo1 firmware](https://software.pycom.io/manifest.json?sysname=pygo1&fwtype=pylife&current_ver=1.20.4)
* [PyGo2 firmware](https://software.pycom.io/manifest.json?sysname=pygo2&fwtype=pylife&current_ver=1.20.4)
2) Connect to your PyGo's serial terminal, and run `upgrade()`
For most people, performing the firmware update through the app is the best option. However, it is possible to update through a computer if you have the USB cradle or your device is already in upgrade mode.
If your device is not already in upgrade mode from a previous upgrade attempt, please install [Atom](https://docs.pycom.io/gettingstarted/software/atom/) or [Visual Studio Code](https://docs.pycom.io/gettingstarted/software/vscode/) and enter the REPL prompt in the Pymakr plugin. Alternatively you can use PuTTy or minicom as Terminal programs
![Pymakr Console](/gitbook/assets/pylife/fwupdate/pymakr.png)
> The above screenshot shows the usual startup messages from the PyGo when in application made. Wait for these commands to complete before issuing the `upgrade()` command.
Please follow these steps to upgrade your PyGo on your PC:
1) Download the relevant firmware for your PyGo. Click on the relevant link below which will initiate the firmware image download.
* [PyGo1 firmware](https://software.pycom.io/manifest.json?sysname=pygo1&fwtype=pylife&current_ver=1.20.4&download=true)
* [PyGo2 firmware](https://software.pycom.io/manifest.json?sysname=pygo2&fwtype=pylife&current_ver=1.20.4&download=true)
2a) If your PyGo is still in application mode, connect to your PyGo's REPL via Atom, Visual Studio Code, PuTTy or minicom, and run `upgrade()`
2b) If your PyGo is advertising a WiFi network with the name `PyCom_AP_Firmware_Update`, your PyGo is already in upgrade mode and you can continue to the next step.
3) On your computer, connect to the PyGo's access point:
* SSID: PyCom_AP_Firmware_Update
* Password: www.pycom.io
4) Open up a command prompt or terminal, navigate to the directory your downloaded firmware is in, and run the following, replacing YOUR_FIRMWARE_HERE with firmware you have downloaded:
```
Ensure that you run each command separately and check the output. You should see a line "Status: OK" in the output for commands that do a `--request GET`. Please note the ota-reboot command may not return a result and seem to hang. You can check if your PyGo is showing the usual start-up messages after the upgrade is complete.
Pushing the firmware binary to the device (command with `--request POST`) can take several minutes so please be patient.
```
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-init"
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-update"
curl --request POST --data-binary @YOUR_FIRMWARE_HERE.bin http://192.168.4.1/update
@@ -62,5 +79,19 @@ curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-finish"
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-verify"
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-reboot"
```
5) Check that all commands have run succesfully without error. Your PyGo is now upgraded.
For example, if you're using MacOS with a PyGo1 and have download the current PyGo1 firmware to the ~/Downloads folder:
```
cd ~/Downloads
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-init"
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-update"
curl --request POST --data-binary @firmware_pygo1_1.20.4.r4-pylife.bin http://192.168.4.1/update
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-finish"
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-verify"
curl -v --request GET http://192.168.4.1/status -H "FW-Header-1: ota-reboot"
```
> For Windows users, the curl command is included in Windows 10 since insider build 17063. For older versions of Windows, please download the curl application from https://curl.se/windows/
5) Check that all commands have run successfully without error. Your PyGo is now upgraded and you should see the startup messages as shown in the screenshot above.