Condividi tramite

Informazioni di riferimento sullo schema XML di configurazione dell'emulatore di dispositivo

  • Articolo

Aggiornamento: novembre 2007

I file di configurazione dell'emulatore di dispositivo, con estensione decfg, sono file XML contenenti le impostazioni che determinano la modalità di avvio dell'emulatore. All'interno di un file con estensione decfg è possibile configurare impostazioni quali l'immagine del sistema operativo, le interfacce, la risoluzione dello schermo LCD e le operazioni di rete. Per informazioni a carattere generale, vedere File di configurazione dell'emulatore di dispositivo. Utilizzare l'esempio riportato di seguito come riferimento per la creazione di file con estensione decfg.

Codice

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

Osservazioni

Nella tabella riportata di seguito vengono descritti i singoli elementi dell'esempio di codice precedente.

Elemento

Descrizione

<DeviceEmulator> tag

Incapsula lo schema per una configurazione dell'emulatore di dispositivo. Utilizzare un solo tag per ciascun file decfg. Contiene i seguenti tag:

  • Platform

  • Emulator

  • Board

  • Peripherals

<Platform>My Plaform</Platform>

Contiene il nome della piattaforma. Utilizzare un solo tag <Platform> per ciascun tag <DeviceEmulator>. Gli emulatori visibili in Gestione emulatori di dispositivo sono organizzati in base al valore nel tag relativo alla piattaforma.

<Emulator> tag

Contiene i seguenti tag:

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

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

Specifica la lingua dell'interfaccia utente (UI), il cui valore è rappresentato da un numero decimale di quattro cifre. Ad esempio, 1033 rappresenta la lingua inglese parlata negli Stati Uniti.

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

Mantiene la finestra dell'emulatore sempre in primo piano, anche quando questa non è attiva. Può essere true o false. Il valore predefinito è false.

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

Crea e visualizza una finestra della console per visualizzare l'output della porta seriale di debug di Windows CE, dove vengono trasmessi i tasti premuti dall'utente. Questa tecnica è utile per controllare l'output del debug e scaricare immagini del kernel da Platform Builder. Può essere true o false. Il valore predefinito è false.

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

Specifica il tasto host, il cui valore che non tiene conto della distinzione tra maiuscole e minuscole può essere None, Left-Alt o Right-Alt.

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

Ruota la visualizzazione in senso orario con un angolo di 0, 90, 180 o 270 gradi. È possibile specificare altri valori interi, che tuttavia verranno arrotondati per difetto al multiplo di 90 più prossimo.

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

Specifica il GUID VMID da associare all'istanza corrente dell'emulatore.

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

Specifica il titolo della finestra. Se questo tag non è presente, la finestra viene denominata in base al tag dell'interfaccia oppure assume il nome predefinito Device Emulator.

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

Attiva il supporto dello stato salvato, il cui valore rappresenta il nome del file dello stato salvato. In un file con estensione decfg deve essere specificato il tag SaveState o OSImage. Di seguito vengono riportate le peculiarità del tag SaveState:

  • Se il tag SaveState non è presente ma è presente il tag OSImage, l'emulatore viene avviato a freddo dal valore del tag OSimage e il supporto dello stato salvato viene disattivato.

  • Se sono presenti sia il tag SaveState sia il tag OSImage, l'emulatore viene avviato a freddo dal valore del tag OSimage, attiva il supporto dello stato salvato alla chiusura e salva lo stato nel nome file specificato.

  • Se il tag SaveState è presente ma non è presente il tag OSImage, l'emulatore utilizza per il ripristino il file dello stato salvato specificato. Alla chiusura dell'emulatore, il nuovo stato viene salvato sovrascrivendo il file dello stato salvato.

    Nota:

    Nell'esempio, il tag SaveState è impostato come commento poiché in un file con estensione decfg non è possibile specificare entrambi i tag SaveStatee defaultsave.

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

Quando il valore è true, l'emulatore di dispositivo utilizza VMID come nome del file dello stato salvato e inserisce tale file nella directory per utente. Può essere true o false.

Nota:

Non è possibile specificare il tag SaveState e il tag defaultsave nello stesso file con estensione decfg.

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

