![]() |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Microsoft Corporation
April 2000
Summary:Microsoft Windows CE Platform Builder includes eight sample operating system (OS) configurations as well as a special dial-up boot loader configuration. This white paper contains a description of the configuration features and components for each sample OS. (27 printed pages)
Contents
Introduction
Microsoft Windows CE Platform Builder includes eight sample
operating system (OS) configurations as well as a special dial-up
boot loader configuration. Each of these configurations has been
rigorously tested to ensure that it contains all the components
needed to build and function properly. This white paper contains a description of the configuration
features and components for each sample OS. All platforms created
in Platform Builder are based on one of the following OS
configurations:
The dial-up boot loader configuration is described below:
For a complete list of the modules and components included in a
specific configuration, see the Cesysgen.bat file located in
%_PROJECTOAKROOT%\Misc. The following table shows the Minkern configuration's
features. Minkern builds a minimal version of Windows CE that features
only the core OS and the Hello World sample application, Hello.exe.
A release configuration of Minkern, with the environment variable
WINCEDEBUG set to retail, presents the text Hello World! to the
debug serial port. A debug configuration with the environment
variable WINCEDEBUG set to debug, presents the same message to the
debug serial port along with debug zone information. To properly
run this sample, enter "
s hello" in the Windows CE Debug Shell window. Minkern uses environment variables to set the driver
configurations. These variables are used in various sources files
and in the Platform.bib and Platform.reg files, both of which are
located in the %_PLATFORMROOT%\%_TGTPLAT%\Files directory. Minkern
cannot support drivers. It sets the variables in the following
table to exclude unsupported modules from the OS image. To configure Minkern for your Windows CE project, use the sample
environment variables provided in the Cesysgen.bat file. The
following table shows the Minkern configuration's environment
variables. The following table shows the Mininput configuration's
features. Mininput builds a minimal version of Windows CE that features
user input device driver support, such as the keyboard. Mininput
also supports the sample code included with Platform Builder for
supporting a keyboard, battery, and notification LED. Mininput
includes a sample application, Kbdmsg.exe, which accepts keyboard
input and displays the appropriate key codes to the debug serial
port. Mininput uses environment variables to set the driver
configurations. These variables are used in various sources files
and in the Platform.bib and Platform.reg files, both of which are
located in the %_PLATFORMROOT%\%_TGTPLAT%\Files directory. The
Mininput configuration does not support generic device driver
support but does support drivers loaded by the GWES system module.
The following table shows the default settings used to include the
supported platform drivers for this configuration. To configure Mininput for your project, use the sample
environment variables provided in the Cesysgen.bat file. The
following table shows the Mininput configuration's environment
variables. The following table shows the Mincomm configuration's
features. Mincomm builds a minimal version of Windows CE that features
serial communications and networking. A sample communications
application, Rasdemo.exe, creates a phone-book entry on the target
device and attempts to connect with the specified RAS server.
Mincomm requires either the IRComm, Irdastk, and Serial components;
and, if TCP is included, then either NDIS or PPP is required. For a
list of communication component dependencies, see the Mincomm text
document in %_PUBLICROOT%\Mincomm\Oak\Misc. Mincomm uses environment variables to set the driver
configurations. These variables are used in various sources files
and in the Platform.bib and Platform.reg files, both of which are
located in the %_PLATFORMROOT%\%_TGTPLAT%\Files directory. The
following table shows the default settings for the environment
variables that set the driver configuration for Mincomm. To configure Mincomm for your project, use the sample
environment variables provided in the Cesysgen.bat file. The
following table shows the Mincomm configuration's environment
variables. The following table shows the Mingdi configuration's
features. Mingdi builds a minimal version of Windows CE that features GDI
support. One sample application, Text.exe, tests the graphic output
of the target device. Mingdi uses environment variables to set the driver
configurations. These variables are used in various sources files
and in the Platform.bib and Platform.reg files, both of which are
located in the %_PLATFORMROOT%\%_TGTPLAT%\Files directory. The
following table shows the default settings for the environment
variables that set the driver configuration for Mingdi.
Minkern
Mininput
Mincomm
Mingdi
Minwmgr
Minshell
Maxall
IESample
DUB
Introduction
Minkern
Functional area
Features
Kernel/OAL
Memory, process, management
CoreDLL
Generic national language support (NLS)
Functional area
Features
Local heap and memory allocation
File system
ROM-based or RAM/ROM-based file system
Database
System registry
Password support
File Management
FormatMessage API support
Debugging
Debug shell (Shell.exe) and ToolHelp
(ToolHelp.dll)
Variable
Default setting (set or not set)
ODO_NOSERIAL
Set, which excludes the serial driver
configuration
ODO_NOAUDIO
Set, which excludes the wavedev driver
configuration
ODO_NOKEYBD
Set, which excludes the keyboard driver
configuration
ODO_NONLED
Set, which excludes the notification LED driver
configuration
ODO_NODISPLAY
Set, which excludes the display driver
configuration
ODO_NOTOUCH
Set, which excludes the touch screen driver
configuration
ODO_NOPCMCIA
Set, which excludes the PC Card driver
configuration
ODO_NOBATTERY
Set, which excludes the battery driver
configuration
ODO_NOGWES
Set, which defines GWES macros
Variable
Description
MINKERN_NOFMTMSG
Removes or includes the FormatMessage application
programming interface (API) function
MINKERN_NODATABASE
Removes or includes database support
MINKERN_NOPASSWORD
Removes or includes password support
MINKERN_NOTOOLHELP
Removes or includes the ToolHelp component
MINKERN_NORAMFS
Removes or includes a RAM-based file system
component
VARIATION1
Removes or includes database, password, and
ToolHelp support
VARIATION2
Removes or includes database, password, ToolHelp,
and RAM/ROM-based file system support
CE_INCLUDE_CEF
Add or removed the Common Executable File format
component.
Mininput
Functional area
Features
Kernel/OAL
Memory, process, management
CoreDLL
NLS for the United States only
Local heap and memory allocation
File system
ROM-only file system
System registry
Password support
File management
GWES
Messaging and user input support
Power management
Notification LED support
Minimal Windowing support (hidden windows)
User notifications API support (customizable)
Native device drivers
Display
Keyboard, sample
Battery, sample
Notification LED, sample
Debugging
Shell.exe and ToolHelp.dll
Variable
Default setting (set or not set)
ODO_NOSERIAL
Set, which excludes the serial driver
configuration
ODO_NOAUDIO
Set, which excludes the wavedev driver
configuration
ODO_NOKEYBD
Not set, which includes the keyboard driver
configuration
ODO_NONLED
Set, which excludes the notification LED driver
configuration
ODO_NODISPLAY
Set, which excludes the display driver
configuration
ODO_NOTOUCH
Not set, which includes the touch screen driver
configuration
ODO_NOPCMCIA
Set, which excludes the PC Card driver
configuration
ODO_NOBATTERY
Set, which excludes the battery driver
configuration
ODO_NOGWES
Not set, which is used in the sources file in
%_PLATFORMROOT%\%_TGTPLAT%\Gwe to define GWES macros
Variable
Description
MININPUT_NOIDLE
Removes or includes an idle component. By default,
this component is removed for the Windows CE PC-based hardware
development platform (CEPC).
MININPUT_NOPOWER
Removes or includes a power management component.
By default, this component is removed for the CEPC.
MININPUT_NONLED
Removes or includes an LED component. By default,
this component is removed for the CEPC.
MININPUT_NOTIFY
Removes or includes user notifications API
support.
VARIATION1
Removes or includes battery, idle state, power
management, and notification LED support.
CE_INCLUDE_CEF
Add or removes the Common Executable File format
component.
Mincomm
Functional area
Features
Kernel/OAL
Memory, process, management
CoreDLL
Generic NLS or USA specific NLS
Functional area
Features
Local heap and memory allocation
Serial port device driver thunks
Communications support for serial communications
and Telephony API (TAPI)
Crypto 1.0 APIs with two cryptographic service
providers (CSPs): Rsabase.dll (40-bit) and Rsaenh.dll
(128-bit)
File system
RAM/ROM-only file system
System registry
File management
Password
Database
Device Manager
Generic device driver support
PC Card support
GWES
Messaging and user input support
Network UI dialog boxes
Minimal messaging, user, and windowing support
User notifications API support (customizable)
Communications: Serial
Basic serial communications support
Infrared (IR) support
PC Card support
Communications: Networking
Winsock APIs
Schannel with Server Gated Cryptographic (SGC)
support, and SCHNLUSA (128-bit)
TCP/IP and IR
Network Driver Interface Specification (NDIS) for
local area networks (LANs)
Dynamic Host Configuration Protocol (DHCP)
Serial Line Internet Protocol (SLIP) and
Point-to-Point Protocol (PPP)
Remote Access Service (RAS)
WNet/Server Message Block (SMB) redirector
Communications: Other
TAPI
Customizable Network UI
IP configuration tool
IPHelper APIs
NTLM
Secure sockets
MSMQ
Functional area
Features
Sample network drivers: NDIS
Management
SNMP server
SNMP MIDs
COM/OLE/DCOM
Component Object Model (COM), OLE, OLE Automation,
Istorage support, or DCOM support
Stream interface drivers
Unimodem
Serial, sample: IrComm
PC Card, sample
Servers
HTTP
Debugging
Shell.exe and ToolHelp.dll
Note The SNMP module contains
the APIs that are required to support the Simple Network Management
Protocol (SNMP). To implement SNMP in a Windows CE-based platform,
you must include the PPP module in the platform OS
configuration.
Variable
Default setting (set or not set)
ODO_NOSERIAL
Not set, which includes the serial driver
configuration
ODO_NOAUDIO
Set, which excludes the wavedev driver
configuration
ODO_NOKEYBD
Set, which excludes the keyboard driver
configuration
ODO_NONLED
Set, which excludes the notification LED driver
configuration
ODO_NODISPLAY
Set, which excludes the display driver
configuration
ODO_NOTOUCH
Set, which excludes the touch screen driver
configuration
ODO_NOPCMCIA
Not set, which includes the PC Card driver
configuration
ODO_NOBATTERY
Set, which excludes the battery driver
configuration
Variable
Default setting (set or not set)
ODO_NOGWES
Not set, which is used in sources file in
%_TGTPLAT%\Gwe to define GWES macro definitions
ODO_NOMOUSE
Set, which is used in the sources file in
%_PLATFORMROOT%\Cepc\Drivers\Mouse\Sermouse to define macro
definitions
Variable
Description
MINCOMM_DCOM
Includes DCOM support and full COM support. Note:
this variable requires MINCOMM_OLE.
MINCOMM_NOPPP
Removes or includes a PPP component. Requires
TCP/IP, Serdev, and TAPI components. Unimodem component is
optional.
MINCOMM_NOSERDEV
Removes or includes a serial driver component.
MINCOMM_NOTAPI
Removes or includes a telephony component.
MINCOMM_NONDIS
Removes or includes an NDIS component. Requires a
TCP/IP component.
MINCOMM_NOTCP
Removes or includes a TCP/IP component. Requires
either a PPP or an NDIS component.
MINCOMM_NOIRCOMM
Removes or includes an infrared communications
component. Requires an IR component.
MINCOMM_NOIRDA
Removes or includes an IR component. Requires the
Serdev component.
MINCOMM_NOMODEM
Removes or includes a Unimodem component. Requires
a PC Card component.
MINCOMM_NOPCMCIA
Removes or includes a PC Card driver
component.
MINCOMM_NOSECURE
Removes or includes a security component.
MINCOMM_NONETUI
Removes or includes a Network UI component. Default
set for 1, which excludes the Network UI.
MINCOMM_NOREDIR
Removes or includes a network redirector
component.
VARIATION1
Removes or includes PPP, TCP, NDIS, TAPI, Unimodem,
network redirector, WinInet, FTP, security, PC Card driver, and
Network UI support.
MINCOMM_OLE
Removes or includes COM, OLE, OLE Automation, and
Istorage support.
MINCOMM_NOTIFY
Removes or includes user notifications API
support.
MINCOMM_NORASDEMO
Removes or includes Rasdemo.exe.
CE_INCLUDE_CEF
Adds or removes the Common Executable F format
component.
MINCOMM_LOCUSA
Removes or includes support for the USA-specific
NLS files.
Variable
Description
MINCOMM_NOPASSWORD
Removes or includes the password components.
MINCOMM_NOSNMP
Removes or includes support for the SNMP
component.
MINCOMM_MSMQ
Removes or includes MSMQ.
MINCOMM_SERVERS
Removes or includes support the HTTP server.
Mingdi
Functional area
Features
Kernel/OAL
Memory, process, management
CoreDLL
Generic NLS
Local heap and memory allocation
File system
RAM/ROM-only file system and file management
Database
System registry
Password support
GWES
Messaging, user, and windowing support
Power management
Notification LED support
User notifications API support (customizable)
GDI support, including TrueType or raster fonts,
text drawing, palette, and printing support
Customizable Touch Screen Calibration UI
Native device drivers
Display
Keyboard, sample
Battery, sample
Notification LED, sample
Debugging
Shell.exe and ToolHelp.dll