advantech ce .net manual

8/11/2019 Advantech CE .NET Manual

1/30

WindowsCE .NET Based

X86 Embedded System

Users Manual


2/30

Imortant Note! "ead Care#ullyThis product is protected by the "End-User License

Agreement"(EULA). Please read it carefully before using theproduct.

Coyri$%t Noti&e

This document is copyrighted !! by Ad#antech $o. Ltd. All

rights are reser#ed. Ad#antech $o. Ltd. reser#es the right to ma%e

impro#ements to the products described in this document at any

time &ithout notice.

'o part of this document may be reproduced copied translated or

transmitted in any form or by any means &ithout the prior &ritten

permission of Ad#antech. nformation pro#ided in this document is

intended to be accurate and reliable. o&e#er Ad#antech assumes

no responsibility for its use nor for any infringements upon the

rights of third parties &hich may result from its use.

*icrosoft and +indo&s are registered trademar%s of *icrosoft

$orporation in the United ,tates andor other countries.

All brand and product names mentioned herein are trademar%s or

registered trademar%s of their respecti#e holders.


3/30

'art Number!


4/30

Table o# Content

Introdu&tion

Installation and Settin$Tutorial ( Usin$ Windows CE .NET

S%ut down t%e system

Tas) Mana$er

Command 'romt *CM+.EXE,

-dante&% "e$istry Edit Utility

'rote&ted "e$istry /eys and 0alues

-dante&% -uto 1aun&% -li&ation Solution

02-

Tou&% s&reen

/eyboard

So#tware /eyboard

Mouse

3ile system and Stora$e

3loy

I+E 4ard +is)53las% +is)5Coma&t3las% +is)

Serial 'orts

'arallel 'ort

Et%ernet

-udio

+i$ital I5

Wat&%do$ timer

USB

Ir+-

Communi&ation 'ro$rams


5/30

-li&ation 'ro$rammin$

Cross +eeloment

4ost and Tar$et+eeloment Tools

Windows CE eMbedded 0isual Tools 7.

9:-

-endi;


6/30

Introdu&tion

*icrosoft

+indo&s $E is a compact highly efficient scalableoperating system that is designed for a broad range of

embedded systems and products. ts multi-threaded multi-

tas%ing fully preempti#e , en#ironment is targeted

specifically to&ard hard&are &ith limited resources. t/s

modular design enables embedded system and application

de#elopers to customi0e it for a #ariety of products such as

industrial controllers and embedded communication de#ices.

Using +indo&s $E de#elopers can le#erage their e1isting

+indo&s-based programming s%ills. +indo&s $E supports

subset of *icrosoft +in2! APs and se#eral additional

programming interfaces.

-dante&%


7/30

.'ET release)

Enhanced ,erial Port 9ri#er

Enhanced Parallel Port 9ri#er

Enhanced P,! mouse 9ri#ernstant n support (ptional)

;ideo $apture ,upport (ptional)


8/30

Installation and Settin$

+indo&s $E is an embedded operating system not a generalpurpose des%top operating system. The +indo&s $E mage

that comes &ith the product is pre-configured for the dedicated

hard&are and settings for on-board de#ices. ,o in most cases

you may not change the related 5,


9/30

System #iles

7ollo&ings are the systems files in the root directory of 7lash

dis%. Please don/t delete it or the system may not boot or&or% normally.

Con#i$uration #ile! boot&e&.&n#

5oot loader needs this file to load image. Please don/t delete

this file or change the default setting.

Boot lo$o .&; #ile! boot&e&.&;

3ou may replace the bootcepc.pc1 &ith your o&n logo file

but the file name must be the same. Please bac%up this file

before using your logo file. The resolution should be

B1BD and color depth should be ! colors.

/ernel Ima$e #ile *n).bin,

This is the +indo&s $E image file. Please don/t delete it or

modify it.

Note! *icrosoft +indo&s $E and Ad#antech soft&are is

protected by copyright la&s. 3ou need to get both *icrosoft and

