该模块仅适用于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。 制作文档 - 运行狮身人面像以创建项目文档。