Freigeben über

XML-Schemareferenz für Geräteemulatorkonfigurationen

  • Artikel

Aktualisiert: November 2007

Geräteemulator-Konfigurationsdateien (.decfg) sind XML-Dateien mit Einstellungen, in denen festgelegt wird, wie der Geräteemulator gestartet wird. Sie können Einstellungen wie Betriebssystemabbild, Designs, LCD-Bildschirmauflösung sowie Netzwerkeinstellungen in einer DECFG-Datei konfigurieren. Allgemeine Informationen finden Sie unter Geräteemulator-Konfigurationsdateien. Verwenden Sie das folgende Beispiel als Referenz zum Erstellen von DECFG-Dateien.

Code

<?xml version="1.0"?>
<DeviceEmulator xmlns="https://schemas.microsoft.com/DeviceEmulator/2006/01/DeCfg">
  <Platform>My Plaform</Platform>
  <Emulator>
    <Language Reconfigurable="false">1033</Language>
    <AlwaysOnTop Reconfigurable="true">true</AlwaysOnTop>
    <ConsoleWindow Reconfigurable="false">true</ConsoleWindow>
    <HostKey Reconfigurable="true">Left-Alt</HostKey>
    <Rotation Reconfigurable="true">270</Rotation>
    <VMID Reconfigurable="false">{B89C49AD-197F-4CB4-A525-D81D0944EEAF}</VMID>
    <VMName Reconfigurable="true">My Custom Emulator</VMName>
    <!--<SaveState Reconfigurable="false">c:\1.dess</SaveState>-->
    <DefaultSave Reconfigurable="false">true</DefaultSave>
    <Zoom Reconfigurable="true">true</Zoom>
    <Video Reconfigurable="false" Width="640" Height="480" BitsPerPixel="16"/>
    <FuncKey Reconfigurable="true">193</FuncKey>
    <!--<Skin Reconfigurable="true" EnableSkin="true" ToolTips="on">c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\Pocket_pc\Pocket_PC.xml</Skin>-->
  </Emulator>
  <Board>
    <OSImage Reconfigurable="false" Address="0">d:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\0409\PPC_USA.BIN</OSImage>
    <Flash Reconfigurable="false" Enabled="true">c:\Flashfile</Flash>
    <MemSize Reconfigurable="false">256</MemSize>
    <CpuCore Reconfigurable="false">ARMv5</CpuCore>
    <CpuOptions Reconfigurable="false">TDI</CpuOptions>
    <VFP Reconfigurable="false">true</VFP>
  </Board>
  <Peripherals>
    <Battery Reconfigurable="true" IsOnAcPower="false" Charge="40"/>
    <SharedFolder Reconfigurable="true">c:\</SharedFolder>
    <CS8900_Networking Reconfigurable="false" Enabled="true">00001A1A190B</CS8900_Networking>
    <NE2000_Networking Reconfigurable="true" Enable="true">00001A1A190B</NE2000_Networking>
    <HostOnly Reconfigurable="true">true</HostOnly>
    <Speakerphone Reconfigurable="true" CarKit="true" Headset="true" Speakerphone="true"/>
    <SerialPort Reconfigurable="true" UARTNumber="0">COM3</SerialPort>
    <SerialPort Reconfigurable="true" UARTNumber="1">none</SerialPort>
    <SerialPort Reconfigurable="true" UARTNumber="2">none</SerialPort>
  </Peripherals>
</DeviceEmulator>

Hinweise

In der folgenden Tabelle werden die einzelnen Elemente im vorherigen Codebeispiel beschrieben.

Element

Beschreibung

<DeviceEmulator> tag

Kapselt das Schema für eine Geräteemulatorkonfiguration. Verwenden Sie in jeder DECFG-Datei nur ein Tag. Enthält die folgenden Tags:

  • Platform

  • Emulator

  • Board

  • Peripherals

<Platform>My Plaform</Platform>

Enthält den Namen der Plattform. Verwenden Sie nur ein <Platform>-Tag pro <DeviceEmulator>-Tag. Emulatoren, die im Geräteemulator-Manager sichtbar sind, werden im Plattformtag nach Wert organisiert.

<Emulator> tag

Enthält die folgenden Tags:

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

<Language Reconfigurable="false">1033</Language>

Gibt die Sprache der Benutzeroberfläche an. Der Wert entspricht einer vierstelligen Dezimalzahl. 1033 entspricht beispielsweise Englisch (USA).

<AlwaysOnTop Reconfigurable="true">true</AlwaysOnTop>

Fixiert das Emulatorfenster im Vordergrund, auch wenn es nicht im Fokus ist. Kann entweder true oder false lauten. Wird standardmäßig auf false festgelegt.

<ConsoleWindow Reconfigurable="false">true</ConsoleWindow>

Erstellt ein Konsolenfenster mit der Ausgabe vom seriellen Windows CE-Debug-Anschluss, über den Tastatureingaben des Benutzers übertragen werden, und zeigt es an. Diese Methode eignet sich insbesondere für das Beobachten der Debugausgabe und das Herunterladen von Kernelabbildern aus Platform Builder. Kann entweder true oder false lauten. Wird standardmäßig auf false festgelegt.

