MLAB wiki

Máte načtenou starší verzi dokumentu! Pokud ji uložíte, vytvoříte tím novou aktuální verzi.

====== Komunikační knihovna pymlab ======

Jde o softwarový balík, který umožňuje vytvářet senzorovou síť založenou na komunikačních rozhraních RS232, [[cs:i2c|I²C]], Ethernet a USB. Jde o pokusnou implementaci [[cs:pdn|polymorfní sítě přístrojů]].

Princip funkce spočívá v definování struktury sítě a adres jednotlivých nódů v konfiguračním souboru ovládacího programu. Lze tak ke všem bodům v síti přistupovat pomocí jazyka Python. Pro routování I2C mezi jednotlivými segmenty obsahujícími čidla se stejnými adresami jsou využívány moduly  [[cs:i2chub|I2Chub02A]], které slouží jako routovací body pro zařízení, která nemohou být na jedné větvi sběrnice. Což je například více senzorů se stejnou I²C adresou. Zdrojové soubory knihovny a příkladů použití jsou v repozitáři [[https://github.com/MLAB-project/MLAB-I2c-modules|pyMLAB]] na  MLAB Githubu.

Výsledkem je možnost testovat a demonstrovat všechna nová čidla a zařízení. Bez nutnosti udržovat aktuální specifické zdrojové kódy pro všechny používané MCU. Lze tak dosáhnout nezávislosti na aktuálně používaných mikrokontrolérech, protože v blízké době by mělo být možné z Pythonu generovat program pro různé architektury.

===== Instalace =====

Pokud potřebujeme na sběrnici přistupovat přes rozhraní USB pomocí modulu [[cs:usbi2c|USBI2C01A]], tak je potřeba nainstalovat balík s hidapi a další nástroje. Viz [[cs:usbi2c|stránka tohoto modulu]].
Instalaci samotného softwarového balíku pymlab pak provedeme snadno pomocí:

sudo easy_install pymlab
  
nebo 
  sudo pip install pymlab

Oba příkazy jsou rovnocenné a využívají python balíčkovací systém ve kterém je [[https://pypi.python.org/pypi/pymlab/|pymlab zařazen]]. Tím by měly být staženy i závislosti se kterými pymlab pracuje, jako je například cython-hidapi v pythonu označovaný pouze jako modul hid.  Nenainstaluje se ale libusb. To stále musíme provést ručně pomocí:

sudo apt-get install libudev-dev libusb-1.0-0-dev libhidapi-dev python-setuptools python-smbus cython

==== Vývojová verze ====

Nejaktuálnější vývojová verze knihovny je k dispozici na githubu. Tu taktéž můžeme nainstalovat do systému a knihovnu přitom vyvíjet.

git clone https://github.com/MLAB-project/pymlab.git
  cd pymlab
  git checkout dev
  sudo python setup.py develop

Následně je užitečné úpravy knihovny zpětně vystavit na githubu, nebo vytvořit pull-request.

===== Použití =====

Základní vlastností knihovny pymlab je možnost nadefinovat strukturu sítě senzorů. Obecně jde o síť zařízení se kterými komunikovat uživatelský kód. Definice sítě vypadá například takto:

cfg = config.Config(
      i2c = {
          "port": '/dev/ttyUSB0', # I2C bus number eg 0 or system device address in case of serial driver'/dev/ttyUSB0'. 
          "device": 'serial',  # here you can explicitly set I2C driver with 'hid', 'smbus', 'serial'
      },
  
      bus = [
          {
              "type": "i2chub",
              "address": 0x73,
              
              "children": [
                  {"name": "thermopile", "type": "thermopile01", "channel": 4, },
              ],
           },
      ],
  )

Jde o JSON zápis struktury. Blok i2c definuje kořenové komunikační rozhraní. Ten má dva parametry.
Parametr //port// určuje systémové rozhraní které bude využito pro komunikaci. Může mít hodnoty buď číslo systémového [[cs:i2c|I2C]] portu na který se má knihovna pymlab připojit.
Nebo řetězec, který určuje adresu k systémovému souboru, který se má použít pro komunikaci.

Volba "device" pak může mít několik hodnot podle typu rozhraní, které má být použito. Aktuálně jsou podporovány tyto typy:

* 'smbus' - Systémové smbus/I²C rozhraní
  * 'hid' - Připojení přes HIDAPI, což je například případ použití modulu [[cs:usbi2c|]]
  * 'serial' - Systémové seriové rozhraní například kombinace [[cs:usb232r|]] a [[cs:i2c232v|]]

Pokud má //device// hodnotu //None//, nebo není vůbec zadaný, tak se knihovna pokusí sekvenčně použít jednotlivé drivery.

==== Interaktivní uživatelské rozhraní iPython ====
 
Vhodným řešením pro testování zařízení je použití interaktivního prostředí iPython, kde můžeme přímo interaktivně zkoušet jednotlivé části kódu a zpracovávat, nebo vykreslovat měřená data.

Ubuntu iPython získáme instalací těchto balíků: 
  sudo apt-get install ipython-notebook python-scipy python-numpy

Pak již můžeme iPython spustit z příkazového řádku
  ipython notebook --pylab inline

Tento příkaz spustí server iPythonu a obvykle otevře i okno systémového webového prohlížeče s otevřenou složkou ze které jsme iPython server spustili. Vytvořené notebooky se pak ukládají s adresou relativní k této složce.

Pro přímý přístup ke sběrnici I²C bez sudo je třeba být ve skupině i2c. Uživatele tam přidáme například takto. 
  sudo adduser kaklik i2c

Změna se projeví po odhlášení a přihlášení uživatele.

----
Poznámka: Pro seznámení se s jazykem [[http://www.tutorialspoint.com/python/|Python]] můžete využít [[http://physics.muni.cz/~janak/pyzen/|Zenovou školu Pythonu]] od Zdeňka Janáka.

===== TODO =====

==== Grafické rozhraní ====

Grafické rozhraní by v kombinaci s touto knihovnou mohlo být využito pro definování síťové topologie a případné vykreslování grafů ze senzorů zapojených do sítě.  Jedním z již hotových nástrojů, které by pro takovou aplikaci bylo možné použít je například [[http://www.pyqtgraph.org/|PyQtGraph]]

===== Python interpreter pro ARM STM32 =====

Pro použití Python frameworku na vyčítání čidel přímo z [[cs:stm32f10xrxt]] by bylo užitečné použít Python interpretr pro ARM. Například by mohl být použitelný [[http://code.google.com/p/python-on-a-chip/|Python on a chip]].

Vyplňte, prosím, všechna písmena v poli, abyste dokázali, že nejste robot. S T H R K Ponechte prosím toto pole prázdné:

Komentář k úpravám

Poznámka: Tím, že editujete tuto stránku, souhlasíte, aby váš obsah byl licencován pod následující licencí: CC Attribution-Noncommercial-Share Alike 4.0 International