Ad#antech license to legally utili0e Ad#antech +indo&s $E

releases. Please don/t ma%e any illegal copy.


10/30

Tutorial ( Usin$ Windows CE .NET

S%ut down t%e systemUnli%e other +indo&s perating ,ystems there is a shut do&n

button. The +indo&s $E default shell is designed for and eld

P$ the ,uspend button does not &or% for 1D +indo&s $E

Embedded ,ystem. To shut do&n the 1D +indo&s $E system

you ha#e to close all applications. Then turn off of the po&er

supply or reset the system. Ad#antech has de#eloped the

solution to use the ,uspend button as the restart function.

+hen you push ,uspend button the system &ill close all de#ice

dri#ers and then restart safely.

Tas) Mana$er

Press -lt=Tab %ey to run Tas% *anager

Button des&rition!

Swit&% To8 3ou can use arro& %eys to select the tas%.

End Tas)8 3ou can stop the selected tas%.

Can&el8 E1it Tas% *anager

Command 'romt *CM+.EXE,

The command Prompt pro#ides similar commands as the

9, prompt. 3ou &ill be able to copy delete mo#e and

e1ecute files.

Type 4elfor a list of commands.

,elect StartF 'ro$ramsF Command 'romtor


11/30

Settin$ #or 'ersistent "e$istry

The persistent registry solution needs a persistent storage

(7lash dis% or hard dri#e) to store the bac%up registry

(registry.dat). Please go to control panel and double clic%?:egistry ,ettings@. Gey in the path to store the

registry.dat. E1ample8 Gey in ?H9is%n$hip@ to store

bac%up registry in ?H9is%n$hipHregistry.dat@. f you don/t

complete this setup the system &ill prompt you &hen

system start up e#ery time.

4ow to &%an$e "e$istry settin$s>

C. *odify by $ontrol Panel8 ,ome registry settings can be

modified in $ontrol Panel.

!. *odify by :emote :egistry tool in *icrosoft e*bedded

;isual Tool.

2. *odify by Ad#antech :egistry Edit Utility (re$&edit.e;e)

B. +rite your o&n application to call :egistry related APs

E1ample APs8 :egpenGeyE1 :eg=uery;alueE1

:eg,et;alueE1 and :eg$loseGey.

4ow to ba&)u t%e "e$istry into ersistent stora$e>

-utomati&ly!Ad#antech/s utility &ill bac%up registry if you

use ,uspend button to restart system.

Manually8 3ou may also manually use Ad#antech :egistry

bac%up utility (re$sae.e;e).

The :egistry bac%up file (re$istry.dat)8 3ou may ha#e to

delete this file if you need to update or reinstall a ne&

image (n%.bin).


12/30

-dante&% -uto 1aun&% -li&ation Solution

The default &ay to launch applications during +indo&s $E

booting is to put your applications in a special :egistry %eyand rebuild the +indo&s $E mage. This is too complicated

and not fle1ible for most application de#elopers. To sol#e

this problem Ad#antech has de#eloped the "Auto Launch"

solution. +ith this solution you can let the system run

your applications &ithout rebuilding the +indo&s $E

mage.

C.Io to Control 'anelF "e$istry Settin$s.

!.$lic% ?-uto 1aun&%@

2.$lic% ?New@

B. Add the applications &ith the full path name and

arguments to the list. E1ample8

H+indo&sHcmd.e1e % dir

H+indo&sHp#bload.e1e H9is%n$hipHmy.#b

Note!3ou need to use p#bload.e1e to run ;isual 5asic

