Поделиться через

Справочник по XML-схеме конфигурации эмулятора устройства

  • Статья

Обновлен: Ноябрь 2007

Файлы конфигурации эмулятора устройства (DECFG) — это XML-файлы, которые содержат параметры, определяющие запуск эмулятора устройства. В файле DECFG можно настроить такие параметры, как образ операционной системы, обложки, разрешение жидкокристаллического экрана, а также параметры сети. Общие сведения см. в разделе Файлы конфигурации эмулятора устройства. Используйте следующий пример в качестве руководства по созданию файлов DECFG.

Код

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

Примечания

В следующей таблице описан каждый элемент из предыдущего примера кода.

Элемент

Описание

<DeviceEmulator> tag

Инкапсулирует схему конфигурации эмулятора устройства. В каждом файле DECFG используйте только один тег. Содержит приведенные ниже теги:

  • Platform

  • Emulator

  • Board

  • Peripherals

<Platform>My Plaform</Platform>

Содержит имя платформы. Используйте только один тег <Platform> в каждом теге <DeviceEmulator>. Эмуляторы, отображаемые в диспетчере эмуляторов устройств, упорядочены по значению, указанному в теге платформы.

<Emulator> tag

Содержит приведенные ниже теги:

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

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

Указывает язык пользовательского интерфейса, значение которого выражается четырехзначным десятичным числом. Например, 1033 представляет "Английский, США".

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

Поддерживает положение окна эмулятора поверх других окон, даже если это окно не имеет фокуса. Может иметь значение true либо false. Значение по умолчанию: false.

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

Создает и показывает окно консоли для отображения выходных данных с последовательного порта отладки Windows CE, в который передаются нажатия клавиш пользователем. Это полезно для отслеживания выходных данных отладки и загрузки образов ядра из Platform Builder. Может иметь значение true либо false. Значение по умолчанию: false.

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

Указывает управляющую клавишу, не зависящее от регистра значение которой может быть None, Left-Alt или Right-Alt.

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

Поворачивает экран по часовой стрелке на градусы, которые могут быть равны 0, 90, 180 или 270. Другие целочисленные значения приемлемы, однако они округляются до ближайших 90 градусов.

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

Указывает идентификатор VMID GUID для сопоставления с текущим экземпляром эмулятора.

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

Указывает заголовок окна. Если этот тег отсутствует, окно получит название по тегу обложки или по стандартному имени "Эмулятор устройства".

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

Включает поддержку сохранения состояния, где значением является имя файла сохранения состояния. В файле DECFG должен быть указан тег SaveState или тег OSImage. Обратите внимание на следующие отличительные черты тега SaveState:

  • При отсутствии тега SaveState и одновременном присутствии тега OSImage эмулятор загружается с учетом значения OSimage и при отключенном сохранении состояния.

  • Если присутствуют теги SaveState и OSImage, эмулятор загружается с учетом значения тега OSimage, при выходе включается сохранение состояния, которое сохраняется в указанный файл.

  • При наличии тега SaveState и отсутствии тега OSImage эмулятор восстанавливается из указанного файла сохранения состояния. При выходе из эмулятора происходит перезапись файла сохранения состояния посредством сохранения нового состояния.

    Bb531167.alert_note(ru-ru,VS.90).gifПримечание.
    В этом примере тег SaveState не используется, так как в файле DECFG не могут одновременно использоваться тегами SaveStateи defaultsave.

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

Если значение равно true, эмулятор устройства использует VMID в качестве имени файла сохранения состояния и помещает файл сохранения состояния в каталог пользователя. Может иметь значение true либо false.

Bb531167.alert_note(ru-ru,VS.90).gifПримечание.
Нельзя одновременно указывать в одном DECFG-файле теги SaveStateи defaultsave.

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

Масштабирует экран (как обложку, так и ЖК-дисплей) до двукратного увеличения обычных размеров. Может иметь значение true либо false.

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

Указывает размер экрана и глубину цвета жидкокристаллического дисплея, где атрибуты width, height и BitsPerPixel являются целыми числами.

Bb531167.alert_note(ru-ru,VS.90).gifПримечание.
Нельзя одновременно указывать в одном DECFG-файле теги Skin и Video.

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

