Verstehen Sie die FreeRTOS Common IO APIs - FreeRTOS

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verstehen Sie die FreeRTOS Common IO APIs

Common I/O APIs fungieren als Hardware-Abstraktionsschichten (HAL), die eine gemeinsame Schnittstelle zwischen Treibern und übergeordnetem Anwendungscode bereitstellen. FreeRTOS Common IO bietet eine Reihe von Standards APIs für den Zugriff auf gängige serielle Geräte auf unterstützten Referenzkarten. Implementierungen davon APIs sind nicht enthalten. Diese Common APIs kommunizieren und interagieren mit diesen Peripheriegeräten und ermöglichen es Ihrem Code, plattformübergreifend zu funktionieren. Ohne Common IO ist das Schreiben von Code für Low-Level-Geräte herstellerspezifisch.

Anmerkung

FreeRTOS benötigt keine Implementierungen des Common IO, APIs um zu funktionieren, aber es wird versuchen, das Common IO APIs als Schnittstelle zu den spezifischen Peripheriegeräten auf einer Mikrocontroller-basierten Platine zu verwenden, anstatt herstellerspezifisch. APIs

Im Allgemeinen sind Gerätetreiber unabhängig vom zugrunde liegenden Betriebssystem und spezifisch für eine bestimmte Hardwarekonfiguration. Die HAL abstrahiert die Details, wie ein bestimmter Treiber funktioniert, und stellt eine einheitliche API zur Steuerung solcher Geräte bereit. Sie können dasselbe verwenden, APIs um auf verschiedene Gerätetreiber für mehrere Mikrocontroller- (MCU) -basierte Referenzkarten zuzugreifen.

Bibliotheken

Derzeit bietet FreeRTOS zwei Common IO-Bibliotheken: Common IO — Basic und Common IO — BLE.

Common IO — einfach

Übersicht

Common I/O — Basic-Angebote, APIs die sich mit grundlegenden I/O-Peripheriegeräten und Funktionen befassen, die Sie möglicherweise auf MCU-basierten Boards finden. Das Common IO — Basic Repository ist verfügbar unter. GitHub

Unterstützte Peripheriegeräte
  • ADC

  • GPIO

  • I2C

  • PWM

  • SPI

  • UART

  • Wachhund

  • Flash

  • RTC

  • ABLEHNEN

  • Setzt zurück

  • I2S

  • Leistungszähler

  • Informationen zur Hardwareplattform

Unterstützte Features
  • Synchrones Lesen/Schreiben

    Die Funktion kehrt erst zurück, wenn die angeforderte Datenmenge übertragen wurde.

  • Asynchrones Lesen/Schreiben

    Die Funktion kehrt sofort zurück und die Datenübertragung erfolgt asynchron. Wenn die Aktion abgeschlossen ist, wird ein registriertes Benutzer-Callback aufgerufen.

Peripheriegeräte-spezifisch
  • I2C

    Kombinieren Sie mehrere Operationen zu einer Transaktion. Wird verwendet, um Schreib- und Leseaktionen in einer Transaktion auszuführen.

  • SPI

    Übertragen Sie Daten zwischen primär und sekundär, was bedeutet, dass das Schreiben und Lesen gleichzeitig erfolgt.

API-Referenz

Eine vollständige API-Referenz finden Sie in der Common IO — Basic API-Referenz.

Allgemeine I/O — BLE

Übersicht

Common IO — BLE bietet Abstraktion vom Bluetooth Low Energy-Stack des Herstellers. Es bietet die folgenden Schnittstellen, über die das Gerät gesteuert und GAP- und GATT-Operationen ausgeführt werden können. Das Common IO - BLE-Repository ist verfügbar unter GitHub.

Bluetooth-Geräte-Manager:

Dies bietet eine Schnittstelle zur Steuerung des Bluetooth-Geräts, zur Durchführung von Geräteerkennungsvorgängen und anderen Aufgaben im Zusammenhang mit der Konnektivität.

BLE-Adaptermanager:

Dies bietet eine Schnittstelle für die GAP-API-Funktionen, die für BLE spezifisch sind.

Klassischer Bluetooth-Adaptermanager:

Dies bietet eine Schnittstelle zur Steuerung der BT Classic-Funktionen eines Geräts.

GATT-Server:

Dies bietet eine Schnittstelle zur Verwendung der Bluetooth-GATT-Serverfunktion.

GATT-Client:

Dies bietet eine Schnittstelle zur Verwendung der Bluetooth-Funktion des GATT-Clients.

A2DP-Verbindungsschnittstelle:

Dies bietet eine Schnittstelle für das A2DP-Quellprofil für das lokale Gerät.

API-Referenz

Eine vollständige API-Referenz finden Sie in der Common IO - BLE API-Referenz.

Gemeinsame I/O für Amazon Common Software

Die Common I/O APIs sind Teil der erforderlichen Implementierungen, die von Amazon Common Software for Devices benötigt werden, insbesondere zur Implementierung in einem Device Porting Kit (DPK) eines Anbieters.

Was ist ACS?

Amazon Common Software (ACS) for Devices ist eine Software, mit der Sie Amazon Device schneller SDKs auf Ihren Geräten integrieren können. ACS bietet eine einheitliche API-Integrationsschicht, vorab validierte und speichereffiziente Komponenten für allgemeine Funktionen wie Konnektivität, ein Device Porting Kit (DPK) und mehrstufige Testsuiten.

Qualifizierungsprogramm

Das Qualifizierungsprogramm für Amazon Common Software for Devices überprüft, ob ein Build des ACS DPK (Device Porting Kit), das auf einem bestimmten Mikrocontroller-basierten Entwicklungsboard ausgeführt wird, mit den veröffentlichten Best Practices des Programms kompatibel und robust genug ist, um die vom Qualifizierungsprogramm vorgeschriebenen ACS-vorgeschriebenen Tests zu bestehen.

Anbieter, die für dieses Programm qualifiziert sind, sind auf der Seite Anbieter von ACS-Chipsätzen aufgeführt.

Informationen zur Qualifizierung erhalten Sie bei ACS for Devices.