uflash
1.0.0
Dieses Modul funktioniert nur mit Python 2.7 oder 3.3+.
Ein Dienstprogramm zum Blinken des BBC Micro: Bit mit Python -Skripten und der Micropython -Laufzeit. Sie geben den Namen dieses Dienstprogramms "Micro-Flash" aus. ;-)
Es bietet drei Dienste:
Mehrere wesentliche Operationen werden implementiert:
So ein einfach eingeben:
$ pip Installieren Sie Uflash
... und das Paket wird von PYPI heruntergeladen. Wenn Sie auf die neueste Version upgraden möchten, verwenden Sie den folgenden Befehl:
$ pip install-no-cache-upgrade uflash
NB: Sie müssen ein USB -Datenkabel verwenden, um das Micro: Bit an Ihren Computer anzuschließen (einige Kabel sind nur Strom). Sie sind in gutem Zustand, wenn das Micro: Bit als USB -Speichergerät in Ihrem Dateisystem angezeigt wird.
Linux -Benutzer: Damit Uflash funktioniert, müssen Sie sicherstellen, dass das Mikro: Bit als USB -Speichergerät montiert ist. Normalerweise erfolgt dies automatisch. Wenn nicht, haben Sie wahrscheinlich die Automounting so konfiguriert, dass sie ausgeschaltet werden. In diesem Fall gehen wir davon aus, dass Sie über das technische Wissen verfügen, um das Gerät selbst zu montieren oder die erforderlichen Kernel -Module zu installieren, wenn es fehlt. Standardinstallationen der beliebten Linux -Distributiere "Sollte nur funktionieren" (TM) aus dem Box bei einer Standardinstallation.
Um Hilfe zu lesen, einfach eingeben:
$ uflash -HELP
oder:
$ uflash -h
Um den Versionsinformationstyp zu entdecken:
$ uflash -Verssion
Wenn Sie den Befehl selbst eingeben, versucht Uflash, eine angeschlossene BBC -Micro zu finden: Bit und eine nicht modifizierte Standardversion der Micropython -Laufzeit darauf:
$ uflash Python blinkend zu: /media/ntoll/microbit/micropython.hex
Um eine Version der Micropython -Laufzeit mit einem angegebenen Skript zu flashen (so dass das Skript ausgeführt wird, wenn das BBC Micro: Bit startet), geben Sie den Pfad an das Python -Skript als erstes Argument zum Befehl weiter:
$ uflash my_script.py Blinking my_script.py to: /media/ntoll/microbit/micropython.hex
Sie können Uflash nach Änderungen Ihres Skripts beobachten lassen. Es wird jedes Mal automatisch geblitzt, wenn Sie es speichern:
$ uflash -W my_script.py
oder:
$ uflash -watch my_script.py
An diesem Punkt versucht Uflash, den Pfad automatisch zum Gerät zu erkennen. Wenn Sie jedoch mehrere Geräte angeschlossen haben und/oder wissen, was der Pfad im Dateisystem zum BBC Micro: Bit bereits ist, können Sie dies als zweites Argument für den Befehl angeben:
$ uflash myscript.py/media/ntoll/microbit Blinking myscript.py an: /media/ntoll/microbit/micropython.hex
Sie können sogar mehrere Geräte gleichzeitig blinken:
$ uflash myscript.py/media/ntoll/microbit/media/ntoll/microbit1 Blinking myscript.py an: /media/ntoll/microbit/micropython.hex Blinking myscript.py an: /media/ntoll/microbit1/micropython.hex
Um ein Python-Skript aus einer Hex-Datei zu extrahieren, verwenden Sie das "-e" -Flag wie dieses:
$ uflash -e etwas.hex myscript.py
Dadurch wird das Python -Skript gespeichert, das aus "there.hex" in die Datei "myScript.py" wiederhergestellt wurde. Wenn Sie kein Ziel liefern, wird das wiederhergestellte Skript an STDOut ausgegeben.
Wenn Sie Micropython entwickeln und eine benutzerdefinierte Laufzeit-Hex-Datei haben, können Sie angeben, dass Uflash diese anstelle der integrierten Version von Micropython auf folgende Weise verwenden:
$ uflash -r firmware.hex
oder:
$ uflash -Runtime = firmware.hex
So erstellen Sie Ausgaben -HEX -Dateien in demselben Verzeichnis wie die Eingabe .py -Dateien:
$ py2hex tests/Beispiel.py SEXIFIERTE BEISPIEL.PY AS: Tests/Beispiel.hex
PY2HEX enthält dieselbe -r/-Laufzeit und -m/-Minify-Optionen wie Uflash und fügt eine zusätzliche Option -o/-Outdir: hinzu:
So erstellen Sie Ausgabe -HEX -Dateien in einem anderen Verzeichnis:
$ py2hex Beispiel.py -o /tmp Hexifizierende Beispiel.py as: /tmp/example.hex
oder:
$ py2hex Beispiel.py -outdir /tmp Hexifizierende Beispiel.py as: /tmp/example.hex
Py2hex kann mehrere Eingabedateien verarbeiten:
$ PY2HEX A.PY B.PY C.PY Hexifizierende a.py als: a.hex Hexifizieren b.py als: B.hex Sechsern Sie C.Py als: C.HEX
oder:
$ py2hex *.py Hexifizierende a.py als: a.hex Hexifizieren b.py als: B.hex Sechsern Sie C.Py als: C.HEX
Der Quellcode wird in GitHub gehostet. Bitte zögern Sie nicht, das Repository zu geben. Angenommen, Sie haben Git installiert, können Sie den Code mit dem folgenden Befehl aus dem kanonischen Repository herunterladen:
$ git clone https://github.com/ntoll/flash.git
Stellen Sie sicher, dass Sie über die richtigen Abhängigkeiten für die Entwicklung verfügen, indem Sie ein Virtualenv erstellen und ausgeführt werden:
$ PIP install -r anforderung.txt
Führen Sie den folgenden Befehl aus:
$ python setup.py entwickeln
Es gibt eine Makefile, die bei den meisten gemeinsamen Workflows mit der Entwicklung hilft. Das make von selbst werden die Optionen so auflisten.
$ make Im Moment gibt es kein Standard -Makefile -Ziel. Versuchen: Machen Sie sauber - setzen Sie das Projekt zurück und entfernen Sie automatische Vermögenswerte. Pyflakes machen - Führen Sie den Pyflakes -Code -Checker aus. Machen Sie PEP8 - Führen Sie den Pep8 -Stil -Checker aus. Test machen - Führen Sie die Testsuite aus. Deckung machen - einen Bericht über die Testabdeckung anzeigen. Überprüfen Sie die Prüfung - Führen Sie alle Prüfer und Tests aus. Paket erstellen - Erstellen Sie ein bereitgestelltes Paket für das Projekt. RPM machen - Erstellen Sie ein RPM -Paket für das Projekt. Veröffentlichung machen - Veröffentlichen Sie das Projekt an PYPI. Machen Sie Dokumente - Führen Sie Sphinx aus, um Projektdokumentation zu erstellen.