<HostKey Reconfigurable="true">Left-Alt</HostKey>

Gibt die Hosttaste an, wobei der Wert ohne Beachtung der Groß-/Kleinschreibung None, Left-Alt oder Right-Alt sein kann.

<Rotation Reconfigurable="true">270</Rotation>

Dreht die Anzeige um einen bestimmten Gradwert im Uhrzeigersinn, wobei der Wert für den Winkel 0, 90, 180 oder 270 sein kann. Es sind zwar auch andere ganze Zahlen zulässig, diese werden aber auf den nächsten 90-Grad-Wert abgerundet.

<VMID Reconfigurable="false">{B89C49AD-197F-4CB4-A525-D81D0944EEAF}</VMID>

Gibt die VMID-GUID an, die mit der aktuellen Instanz des Emulators verknüpft werden soll.

<VMName Reconfigurable="true">My Custom Emulator</VMName>

Gibt den Fenstertitel an. Wenn dieses Tag nicht vorhanden ist, wird das Fenster entweder nach dem Designtag benannt oder erhält den Standardnamen Geräteemulator.

<!--<SaveState Reconfigurable="false">c:\1.dess</SaveState>-->

Aktiviert die Unterstützung für den gespeicherten Zustand, wobei der Wert dem Namen der Datei mit dem gespeicherten Zustand entspricht. Eine DECFG-Datei muss entweder das SaveState-Tag oder OSImage-Tag angeben. Beachten Sie die folgenden Eigenheiten des SaveState-Tags:

  • Wenn das SaveState-Tag nicht vorhanden, das OSImage-Tag jedoch vorhanden ist, führt der Emulator einen Kaltstart über den OSimage-Wert aus, und die Zustandsspeicherung ist deaktiviert.

  • Wenn das SaveState-Tag und das OSImage-Tag vorhanden sind, führt der Emulator einen Kaltstart über den Wert des OSimage-Tags aus, aktiviert die Zustandsspeicherung, falls vorhanden, und speichert den Zustand unter dem angegebenen Dateinamen.

  • Wenn das SaveState-Tag vorhanden, das OSImage-Tag jedoch nicht vorhanden ist, führt der Emulator eine Wiederherstellung von der angegebenen Datei mit dem gespeichertem Zustand aus. Wenn der Emulator beendet wird, wird der neue Zustand über der Datei mit dem gespeicherten Zustand gespeichert.

    Hinweis:
    In diesem Beispiel ist das SaveState-Tag auskommentiert, da in einer DECFG-Datei nicht sowohl das SaveState-Tag als auch das defaultsave-Tag. angegeben werden kann.

<DefaultSave Reconfigurable="false">true</DefaultSave>

Wenn der Wert true lautet, verwendet der Geräteemulator die VMID als Namen für die Datei mit dem gespeicherten Zustand und fügt diese Datei in das jeweilige Benutzerverzeichnis ein. Kann entweder true oder false lauten.

Hinweis:
Sowohl das SaveState-Tag als auch das defaultsave-Tag können nicht in derselben DECFG-Datei angegeben werden..

<Zoom Reconfigurable="true">true</Zoom>

Vergrößert die Anzeige (des Designs und des LCD-Fensters) auf das Zweifache der Normalgröße. Kann entweder true oder false lauten.

<Video Reconfigurable="false" Width="640" Height="480" BitsPerPixel="16"/>

Gibt die Bildschirmgröße und die Bittiefe des LCD-Fensters an, wobei die Attribute width, height und BitsPerPixel ganze Zahlen sind.

Hinweis:
Sowohl das Skin-Tag als auch das Video-Tag können nicht in derselben DECFG-Datei angegeben werden.

<FuncKey Reconfigurable="true">193</FuncKey>

Dieses spezielle Tag hat normalerweise den Wert 193. Beim Wert 193 werden die Funktionstasten der Tastatur (F1, F2 usw.) den Bildschirmtasten eines Geräteemulators zugeordnet.

<!--<Skin Reconfigurable="true" EnableSkin="true" ToolTips="on">c:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\Pocket_pc\Pocket_PC.xml</Skin>-->

Lädt die angegebene Designdatei.

Hinweis:
In diesem Beispiel ist das Skin-Tag auskommentiert, da in einer DECFG-Datei sowohl das Skin-Tag als auch das Video-Tag nicht angegeben werden können.

<Board> tag

Enthält die folgenden Tags:

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

<OSImage Reconfigurable="false" Address="0">d:\Program Files\Windows Mobile 5.0 SDK R2\PocketPC\Deviceemulation\0409\PPC_USA.BIN</OSImage>

Gibt den Pfad und Dateinamen (*.bin oder *.nb0) des OSimage an, das der Emulator verwendet. Dieses Tag ist erforderlich, sofern das SaveState-Tag nicht vorhanden ist.

<Flash Reconfigurable="false" Enabled="true">c:\flash.txt</Flash>

