Informationen zum Benutzerhandbuch für Azure RTOS NetX

Dieses Handbuch enthält umfassende Informationen zu Azure RTOS NetX, dem Hochleistungsnetzwerkstapel von Microsoft.

Es richtet sich an Entwickler von Embedded-Echtzeitsoftware, die mit grundlegenden Netzwerkkonzepten, Azure RTOS ThreadX und der Programmiersprache C vertraut sind.

Organization

Kapitel 1: Einführung in Azure RTOS NetX

Kapitel 2: Enthält die grundlegenden Schritte zur Installation und Verwendung von Azure RTOS NetX mit Ihrer ThreadX-Anwendung.

Kapitel 3: Bietet einen funktionellen Überblick über das Azure RTOS NetX-System sowie grundlegende Informationen zu den TCP/IP-Netzwerkstandards.

Kapitel 4: Bietet Details zur Schnittstelle der Anwendung mit Azure RTOS NetX.

Kapitel 5: Beschreibt Netzwerktreiber für Azure RTOS NetX.

Anhang A: Azure RTOS NetX-Dienste

Anhang B: Azure RTOS NetX-Konstanten

Anhang C: Azure RTOS NetX-Datentypen

Anhang D: BSD-kompatible Socket-API

Anhang E: ASCII-Diagramm

Azure RTOS NetX-Datentypen

Zusätzlich zu den benutzerdefinierten Azure RTOS NetX-Kontrollstruktur-Datentypen gibt es mehrere spezielle Datentypen, die in Azure RTOS NetX-Dienstaufruf-Schnittstellen verwendet werden. Diese speziellen Datentypen werden direkt den Datentypen des zugrunde liegenden C-Compilers zugeordnet. Dies geschieht, um die Portabilität zwischen verschiedenen C-Compilern zu gewährleisten. Die genaue Implementierung wird von ThreadX geerbt und befindet sich in der Datei tx_port.h , die in der ThreadX-Verteilung enthalten ist.

Nachfolgend finden Sie eine Liste mit Azure RTOS NetX-Dienstaufruf-Datentypen und deren zugehörigen Bedeutungen:

Datentypen Beschreibung
UINT Einfache Ganzzahl ohne Vorzeichen. Dieser Typ muss 32-Bit-Daten ohne Vorzeichen unterstützen. Er wird jedoch dem am besten geeigneten Datentyp ohne Vorzeichen zugeordnet.
ULONG Long-Typ ohne Vorzeichen. Dieser Typ muss 32-Bit-Daten ohne Vorzeichen unterstützen.
VOID Entspricht fast immer dem void-Typ des Compilers.
CHAR Meistens ein Standard-8-Bit-Zeichentyp.

Zusätzliche Datentypen werden innerhalb der Azure RTOS NetX-Quelle verwendet. Sie befinden sich entweder in den Dateien tx_port.h oder nx_port.h .

Kundensupportcenter

Reichen Sie mit den vorliegenden Schritten ein Supportticket über das Azure-Portal ein, wenn Sie Fragen haben oder Hilfe benötigen. Geben Sie die folgenden Informationen in einer E-Mail-Nachricht an uns an, damit wir Ihre Supportanfrage effizienter bearbeiten können:

  1. Eine detaillierte Beschreibung des Problems, einschließlich der Häufigkeit des Auftretens und ob es zuverlässig reproduziert werden kann.

  2. Eine detaillierte Beschreibung aller Änderungen an der Anwendung und/oder an Azure RTOS NetX, die dem Problem vorausgingen.

  3. Der Inhalt der Zeichenfolgen _tx_version_id und _nx_version_id in den Dateien tx_port.h und nx_port.h Ihrer Distribution. Diese Zeichenfolgen liefern uns wertvolle Informationen zu Ihrer Laufzeitumgebung.

  4. Die Inhalte im RAM der folgenden ULONG-Variablen:

    _tx_build_options

    _nx_system_build_options1

    _nx_system_build_options2

    _nx_system_build_options3

    _nx_system_build_options4

    _nx_system_build_options5

    Diese Variablen liefern uns Informationen darüber, wie Ihre Azure RTOS ThreadX- und Azure RTOS NetX-Bibliotheken erstellt wurden.

  5. Ein Ablaufverfolgungspuffer, der unmittelbar nach der Erkennung des Problems aufgezeichnet wurde. Dies wird erreicht, wenn die Azure RTOS ThreadX- und Azure RTOS NetX-Bibliotheken mit TX_ENABLE_EVENT_TRACE erstellt werden und tx_trace_enable mit den Ablaufverfolgungspufferinformationen aufgerufen wird. Einzelheiten hierzu finden Sie im Benutzerhandbuch für Azure RTOS TraceX.