Référence du schéma XML de configuration de Microsoft Device Emulator

  • Article

Mise à jour : novembre 2007

Les fichiers de configuration de Microsoft Device Emulator (.decfg) sont des fichiers XML contenant des paramètres qui déterminent comment démarre l'émulateur de périphérique. Vous pouvez configurer des paramètres tels que l'image du système d'exploitation, les apparences, la résolution d'écran LCD et la mise en réseau dans un fichier .decfg. Pour obtenir des informations générales, consultez Fichiers de configuration de Microsoft Device Emulator. Utilisez l'exemple suivant comme référence pour créer des fichiers .decfg.

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>

Notes

Le tableau suivant décrit chaque élément de l'exemple de code précédent.

Élément

Description

<DeviceEmulator> tag

Encapsule le schéma pour une configuration d'émulateur de périphérique. Utilisez une seule balise par fichier .decfg. Contient les balises suivantes :

  • Platform

  • Emulator

  • Board

  • Peripherals

<Platform>My Plaform</Platform>

Contient le nom de la plateforme. N'utilisez qu'une seule balise <Platform> par balise <DeviceEmulator>. Les émulateurs qui sont visibles dans le Gestionnaire Device Emulator sont organisés par valeur dans la balise de plateforme.

<Emulator> tag

Contient les balises suivantes :

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

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

Spécifie la langue de l'interface utilisateur, où la valeur est un nombre décimal de quatre chiffres. Par exemple, 1033 représente l'anglais, États-Unis.

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

Permet que la fenêtre de l'émulateur soit toujours visible, même lorsqu'elle n'a pas le focus. Peut être true ou false. La valeur par défaut est false.

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

Crée et affiche une fenêtre de console pour afficher la sortie du port série de débogage Windows CE, où les séquences de touches tapées par l'utilisateur sont transmises. Cette technique est utile pour examiner la sortie de débogage et télécharger les images de noyau à partir de Platform Builder. Peut être true ou false. La valeur par défaut est false.

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

Spécifie la touche de l'hôte, où la valeur (qui ne respecte pas la casse) peut être None, Left-Alt ou Right-Alt.

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

Fait pivoter l'affichage dans le sens des aiguilles d'une montre par degrés, où l'angle peut avoir la valeur 0, 90, 180 ou 270. D'autres valeurs entières sont acceptables mais sont arrondies vers le bas au 90 le plus proche.

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

Spécifie le GUID VMID à associer à l'instance actuelle de l'émulateur.

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

Spécifie le titre de la fenêtre. Si cette balise n'est pas présente, la fenêtre est nommée par la balise d'apparence ou reçoit le nom par défaut, Microsoft Device Emulator.

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

Active la prise en charge de l'état enregistré, où la valeur est le nom du fichier d'état enregistré. Un fichier .decfg doit spécifier la balise SaveState ou OSImage. Notez les spécificités suivantes de la balise SaveState :

  • Si la balise SaveState n'est pas présente mais que la balise OSImage l'est, l'émulateur effectue un démarrage à froid à partir de la valeur de l'OSimage et l'état enregistré est désactivé.

  • Si les balises SaveState et OSImage sont présentes, l'émulateur effectue un démarrage à froid à partir de la valeur de l'OSimage, active l'état enregistré lorsqu'il s'arrête et enregistre l'état dans le fichier dont le nom est spécifié.

  • Si la balise SaveState est présente, mais pas la balise OSImage, l'émulateur effectue la restauration à partir du fichier d'état enregistré spécifié. Lorsque l'émulateur s'arrête, il enregistre le nouvel état en remplaçant le fichier d'état enregistré.

    Remarque :

    Dans cet exemple, la balise SaveState est supprimée parce qu'un fichier .decfg ne peut pas spécifier à la fois les balises SaveState et defaultsave.

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

Lorsque la valeur est true, l'émulateur de périphérique utilise le VMID comme nom du fichier d'état enregistré et place le fichier d'état enregistré dans le répertoire de l'utilisateur. Peut être true ou false.

Remarque :

Vous ne pouvez pas spécifier à la fois les balises SaveState et defaultsave dans le même fichier .decfg.

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

Effectue un zoom de l'affichage (apparence et fenêtre LCD) 2 fois plus grand que la taille normale. Peut être true ou false.

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

Spécifie la dimension d'écran et la profondeur de couleur de la fenêtre LCD, où les attributs width, height et BitsPerPixel sont des entiers.

