twi.h-Dateireferenz
Two-Wire-Interface (I2C) Funktionen.
Mehr ...
#include <avr/io.h>
#include <util/twi.h>
gehe zum Quellcode dieser Datei
Funktionen |
int8_t | TWI_Init (uint8_t BR) |
| Initialisierung des TWI.
|
int8_t | TWI_Init_default () |
| Initialisierung des TWI mit Standardwerten.
|
int8_t | TWIMasterTransmit (int8_t SLA, uint8_t *data, uint8_t count) |
| Mit dem I2C Bus Daten als Master versenden.
|
int8_t | TWIMasterReceive (uint8_t SLA_R, uint8_t *data, uint8_t length) |
| Mit dem I2C Bus Daten als Master empfangen.
|
Ausführliche Beschreibung
Two-Wire-Interface (I2C) Funktionen.
Header-datei für den Zugriff auf das TWI-Interface des ATmega16
Dokumentation der Funktionen
int8_t TWI_Init |
( |
uint8_t |
BR |
) |
|
Initialisierung des TWI.
- Parameter:
-
| BR | der gewünschte Wert des Registers TBRR. Dieser kann dem Datenblatt entnommen werden. Dabei ist jedoch zu beachten, dass die PrescalerBits des TWST Registers auf null gesetzt werden. |
int8_t TWI_Init_default |
( |
|
) |
|
Initialisierung des TWI mit Standardwerten.
Der TWI wird mit TWBR=72 initialisiert. Dies entspricht einer Frequenz von 100kHz auf SCL.
int8_t TWIMasterReceive |
( |
uint8_t |
SLA_R, |
|
|
uint8_t * |
data, |
|
|
uint8_t |
length | |
|
) |
| | |
Mit dem I2C Bus Daten als Master empfangen.
- Parameter:
-
| SLA_R | 7-bit Addresse des anzusprechden Geräts. Das MostSignificantBit bleibt unbeachtet und sollte null sein. |
| *data | Addresse des Speicherbereichs in dem die zu empfangenden Daten gespeichert sind |
| length | Anzahl der Bytes, die empfangen werden sollen |
- Rückgabe:
- Falls die Übertragung selbst gestört wurde, wird die Anzahl der empfangenen Bytes zurückgegeben. Ansonsten werden die folgenden Fehlercodes zurückgegeben.
- Rückgabewerte:
-
| 0 | Die Übertragung hat, wie gewünscht funktioniert. |
| -1 | Undefinierter Fehler |
| -2 | Es konnte keine START-Bedingung erzeugt werden |
| -3 | Das addressierte Geräte antwortet nicht(ist es angeschlossen?) |
int8_t TWIMasterTransmit |
( |
int8_t |
SLA, |
|
|
uint8_t * |
data, |
|
|
uint8_t |
count | |
|
) |
| | |
Mit dem I2C Bus Daten als Master versenden.
- Parameter:
-
| SLA | 7-bit Adresse des anzusprechden Geräts. Das MostSignificantBit bleibt unbeachtet und sollte null sein. |
| *data | Adresse des Speicherbereichs in dem die zu sendenden Daten gespeichert sind |
| count | Anzahl der Bytes, die aus dem Speicherbereich data versendet werden sollen |
- Rückgabe:
- Falls der Empfänger eines der Bytes nicht mit ACK bestätigt wurde, wird die Anzahl der übertragenen Bytes zurückgegeben. Ansonsten werden die folgenden Fehlercodes zurückgegeben.
- Rückgabewerte:
-
| 0 | Die Übertragung hat, wie gewünscht funktioniert. |
| -1 | Undefinierter Fehler |
| -2 | Es konnte keine START-Bedingung erzeugt werden |
| -3 | Das addressierte Geräte antwortet nicht(ist es angeschlossen?) |