다음을 통해 공유


장치 에뮬레이터 구성 XML 스키마 참조

업데이트: 2007년 11월

장치 에뮬레이터 구성 파일(.decfg)은 장치 에뮬레이터를 시작하는 방법을 결정하는 설정이 들어 있는 XML 파일입니다. .decfg 파일에서 운영 체제 이미지, 스킨, LCD 화면 해상도, 네트워킹 등과 같은 설정을 구성할 수 있습니다. 일반적인 내용은 장치 에뮬레이터 구성 파일을 참조하십시오. .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>

플랫폼 이름을 포함합니다. <DeviceEmulator> 태그당 <Platform> 태그를 하나만 사용하십시오. 장치 에뮬레이터 관리자에 표시되는 에뮬레이터는 플랫폼 태그의 값으로 구성됩니다.

<Emulator> tag

다음과 같은 태그를 포함합니다.

  • Language

  • AlwaysOnTop

  • ConsoleWindow

  • HostKey

  • Rotation

  • VMID

  • VMName

  • SaveState

  • DefaultSave

  • Zoom

  • Video

  • FuncKey

  • Skin

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

UI(사용자 인터페이스) 언어를 지정합니다. 여기서 값은 네 자리로 된 10진수입니다. 예를 들어, 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 태그가 없으면 에뮬레이터가 지정된 상태 저장 파일에서 복원합니다. 또한 에뮬레이터가 종료될 때 새로운 상태를 저장하여 상태 저장 파일을 덮어씁니다.

    참고:

    이 예제에서는 .decfg 파일이 SaveState및 defaultsave태그를 동시에 지정할 수 없으므로 SaveState 태그가 주석 처리되어 있습니다.

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

값이 true이면 장치 에뮬레이터에서 상태 저장 파일 이름으로 VMID를 사용하고 상태 저장 파일을 사용자별 디렉터리에 저장합니다. true 또는 false일 수 있습니다.

참고:

동일한 .decfg 파일에 SaveState태그와 defaultsave태그를 모두 지정할 수 없습니다.

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

화면(스킨과 LCD 창 모두)을 보통 크기의 2배로 확대합니다. true 또는 false일 수 있습니다.

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

LCD 창의 화면 크기와 비트 수준을 지정합니다. 여기서 width, height 및 BitsPerPixel 특성은 정수입니다.

참고:

동일한 .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>-->

지정된 스킨 파일을 로드합니다.

참고:

이 예제에서는 .decfg 파일이 Skin 및 Video 태그를 동시에 지정할 수 없으므로 Skin 태그가 주석 처리되어 있습니다.

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

에뮬레이터에서 사용할 OSimage의 경로 및 파일 이름(*.bin 또는 *.nb0)을 지정합니다. SaveState 태그가 없는 경우 이 태그가 필요합니다.

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

플래시 메모리 에뮬레이션을 사용합니다. 여기서 값은 플래시 메모리 저장소로 사용할 파일의 이름을 지정합니다.

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

에뮬레이트된 RAM 크기를 설정합니다. 여기서 값은 MB 단위입니다. 유효한 값은 64부터 256까지입니다. 유효한 값을 지정하지 않으면 RAM 크기는 기본값인 64로 설정됩니다.

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

에뮬레이트할 CPU 아키텍처를 지정합니다. 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 특성은 에뮬레이터가 배터리로 실행되는지 AC 전원으로 실행되는지를 지정합니다. 배터리 전원인 경우 charge 특성은 충전 상태를 백분율로 지정합니다. 기본값은 AC 전원입니다.

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

디렉터리를 공유 폴더로 탑재합니다. 여기서 값은 Windows 디렉터리입니다. 디렉터리는 저장소 카드인 것처럼 탑재됩니다.

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

CS8900 네트워크 어댑터를 사용합니다. 여기서 선택 사항인 값은 데스크톱 컴퓨터가 바인딩될 호스트 어댑터를 지정하는 12자리 16진수 MAC 주소입니다.

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

NE2000 PCMCIA 네트워크 어댑터를 사용합니다. 여기서 선택 사항인 값은 데스크톱 컴퓨터가 바인딩될 호스트 어댑터를 지정하는 12자리 16진수 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>

에뮬레이터 직렬 포트를 Windows COM 포트에 매핑합니다. UARTNumber 특성은 에뮬레이터의 포트 번호 0-2를 나타냅니다. 이 값은 데스크톱 컴퓨터의 COM 포트를 지정합니다. .decfg 파일에서는 이 태그를 최대 3번까지 사용할 수 있으며, 각 태그는 에뮬레이터에 있는 직렬 포트 세 개 중 하나를 나타냅니다.

Reconfigurable="true"

장치 에뮬레이터가 실행 중인 동안에는 이 태그와 연결된 기능을 다시 구성할 수 있다는 것을 나타냅니다. 즉, 에뮬레이터를 종료한 후 다시 시작하지 않고도 기능을 다시 구성할 수 있습니다. 다음 태그를 다시 구성할 수 있습니다.

  • AlwaysOnTop

  • postKey

  • 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

참고 항목

개념

장치 에뮬레이터 구성 파일

장치 에뮬레이터 관리자

참조

장치 에뮬레이터 명령줄 참조