Quelltext der Seite Pins in Ethersex definieren

== Symbolische Pinnamen ==

Um es zu ermöglichen schnell eine Funktion von einem Pin auf einen anderen zu verlagern, ohne den ganzen Code zu ändern, hat Ethersex eine Abstraktionsschicht, die symbolische Namen für Pins vergibt. Die symbolischen Namen werden dann im Code verwendet. So kann ganz einfach ein anderer Pin für eine Funktion definiert werden.

Die Pindefinitionen, pinning genannt, liegt im ethersex Projektordner unter pinning:

{| border=1 cellspacing=0
| pinning/controllers
| Hier werden spezielle Pindefinitonen und die Größe des uip Buffers, die typisch sind für den Controller (z.b. atmega32). Welche Datei ausgewählt wird hängt von der Konfiguration im menuconfig ab.
|-
| pinning/hardware
| Hier werden die einzelnen Pins definiert die typisch sind für die Plattform (z.b. das pollin netio board). Vornehmlich werden hier Applikationsspezifische Pins definiert. Welche Datei ausgewählt wird hängt von dem Hardware Profil im menuconfig ab.
|-
| pinning/internals
| Hier kommt all der foo rein, der inkompatibilitäten (z.b. von der AVR Libc) umschiffen soll. Er wird wie pinning/hardware nach dem Prozessornamen ausgewählt. Außerdem ist hier das Pin System definiert (header.m4/footer.m4)
|-
|}

Die Datei '''pinning.c''' (im Hauptverzeichnis) wird durch m4 aus den folgenden Dateien in dieser Reihenfolge generiert.

* pinning/internals/header.m4
* pinning/controllers/$(MCU).m4
* pinning/internals/hackery_$(MCU).m4
* pinning/hardware/$(HARDWARE_PROFILE).m4
* pinning/internals/footer.m4

Dem m4 wird dabei die Konfiguration mittels der Variabelen conf_BLAHFASEL (als Beispiel für das menuconfig Flag BLAHFASEL_SUPPORT) mitgeteilt. Als Beispiel, wie diese verwendet wird, einfach die Dateien unter pinning/hardware anschauen. 

Einen symbolischen Pinnamen wird mit dem Makro pin definiert ( pin($NEUER_PINNAME, $PIN) ). Ein Beispiel:

<pre>
pin(PS2_DATA, PD3)
</pre>

Es ist auch möglich gleich im pinning den Pin als Ausgang zu definieren, damit das passende DDR Register gleich bei Start richtig gesetzt ist.
<pre>
pin(PS2_CLOCK, PD2, OUTPUT)
</pre>

Auch besteht die Möglichkeit, ein Alias für einen anderen Pin zu definieren:
<pre>
pin(GENERAL_HUPE, PD2)
pin(MEINE_HUPE, GENERAL_HUPE)
</pre>

Um die Pins dann im Code zu verwenden, sind einige Makros definiert (MEINE_HUPE durch symbolischen Pinnamen ersetzen):
{| border=1 cellspacing=0
| DDR_CONFIG_IN(MEINE_HUPE)
|Pin wird Eingang (DDR Register)
|-
| DDR_CONFIG_OUT(MEINE_HUPE)
|Pin wird Ausgang  (DDR Register)
|-
| PIN_SET(MEINE_HUPE), PIN_CLEAR(MEINE_HUPE) 
| Pin setzen oder Löschen (PORT Register)
|-
| PIN_TOGGLE(MEINE_HUPE) 
|Ausgangszustand des Pins umkehren (PORT Register)
|-
| PIN_PULSE(MEINE_HUPE)
| Pin zuerst löschen, dann wieder setzen (PORT Register) 
|-
| PIN_HIGH(MEINE_HUPE)
| Eingangszustand des Pins auslesen (PIN Register)
|-
| PIN_NR(MEINE_HUPE) 
| PD2 -> 2, PD6 -> 6 
|-
| PIN_BV(MEINE_HUPE) 
| PD1 -> 2, PD7 -> 128, 1 << PIN_NR(MEINE_HUPE)
|-
|}


[[Kategorie: Ethersex]]
[[Kategorie: StepByStep]]