programs (.#b files).

-dante&% Memory -d?ust Solution

The +indo&s $E default setting for ,torage *emory and

Program *emory ratio is fi1ed. E#en you can change the

setting ho&e#er the setting &ill go bac% to the default

after resetting the system. 5ecause 1D platform does not

ha#e battery to bac%up the setting in 9:A* also the

setting is not in :egistry so the +indo&s mage has to berebuilt for the ne& setting.

Ad#antech has de#eloped the solution and integrate into

the pre-configured +indo&s $E mage. 3ou only ha#e to

follo& the procedure to change the setting.

C. Io to Control 'anelF System

!. $lic% ?Memory@2. *o#e slider to the left for more memory to run


13/30

programs mo#e slider to the right for more storage

room.

B. :estart the system

02- +islay Settin$

C. Io to Control 'anelF +islay "esolution

!. ,elect the resolution and color depth

2. :estart the system

Note!

C. This utility is only for 7lat display dri#er. This 7lat display

dri#er supports display chips &ith ;E,A !. compatible

;IA 5,. 7or the other display chipdri#er Ad#antech

may de#elop special utility. n this case please refer to

the related document for more details.

!. Please don/t select the resolution and color depth &hich

are not supported by the display chip. 3ou may also

need to update the ;IA 5, to support different

resolution or L$9 type. 7or more details please chec%

the hard&are user manual.

Tou&% s&reen

f the target hard&are does not come &ith the Touch

screen please s%ip this session. Touch screen is a#ailable

as an option on most Panel P$s. 7or the other $PU board

platforms the default pre-configured +indo&s $E mage

does not include Touch screen dri#er and the serial port is

a#ailable for the other de#ice. To add a Touch screen to the

+indo&s $E platform the +indo&s $E mage needs to berebuilt &ith the Touch screen dri#er. The touch screen

calibration utility is in the $ontrol Panel.

Calibration Utility

3ou need to calibrate at least once for each system. ere is

the procedure8

C. :un the calibration utility for the touch screen

!. 7ollo&ing the instruction to calibrate.2. ,a#e the registry.


14/30

B. :eboot the system.


15/30

/eyboard

*ost Embedded applications don/t need a %eyboard. 3ou

may need to connect a standard %eyboard to configureyour Embedded system. After that you may po&er off the

system remo#e the %eyboard and reboot.

So#tware /eyboard

:un sipselect.e1e then there &ill be a ?red pen@ icon on

the right of the shell bar.

To enable soft&are %eyboard you may

C. ,ingle clic% the icon &ait for the pop-up menu then

clic% ?%eyboard@. or

!. 9ouble clic% the icon.

To hide the soft&are %eyboard you may

C. ,ingle clic% the icon &ait for the pop-up menu then

clic% ?ide input panel@. or

!. 9ouble clic% the icon.

Mouse

P,! *ouse is the default +indo&s $E *ouse de#ice. 7or

the fe& platforms that do not support a P,! *ouse a

,erial *ouse &ill be the pointing de#ice. Li%e the %eyboard

the system does not need a mouse for most Embedded

applications.


16/30


17/30

+is)nC%i

The *-,ystems 9is%n$hip dri#er is built into the pre-

configured +indo&s $E mage if the $PU board has

onboard 9is%n$hip soc%et. Please s%ip this session if thetarget hard&are does not ha#e 9is%n$hip soc%et.

'ote8 3ou must not change the memory


18/30

'arallel 'ort

+indo&s $E only comes &ith P$L printer dri#er. *ost P

printers should support P$L. f your printer does notsupport P$L then you ha#e to de#elop the +indo&s $E

printer dri#er.

To test the printer port you may8

C. $onnect a printer and use Ad#antech utility tstlt.e;e

to print a simple plain te1t page.

!. $onnect a P$L compatible printer and use the 5ro&ser

to print out the &eb page.

Et%ernet

Networ) Settin$

f the hard&are you ha#e does not ha#e net&or% chip

please s%ip this session. +indo&s $E needs you to change

the 9e#ice 'ame in the $ontrol Panel before using the

net&or% functions.

Please follo& the procedure belo&8

C. Io to Control 'anel F Communi&ationsProperties.

!. $hange the default "WinCE" to any other name. 3ou

ha#e to select a uniue name in the net&or%.

2. 3ou may change the 'et&or% and T$PP settings at this