Remarque :

Vous ne pouvez pas spécifier à la fois les balises Skin et Video dans le même fichier .decfg.

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

Il s'agit d'une balise spéciale ayant habituellement la valeur 193. Cette valeur mappe les touches de fonction du clavier (F1, F2, etc.) aux touches programmables d'un émulateur de périphérique.

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

Charge le fichier d'apparence spécifié.

Remarque :

Dans cet exemple, la balise Skin est supprimée parce qu'un fichier .decfg ne peut pas spécifier à la fois les balises Skin et Video.

<Board> tag

Contient les balises suivantes :

  • 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>

Spécifie le chemin d'accès et le nom de fichier (* .bin ou * .nb0) de l'OSimage utilisée par l'émulateur. Cette balise est requise à moins que la balise SaveState ne soit présente.

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

Active l'émulation de mémoire flash où la valeur spécifie le nom du fichier à utiliser comme stockage de la mémoire flash.

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

Définit la taille de la RAM émulée, où la valeur est en mégaoctets. Les valeurs valides sont comprises entre 64 et 256 inclus. Si une valeur valide n'est pas spécifiée, la taille de la RAM est de 64 par défaut.

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

Spécifie l'architecture du processeur à émuler. Peut être ARMv4 ou ARMv5. La valeur par défaut est ARMv4.

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

Spécifie une combinaison de (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Au nombre desquels, T,D,I sont toujours définis.

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

Spécifie la présence du coprocesseur VFP (Vector Floating Point). Peut être true ou false. La valeur par défaut est false.

<Peripherals> tag

Contient les balises suivantes :

  • Battery

  • SharedFolder

  • CS8900_Networking

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • SerialPort

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

Spécifie l'utilisation et la charge de la batterie. L'attribut IsOnAcPower spécifie si l'émulateur s'exécute sur batterie ou sur secteur. Si la batterie est utilisée, l'attribut charge spécifie la charge sous forme de pourcentage. La valeur par défaut est l'alimentation secteur.

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

Monte un répertoire en tant que dossier partagé, où la valeur est un répertoire Windows. Le répertoire est monté comme s'il s'agissait d'une carte de stockage.

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

Active la carte réseau CS8900, où la valeur facultative est une adresse MAC hexadécimale de douze chiffres qui spécifie un adaptateur hôte sur l'ordinateur de bureau auquel se connecter.

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

Active la carte réseau NE2000 PCMCIA, où la valeur facultative est une adresse MAC hexadécimale de douze chiffres qui spécifie un adaptateur hôte sur l'ordinateur de bureau auquel se connecter.

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

Définit le routage invité uniquement pour les paquets réseau. Affecte les cartes CS8900 et NE2000. Peut être true ou false. La valeur par défaut est false.

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

  • Spécifie la présence d'un haut-parleur, d'un casque et/ou d'un kit de voiture.

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

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

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

Mappe le port série de l'émulateur au port COM Windows. L'attribut UARTNumber indique le numéro de port (0 à 2) sur l'émulateur. La valeur spécifie le port COM de l'ordinateur de bureau. Cette balise peut être utilisée jusqu'à trois fois dans un fichier .decfg, à raison d'un pour chacun des trois ports série de l'émulateur.

Reconfigurable="true"

Indique que la fonctionnalité associée à cette balise est reconfigurable tant que l'émulateur de périphérique est en cours d'exécution. La fonctionnalité peut être reconfigurée sans quitter ni redémarrer l'émulateur. Les balises suivantes peuvent être reconfigurées :

  • AlwaysOnTop

  • HostKey

  • Rotation

  • VMName

  • Zoom

  • Touche de fonction

  • Apparence

  • Batterie

  • SharedFolder

  • NE2000_Networking

  • HostOnly

  • Haut-parleur

  • SerialPort

Reconfigurable="false"

Indique que la fonctionnalité associée à cette balise ne peut pas être reconfigurée tant que l'émulateur de périphérique est en cours d'exécution. La fonctionnalité doit être spécifiée pendant le démarrage de l'émulateur. Les balises suivantes ne peuvent pas être reconfigurées :

  • Langue

  • ConsoleWindow

  • VMID

  • SaveState

  • DefaultSave

  • Vidéo

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

  • CS8900_Networking

Voir aussi

Concepts

Fichiers de configuration de Microsoft Device Emulator

Gestionnaire Device Emulator

Référence

Référence de la ligne de commande Microsoft Device Emulator