Compartir a través de

Referencia de esquemas XML para la configuración del emulador de dispositivos

  • Artículo

Actualización: noviembre 2007

Los archivos de configuración del emulador de dispositivos (.decfg) son archivos XML que contienen valores que determinan cómo se inicia el emulador de dispositivos. En un archivo .decfg puede configurar valores como imagen del sistema operativo, máscaras, resolución de la pantalla LCD y conexión de red. Para obtener información general, vea Archivos de configuración del emulador de dispositivos. Use el ejemplo siguiente como referencia para crear archivos .decfg.

Código

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

Comentarios

En la tabla siguiente se describen los elementos del ejemplo de código anterior.

Elemento

Descripción

<DeviceEmulator> tag

Encapsula el esquema para una configuración del emulador de dispositivos. Utilice sólo una etiqueta en cada archivo .decfg. Contiene las siguientes etiquetas:

  • Platform

  • Emulator

  • Board

  • Peripherals

<Platform>My Plaform</Platform>

Contiene el nombre de la plataforma. Use solamente una etiqueta <Platform> por cada etiqueta <DeviceEmulator>. Los emuladores que están visibles en el Administrador de emuladores de dispositivos se organizan por valor en la etiqueta de la plataforma.

<Emulator> tag

Contiene las siguientes etiquetas:

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

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

Especifica el idioma de la interfaz de usuario, donde el valor es un decimal de cuatro dígitos. Por ejemplo, 1033 representa inglés de Estados Unidos.

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

Mantiene la ventana del emulador siempre visible, aunque no tenga el foco. Puede ser true o false. El valor predeterminado es false.

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

Crea y muestra una ventana de consola para mostrar la salida del puerto serie de depuración de Windows CE, donde se transmiten las pulsaciones de tecla del usuario. Esta técnica es útil para examinar los resultados de la depuración y descargar las imágenes del kernel de Platform Builder. Puede ser true o false. El valor predeterminado es false.

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

Especifica la tecla del host, donde el valor, sin distinción entre mayúsculas y minúsculas, puede ser None, Left-Alt o Right-Alt.

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

Gira la presentación en el sentido de las agujas del reloj por grados, donde el valor angular puede ser 0, 90, 180 ó 270. Otros valores enteros son aceptables, pero se redondean al múltiplo de 90 más cercano.

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

Especifica el GUID de VMID que se asociará a la instancia actual del emulador.

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

Especifica el título de la ventana. Si esta etiqueta no está presente, la ventana recibe el nombre de la etiqueta de máscara o el nombre predeterminado, Emulador de dispositivos.

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

Habilita la compatibilidad de estado guardado, donde el valor es el nombre del archivo de estado guardado. Un archivo .decfg debe especificar la etiqueta SaveState u OSImage. Observe las peculiaridades siguientes de la etiqueta SaveState:

  • Si está presente la etiqueta OSImage pero no la etiqueta SaveState, se deshabilitan los arranques en frío del emulador desde el valor de OSimage y el estado guardado.

  • Si las etiquetas SaveState y OSImage están presentes, el emulador se arranca en frío desde el valor de la etiqueta OSimage, se habilita el estado guardado cuando se cierra y se guarda el estado en el nombre de archivo especificado.

  • Si la etiqueta SaveState está presente pero no la etiqueta OSImage, el emulador se restaura a partir del archivo de estado guardado especificado. Cuando el emulador se cierra, sobrescribe el archivo de estado guardado y almacena el nuevo estado.

    Nota:
    En este ejemplo, la etiqueta SaveState se marca como comentario porque un archivo .decfg no puede especificar a la vez las etiquetas SaveStatey defaultsave.

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

Si el valor es true, el emulador de dispositivos usa VMID como nombre del archivo de estado guardado y coloca el archivo de estado guardado en el directorio de cada usuario. Puede ser true o false.

Nota:
No se pueden especificar las etiquetas SaveState y defaultsave en el mismo archivo .decfg.

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

Amplía la presentación (tanto la máscara como la ventana LCD) al doble del tamaño normal. Puede ser true o false.

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

Especifica el tamaño de pantalla y la profundidad de color de la ventana LCD, donde los atributos width, height y BitsPerPixel son valores de tipo Integer.