time.

(Io to Control 'anelF Networ)) The default P setting

is to obtain an P address #ia 9$P. 3ou may change tostatic P.

B. :un re$sae.e;eto sa#e the :egistry setting.

. :eboot the system.

. 3ou can use netcommand and UNCto access +indo&s

KKD'T!MP share directories and files. o&e#er

+indo&s $E does not support +indo&s KKD'T!MP

to #ie& or access files on +indo&s $E de#ice. 3ou may

de#elop an application such as 7TP applications to help out&ith this solution. .


19/30

Mi&roso#t UNC *Uniersal Namin$ Conention,

To access files on the net&or% you may need U'$. t is

"HH" N,er#er 'ame N "H" N ,hare 'ame. 7or more details please

refer to

*icrosoft document.

net &ommand

The net command is helpful to #ie& or access files on

+indo&s

KKD'T!MP.

The elp information is a#ailable by8 net O

net #ie& computernameF Q 9*A'8 domainnameF

net use Rlocal nameFQS Rremote nameF Ruser8usernameF R

d

E1ample8

net #ie& \\MyServer\MyShareDirectory

cd ?HH*y ,er#erH*y 9ocument@

cd HH*y,er#erH*y,hare9irectory

-udio

f the target hard&are does not support audio function

please s%ip this session.

3ou may go to Control 'anelF 0olume : Soundstocontrol the #olume or change the .+A; file for system

e#ents.
http://smb//MyServer/MyShareDirectoryhttp://smb//MyServer/MyShareDirectory


20/30

-dante&% -udio "e&order Test Utility *re&ord.e;e,

C. $onnect the microphone and spea%er

!.:un record.e1e

2. ,elect sample rate

B. :ecord your sound

. Play the sound

'ote8 f there is any problem please chec% the audio chip

:= and 9*A 5, or hard&are settings are the same

as the :egistry settings. 7or mage si0e consideration it

may be pro#ided in 7loppy $9 rather than +indo&s $E

mage.

+i$ital I5

f the target hard&are does not support 9igital

function please s%ip this session.

3ou may use inp()inp&()outp() and outp&()

functions in your +indo&s $E application to access the

address directly.

-dante&% I5 'ort Test Utility *ioort.e;e,

3ou may use the utility to read and &rite data of ports

and test the digital functions.


21/30

Wat&%do$ timer

f the target hard&are does not support &atchdog timer

function please s%ip this session.

3ou may use inp()inp&()outp() and outp&() function

calls in your +indo&s $E application to access the port

to enabledisable the &atchdog timer. 9ifferent $PU boards

may ha#e different &ays to enabledisable &atchdog timer.

7or more details please refer to hard&are manual.

USB

f the target hard&are does not support U,5 please s%ip

this session.

To enable U,5 please follo& the procedure8

C. Enable U,5 in 5, setting

!. Po&er off the system

2. Po&er on the system

B. Plug in U,5 de#ice li%e U,5 mouse

'ote8

C. The pre-configured +indo&s $E mage only includes

U,5 mouse dri#er.

!. To enable other U,5 de#ice you need the +indo&s $E

dri#er for the U,5 de#ice. n most case U,5 de#ice

#endor doesn/t pro#ide +indo&s $E dri#er. That means

you may ha#e to de#elop the dri#er.


22/30

Ir+- *SI",

f the target hard&are does not support r9A function

please s%ip this session.

Please follo& the procedure to enable r9A8

C. Enable r9A in 5, setting. *a%e sure to select half

duple1 mode.

!. $onnect an r9A Adapter to the $PU board. E1ample8

A$Ti,3, A$T-:!CL (http8&&&.actisys.com)

-dante&% Ir+- 3ile Trans#er Test Utility!

(r9Asnd.e1e and r9Arc#.e1e)

Prepare t&o +indo&s $E Embedded ,ystems &ith r9A

adapters and r9A function is enabled. Transfer file

bet&een t&o +indo&s $E de#ices.

Usage8

r9Asnd.e1e filename

r9Arc#.e1e filename

E1ample8

,ending side8 r9Asnd.e1e send.t1t:ecei#ing side8 r9Arc#.e1e recei#e.t1t

'ote8

+hen you enable the r9A it &ill use one $* port

resource. ,o the $* port &ill not be a#ailable to connect

serial port de#ices.


23/30

Communi&ation 'ro$rams

,elect StartF 'ro$ramsF Communi&ationto run the

programs. The on-line elp information is in StartF 4el.,elect "emote Conne&tions.

"emote Networ)in$ *remnet.e;e,8 ,ee Topics about

?$onnecting to an ,P@ ?$onnection to a 'et&or%@ and

?Ad


24/30

-li&ation 'ro$rammin$

Cross +eeloment7or +indo&s KD'T! application programming the

de#elopment tool li%e ;isual $NN and application can be on

the same P$. ,o de#eloper can de#elop debug and test

application on the same P$. o&e#er this is impossible for

most embedded system de#elopment. 5ecause some

embedded systems are headless (no display %eyboard or

mouse) or the $PU is not po&erful enough to install the

de#elopment tool. $ross de#elopment is the solution. The

cross de#elopment includes a po&erful de#elopment host

target embedded system and the cable connection bet&een

t&o system.

Windows CE -li&ation Cross@+eeloment

Enironment

4ost!P$ &ith de#elopment tools

Tar$et!3our +indo&s $E Embedded ,ystem

Conne&tion!Ethernet or serial port connection


25/30

-li&ation +eeloment Tools

A. 0isual Studio .NET

3ou may purchase *icrosoft ;isual ,tudio .'ET from

*icrosoft online store or *icrosoft local Embedded

distributor.

%tt!55msdn.mi&roso#t.&om5studio5

. Embedded 0isual C== 7.

3ou may purchase *icrosoft Embedded ;isual $NN B.

from *icrosoft online store or *icrosoft local Embedded

distributor. 3ou may also do&nload from the follo&ing

&ebsite.

http8msdn.microsoft.com#studiode#icedo&nload.asp

. 'lat#orm S+/

To de#elop +indo&s $E application for Ad#antech MD

platform you may no& use the standard MD ,9G from

Platform 5uilder B.
http://www.microsoft.com/windows/embedded/ce/tools/emvt30order.asphttp://msdn.microsoft.com/vstudio/device/download.asphttp://msdn.microsoft.com/vstudio/default.asphttp://www.microsoft.com/windows/embedded/ce/tools/emvt30order.asphttp://msdn.microsoft.com/vstudio/device/download.asp


26/30

+eeloment 4ost System "eDuirement

*inimum :euirements

'ro&essor Personal computer (P$) &ith a Pentium -class processor B

megahert0 (*0)

eratin$ System *icrosoft +indo&s 'TV B. or later operating system

Memory Mi&roso#t Windows X' 'ro#essional

C megabytes (*5) of :A*

Windows 'ro#essional

K *5 of :A*

Windows Serer

CK! *5 of :A*

Windows NT 7. Wor)station

B *5 of :A*

Windows NT 7. Serer

C *5 of :A*

4ard +is) Standard Edition