Это специальный тег, значение которого, как правило, равно 193. Значение 193 служит для сопоставления функциональных клавиш (F1, F2 и т. д.) с программируемыми клавишами эмулятора устройства).

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

Загружает указанный файл обложки.

Bb531167.alert_note(ru-ru,VS.90).gifПримечание.
В этом примере тег Skin закомментирован, так как в DECFG-файле нельзя одновременно указывать теги Skin и Video.

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

Указывает путь и имя файла (BIN или NB0) используемого эмулятором OSimage. Этот тег необходим в том случае, если используется тег SaveState.

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

Включает эмуляцию флэш-памяти, где используемое значение обозначает имя файла, который будет использоваться в качестве места хранения флэш-памяти.

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

Задает размер эмулируемого ОЗУ, где значение указывается в мегабайтах. Допустимые значения — от 64 до 256 включительно. Если допустимое значение не указано, используется размер ОЗУ по умолчанию, то есть 64.

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

Указывает эмулируемую архитектуру ЦП. Может иметь значения ARMv4 или ARMv5. Значение по умолчанию: ARMv4.

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

Указывает комбинацию (T)humb, (D)ebug, (I)nternetworking, (M)Long Multiply, (e)DSP. Из них T, D и I всегда будут заданы.

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

Указывает наличие сопроцессора для вектора вычислений с плавающей запятой. Может иметь значение true либо false. По умолчанию используется значение false.

<Peripherals> tag

Содержит приведенные ниже теги:

  • Battery

  • SharedFolder

  • CS8900_Networking

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • SerialPort

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

Указывает уровень заряда батареи и источник питания. Атрибут IsOnAcPower указывает на то, работает ли эмулятор от батареи или от сети. При работе от батареи атрибут charge служит для указания процентного соотношения заряда. По умолчанию указано питание от сети.

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

Подключает каталог как общую папку, где значением является каталог Windows. Каталог подключается как карта памяти.

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

Включает сетевой адаптер CS8900, где дополнительным значением является двенадцатизначный шестнадцатеричный MAC-адрес, указывающий адаптер рабочей станции, к которому следует выполнить привязку.

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

Включает сетевой адаптер NE2000 PCMCIA, где дополнительным значением является двенадцатизначный шестнадцатеричный MAC-адрес, указывающий адаптер рабочей станции, к которому следует выполнить привязку.

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

Задает маршрутизацию сетевых пакетов только в пределах самого узла. Влияет на обе сетевые карты: CS8900 и NE2000. Может иметь значение true либо false. Значение по умолчанию: false.

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

  • Указывает на наличие микрофона с громкоговорителем, головного телефона и автомобильного комплекта.

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

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

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

Сопоставляет последовательный порт эмулятора с COM-портом Windows. Атрибут UARTNumber указывает номер порта (0-2) эмулятора. Это значение определяет COM-порт на рабочей станции. Этот тег может использоваться в файле DECFG не более трех раз, по одному разу для каждого из трех последовательных портов эмулятора.

Reconfigurable="true"

Указывает, что функциональная возможность, связанная с этим тегом, может быть перенастроена во время работы эмулятора. Эта функциональная возможность может быть перенастроена без завершения работы и повторного запуска эмулятора. Можно перенастроить следующие теги:

  • AlwaysOnTop

  • HostKey

  • Rotation

  • VMName

  • Zoom

  • FuncKey

  • Skin

  • Battery

  • SharedFolder

  • NE2000_Networking

  • HostOnly

  • Speakerphone

  • Serialport

Reconfigurable="false"

Указывает, что функциональная возможность, связанная с этим тегом, не может быть перенастроена во время работы эмулятора. Эта функциональная возможность должна быть определена во время запуска эмулятора. Невозможно перенастроить следующие теги:

  • Language

  • ConsoleWindow

  • VMID

  • SaveState

  • DefaultSave

  • Video

  • OSImage

  • Flash

  • MemSize

  • CpuCore

  • CpuOptions

  • VFP

  • CS8900_Networking

См. также

Основные понятия

Файлы конфигурации эмулятора устройства

Диспетчер эмуляторов устройств

Ссылки

Справочник по командной строке эмулятора устройства