Om GUIX-användarhandbok

Den här guiden innehåller omfattande information Azure RTOS GUIX, den högpresterande GUI-produkten från Microsoft. Den är avsedd för inbäddade realtidsutvecklare som är bekanta med grundläggande GUI-begrepp, Azure RTOS ThreadX och programmeringsspråket C.

Organisation

Kapitel 1 – Introduktion till Azure RTOS GUIX

Kapitel 2 – Installation och användning av Azure RTOS GUIX

Kapitel 3 – Funktionell översikt över Azure RTOS GUIX

Kapitel 4 – Beskrivning Azure RTOS GUIX-tjänster

Kapitel 5 – Azure RTOS GUIX-visningsdrivrutiner

Azure RTOS GUIX-exempel

Bilaga A – Azure RTOS GUIX-färgdefinitioner

Bilaga B – Azure RTOS GUIX-färgformat

Bilaga C – Azure RTOS GUIX-widgetformat

Bilaga D – Azure RTOS GUIX-pensel, arbetsyteattribut och toningar

Bilaga E – Azure RTOS GUIX-händelsebeskrivning

Bilaga F – Azure RTOS GUIX RTOS-bindningstjänster

Bilaga G – Azure RTOS GUIX-teckensnittsstruktur

Bilaga H – Azure RTOS GUIX Build-Time Configuration-flaggor

Bilaga I – Azure RTOS GUIX-informationsstrukturer

Guidekonventioner

Italics – Typeface anger boktitlar, betonar viktiga ord och anger variabler.

Boldface – Typeface anger filnamn, nyckelord och betonar dessutom viktiga ord och variabler.

Viktigt

Informationssymboler uppmärksammar viktig eller ytterligare information som kan påverka prestanda eller funktion.

Azure RTOS GUIX-datatyper

Förutom de anpassade Azure RTOS GUIX-kontrollstrukturdatatyperna finns det flera särskilda datatyper som används i Azure RTOS GUIX-tjänstens anropsgränssnitt. Dessa särskilda datatyper mappar direkt till datatyperna i den underliggande C-kompilatorn. Detta görs för att säkerställa portabilitet mellan olika C-kompilatorer. Den exakta implementeringen ärvs från ThreadX och finns i filen tx_port.h som ingår i ThreadX-distributionen.

Följande är en lista över de Azure RTOS GUIX-tjänstens anropsdatatyper och deras associerade betydelser:

UINT Grundläggande heltal utansignering. Den här typen mappas till den mest praktiska osignerade datatypen.
INT Grundläggande heltal som signerats. Den här typen mappas till den mest praktiska signerade datatypen.
ULONG Osignerad lång typ. Den här typen måste ha stöd för 32-bitars osignerade data.
VOID Nästan alltid likvärdigt med kompilatorns void-typ.
GX_CHAR Skriv oftastdefed som kompilerardefinierad teckentyp.
GX_BYTE 8-bitars signerad typ.
GX_UBYTE 8-bitars osignerad typ.
GX_VALUE 16- eller 32-bitars signerad typ. Definieras efter behov för bästa prestanda i målsystemet.
GX_FIXED_VAL Numerisk datatyp med fast punkt.
GX_RESOURCE_ID Osignerad lång typ.
GX_COLOR Osignerad lång typ.
GX_STRING Struktur som GX_CHAR *gx_string_ptr och UINT gx_string_length.
GX_POINT Struktur som gx_point_x och gx_point_y.
GX_RECTANGLE Struktur som gx_rectangle_left, gx_rectangle_top, gx_rectangle_right och gx_rectangle_bottom fält.
GX_GLYPH Struktur som innehåller glyph-mått.
GX_FONT Struktur som innehåller teckensnittsmått.
GX_BRUSH Struktur som innehåller penselmått.
GX_PIXELMAP Struktur som innehåller pixelkarta-mått.

Ytterligare datatyper används i den Azure RTOS GUIX-källan. De finns antingen i filerna tx_port.heller gx_port.h.

Kundtjänst

Skicka en supportbiljett via Azure-portalen för frågor eller hjälp med att följa stegen här. Ange följande information i ett e-postmeddelande så att vi kan lösa din supportbegäran mer effektivt:

  1. En detaljerad beskrivning av problemet, inklusive förekomstfrekvens och huruvida det kan återskapas på ett tillförlitligt sätt.

  2. En detaljerad beskrivning av eventuella ändringar i programmet och/eller Azure RTOS GUIX som föregick problemet.

  3. Innehållet i de _tx_version_id _gx_version_id strängarna som finns i tx_port.h- och gx_port.h-filerna för distributionen. Dessa strängar ger oss värdefull information om din körningsmiljö.

  4. Innehållet i RAM-minnet för följande ULONG-variabler:

    _tx_build_options_gx_system_build_options

    Dessa variabler ger oss information om hur dina Azure RTOS ThreadX- och Azure RTOS GUIX-bibliotek har skapats.

  5. Innehållet i RAM-minnet för följande ULONG-variabler:

    _gx_system_last_error_gx_system_error_count

    Dessa variabler håller reda på interna systemfel i Azure RTOS GUIX. Om _gx_system_error_count är större än en anger du en brytpunkt för funktionen som returneras i _gx_system_error_process-funktionen och anger värdet för _gx_system_last_error i det här läget. Detta ger den första interna Azure RTOS GUIX-systemfel.

  6. En spårningsbuffert avbildas omedelbart efter att problemet har identifierats. Detta åstadkoms genom att Azure RTOS ThreadX- och Azure RTOS GUIX-bibliotek med TX_ENABLE_EVENT_TRACE och anropa tx_trace_enable med spårningsbuffertinformationen.

  7. Det Azure RTOS GUIX Studio-projekt som du använder, om tillämpligt, eller åtminstone ett litet projekt som är tillräckligt för att visa vilken brist du rapporterar.