!. gigabytes (I5) on installation dri#e &hich includes *5 on system dri#e

'ro#essional and Enterrise Editions

2. I5 on installation dri#e &hich includes *5 on system dri#e

+rie $9-:* or 9;9-:* dri#e

+islay ,uper ;IA (D 1 ) or higher-resolution monitor &ith ! colors

Mouse *icrosoft *ouse or compatible pointing de#ice

+eeloment 4ost Installation

C. nstall +indo&s 'T B. N ,er#ice Pac% or later or +indo&s

!MP

!. nstall *icrosoft ;isual ,tudio .'ET or e*bedded ;isual $NN


27/30

B.

2. nstall ,tandard MD Platform ,9G

7or more information about application programming &ith+indo&s $E .'ET please refer to the document -dante&%

Windows CE .NET -li&ation 4and on 1ab.F


28/30

9:-

I %ae ur&%ased Windows CE 1i&ense #rom Mi&roso#t+istributor. -m I aut%oriGed to use -dante&% Windows

CE S release>

E#ery Ad#antech +indo&s $E , binary contains some

Ad#antech intellectual properties that are not automatically

licensed to +indo&s $E licensee. $ustomers ha#e to be

licensed by Ad#antech independently to utili0e Ad#antech

+indo&s $E , release. 'ormally Ad#antech grant customer

