Commits

Anonymous committed 70d28df

minor fix

Comments (0)

Files changed (3)

   Documentation sur python et le STM32F4 : 
 ==========================================
 
-Quelques remarques :
 
-Cette documentation ne porte que sur la plateforme linux. Il sera
-donc nécessaire de la compléter pour win32, et Mac Os.
+.. warning ::
 
-pymite ne fonctionne qu'avec PYTHON 2.6 et rien d'autre
+    Cette documentation ne porte que sur la plateforme linux. Il sera donc nécessaire de la compléter pour win32, et Mac Os.
 
-Il est relativement important de récupérer les sources proposés par J.SCHEMOUL
-pour le STM32F4. en attendant d'avoir un packaging simple à proposer.
 
+.. warning ::
+    
+    Pymite ne fonctionne qu'avec PYTHON 2.6 et rien d'autre
+
+.. warning ::
+    
+    Il est relativement important de récupérer les sources proposés par J.SCHEMOUL
+    pour le STM32F4. en attendant d'avoir un packaging simple à proposer.
+
+
+.. toctree::
+   :maxdepth: 2
+
+   installation
+   tutorial_part1
+   ETHERNET/ethernet
 
 
 Introduction sur la plaque STM32F4 (discovery) :
 
    * un blog sur le STM32F4 : http://www.emcu.it/STM32F4xx/STM32F4xx.html
 
-
-.. toctree::
-   :maxdepth: 2
-
-   installation
-   tutorial_part1
-   ETHERNET/ethernet
-
-
 + Quelques caractéristiques :
 
     - 32 bit
             Un manque certain de facilité, par rapport à l'IDE de l'ARDUINO où toutes
             les difficulté techniques sont masqués à l'utilisateur. Le debug n'est pas inclu également ...
 
