uflash
1.0.0
Ce module ne fonctionne qu'avec Python 2.7 ou 3.3+.
Un utilitaire pour clignoter la BBC Micro: Bit avec des scripts Python et le runtime Micropython. Vous prononcez le nom de cet utilitaire "micro-flash". ;-)
Il fournit trois services:
Plusieurs opérations essentielles sont mises en œuvre:
Pour installer simplement Type:
$ pip install uflash
... et le package téléchargera depuis PYPI. Si vous souhaitez passer à la dernière version, utilisez la commande suivante:
$ pip install --no-cache - Upgrade uflash
NB: Vous devez utiliser un câble de données USB pour connecter le micro: bit à votre ordinateur (certains câbles sont uniquement alimentaires). Vous êtes en bon état si, lorsqu'il est branché, le bit Micro: apparaît comme un périphérique de stockage USB sur votre système de fichiers.
Utilisateurs de Linux: Pour que Uflash fonctionne, vous devez vous assurer que le bit Micro: est monté comme un périphérique de stockage USB. Habituellement, cela se fait automatiquement. Sinon, vous avez probablement configuré la disparition automatique pour être désactivée. Si tel est le cas, nous supposons que vous avez les connaissances techniques pour monter l'appareil vous-même ou pour installer les modules de noyau requis s'ils manquent. Les installations par défaut des distros Linux populaires "devraient simplement fonctionner" (TM) hors de la boîte étant donné une installation par défaut.
Pour lire l'aide simplement à taper:
$ uflash - help
ou:
$ uflash -h
Pour découvrir le type d'informations de version:
$ uflash --version
Si vous tapez la commande à lui seul, Uflash tentera de trouver une BBC Micro: bit connectée et flasher une version par défaut non modifiée du MicroPython Runtime sur lui:
$ uflash Python clignotant à: /media/ntoll/microbit/micropopython.hex
Pour flasher une version de l'exécution de Micropython avec un script spécifié intégré à l'intérieur (de sorte que le script est exécuté lorsque le bbc Micro: Bit est ensuite passé le chemin du script Python comme le premier argument à la commande:
$ uflash my_script.py Flashing my_script.py à: /media/ntoll/microbit/micropopython.hex
Vous pouvez laisser Uflash regarder les modifications de votre script. Il sera clignotant automatiquement à chaque fois que vous l'enregistrez:
$ uflash -w my_script.py
ou:
$ uflash --watch my_script.py
À ce stade, UFLASH essaiera de détecter automatiquement le chemin d'accès à l'appareil. Cependant, si vous avez déjà plusieurs périphériques branchés et / ou quel est le chemin du système de fichiers vers la BBC Micro: Bit déjà, vous pouvez le spécifier comme un deuxième argument à la commande:
$ uflash myscript.py / media / ntoll / microbit Clignotant myscript.py à: /media/ntoll/microbit/micropython.hex
Vous pouvez même flasher plusieurs appareils à la fois:
$ uflash myscript.py / media / ntoll / microbit / media / ntoll / microBit1 Clignotant myscript.py à: /media/ntoll/microbit/micropython.hex Clignotant myscript.py à: /media/ntoll/microbit1/micropopython.hex
Pour extraire un script Python à partir d'un fichier hexadécimal, utilisez le drapeau "-e" comme ceci:
$ uflash -e quelque chose.hex myscript.py
Cela sauvera le script Python récupéré de "quelque chose.hex" dans le fichier "myscript.py". Si vous ne fournissez pas de cible, le script récupéré émettra à Stdout.
Si vous développez MicropyThon et que vous avez un fichier hexadécimal d'exécution personnalisé, vous pouvez spécifier que UFLASH l'utilise au lieu de la version intégrée de MicropyThon de la manière suivante:
$ uflash -r firmware.hex
ou:
$ uflash --runtime = firmware.hex
Pour créer des fichiers .hex de sortie dans le même répertoire que les fichiers d'entrée .py:
$ py2hex tests / example.py Exemple hexifier.py comme: tests / exemple.hex
PY2HEX inclut ce même -r / - Runtime et -M / - Minify Options comme UFlash et ajoute une option supplémentaire -o / - outdir:
Pour créer des fichiers .hex de sortie dans un autre répertoire:
$ py2hex example.py -o / tmp Exemple hexifier.py comme: /tmp/example.hex
ou:
$ py2hex example.py --outdir / tmp Exemple hexifier.py comme: /tmp/example.hex
PY2HEX peut gérer plusieurs fichiers d'entrée:
$ py2hex a.py b.py c.py Hexifier a.py comme: a.hex Hexifier b.py as: b.hex Hexifier c.py as: c.hex
ou:
$ py2hex * .py Hexifier a.py comme: a.hex Hexifier b.py as: b.hex Hexifier c.py as: c.hex
Le code source est hébergé dans GitHub. N'hésitez pas à fourrer le référentiel. En supposant que vous avez installé Git, vous pouvez télécharger le code du référentiel canonique avec la commande suivante:
$ git clone https://github.com/ntoll/uflash.git
Assurez-vous d'avoir les dépendances correctes pour le développement installées en créant un virtualenv et en cours d'exécution:
$ pip install -r exigences.txt
Pour installer localement votre version de développement du module dans un VirtualEnv, exécutez la commande suivante:
$ python setup.py développe
Il existe un makefile qui aide à la plupart des flux de travail courants associés au développement. La make à lui-même lira les options ainsi:
$ faire Il n'y a pas de cible MakeFile par défaut en ce moment. Essayer: Claitez-vous - réinitialisez le projet et supprimez les actifs générés automatiquement. Faites des pyflakes - exécutez le vérificateur de code Pyflakes. Faites PEP8 - Exécutez le vérificateur de style PEP8. Faites le test - exécutez la suite de tests. Couverture - Affichez un rapport sur la couverture des tests. Faites un chèque - exécutez tous les vérificateurs et tests. Faire un package - Créez un package déployable pour le projet. Créez RPM - Créez un package RPM pour le projet. faire publier - Publier le projet à PYPI. Faites des documents - exécutez Sphinx pour créer une documentation de projet.