Ingrandisce la visualizzazione (sia dell'interfaccia che della finestra LCD) di due volte rispetto alle dimensioni normali. Può essere true o false.

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

Specifica le dimensioni dello schermo e la profondità in bit della finestra LCD, in cui gli attributi width, height e BitsPerPixel sono numeri interi.

Nota:

Non è possibile specificare il tag Skin e il tag Video nello stesso file con estensione decfg.

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

Si tratta di un tag speciale che ha generalmente un valore di 193. Tale valore consente l'esecuzione del mapping dei tasti funzione della tastiera (F1, F2 e così via) ai tasti softkey di un emulatore di dispositivo.

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

Carica il file di interfaccia specificato.

Nota:

Nell'esempio, il tag Skin è impostato come commento poiché in un file con estensione decfg non è possibile specificare entrambi i tag Skin e Video.

<Board> tag

Contiene i seguenti tag:

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

Specifica il nome e il percorso del file (*.bin o *.nb0) dell'oggetto OSimage utilizzato dall'emulatore. Questo tag è obbligatorio, a meno che non sia presente il tag SaveState.

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

Attiva l'emulazione della memoria flash, in cui il valore specifica il nome del file da utilizzare come archivio della memoria flash.

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

Imposta le dimensioni della RAM emulata, il cui valore è espresso in megabyte. I valori validi sono da 64 a 256 inclusi. Se non viene specificato un valore valido, il valore predefinito è 64.

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

Specifica l'architettura della CPU da emulare. Può essere ARMv4 o ARMv5. Il valore predefinito è ARMv4.

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

Specifica una combinazione di (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Le opzioni T, D, I sono sempre impostate.

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

Specifica la presenza del coprocessore VFP (Vector Floating Point). Può essere true o false. Il valore predefinito è false.

<Peripherals> tag

Contiene i seguenti tag:

  • Battery

  • SharedFolder

  • CS8900_Networking

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • SerialPort

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

Specifica l'alimentazione a batteria e lo stato di carica. L'attributo IsOnAcPower specifica se l'emulatore viene alimentato a batteria o mediante la corrente di rete. In caso di alimentazione a batteria, l'attributo charge indica lo stato di carica come valore percentuale. L'impostazione predefinita è l'alimentazione di rete.

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

Collega una directory come cartella condivisa, il cui valore è una directory di Windows. La directory viene collegata come se si trattasse di una scheda di memoria.

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

Attiva la scheda di rete CS8900, il cui valore facoltativo è un indirizzo MAC esadecimale di dodici cifre che specifica un adattatore host nel computer desktop a cui eseguire l'associazione.

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

Attiva la scheda di rete NE2000 PCMCIA, il cui valore facoltativo è un indirizzo MAC esadecimale di dodici cifre che specifica un adattatore host nel computer desktop a cui eseguire l'associazione.

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

Imposta il routing solo su host per i pacchetti di rete. Interessa le schede CS8900 e NE2000. Può essere true o false. Il valore predefinito è false.

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

  • Specifica la presenza di telefono viva voce, cuffia auricolare e/o kit per auto.

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

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

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

Esegue il mapping della porta seriale dell'emulatore alla porta COM Windows. L'attributo UARTNumber indica il numero di porta da 0 a 2 dell'emulatore. Il valore specifica la porta COM del computer desktop. Il tag può essere utilizzato fino a tre volte all'interno di un file con estensione decfg, una volta per ognuna delle tre porte seriali dell'emulatore.

Reconfigurable="true"

Indica la possibilità di riconfigurare la funzionalità associata a questo tag finché l'emulatore di dispositivo è in esecuzione. La funzionalità può essere riconfigurata senza chiudere e riavviare l'emulatore. Sono riconfigurabili i tag riportati di seguito.

  • AlwaysOnTop

  • HostKey

  • Rotation

  • VMName

  • Zoom

  • FuncKey

  • Skin

  • Battery

  • SharedFolder

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • Serialport

Reconfigurable="false"

Indica l'impossibilità di riconfigurare la funzionalità associata a questo tag finché l'emulatore di dispositivo è in esecuzione. La funzionalità deve essere specificata all'avvio dell'emulatore. Non sono riconfigurabili i tag riportati di seguito.

  • Language

  • ConsoleWindow

  • VMID

  • SaveState

  • DefaultSave

  • Video

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

  • CS8900_Networking

Vedere anche

Concetti

File di configurazione dell'emulatore di dispositivo

Gestione emulatori di dispositivo

Riferimenti

Informazioni di riferimento sulla riga di comando dell'emulatore di dispositivo