-*Note pour le debug :*
+.. note::
 
     Si vous voulez faire du debug, il vous faut rajouter un petit bout d'électronique pour
     utiliser la console série (UART) de la carte (on branche deux fils sur les pattes qui vont bien
     et on connecte l'engin sur un autre port usb, il ne restera plus qu'à écouter sur l'usb
-    avec putty par exemple : **putty -serial -sercfg 9600 /dev/ttyUSB0**
+    avec putty par exemple : 
+    
+    .. code-block :: sh
+
+        putty -serial -sercfg 9600 /dev/ttyUSB0
 
 
 Pymite :

source/installation.rst

-Installer la chaîne de compilation et de tous les éléments nécessaires :
-------------------------------------------------------------------------
+====================================
+Installer la chaîne de compilation :
+====================================
 
     * se procurer les éléments nécessaires pour sa plateforme (linux) :
 
         - stlink.tar.gz
         - pymite-09.tar.gz
         
-        + note :
+        .. note::
+
             J.SCHEMOUL devrait publier dans peu de temps un dépôt sur github ou bitbucket contenant
             les éléments nécessaires. Ceux-ci étaient fournis lors de l'atelier
 
-        + note : 
+        .. note::
+
             Il parait relativement important de reprendre les sources de J.SCHEMOUL qui semble règler
             pas mal de problèmes
 
     * pour le reste de la documentation on supposera que tout se passe dans un répertoire
       créé pour l'exemple :
       
-.. code-block :: sh
+        .. code-block :: sh
 
-           virtualenv --python=python2.6 myvenv
-           source ./myvenv/bin/activate
-           mkdir ~/stm32f4_work
-           cp stlink.tar.gz ~/stm32f4_work
-           cp pymite-09.tar.gz ~/stm32f4_work
-           cp arm-2011.09-69-arm-none-eabi.bin ~/stm32f4_work
+                   virtualenv --python=python2.6 myvenv
+                   source ./myvenv/bin/activate
+                   mkdir ~/stm32f4_work
+                   cp stlink.tar.gz ~/stm32f4_work
+                   cp pymite-09.tar.gz ~/stm32f4_work
+                   cp arm-2011.09-69-arm-none-eabi.bin ~/stm32f4_work
 
     * installer la chaîne de compilation
 
-.. code-block :: sh
+        - exécuter le binaire arm-2011.09-69-arm-none-eabi.bin
 
-           cd ~/stm32f4_work
-          ./arm-2011.09-69-arm-none-eabi.bin
+            .. code-block :: sh
+
+                       cd ~/stm32f4_work
+                      ./arm-2011.09-69-arm-none-eabi.bin
+
 
             vous pouvez exécuter ce binaire depuis votre utilisateur habituel (pas besoin de sudo)
             cela exécute un installeur basé en java, suivre la procédure d'installation, le programme
-            crée deux répertoires dans le home directory de l'utilisateur.
-            
-            **~/Sourcery_CodeBench_Lite_for_ARM_EABI** et **~/CodeSourcery/**
+            crée deux répertoires dans le home directory de l'utilisateur:
 
-        - modifier votre PATH pour prendre en compte ce nouveau répertoire (le binaire arm-none-eabi-gdb doit
-        être accessible, il )
+             + ~/Sourcery_CodeBench_Lite_for_ARM_EABI
+             + ~/CodeSourcery/
 
-.. code-block :: sh
+        - rendre accessible le binaire arm-none-eabi-gdb pour cela modifier votre PATH :
 
-            export PATH=$PATH:~/CodeSourcery/Sourcery_CodeBench_Lite_for_ARM_EABI/bin/
+            .. code-block :: sh
 
-        - installer des librairies nécessaires (** facultatif et fonction du système ...**) :
+                        export PATH=$PATH:~/CodeSourcery/Sourcery_CodeBench_Lite_for_ARM_EABI/bin/
 
-.. code-block :: sh
+        - installer des librairies nécessaires (facultatif et fonction du système ...) :
 
-            sudo apt-get install libusb--dev
-            sudo apt-get install libusb-1.0-0
-            sudo apt-get install libusb-1.0-0-dev
-            sudo apt-get install libsgutils2-dev
-            sudo apt-get install scons
+            .. code-block :: sh
+
+                        sudo apt-get install libusb--dev
+                        sudo apt-get install libusb-1.0-0
+                        sudo apt-get install libusb-1.0-0-dev
+                        sudo apt-get install libsgutils2-dev
+                        sudo apt-get install scons
 
         - compiler stlink :
 
-.. code-block :: sh
+            .. code-block :: sh
 
-            cd ~/stm32f4_work
-            tar -zxvf stlink.tar.gz
-            cd stlink
-            make
+                        cd ~/stm32f4_work
+                        tar -zxvf stlink.tar.gz
+                        cd stlink
+                        make
+            .. note::
 
-          note : en cas de problème de compilation, regarder du côté des librairies de développement
+                   En cas de problème de compilation, regarder du côté des librairies de développement
 
         - décompresser l'archive de pymite  :
 
-.. code-block :: sh
+            .. code-block :: sh
 
-            cd ~/stm32f4_work
-            tar -zxvf pymite-09.tar.gz
+                        cd ~/stm32f4_work
+                        tar -zxvf pymite-09.tar.gz
 

source/tutorial_part1.rst

         - 1 pour la compilation
         - 1 pour la console gdb permettant de charger le code sur le STM32F4
 
-        note : je conseille d'utiliser screen (en attendant d'avoir un IDE, dédié / ou pas ...)
+        .. note::
+
+        Je conseille d'utiliser screen (en attendant d'avoir un IDE, dédié / ou pas ...)
             - cd ~/stm32f4_work
             - screen
             - export PATH=$PATH:~/CodeSourcery/Sourcery_CodeBench_Lite_for_ARM_EABI/bin/
 
     6. exécuter son projet
 
-.. code-block :: sh
+        .. code-block :: sh
 
-        cd ~/stm32f4_work/pymite-0.9/src/platform/stm32f4
-        # si votre path est bien configuré l'appel de arm-none-eabi-gdb devrait se dérouler correctement
-        # sinon un appel directe fera l'affaire :
-            ~/CodeSourcery/Sourcery_CodeBench_Lite_for_ARM_EABI/bin/arm-none-eabi-gdb
-        arm-none-eabi-gdb
-        # cela démarre la console gdb et vous donne la main
-        target extended localhost:4242
-        # charge le fichier elf (préalablement compilé, cf `scons PLATFORM=stm32f4`
-        load main.elf
-        # indique au debugger de continuer l'exécution sur le STM32F4
-        continue
+                cd ~/stm32f4_work/pymite-0.9/src/platform/stm32f4
+                # si votre path est bien configuré l'appel de arm-none-eabi-gdb devrait se dérouler correctement
+                # sinon un appel directe fera l'affaire :
+                    ~/CodeSourcery/Sourcery_CodeBench_Lite_for_ARM_EABI/bin/arm-none-eabi-gdb
+                arm-none-eabi-gdb
+                # cela démarre la console gdb et vous donne la main
+                target extended localhost:4242
+                # charge le fichier elf (préalablement compilé, cf `scons PLATFORM=stm32f4`
+                load main.elf
+                # indique au debugger de continuer l'exécution sur le STM32F4
+                continue
 
     7. having fun ...
         Si tout c'est bien passé, votre code python tourne sur la plaque.