Modifications

Sauter à la navigation Sauter à la recherche
2 157 octets ajoutés ,  10 juillet 2020 à 12:20
Ligne 1 : Ligne 1 : −
{{traduction}}
+
= Préambule =
 +
[[Fichier:RShell-logo.jpg|480x]]
   −
= Préambule =
+
Voici une traduction libre de la documentation de l'outil RShell écrit par Dave Hylands.
Voici une traduction libre de la documentation de l'outil RShell écrit par Daniel Hylands.
      
C'est un outil très intéressant pour réaliser des développements MicroPython, RShell fonctionne avec de nombreuses cartes MicroPython dont PyBoard, ESP8266, Teensy et toutes carte MicroPython ayant une invite REPL sur un port série.
 
C'est un outil très intéressant pour réaliser des développements MicroPython, RShell fonctionne avec de nombreuses cartes MicroPython dont PyBoard, ESP8266, Teensy et toutes carte MicroPython ayant une invite REPL sur un port série.
Ligne 16 : Ligne 16 :  
* Dec 13, 2016 - Traduction jusqu'à révision 480945c du Apr 30, 2016
 
* Dec 13, 2016 - Traduction jusqu'à révision 480945c du Apr 30, 2016
   −
= RShell sur ESP8266 =
+
== RShell sur ESP8266 ==
    
