uflash

uflash

Modul ini hanya berfungsi dengan Python 2.7 atau 3.3+.

Utilitas untuk mem -flash BBC Micro: Bit dengan skrip Python dan Micropython Runtime. Anda mengucapkan nama utilitas ini "mikro-flash". ;-)

Ini menyediakan tiga layanan:

1. Perpustakaan fungsi untuk secara program membuat file hex dan mem -flash ke mikro BBC: bit.
2. Utilitas baris perintah yang disebut uflash yang akan mem -flash skrip python ke bbc micro: bit.
3. Utilitas baris perintah yang disebut py2hex untuk membuat file hex dari skrip python dan menyimpannya pada sistem file lokal

Beberapa operasi penting diimplementasikan:

• Mengkode python ke dalam format hex.
• Embed python hexified yang dihasilkan ke dalam micropython runtime hex.
• Ekstrak skrip Python yang dikodekan dari file micropython hex.
• Temukan mikro yang terhubung: bit.
• Salin hex yang dihasilkan ke mikro: bit, sehingga mem -flash perangkat.
• Tentukan micropython runtime hex untuk menanamkan kode python Anda.

Instalasi

Untuk menginstal cukup ketik:

 $ Pip Instal Uflash

... dan paket akan diunduh dari PYPI. Jika Anda ingin meningkatkan ke versi terbaru, gunakan perintah berikut:

 $ pip instal ---no-cache-Ufle-upgrade uflash

NB: Anda harus menggunakan kabel data USB untuk menghubungkan mikro: bit ke komputer Anda (beberapa kabel hanya daya). Anda dalam kondisi yang baik jika, saat dicolokkan, bit mikro: muncul sebagai perangkat penyimpanan USB di sistem file Anda.

Pengguna Linux: Agar Uflash berfungsi, Anda harus memastikan mikro: bit dipasang sebagai perangkat penyimpanan USB. Biasanya ini dilakukan secara otomatis. Jika tidak, Anda mungkin mengonfigurasi automunting menjadi tidak aktif. Jika itu masalahnya, kami menganggap Anda memiliki pengetahuan teknis untuk memasang perangkat sendiri atau untuk menginstal modul kernel yang diperlukan jika mereka hilang. Instalasi default dari distro linux populer "hanya harus berfungsi" (TM) di luar kotak yang diberikan instalasi default.

Penggunaan Perintah

uflash

Untuk membaca bantuan, cukup ketik:

 $ uflash --help

atau:

 $ uflash -h

Untuk menemukan jenis informasi versi:

 $ uflash --version

Jika Anda mengetik perintah sendiri maka UFLASH akan mencoba menemukan BBC Micro yang terhubung: Bit dan mem -flash versi default yang tidak dimodifikasi dari runtime Micropython ke dalamnya:

 $ uflash
Flashing Python ke: /media/ntoll/microbit/micropython.hex

Untuk mem -flash versi runtime Micropython dengan skrip tertentu yang tertanam di dalamnya (sehingga skrip dijalankan ketika BBC Micro: Bit Boots Up) kemudian lewati jalur ke skrip Python sebagai argumen pertama ke perintah:

 $ uflash my_script.py
Flashing my_script.py ke: /media/ntoll/microbit/micropython.hex

Anda dapat membiarkan Uflash menonton perubahan skrip Anda. Ini akan disinari secara otomatis setiap kali Anda menyimpannya:

 $ uflash -w my_script.py

atau:

 $ uflash --watch my_script.py

Pada titik ini Uflash akan mencoba secara otomatis mendeteksi jalur ke perangkat. Namun, jika Anda memiliki beberapa perangkat yang terhubung dan/atau tahu apa jalur pada sistem file ke mikro BBC: bit sudah, Anda dapat menentukan ini sebagai argumen kedua untuk perintah:

 $ uflash myscript.py/media/ntoll/microbit
Flashing myscript.py ke: /media/ntoll/microbit/micropython.hex

Anda bahkan dapat mem -flash beberapa perangkat sekaligus:

 $ uflash myscript.py/media/ntoll/microbit/media/ntoll/microbit1
Flashing myscript.py ke: /media/ntoll/microbit/micropython.hex
Flashing myscript.py ke: /media/ntoll/microbit1/micropython.hex

Untuk mengekstrak skrip python dari file hex, gunakan flag "-e" seperti ini:

 $ uflash -e sesuatu.hex myscript.py

Ini akan menyimpan skrip Python yang dipulihkan dari "Something.hex" ke dalam file "myscript.py". Jika Anda tidak memberikan target, skrip yang dipulihkan akan memancarkan ke stdout.

Jika Anda mengembangkan Micropython dan memiliki file hex runtime khusus, Anda dapat menentukan bahwa UFLASH menggunakannya alih-alih versi built-in micropython dengan cara berikut:

 $ uflash -r firmware.hex

atau:

 $ ufLash --runtime = firmware.hex

py2hex

Untuk membuat file .hex output di direktori yang sama dengan file input .py:

 $ py2hex tes/example.py
Hexifying example.py as: tes/example.hex

PY2Hex termasuk -r/-runtime dan -m/-opsi Minify sebagai uflash dan menambahkan opsi tambahan -O/-OUTDIR:

Untuk membuat file .hex output di direktori yang berbeda:

 $ py2hex example.py -o /tmp
Hexifying example.py as: /tmp/example.hex

atau:

 $ py2hex example.py -outdir /tmp
Hexifying example.py as: /tmp/example.hex

PY2Hex dapat menangani beberapa file input:

 $ py2hex A.py b.py c.py
Hexifying A.py as: A.hex
Hexifying b.py as: b.hex
Hexifying C.Py As: C.Hex

atau:

 $ py2hex *.py
Hexifying A.py as: A.hex
Hexifying b.py as: b.hex
Hexifying C.Py As: C.Hex

Perkembangan

Kode sumber dihosting di GitHub. Jangan ragu untuk membayar repositori. Dengan asumsi Anda telah menginstal git Anda dapat mengunduh kode dari repositori kanonik dengan perintah berikut:

 $ git clone https://github.com/ntoll/uflash.git

Pastikan Anda memiliki dependensi yang benar untuk pengembangan yang diinstal dengan membuat VirtualEnv dan menjalankan:

 $ pip instal -r persyaratan.txt

Untuk menginstal modul pengembangan Anda secara lokal ke VirtualEnv, jalankan perintah berikut:

 $ python setup.py berkembang

Ada Makefile yang membantu sebagian besar alur kerja umum yang terkait dengan pengembangan. Mengetik make sendiri akan mencantumkan opsi demikian:

 $ make

Tidak ada target Makefile default sekarang. Mencoba:

Buatlah Bersih - Setel ulang proyek dan hapus aset yang dihasilkan secara otomatis.
Buat Pyflakes - Jalankan Pemeriksa Kode Pyflakes.
Buat PEP8 - Jalankan pemeriksa gaya PEP8.
Lakukan tes - Jalankan test suite.
Buat Cakupan - Lihat Laporan Cakupan Uji.
Lakukan pemeriksaan - Jalankan semua pemeriksa dan tes.
Buat paket - Buat paket yang dapat digunakan untuk proyek ini.
Buat RPM - Buat paket RPM untuk proyek tersebut.
Make Publish - Publikasikan proyek ke PYPI.
Make Docs - Jalankan Sphinx untuk membuat dokumentasi proyek.