このモジュールは、Python 2.7または3.3+でのみ動作します。
BBCマイクロをフラッシュするためのユーティリティ:PythonスクリプトとMicropythonランタイムを使用してビット。このユーティリティ「マイクロフラッシュ」の名前を発音します。 ;-)
3つのサービスを提供します。
いくつかの重要な操作が実装されています。
単にインストールするには、次を入力します。
$ pipインストールuflash
...そしてパッケージはPypiからダウンロードします。最新バージョンにアップグレードする場合は、次のコマンドを使用してください。
$ pipインストール - ノーキャッシュ - アップグレードUflash
NB: USBデータケーブルを使用して、マイクロ:ビットをコンピューターに接続する必要があります(一部のケーブルは電源のみです)。プラグインすると、マイクロ:ビットがファイルシステムのUSBストレージデバイスとして表示される場合、あなたは良好な形になります。
Linuxユーザー:Uflashが機能するには、Micro:BITがUSBストレージデバイスとして取り付けられていることを確認する必要があります。通常、これは自動的に行われます。そうでない場合は、おそらくオフになるように自動化を構成しました。その場合、デバイスを自分でマウントするか、必要なカーネルモジュールが欠落している場合はインストールする技術的な知識があると想定しています。人気のあるLinuxディストリビューションのデフォルトインストールは、デフォルトのインストールを考慮して、ボックスから「機能する必要があります」(TM)。
ヘルプを読むには、単に入力します。
$ uflash-ヘルプ
または:
$ uflash -h
バージョン情報タイプを発見するには:
$ uflash -version
コマンドを単独で入力すると、Uflashは接続されたBBC Micro:BITを見つけようとします。
$ uflash Pythonの点滅:/media/ntoll/microbit/micropython.hex
指定されたスクリプトが埋め込まれたマイクロパイソンランタイムのバージョンをフラッシュするには(BBC Micro:Bit Boots Upのときにスクリプトが実行されるように)、コマンドの最初の引数としてPythonスクリプトへのパスを渡します。
$ uflash my_script.py My_script.pyのフラッシュ:/media/ntoll/microbit/micropython.hex
スクリプトの変更をuflashに監視させることができます。保存するたびに自動的にフラッシュされます。
$ uflash -w my_script.py
または:
$ uflash -Watch my_script.py
この時点で、Uflashはデバイスへのパスを自動的に検出しようとします。ただし、いくつかのデバイスがプラグインしている場合、および/またはBBCマイクロへのファイルシステム上のパスが既にあることを知っている場合、コマンドの2番目の引数としてこれを指定できます。
$ uflash myscript.py/media/ntoll/microbit Flashing myscript.py to:/media/ntoll/microbit/micropython.hex
複数のデバイスを一度にフラッシュすることもできます。
$ uflash myscript.py/media/ntoll/microbit/media/ntoll/microbit1 Flashing myscript.py to:/media/ntoll/microbit/micropython.hex フラッシュmyscript.py to:/media/ntoll/microbit1/micropython.hex
HEXファイルからPythonスクリプトを抽出するには、次のような「-e」フラグを使用します。
$ uflash -e Something.hex myscript.py
これにより、「Something.hex」からファイル「myscript.py」に回復したpythonスクリプトが保存されます。ターゲットを提供しない場合、回復したスクリプトはstdoutに発します。
Micropythonを開発しており、カスタムランタイムヘックスファイルを持っている場合は、Micropythonの組み込みバージョンの代わりにUflashを使用することを指定できます。
$ uflash -r firmware.hex
または:
$ uflash - runtime = firmware.hex
入力ファイルと同じディレクトリに出力.hexファイルを作成するには:
$ py2hexテスト/example.py hexifying example.py as:tests/example.hex
py2hexには、同じ-r/ - ランタイムと-m/ - オプションをuflashとしてマニー化することを含み、追加オプションを追加します-o/ - outdir:
別のディレクトリに出力.hexファイルを作成するには:
$ py2hex example.py -o /tmp hexifying example.py as:/tmp/example.hex
または:
$ py2hex example.py -outdir /tmp hexifying example.py as:/tmp/example.hex
py2hexは複数の入力ファイルを処理できます。
$ py2hex a.py b.py c.py A.py AS:A.Hex B.py AS:B.Hex c.py AS:C.HEX
または:
$ py2hex *.py A.py AS:A.Hex B.py AS:B.Hex c.py AS:C.HEX
ソースコードはGitHubでホストされています。リポジトリを自由にフォークしてください。 gitがインストールされていると仮定すると、次のコマンドを使用して、標準リポジトリからコードをダウンロードできます。
$ git clone https://github.com/ntoll/uflash.git
Virtualenvを作成して実行することにより、開発のための正しい依存関係を確保してください。
$ pip install -r compoestion.txt
開発バージョンのモジュールをVirtualenvにローカルにインストールするには、次のコマンドを実行します。
$ python setup.py開発
開発に関連する一般的なワークフローのほとんどに役立つメイクファイルがあります。 make
単独で入力すると、オプションがリストされています。
$ make 現在、デフォルトのMakeFileターゲットはありません。試す: クリーンにする - プロジェクトをリセットし、自動生成資産を削除します。 pyflakesを作成 - pyflakesコードチェッカーを実行します。 PEP8を作成 - PEP8スタイルチェッカーを実行します。 テストを行う - テストスイートを実行します。 カバレッジを行う - テストカバレッジに関するレポートをご覧ください。 チェックを行う - すべてのチェッカーとテストを実行します。 パッケージを作成 - プロジェクトの展開可能なパッケージを作成します。 RPMを作成 - プロジェクトのRPMパッケージを作成します。 パブリッシュを作成 - プロジェクトをPypiに公開します。 ドキュメントを作成 - スフィンクスを実行してプロジェクトドキュメントを作成します。