{{ambox-stop|text=Il est impératif de réduire la taille du buffer à 128 octets sur un ESP8266 sinon vous risquez d'écraser le système de fichier votre ESP8266... auquel cas il faudra reflasher votre carte}}
 
{{ambox-stop|text=Il est impératif de réduire la taille du buffer à 128 octets sur un ESP8266 sinon vous risquez d'écraser le système de fichier votre ESP8266... auquel cas il faudra reflasher votre carte}}
Ligne 22 : Ligne 22 :  
  <nowiki>rshell --port /dev/ttyUSB0 --baud 115200 --buffer-size 128 --editor nano</nowiki>
 
  <nowiki>rshell --port /dev/ttyUSB0 --baud 115200 --buffer-size 128 --editor nano</nowiki>
   −
Nous avons également un petit script shell [https://github.com/mchobby/esp8266-upy/blob/master/rshell-esp8266.sh rsheel-esp8266.sh] pour faciliter faciliter le démarrage de rshell pour un esp8266.  
+
Nous avons également un petit script shell [https://github.com/mchobby/esp8266-upy/blob/master/rshell-esp8266.sh rsheel-esp8266.sh] pour faciliter faciliter le démarrage de rshell pour un esp8266.
 +
 
 +
== RShell sur ESP32 (M5Stack) ==
 +
 
 +
L'outil RShell ne détecte pas automatiquement le port série associé au M5Stack. Il sera donc nécessaire de le stipuler au lancement de RShell.
 +
 
 +
<nowiki>rshell --port /dev/ttyUSB0 --editor nano</nowiki>
 +
 
 +
Sur un système Linux, il est facile d'identifier le port série dans les messages envoyés par le noyaux Linux lors de la connexion de l'ESP32 sur un port USB.
 +
 
 +
Brancher l'ESP32 / M5-Core puis exécuter la commande {{fname|dmesg}} dans un terminal pour collecter les messages de débogage.
 +
 
 +
<nowiki>[441990.881362] usb 2-3.2: new full-speed USB device number 16 using xhci_hcd
 +
[441990.983365] usb 2-3.2: New USB device found, idVendor=10c4, idProduct=ea60
 +
[441990.983368] usb 2-3.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
 +
[441990.983370] usb 2-3.2: Product: CP2104 USB to UART Bridge Controller
 +
[441990.983371] usb 2-3.2: Manufacturer: Silicon Labs
 +
[441990.983373] usb 2-3.2: SerialNumber: 01DB6B96
 +
[441990.984594] cp210x 2-3.2:1.0: cp210x converter detected
 +
[441990.985755] usb 2-3.2: cp210x converter now attached to ttyUSB0</nowiki>
 +
 
 +
il s'agit ici du port '''ttyUSB0''' et donc du périphérique '''/dev/ttyUSB0'''
 +
 
 +
== RShell sur WiPy/WiPy2 ==
 +
Nous recommandons vivement de modifier le mot de passe et utilisateur par défaut de votre WiPy/WiPy 2.
 +
 
 +
Voici des exemples concernant les plateformes WiPy et WiPy2.
 +
 
 +
Exemple avec WiPy et WiPy 2:
 +
<nowiki>rshell --port 192.168.2.200 --user micro --password python --editor nano</nowiki>
    
= RShell: Shell distant pour MicroPython =
 
= RShell: Shell distant pour MicroPython =
   
== Qu'est ce que RSHell? ==
 
== Qu'est ce que RSHell? ==
 
Le shell distant (en ''remote'') pour MicroPython
 
Le shell distant (en ''remote'') pour MicroPython
Ligne 44 : Ligne 72 :  
Le grand bénéfice de cette approche est de permettre le transfert de fichier et REPL par l'intermédiaire d'une simple connexion série (filaire, USB et '''Port-Série via Bluetooth''' [[MicroPython-bluetooth|comme décrit ici]]).
 
Le grand bénéfice de cette approche est de permettre le transfert de fichier et REPL par l'intermédiaire d'une simple connexion série (filaire, USB et '''Port-Série via Bluetooth''' [[MicroPython-bluetooth|comme décrit ici]]).
   −
== PC ou /flash ou /sdcard ==
+
== PC ou /flash ou /sdcard ou /pyboard ==
 
{{ambox|text=RShell utilise une notation particulière pour les échanges de fichiers.}}
 
{{ambox|text=RShell utilise une notation particulière pour les échanges de fichiers.}}
   −
Lorsque vous utilisez des commandes RShell, les répertoires {{fname|/flash}} et {{fname|/sdcard}} (si vous utilisez une carte SD) sont considérés comme étant sur la carte MicroPython.
+
Lorsque vous utilisez des commandes RShell, les répertoires {{fname|/flash}} et {{fname|/sdcard}} (si vous utilisez une carte SD) sont considérés comme étant sur la carte MicroPython.
 +
 
 +
Dans certains cas, comme pour l'ESP8266, c'est le répertoire {{fname|/pyboard}} qu'il faut utiliser à la place de {{fname|/flash}}. En cas de doute, l'utilisation de la commande {{fname|boards}} permet de lister les cartes connectées (et répertoires distants associés).
    
Tous les autres répertoires sont réputés être sur l'hôte (votre Ordinateur).
 
Tous les autres répertoires sont réputés être sur l'hôte (votre Ordinateur).
Ligne 270 : Ligne 300 :  
== Commandes ==
 
== Commandes ==
 
Voici une liste des commandes que vous pouvez utiliser dans RShell.
 
Voici une liste des commandes que vous pouvez utiliser dans RShell.
  −
{{traduction}}
      
=== args ===
 
=== args ===
Ligne 282 : Ligne 310 :     
Liste/affiche toutes les cartes actuellement connectés sur RSHell, leurs nomst et point de connexion.
 
Liste/affiche toutes les cartes actuellement connectés sur RSHell, leurs nomst et point de connexion.
 +
 +
Voici un exemple de résultat (avec un carte Feather Huzzah ESP8266 sous MicroPython):
 +
 +
[[Fichier:MicroPython-Hack-RShell-boards.png]]
    
=== cat ===
 
=== cat ===
Ligne 398 : Ligne 430 :     
=== shell ===
 
=== shell ===
  shell some-command
+
  shell commande-shell
  !some-command
+
  !commande-shell
   −
The shell command can also be abbreviated using the exclamation point.
+
Ceci invoke une commande dans le shell de votre système d'exploitation puis rend la main à RShell.
This will invoke a command, and return back to rshell.  
     −
Example:
+
La commande {{fname|shell}} peut être remplacée par son abréviation {{fname|!}}.
    +
Exemple:
 
  !make deploy
 
  !make deploy
   −
will flash the pyboard.
+
Dans l'exemple ci-dessus, l'utilitaire {{fname|make}} est appelé avec l'argument ''deploy'' dans le shell du système d'exploitation. Cela permet, en autre, de pouvoir flasher une carte PyBoard.
29 836

modifications

Menu de navigation