Nota:
No se pueden especificar las etiquetas Skin y Video en el mismo archivo .decfg.

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

Se trata de una etiqueta especial que normalmente tiene un valor de 193. Este valor asigna las teclas de función (F1, F2, etc.) a las teclas programables de un emulador de dispositivos.

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

Carga el archivo de máscara especificado.

Nota:
En este ejemplo, la etiqueta Skin se marca como comentario porque un archivo .decfg no puede especificar a la vez las etiquetas Skin y Video.

<Board> tag

Contiene las siguientes etiquetas:

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

Especifica la ruta de acceso y el nombre de archivo (*.bin o *.nb0) de la OSimage que el emulador usa. Se requiere esta etiqueta a menos que la etiqueta SaveState esté presente.

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

Habilita la emulación de memoria flash, donde el valor especifica el nombre del archivo que se usará como almacenamiento de la memoria flash.

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

Establece el tamaño de la RAM emulada, donde el valor se expresa en megabytes. Los valores válidos son del 64 al 256, ambos inclusive. Si no se especifica un valor válido, el tamaño de RAM predeterminado es de 64.

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

Especifica la arquitectura de la CPU que se desea emular. Puede ser ARMv4 o ARMv5. El valor predeterminado es ARMv4.

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

Especifica una combinación de (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. De éstos, T, D e I se establecerán siempre.

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

Especifica la presencia del coprocesador de punto flotante vectorial. Puede ser true o false. El valor predeterminado es false.

<Peripherals> tag

Contiene las siguientes etiquetas:

  • Battery

  • SharedFolder

  • CS8900_Networking

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • SerialPort

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

Especifica la corriente y carga de la batería. El atributo IsOnAcPower especifica si el emulador se está ejecutando con alimentación por batería o de corriente alterna. Si funciona con la batería, el atributo charge especifica la carga en forma de porcentaje. Tiene como valor predeterminado alimentación de corriente alterna.

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

Monta un directorio como carpeta compartida, donde el valor es un directorio de Windows. El directorio se monta como si fuera una tarjeta de almacenamiento.

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

Habilita el adaptador de red CS8900, donde el valor opcional es una dirección MAC hexadecimal de doce dígitos que especifica un adaptador de host en el equipo de escritorio al que se va a enlazar.

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

Habilita el adaptador de red NE2000 PCMCIA, donde el valor opcional es una dirección MAC hexadecimal de doce dígitos que especifica un adaptador de host en el equipo de escritorio al que se va a enlazar.

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

Establece el enrutamiento sólo host para paquetes de red. Afecta a las tarjetas CS8900 y NE2000. Puede ser true o false. El valor predeterminado es false.

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

  • Especifica la presencia de altavoz, auriculares con micrófono y/o kit de automóvil.

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

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

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

Asigna el puerto serie del emulador a un puerto COM de Windows. El atributo UARTNumber indica el número de puerto 0-2 en el emulador. El valor especifica el puerto COM en el equipo de escritorio. Esta etiqueta se puede usar hasta tres veces en un archivo .decfg; una por cada uno de los tres puertos serie del emulador.

Reconfigurable="true"

Indica que la característica asociada a esta etiqueta puede configurarse de nuevo, siempre y cuando el emulador de dispositivos esté en ejecución. La característica puede configurarse otra vez sin necesidad de salir y reiniciar el emulador. Las etiquetas siguientes pueden configurarse de nuevo:

  • AlwaysOnTop

  • HostKey

  • Rotation

  • VMName

  • Zoom

  • FuncKey

  • Skin

  • Battery

  • SharedFolder

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • Serialport

Reconfigurable="false"

Indica que la característica asociada a esta etiqueta es no puede configurarse de nuevo mientras el emulador de dispositivos esté en ejecución. La característica debe especificarse durante el inicio del emulador. Las etiquetas siguientes no pueden configurarse de nuevo:

  • Language

  • ConsoleWindow

  • VMID

  • SaveState

  • DefaultSave

  • Video

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

  • CS8900_Networking

Vea también

Conceptos

Archivos de configuración del emulador de dispositivos

Administrador de emuladores de dispositivos

Referencia

Referencia de la línea de comandos del emulador de dispositivos