Aktiviert die Flashspeicheremulation, wobei der Wert den Namen der Datei angibt, die als Flashspeicher verwendet werden soll.

<MemSize Reconfigurable="false">256</MemSize>

Legt die Größe des emulierten Arbeitsspeichers fest, wobei der Wert in Megabytes angegeben wird. Gültige Werte liegen im Bereich von 64 bis 256. Wenn kein gültiger Wert angegeben wird, wird die RAM-Größe standardmäßig auf 64 festgelegt.

<CpuCore Reconfigurable="false">ARMv5</CpuCore>

Gibt die zu emulierende CPU-Architektur an. Kann ARMv4 oder ARMv5 sein. Wird standardmäßig auf ARMv4 festgelegt.

<CpuOptions Reconfigurable="false">TDI</CpuOptions>

Gibt eine Kombination aus (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP an. Die Optionen T, D und I werden immer festgelegt.

<VFP Reconfigurable="false">true</VFP>

Gibt an, dass ein VFP-Coprozessor (Vector Floating Point) vorhanden ist. Kann entweder true oder false lauten. Übernimmt den Standardwert false.

<Peripherals> tag

Enthält die folgenden Tags:

  • Battery

  • SharedFolder

  • CS8900_Networking

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • SerialPort

<Battery Reconfigurable="true" IsOnAcPower="false" Charge="40"/>

Gibt Akkuleistung und -ladezustand an. Das IsOnAcPower-Attribut gibt an, ob der Emulator im Akku- oder Netzbetrieb läuft. Im Akkubetrieb gibt das charge-Attribut den Ladezustand als Prozentwert an. Wird standardmäßig auf Netzbetrieb festgelegt.

<SharedFolder Reconfigurable="true">c:\</SharedFolder>

Stellt ein Verzeichnis als freigegebenen Ordner bereit, wobei der Wert einem Windows-Verzeichnis entspricht. Das Verzeichnis wird bereitgestellt, als würde es sich um eine Speicherkarte handeln.

<CS8900_Networking Reconfigurable="false" Enabled="true">00001A1A190B</CS8900_Networking>

Aktiviert den CS8900-Netzwerkadapter, wobei der optionale Wert eine zwölfstellige hexadezimale MAC-Adresse ist, die angibt, an welchen Hostadapter auf dem Desktopcomputer gebunden wird.

<NE2000_Networking Reconfigurable="true" Enable="true">00001A1A190B</NE2000_Networking>

Aktiviert den NE2000 PCMCIA-Netzwerkadapter, wobei der optionale Wert eine zwölfstellige hexadezimale MAC-Adresse ist, die angibt, an welchen Hostadapter auf dem Desktopcomputer gebunden wird.

<HostOnly Reconfigurable="true">true</HostOnly>

Legt Nur-Host-Routing für Netzwerkpakete fest. Beeinflusst CS8900- und NE2000-Karten. Kann entweder true oder false lauten. Wird standardmäßig auf false festgelegt.

<Speakerphone Reconfigurable="true" CarKit="true" Headset="true" Speakerphone="true"/>

  • Gibt an, dass ein Freisprechtelefon, Headset und/oder Carkit vorhanden ist.

<SerialPort Reconfigurable="true" UARTNumber="0">COM3</SerialPort>

<SerialPort Reconfigurable="true" UARTNumber="1">COM2</SerialPort>

<SerialPort Reconfigurable="true" UARTNumber="2">none</SerialPort>

Ordnet den seriellen Emulatoranschluss dem COM-Anschluss von Windows zu. Das UARTNumber-Attribut gibt die Anschlussnummer 0-2 auf dem Emulator an. Der Wert gibt den COM-Anschluss auf dem Desktopcomputer an. Dieses Tag kann in einer DECFG-Datei höchstens dreimal verwendet werden, und zwar einmal für jeden der drei seriellen Emulatoranschlüsse.

Reconfigurable="true"

Gibt an, dass das mit diesem Tag verknüpfte Feature neu konfiguriert werden kann, während der Geräteemulator ausgeführt wird. Das Feature kann neu konfiguriert werden, ohne dass der Emulator beendet und neu gestartet werden muss. Die folgenden Tags können neu konfiguriert werden:

  • AlwaysOnTop

  • HostKey

  • Rotation

  • VMName

  • Zoom

  • FuncKey

  • Design

  • Akku

  • SharedFolder

  • NE2000_Networking

  • HostOnly

  • Freisprechtelefon

  • SerialPort

Reconfigurable="false"

Gibt an, dass das mit diesem Tag verknüpfte Feature nicht neu konfiguriert werden kann, während der Geräteemulator ausgeführt wird. Das Feature muss beim Start des Emulators angegeben werden. Die folgenden Tags können nicht neu konfiguriert werden:

  • Language

  • ConsoleWindow

  • VMID

  • SaveState

  • DefaultSave

  • Video

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

  • CS8900_Networking

Siehe auch

Konzepte

Geräteemulator-Konfigurationsdateien

Geräteemulator-Manager

Referenz

Befehlszeilenreferenz zum Geräteemulator