該模塊僅適用於Python 2.7或3.3+。
用於閃爍BBC Micro:使用Python腳本和Micropython運行時的實用程序。您可以發音此實用程序“微閃光”的名稱。 ;-)
它提供三個服務:
實施了幾項基本操作:
安裝簡單類型:
$ pip安裝uflash
...包裹將從PYPI下載。如果您想升級到最新版本,請使用以下命令:
$ pip安裝-NO-CACHE-UPGRADE UFLASH
NB:您必須使用USB數據電纜將Micro:位連接到您的計算機(某些電纜僅是電源)。如果插入時,您的狀態良好,Micro:lit作為文件系統上的USB存儲設備出現。
Linux用戶:為了使Uflash工作,您必須確保Micro:位作為USB存儲設備安裝。通常這是自動完成的。如果不是,您可能已經配置了自動填充以關閉。如果是這樣,我們假設您有技術知識可以自己安裝設備或在缺失的情況下安裝所需的內核模塊。默認安裝流行的Linux發行版“應該只是工作”(TM)(tm),但給定默認安裝。
要閱讀幫助簡單地鍵入:
$ uflash-助理
或者:
$ UFLASH -H
發現版本信息類型:
$ uflash- version
如果您單獨鍵入命令,那麼Uflash將嘗試找到一個連接的BBC Micro:bit和Flash Micropopython運行時未修改的默認版本:
$ uflash 閃爍python到:/media/ntoll/microbit/micropopython.hex
要閃爍具有嵌入其中的指定腳本的Micropython Runtime的版本(以便在BBC Micro:Bit Boots up時運行腳本),然後將通往Python腳本的路徑傳遞給命令:命令:
$ uflash my_script.py flash my_script.py to:/media/ntoll/microbit/micropopython.hex
您可以讓Uflash觀看腳本的更改。每次保存時,它都會自動閃爍:
$ uflash -w my_script.py
或者:
$ uflash -watch my_script.py
此時,Uflash將嘗試自動檢測到設備的路徑。但是,如果您插入了多個設備和/或知道BBC Micro的文件系統上的路徑:BIT已經是什麼,則可以將其指定為命令的第二個參數:
$ uflash myscript.py/媒體/ntoll/microbit flash myScript.py to:/media/ntoll/microbit/micropopython.hex
您甚至可以一次閃爍多個設備:
$ uflash myScript.py/媒體/ntoll/microbit/媒體/ntoll/microbit1 flash myScript.py to:/media/ntoll/microbit/micropopython.hex flash myScript.py to:/media/ntoll/microbit1/micropopython.hex
從十六進製文件中提取python腳本,請使用“ -e”標誌這樣的標誌:
$ uflash -e somings.hex myscript.py
這將使從“ something.hex”恢復的python腳本中的文件“ myscript.py”中恢復。如果您不提供目標,則恢復的腳本將散發到stdout。
如果您要開發微部且具有自定義運行時十六進製文件,則可以指定Uflash使用它,而不是以下方式使用Micropython的內置版本:
$ uflash -r instorware.hex
或者:
$ uflash - -runtime = stoneware.hex
在與輸入.py文件相同的目錄中創建輸出.hex文件:
$ py2hex tests/example.py 示例示例。
PY2HEX包含相同的-r/ - 運行時和-m/ - 縮小uflash選項,並添加了附加選項-O/ - OUTDIR:
在其他目錄中創建輸出.hex文件:
$ py2hex example.py -o /tmp hexifying示例.py as:/tmp/example.hex
或者:
$ py2hex example.py- outdir /tmp hexifying示例.py as:/tmp/example.hex
PY2HEX可以處理多個輸入文件:
$ py2hex a.py b.py c.py 六型a.py為:a.hex 將B.Py示為:b.hex 己縮為:c.hex
或者:
$ py2hex *.py 六型a.py為:a.hex 將B.Py示為:b.hex 己縮為:c.hex
源代碼託管在GitHub中。請隨時訂購存儲庫。假設您已經安裝了git,則可以從規範存儲庫下載以下命令:
$ git克隆https://github.com/ntoll/uflash.git
確保您通過創建Virtualenv並運行的正確依賴項來安裝開發:
$ pip install -r要求.txt
要將模塊的開發版本安裝到Virtualenv中,請運行以下命令:
$ python setup.py開發
有一個Makefile可以幫助大多數與開發相關的常見工作流程。單獨鍵入將make
列出選項:
$製作 現在沒有默認的makefile目標。嘗試: 進行清潔 - 重置項目並刪除自動生成的資產。 製作Pyflakes-運行PYFLAKES代碼檢查器。 製作PEP8-運行PEP8樣式檢查器。 進行測試 - 運行測試套件。 進行覆蓋範圍 - 查看有關測試覆蓋的報告。 進行檢查 - 運行所有檢查器和測試。 製作軟件包 - 為項目創建可部署的軟件包。 製作RPM-為項目創建RPM軟件包。 使發布 - 將項目發布給PYPI。 製作文檔 - 運行獅身人面像以創建項目文檔。