Differences

This shows you the differences between two versions of the page.

--- en:pymlab [2016/05/14 17:31] – [Interactive Python shell iPython] kaklik
+++ en:pymlab [Unknown date] (current) – external edit (Unknown date) 127.0.0.1
@@ Line 46: / Line 46: @@
 {{ :cs:sw:flowchart.png?direct&500 |}}
-===== ARM STM32 Python interpreter =====
+===== ARM STM32 Python interpreter ====
-Pyhthon interpreter should be useful if pymlab would be used at [[cs:stm32f10xrxt|ARM]] microcontrolers.
-One example of possible interpreter is [[http://code.google.com/p/python-on-a-chip/|Python on a chip]].
+The latest version of Pymlab is compatible with the [[https://micropython.org/|MicroPython]] interpretation of Python. Testing has been performed on the [[http://docs.micropython.org/en/latest/pyboard/pyboard/quickref.html|Pyboard v1.0]] ([[http://www.st.com/en/microcontrollers/stm32f405rg.html|STM32F405RG]] processor) and [[https://github.com/micropython/micropython/tree/v1.9.3|version 1.9.3 of MicroPython]].
+=== Example ===
+<file python main.py>
+import pymlab.config
+cfg = pymlab.config.Config(i2c={"device": "machine", "port": 1, "freq": 100000},
+                           bus=[{"name": "altimet", "type": "altimet01"},
+                                {"name": "light", "type": "isl03"},
+                                {"name": "sht", "type": "sht31"}])
+cfg.initialize()
+altimet = cfg.get_device("altimet")
+altimet.route()
+light = cfg.get_device("light")
+light.config(0x0000)
+sht = cfg.get_device("sht")
+sht.soft_reset()
+t1, p = altimet.get_tp()
+l = light.get_lux()
+t2, h = sht.get_TempHum()
+</file>
+=== Tips & Tricks ===
+Resources (Flash and RAM) embedded systems are typically quite limited, the whole pymlab module does not fit to the flash memory available on the [[http://docs.micropython.org/en/latest/pyboard/pyboard/quickref.html|Pyboard]] for example.
+Fortunately MicroPython provides cross compiler that allows us to compile the source code to bytecode and therefore reduce the RAM and flash usage.
+Version of the cross compiler must match the version of MicroPython running on your board. If in doubt just compile and flash your board with firmware compiled from the same branch of the [[https://github.com/micropython/micropython#the-stm32-version|MicroPython repository]] as the cross compiler, instruction can be found at [[https://github.com/micropython/micropython#the-stm32-version|https://github.com/micropython/micropython#the-stm32-version]].
+<code sh>
+$ git clone https://github.com/micropython/micropython
+$ cd micropython
+$ git checkout UPY_VERSION # This is very important!
+$ # Optional compiling and flashing of the firmware
+$ cd mpy-cross
+$ make
+</code>
+In  Makefile at [[https://github.com/MLAB-project/pymlab/blob/master/src/pymlab/Makefile|pymlab/src/pymlab/Makefile]] edit the path to the cross compiler, mountpoint of the flash memory and devices you wish to use as all drivers are still to much for the limited space on the Pyboard. The just type
+  make deploy
+and you are good to go.