the right to use Ad#antech intellectual properties that come

&ith Ad#antech +indo&s $E , release if he purchases

+indo&s $E license from Ad#antech.

W%y are t%e Inbo; and 'o&)et Word missin$>

5ecause most of the Embedded applications do not need nbo1

and Poc%et +ord. ,o &e choose 7ull #ersion as the default

+indo&s $E license. 7or *icrosoft nbo1 and Poc%et +ord

applications the license " Professional ;ersion License" is

needed.

W%en I &oied #iles to t%e root dire&tory or HWindows

dire&tory and reset t%e system t%ey all disaeared.

W%y>

The +indo&s $E uses the :A* based 7ile system. ,o

directories such as :oot and H+indo&s are actually loaded in

:A*. 7or 1D platform there is no battery to bac%up the data

in :A*. The data &ill be lost after po&er is off. f you need tostore your files you may ha#e to copy them to the follo&ing

storage de#ices8

7loppy 9is%n$hip or 9E 7lash dis%$ompact7lash J

$ardard 9ri#e

+oes -dante&% o##er Windows CE system inte$ration

seri&e>3es &e can pro#ide the complete +indo&s$E Embedded


29/30

,ystem based on your reuirements. 3ou simply choose the

Ad#antech hard&are and +indo&s$E configuration &e build

the customi0ed +indo&s$E mage. The +indo&s$E

Embedded systems &e ship to you &ill include Ad#antechhard&are 7lash dis% &ith pre-installed +indo&s$E mage and

+indo&s$E license.

ur +indo&s$E e1perience and strong customer focus

enables us to understand your reuirements and specifications.

5y utili0ing the core technology and intellectual property

deri#ed from our past pro your creati#e application.

W%at do I do to $et a Windows CE dei&e drier #or my

add@on module>

+indo&s $E is tied directly to the hard&are so many of the

standard P$ peripherals reuiring dri#ers ha#e been left out.

Ad#antech has de#eloped hard&are-specific dri#ers for on-

board functions such as net&or% ;IA ...of its specific

single board computers. All these dri#ers are &ell ported into

the +indo&s $E image file to be shipped together &ith the

single board computer or Panel P$.

+indo&s $E is different than +indo&s KD or 'T in that you can

get the dri#er from the chip or board #endors and install the

de#ice dri#ers. n most cases the +indo&s $E image needs to

be re-built &ith the add-on P$CB ,A or P$ de#ices4

+indo&s $E dri#ers. Usually the add-on de#ices do not come

&ith a +indo&s $E dri#er. ,o you may ha#e to de#elop or

purchase one from a third party.


30/30

Appendix

1. Null Modem Cable pin-out (DB-9 to DB-9)

1 and 6 short 4

!

!

4 1 and 6 short

" "

# $

$ #

Please make sure your Null Modem cable pin-out is correct, or

the ActiveSync connection will fail.

. %indo&s C' .N' related lins.

Ad*ante+h 'mbedded ,ot&are ome /a0e

http:www.advantech.comembeddedsw

Mi+rosot %indo&s C' .N' ,ot&are De*eloper

Do+umentation

http:msdn.microsoft.comlibrarywcedocwceintrocestart.htm

Mi+rosot %indo&s C' .N' ome /a0e

http:www.microsoft.comwindowsembeddedce.netdefault.as

p

advantech ce .net manual

Documents