โมดูลนี้ใช้งานได้กับ Python 2.7 หรือ 3.3+ เท่านั้น
ยูทิลิตี้สำหรับกระพริบ BBC micro: บิตด้วยสคริปต์ Python และรันไทม์ micropython คุณออกเสียงชื่อของยูทิลิตี้นี้ "Micro-Flash" -
ให้บริการสามบริการ:
มีการดำเนินการที่จำเป็นหลายอย่าง:
เพื่อติดตั้งง่ายๆพิมพ์:
$ PIP ติดตั้ง uflash
... และแพ็คเกจจะดาวน์โหลดจาก PYPI หากคุณต้องการอัปเกรดเป็นเวอร์ชันล่าสุดให้ใช้คำสั่งต่อไปนี้:
$ PIP Install-NO-CACHE-UMGRADE UFLASH
NB: คุณต้องใช้สายเคเบิล ข้อมูล USB เพื่อเชื่อมต่อไมโคร: บิตเข้ากับคอมพิวเตอร์ของคุณ (สายเคเบิลบางตัวเป็นพลังงานเท่านั้น) คุณอยู่ในสภาพดีถ้าเมื่อเสียบปลั๊กไมโคร: บิตจะปรากฏเป็นอุปกรณ์จัดเก็บข้อมูล USB ในระบบไฟล์ของคุณ
ผู้ใช้ Linux: สำหรับ UFLASH ในการทำงานคุณต้องตรวจสอบให้แน่ใจว่าไมโคร: บิตติดตั้งเป็นอุปกรณ์จัดเก็บข้อมูล USB โดยปกติจะทำโดยอัตโนมัติ ถ้าไม่คุณอาจกำหนดค่าอัตโนมัติให้ปิด หากเป็นเช่นนั้นเราถือว่าคุณมีความรู้ด้านเทคนิคในการติดตั้งอุปกรณ์ด้วยตัวเองหรือติดตั้งโมดูลเคอร์เนลที่ต้องการหากพวกเขาหายไป การติดตั้งเริ่มต้นของ Linux Distros ยอดนิยม "ควรใช้งานได้" (TM) ออกจากกล่องที่ได้รับการติดตั้งเริ่มต้น
เพื่ออ่านวิธีใช้เพียงพิมพ์:
$ uflash -ช่วยเหลือ
หรือ:
$ uflash -h
เพื่อค้นหาประเภทข้อมูลเวอร์ชัน:
$ uflash -Version
หากคุณพิมพ์คำสั่งด้วยตัวเอง Uflash จะพยายามค้นหา BBC Micro ที่เชื่อมต่อ: บิตและแฟลชเวอร์ชันเริ่มต้นที่ไม่ได้แก้ไขของรันไทม์ micropython ลงบนมัน:
$ uflash Python กระพริบไปที่:/media/ntoll/microbit/micropython.hex
หากต้องการแฟลชเวอร์ชันของรันไทม์ micropython ที่มีสคริปต์ที่ระบุที่ฝังอยู่ภายใน (เพื่อให้สคริปต์นั้นทำงานเมื่อ 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 -ดู my_script.py
ณ จุดนี้ Uflash จะพยายามตรวจจับเส้นทางไปยังอุปกรณ์โดยอัตโนมัติ อย่างไรก็ตามหากคุณมีอุปกรณ์หลายอย่างเสียบและ/หรือรู้ว่าเส้นทางบนระบบไฟล์ไปยัง BBC Micro: บิตอยู่แล้วคุณสามารถระบุสิ่งนี้เป็นอาร์กิวเมนต์ที่สองของคำสั่ง:
$ uflash myscript.py/media/ntoll/microbit กระพริบ myscript.py ถึง:/media/ntoll/microbit/micropython.hex
คุณสามารถแฟลชอุปกรณ์หลายตัวพร้อมกัน:
$ uflash myscript.py/media/ntoll/microbit/media/ntoll/microbit1 กระพริบ myscript.py ถึง:/media/ntoll/microbit/micropython.hex กระพริบ myscript.py ถึง:/media/ntoll/microbit1/micropython.hex
ในการแยกสคริปต์ Python จากไฟล์ hex ให้ใช้ธง "-e" เช่นนี้:
$ uflash -e something.hex myscript.py
สิ่งนี้จะบันทึกสคริปต์ Python ที่กู้คืนจาก "Something.hex" ลงในไฟล์ "myscript.py" หากคุณไม่ได้จัดหาเป้าหมายสคริปต์ที่กู้คืนจะปล่อยออกมาเป็น stdout
หากคุณกำลังพัฒนา micropython และมีไฟล์ hex รันไทม์ที่กำหนดเองคุณสามารถระบุว่า Uflash ใช้มันแทน micropython เวอร์ชันในตัวด้วยวิธีต่อไปนี้:
$ uflash -r firmware.hex
หรือ:
$ uflash ---runtime = firmware.hex
ในการสร้างไฟล์. hex ในไดเรกทอรีเดียวกับไฟล์อินพุต. py:
$ py2hex tests/example.py hexifying example.py เป็น: tests/example.hex
Py2Hex รวมถึง -r/-runtime และ -m/-minify ตัวเลือกที่เหมือนกันเป็น uflash และเพิ่มตัวเลือกเพิ่มเติม -o/-outdir:
ในการสร้างไฟล์. HEX ในไดเรกทอรีอื่น:
$ py2hex ตัวอย่าง. py -o /tmp hexifying example.py เป็น: /tmp/example.hex
หรือ:
$ PY2HEX EXAMPLE.PY -OUTDIR /TMP hexifying example.py เป็น: /tmp/example.hex
PY2Hex สามารถจัดการไฟล์อินพุตหลายไฟล์:
$ 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
หรือ:
$ py2hex *.py hexifying A.py AS: A.Hex hexifying b.py as: b.hex hexifying C.py AS: C.Hex
ซอร์สโค้ดโฮสต์ใน GitHub โปรดอย่าลังเลที่จะแยกที่เก็บ สมมติว่าคุณได้ติดตั้ง Git แล้วคุณสามารถดาวน์โหลดรหัสจากที่เก็บ Canonical ด้วยคำสั่งต่อไปนี้:
$ git clone https://github.com/ntoll/uflash.git
ตรวจสอบให้แน่ใจว่าคุณมีการพึ่งพาที่ถูกต้องสำหรับการพัฒนาที่ติดตั้งโดยการสร้าง virtualenv และทำงาน:
$ PIP Install -r chendreh.txt
หากต้องการติดตั้งโมดูลเวอร์ชันการพัฒนาของคุณเป็น VirtualEnV ให้เรียกใช้คำสั่งต่อไปนี้:
$ python setup.py พัฒนา
มี makefile ที่ช่วยในเวิร์กโฟลว์ทั่วไปส่วนใหญ่ที่เกี่ยวข้องกับการพัฒนา การพิมพ์ make
ด้วยตัวเองจะแสดงรายการตัวเลือกดังนั้น:
$ make ไม่มีเป้าหมาย makefile เริ่มต้นในขณะนี้ พยายาม: ทำความสะอาด - รีเซ็ตโครงการและลบสินทรัพย์ที่สร้างโดยอัตโนมัติ ทำ pyflakes - เรียกใช้ตัวตรวจสอบรหัส Pyflakes Make Pep8 - เรียกใช้ตัวตรวจสอบสไตล์ PEP8 ทำการทดสอบ - เรียกใช้ชุดทดสอบ ให้ความคุ้มครอง - ดูรายงานเกี่ยวกับความครอบคลุมการทดสอบ ตรวจสอบ - เรียกใช้หมากรุกและการทดสอบทั้งหมด Make Package - สร้างแพ็คเกจที่ปรับใช้ได้สำหรับโครงการ สร้าง RPM - สร้างแพ็คเกจ RPM สำหรับโครงการ เผยแพร่ - เผยแพร่โครงการไปยัง PYPI ทำเอกสาร - เรียกใช้สฟิงซ์เพื่อสร้างเอกสารประกอบโครงการ