Motorola A1000

SDK
Users Guide











Ver si on : 1. 1


Dat e : 15- Oct - 2004





Copyr i ght 1998 - 2004 Mot or ol a, I nc. Al l r i ght s r eser ved.
Thi s copyr i ght st at ement does not i mpl y publ i cat i on of t hi s document .


Copyr i ght 1998 - 2004 Mot or ol a, I nc. i





Revision History



Revision # Date Description
0. 1 22- Sept - 2003 I ni t i al dr af t .
1. 0 14- Mar - 2004 New For mat .
1. 1 15- Oct - 2004 Updat ed f or A1000.







Copyr i ght 1998 - 2004 Mot or ol a, I nc. 1





Contents

1. I nt r oduct i on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1. 1 Pur pose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1. 2 Tar get Audi ence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2. Devel opment Envi r onment Conf i gur at i on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. 2 A1000 SDK w/ o Symbi an 7. 0 SDK f or UI Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. 3 A1000 SDK wi t h Symbi an 7. 0 SDK f or UI Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. 3. 1 devi ce. exe Ki t Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. 3. 2 Uni que A1000 Tool s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2. 4 Nat i ve Bui l d Tar get s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3. Mot or ol a API s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 2 C++/ EPOC API s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 2. 1 Audi o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 2. 2 Camer a Capt ur e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 2. 3 Power Ser ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 2. 4 Vi deo Pl ayback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. 3 J 2ME Gami ng API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4. Mot or ol a A1000 Key Mappi ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4. 2 Rest r i ct i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4. 3 Avai l abl e Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5. Mi scel l aneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5. 1 Handset I MEI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5. 2 RTi mer s and A1000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
6. GDB On- Devi ce Debuggi ng f or EPOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
6. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
6. 2 Rest r i ct i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
6. 3 St ar t i ng GDBst ub. exe on t he A1000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
7. Redi r ect or On- Devi ce Debuggi ng f or J ava . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
7. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
7. 2 Rest r i ct i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
7. 3 St ar t i ng Redi r ect or on t he A1000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
8. Wi nsock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8. 2 Rest r i ct i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8. 3 Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8. 3. 1 St at us . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8. 3. 2 Enabl e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8. 3. 3 Di sabl e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
9. Di gi t al l y Si gned Appl i cat i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9. 2 Rest r i ct i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9. 3 SI S PKG Fi l es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9. 3. 1 Pr oduct / Pl at f or mVer si on Compat i bi l i t y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
9. 3. 2 Condi t i on Bl ock Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
9. 4 J 2ME Si gni ng Pr ocedur e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
10. Emul at or Appl i cat i on I nst al l . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
10. 1 Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
10. 2 C++/ EPOC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
10. 2. 1 WI NS UDEB Bui l d Tar get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 2




10. 2. 2 Copyi ng Fi l es I nt o WI NS UDEB Di r ect or y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
10. 2. 3 Usi ng Emul at or App I nst al l er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
10. 3 J 2ME MI Dl et s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Appendi x A - Remot e Access Ser vi ce PC Set up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Over vi ew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Rest r i ct i ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Wi ndows 2000 Set up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Wi ndows NT Set up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Di al - Up Net wor ki ng. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Addi ng RAS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
TCP/ I P Pr oper t i es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
RAS User Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
St ar t i ng RAS Ser vi ce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Tr oubl eshoot i ng. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Appendi x B - HALDat a At t r i but es. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28


Copyr i ght 1998 - 2004 Mot or ol a, I nc. 3




1. Introduction
1.1 Purpose
The pur pose of t hi s document i s t o pr ovi de a user s gui de f or t he Mot or ol a
A1000 SDK. Topi cs on set t i ng up t he devel opment envi r onment and i ssues wi t h
usi ng t he emul at or ar e cover ed i n t hi s document .
1.2 Target Audience
Thi s document i s i nt ended t o be ut i l i zed by appl i cat i on devel oper s of t he
Mot or ol a A1000.
Fami l i ar i t y wi t h Symbi an OS 7. 0, UI Q 2. 0 or 2. 1, and J ava 2 Mi cr o Edi t i on i s
assumed and r ecommended.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 4




2. Development Environment Configuration
2.1 Overview
The A1000 SDK can be used as a st andal one envi r onment or i n conj unct i on wi t h
t he Symbi an 7. 0 SDK f or UI Q 2. 0 or 2. 1. The SDK i s easi er t o use as a
st andal one envi r onment , but t hi s sect i on wi l l al l ow devel oper s t o use t he
Symbi an 7. 0 SDK f or UI Q f r amewor k t o wor k wi t h t he A1000 SDK.
2.2 A1000 SDK w/o Symbian 7.0 SDK for UIQ
I f you do not have t he Symbi an 7. 0 SDK f or UI Q i nst al l ed, t hen t he A1000 SDK
wi l l r equi r e t he f ol l owi ng:
Act i veSt at e Per l
J ava Runt i me Envi r onment
Devel oper s f ami l i ar wi t h Symbi an pr ogr ammi ng may wi sh t o map t he A1000 SDK
ont o a separ at e l ogi cal dr i ve. Thi s can st i l l be done by usi ng t he f ol l owi ng
command:

subst Q: C: \ Symbi an\ A1000SDK
Wi t h t he above envi r onment , t he f ol l owi ng envi r onment var i abl es wi l l need t o
be added:
EPOCROOT=\
PATH=\ epoc32\ gcc\ bi n; \ epoc32\ t ool s; %PATH%
Whi l e usi ng t he A1000 SDK wi t hout a separ at e l ogi cal dr i ve i s possi bl e,
t her e ar e pot ent i al i ncompat i bi l i t i es on t he WI NS emul at or wi t h appl i cat i ons
t hat do not i ncl ude dr i ve l et t er s i n t hei r f i l e and di r ect or y pat hs.
2.3 A1000 SDK with Symbian 7.0 SDK for UIQ
2.3.1 device.exe Kit Management
The use of t he devi ces. exe ki t manager i s opt i onal f or envi r onment s wi t h t he
Symbi an 7. 0 SDK f or UI Q i nst al l ed.
To add t he A1000 SDK t o t he l i st of suppor t ed ki t s i n t he Symbi an 7. 0 SDK
f or UI Q, r un t he f ol l owi ng f r omt he command l i ne:

devi ces add C: \ Symbi an\ A1000SDK C: \ Symbi an\ A1000SDK
@A1000: com. mot or ol a. A1000

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 5




To make t he A1000 SDK t he def aul t devi ce envi r onment , r un t he f ol l owi ng f r om
t he command l i ne:

devi ces set def aul t @A1000: com. mot or ol a. A1000
For appl i cat i ons whi ch do not have dr i ve l et t er s i n di r ect or y and f i l e
pat hs, t he use of devi ces. exe wi l l not cor r ect WI NS emul at or
i ncompat i bi l i t i es. Set t i ng C: \ Symbi an\ A1000SDK as a separ at e l ogi cal dr i ve
cor r ect s t hose i ssues.
For mor e det ai l s on devi ces. exe, r ef er t o t he UI Q SDK document at i on.
2.3.2 Unique A1000 Tools
Wi t h t he Symbi an 7. 0 SDK, t he PC di r ect or y- - C: \ Pr ogr amFi l es\ Common
Fi l es\ Symbi an\ Tool s- - i s added t o t he PC s PATH envi r onment var i abl e.
The use of devi ces. exe f r omt he UI Q SDK poi nt s t he appl i cat i on st ub f i l es i n
t he C: \ Pr ogr amFi l es\ Common Fi l es\ Symbi an\ Tool s di r ect or y t o t he
<EPOCROOT>\ epoc32\ t ool s di r ect or y assi gned i n t he devi ces. exe synt ax.
Thi s di r ect or y i ncl udes st ub f i l es f or most GCC and gener i c Symbi an t ool s.
But t her e ar e t wo t ool s t hat ar e uni que t o t he Mot or ol a A1000 SDK whi ch need
t o be added t o t he C: \ Pr ogr amFi l es\ Common Fi l es\ Symbi an\ Tool s di r ect or y:
si gnmi dl et f or di gi t al si gni ng of J 2ME MI Dl et s
wsp f or Wi nsock oper at i on
To ensur e t hat t hese t wo t ool s ar e avai l abl e f or t he A1000 SDK envi r onment
wi t h t he Symbi an 7. 0 SDK envi r onment set t i ngs, copy t he cont ent s of
C: \ Symbi an\ A1000SDK\ epoc32\ st ub\ t ool s i nt o t he C: \ Pr ogr amFi l es\ Common
Fi l es\ Symbi an\ Tool s di r ect or y.
2.4 Native Build Targets
Al t hough t he Mot or ol a A1000 SDK suppor t s t wo Appl i cat i on Bi nar y I nt er f aces
( ABI s) ARMI and THUMB, most appl i cat i on devel oper s shoul d bui l d f or THUMB
f or devi ce r el eases. ARMI l i br ar i es ar e i ncl uded due t o dependenci es on some
Mot or ol a THUMB component s.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 6




3. Motorola APIs
3.1 Overview
Thi s sect i on br i ef l y descr i bes t he var i ous Mot or ol a API s suppor t ed i n t he
Mot or ol a A1000 handset suppor t ed by t he SDK.
For Symbi an 7. 0 and UI Q 2. 0 and 2. 1 API s and usage, pl ease consul t t he
Symbi an 7. 0 SDK f or UI Q 2. 0 or 2. 1 document at i on.
3.2 C++/EPOC APIs
Document at i on of t he cont ent s and usage of t he f ol l owi ng API s ar e l ocat ed i n
t he SDK di r ect or y: c: \ Symbi an\ A1000SDK\ docs.
3.2.1 Audio
I n addi t i on t o t he Medi a Ser ver audi o i nt er f aces f r omt he UI Q SDK, t he
Mot or ol a A1000 handset uses a Mot or ol a Audi o API f or enhanced sound
gener at i on and audi o pl ayback. Not e t hat audi o pl ayback i s not suppor t ed on
t he WI NS emul at or so t est i ng of appl i cat i ons usi ng t he Audi o API must be
per f or med on t he A1000 devi ce.
3.2.2 Camera Capture
The A1000 handset uses t he Camer a Capt ur e API f or t aki ng i mage snapshot s of
wi t h t he devi ce s bui l t - i n di gi t al camer a. The WI NS emul at or does not
suppor t t he Camer a Capt ur e API , so appl i cat i ons usi ng i t wi l l need t o be
t est ed on t he t ar get har dwar e.
3.2.3 Power Server
The A1000 handset uses t he Power Ser ver API f or managi ng power - based
condi t i ons and event s. The WI NS emul at or does not suppor t t he Vi deo Pl ayback
API , so appl i cat i ons usi ng vi deo wi l l need t o be t est ed on t he handset .
3.2.4 Video Playback
The A1000 handset uses t he Vi deo Pl ayback API f or pl ayback of MPEG- 4 vi deo
cont ent . The WI NS emul at or does not suppor t t he Vi deo Pl ayback API , so
appl i cat i ons usi ng vi deo wi l l need t o be t est ed on t he handset .

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 7





Copyr i ght 1998 - 2004 Mot or ol a, I nc. 8
3.3 J2ME Gaming API
The Mot or ol a A1000 devi ce suppor t s a J 2ME Gami ng API . The WI NS emul at or
suppor t s most of t he Gami ng API except f or t hose deal i ng wi t h audi o
pl ayback.
Document at i on of t he cont ent s and usage of t he J 2ME Gami ng API i s l ocat ed i n
t he di r ect or y
C: \ Symbi an\ A1000SDK\ Gami ngAPI
The cl assf i l es f or bui l di ng J 2ME Gami ng API MI Dl et s ar e l ocat ed i n t he PC
di r ect or y

C: \ Symbi an\ A1000SDK\ Gami ngAPI \ bi n




4. Motorola A1000 Key Mappings
4.1 Overview
I n addi t i on t o t he t ouchscr een, t he Mot or ol a A1000 devi ce has 15 separ at e
har dwar e but t ons. The A1000 but t ons ar e assi gned t o speci f i c scancodes and
keycodes whi ch ar e det ai l ed her e.
For det ai l s on t he usage of scancodes and keycodes pl ease consul t t he UI Q
SDK document at i on.
4.2 Restrictions
Most devi ce but t ons ar e assi gned t o speci f i c appl i cat i ons and ar e
unavai l abl e f or use by devel oper s. The f ol l owi ng keys ar e consumed by
ot her appl i cat i ons:
Send consumed by Phone appl i cat i on
End consumed by Phone appl i cat i on
Br owser / Shor t cut l aunches Br owser app or Shor t cut app ( i f hel d down)
Speaker phone t oggl es speaker phone f unct i onal i t y
Vol ume Up/ Down consumed by audi o dr i ver s
Voi ce Tag consumed by Cont act s appl i cat i on
Camer a consumed by Camer a appl i cat i on
4.3 Available Keys
The but t ons t hat ar e accessi bl e f or devel oper use ar e as f ol l ows:
Up Scancode: ESt dKeyDevi ce4, Keycode: EQuar t zKeyFour WayUp
Down - Scancode: ESt dKeyDevi ce5, Keycode: EQuar t zKeyFour WayDown
Lef t - Scancode: ESt dKeyDevi ce6, Keycode: EQuar t zKeyFour WayLef t
Ri ght - Scancode: ESt dKeyDevi ce7, Keycode: EQuar t zKeyFour WayRi ght
Sel ect - Scancode: ESt dKeyDevi ce8, Keycode: EQuar t zKeyConf i r m
Game A - Scancode: ESt dKeyAppl i cat i onA
Game B - Scancode: ESt dKeyAppl i cat i onB
The scancodes and keycodes above can be r ef er enced i n t he e32keys. h and
Quar t zKeys. h header f i l es.
Not e: The A1000 j oyst i ck i s an 8- way swi t ch. When a di agonal di r ect i on i s
pushed, t he j oyst i ck act ual l y gener at es t wo separ at e keycodes r at her t han an
i ndi vi dual uni que keycode.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 9




5. Miscellaneous
5.1 Handset IMEI
Some devel oper s wi sh t o use t he handset s I MEI number as a uni que
i dent i f i er .
The A1000 SDK suppor t s t he r eadi ng of t he devi ce I MEI val ue t hr ough
Symbi an s PLP i nt er f aces.
Locat ed i n t he PLPVARI ANT. H header f i l e, t he f unct i on:
voi d Get Machi neI dL( TPl pVar i ant Machi neI d &aI d)
wi l l r et ur n t he devi ce I MEI number i n t he aI d var i abl e.
5.2 RTimers and A1000
Al t hough RTi mer s ar e descr i bed i n t he UI Q document at i on, usage of t he
RTi mer s i n t he A1000 handset r equi r es addi t i onal consi der at i on.
The power management f or t he A1000 handset i s par t i cul ar l y aggr essi ve when
i t comes t o savi ng handset bat t er y l i f e. Ther ef or e, RTi mer event s on t he
A1000 behave di f f er ent l y t han descr i bed i n t he UI Q document at i on i n t he
f ol l owi ng ways:
RTi mer : : At ( ) event s wi l l not t r i gger i f t he A1000 i s of f .
RTi mer : : Af t er ( ) handl er s ar e vul ner abl e t o t he handset ent er i ng l ow-
power mode shor t l y af t er t he t i mer event .

I f an appl i cat i on r equi r es t he A1000 t o st ay i n r un mode t o per f or m
act i vi t i es af t er a t i mer event ( e. g. schedul ed pul l appl i cat i on f or
cont ent ) , usage of t he Power Ser ver API i s needed.
By usi ng t he I nf or mCondi t i onTypeSt ar t ( EMCondi t i onTypeEmai l ) f unct i on i n t he
Power Ser ver API , t he appl i cat i on can manual l y f or ce t he handset i nt o r un
mode unt i l r unni ng I nf or mCondi t i onTypeSt op( EMCondi t i onTypeEmai l ) .
Not e: I ncor r ect usage of t he I nf or mCondi t i onTypeSt ar t ( ) and
I nf or mCondi t i onTypeSt op( ) can dr amat i cal l y r educe t he bat t er y l i f e of t he
A1000 handset . Devel oper s must avoi d ci r cumst ances wher e t he A1000 i s f or ced
i nt o r un mode but i s not r et ur ned t o l ow- power mode af t er nor mal
oper at i ons or er r or handl i ng.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 10




6. GDB On-Device Debugging for EPOC
6.1 Overview
The Mot or ol a A1000 devi ce suppor t s on- devi ce debuggi ng of C++/ EPOC
appl i cat i ons wi t h t he hel p of t he GNU Debugger ( GDB) . GDB r uns on a host
comput er t hat i s connect ed t o t he devi ce vi a ser i al i nt er f ace. A st ub
pr ogr amr unni ng on t he devi ce pr ovi des t he debuggi ng ser vi ces t o GDB.
For det ai l s on set t i ng up your pr oj ect f or GDB pl ease consul t t he UI Q SDK
document at i on.
For gener al usage and document at i on on t he GNU Debugger , pl ease consul t t he
GDB websi t e at ht t p: / / www. gnu. or g/ sof t war e/ gdb/ gdb. ht ml .
6.2 Restrictions
The A1000 devi ce onl y suppor t s GDB oper at i ons over a ser i al por t ( t he
GDBst ub. exe ver si on on t he devi ce does not suppor t set t i ng t he CSY) . Thus,
i t i s necessar y f or devel oper s who wi sh t o use t hi s f unct i onal i t y t o obt ai n
an A1000- compat i bl e ser i al por t .
I nf or mat i on about Dat a Cabl e S9141:
Adapt er SYN0279B wi t h char gi ng por t
9- pi n cabl e SKN6315A
Compat i bl e wi t h Mot or ol a 120, 120c, 120e, 120t , 120x, 270c, 280, 60, 60c,
60g, 60i , 60p, 60s, 60t , 60x, T720, T720i , T721, T721g, T721i , T722,
T722i , T725, T730, T730c, T730i , T731, Ti mepor t 270c, Ti mepor t 280, v120,
v120c, v60, v60c, v60g, v60i , v60p, v60s, v60t , v60x, v66, v70, A830,
A920, A925, and A1000 cel l phones.
Si nce GDB r equi r es a f r ee ser i al COM por t , Wi ndows PCs wi t h Symbi an
Connect / Deskt op Sui t e i nst al l ed wi l l need t o di sabl e t he ser i al COM por t i n
mRout er t o avoi d bl ocki ng GDB f r omusi ng t he por t .
Manual l y r unni ng GDBst ub. exe on t he A1000 r equi r es a way t o r un Z: dr i ve
appl i cat i ons. Ther ef or e, a f i l e manager l i ke QFi l eman i s r equi r ed t o
manual l y r un t he st ub.
6.3 Starting GDBstub.exe on the A1000
Si nce t he GDBst ub. exe, GDBseal . dl l , and GDBseng. dl l f i l es r esi de on t he
A1000 devi ce, t he devel oper f ol l ows t he bel ow st eps t o r un t he GDB st ub
pr ogr am.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 11




1. Launch Fi l e Manager ( qf i l eman) on t he devi ce.
2. Got o Z: \ Syst em\ Pr ogr ams.
3. Run gdbst ub. exe.
4. Pl ug t he ser i al cabl e i nt o t he devi ce. Thi s st ep must be r un af t er St ep
3. Ot her wi se, t he communi cat i on l i nk bet ween GDB and t he GDB st ub wi l l
not be est abl i shed.
The Fi l e Manager ( qf i l eman) can be downl oaded f r omSymbi an s devel oper
websi t e:

ht t p: / / www. symbi an. com/ devel oper / downl oads/ t ool s. ht ml

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 12




7. Redirector On-Device Debugging for Java
7.1 Overview
The Mot or ol a A1000 devi ce suppor t s on- devi ce debuggi ng of pJ ava and J 2ME
appl i cat i ons wi t h t he hel p of t he Redi r ect or appl i cat i on. Redi r ect or t akes
over al l t hr ee of J ava' s st andar d I / O st r eamsSyst em. out , Syst em. i n, and
Syst em. er r and pr ovi des you wi t h t he means t o r edi r ect t hese st r eams t o a
consol e wi ndow. I n addi t i on i t al so al l ows you t o r edi r ect out put t o a l og
f i l e, or t o a ser i al por t .
Two ver si ons of t he Redi r ect or ar e pr ovi ded f or devel oper s. One i s f or t he
WI NS t ar get envi r onment and i s al r eady bundl ed on t he WI NS emul at or . The
ot her i s bui l t f or t he THUMB t ar get envi r onment and can be i nst al l ed on
A1000 har dwar e. The Redi r ect _t humb. SI S appl i cat i on i s l ocat ed i n t he
C: \ Symbi an\ A1000SDK\ epoc32\ t ool s di r ect or y.
For gener al i nf or mat i on on t he Redi r ect or t ool pl ease consul t t he UI Q SDK
document at i on.
7.2 Restrictions
Devel oper s who wi sh t o use Redi r ect or t o out put st andar d I / O over t he ser i al
por t wi l l need t o obt ai n an A1000- compat i bl e ser i al por t .
Pl ease consul t i nf or mat i on i n Sect i on 6. 2 Rest r i ct i ons on ser i al por t par t
number s and i nf or mat i on.
When usi ng Redi r ect or over t he ser i al por t , Wi ndows PCs wi t h Symbi an
Connect / Deskt op Sui t e i nst al l ed wi l l need t o di sabl e t he ser i al COM por t i n
mRout er t o avoi d bl ocki ng t er mi nal sof t war e f r omusi ng t he por t .
7.3 Starting Redirector on the A1000
Runni ng Redi r ect or wi t h J ava appl i cat i ons f or consol e or f i l e out put on t he
A1000 i s descr i bed i n t he UI Q SDK document at i on.
However , because t he A1000 ser i al por t i mpl ement at i on i s di f f er ent t han UI Q,
r unni ng Redi r ect or wi t h t he ser i al por t r equi r es t he f ol l owi ng pr ocedur e:

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 13




1. Launch Redi r ect or on t he devi ce i n ser i al por t mode.
2. Launch a J ava appl i cat i on whi ch gener at es st andar d I / O.
3. Pl ug t he ser i al cabl e i nt o t he devi ce. Thi s st ep must be r un af t er St ep
2. Ot her wi se, t he communi cat i on l i nk bet ween Redi r ect or and t he ser i al
por t wi l l not be est abl i shed at cabl e pl ugi n.


Copyr i ght 1998 - 2004 Mot or ol a, I nc. 14




8. Winsock
8.1 Overview
To ai d devel oper s i n t est i ng i nt er net - awar e appl i cat i ons, t he Mot or ol a A1000
SDK emul at or pr ovi des a mechani smf or accessi ng t he socket connect i on of t he
devel opment PC usi ng a Wi nsock connect i on.
8.2 Restrictions
The Wi nsock i mpl ement at i on f or t he WI NS emul at or does not suppor t pr oxi es
used by t he devel opment PC s net wor k connect i on.
The Wi nsock i mpl ement at i on al so di sabl es Wi ndows RAS oper at i ons when
enabl ed.
8.3 Usage
The Wi nsock t ool i s l ocat ed i n t he \ epoc32\ t ool s di r ect or y of t he Mot or ol a
A1000 SDK.
8.3.1 Status
To check whet her t he Wi nsock component i s enabl ed or di sabl ed f or t he WI NS
emul at or , r un t he f ol l owi ng command:
wsp s
8.3.2 Enable
To enabl e t he Wi nsock i mpl ement at i on f or t he WI NS emul at or , r un t he
f ol l owi ng command:
wsp e
8.3.3 Disable
To di sabl e t he Wi nsock i mpl ement at i on f or t he WI NS emul at or , r un t he
f ol l owi ng command:
wsp d

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 15




9. Digitally Signed Applications
9.1 Overview
The Mot or ol a A1000 suppor t s di gi t al l y si gned appl i cat i ons, i ncl udi ng J 2ME
MI Dl et s. Thi s sect i on out l i nes i ssues wi t h si gni ng appl i cat i onsEPOC or
J 2MEwi t h di gi t al cer t i f i cat es.
For det ai l s on di gi t al l y si gni ng a SI S f i l e, see t he UI Q SDK document at i on.
9.2 Restrictions
Onl y J 2ME MI Dl et s si gned wi t h a RSA- based key ar e suppor t ed i n t he A1000
secur e i nst al l er . J 2ME MI Dl et s si gned wi t h a key not based on RSA wi l l be
t r eat ed as an unsi gned MI Dl et .
9.3 SIS PKG Files
9.3.1 Product/Platform Version Compatibility
The A1000 suppor t s t he pr oduct / pl at f or mver si on compat i bi l i t y f eat ur e f or
SI S f i l e packages. The UI D shoul d i dent i f y t he ear l i est possi bl e pl at f or m
ver si on or pr oduct t o maxi mi ze t he number of phones t he package can be
i nst al l ed on.
As a UI Q 2. 0 devi ce, t he Mot or ol a A1000 suppor t s t he UI Q 2. 0 Pl at f or mI D.
Newer ver si ons of t he A1000 may al so suppor t t he Mot or ol a A920 Pl at f or mI D.
The Mot or ol a A1000 i s not a UI Q 2. 1 devi ce.
For gener i c UI Q 2. 0 appl i cat i ons, i t i s r ecommended t o use t he UI Q 2. 0 I D by
i nser t i ng t he f ol l owi ng l i ne i nt o t he PKG f i l e:

( 0x101F617B) , 2, 0, 0, {" UI Q20Pr oduct I D" }
I f your PKG f i l e suppor t s mor e t han one l anguage, t he dependency st r i ng wi l l
need t o be def i ned mul t i pl e t i mes. For exampl e, f or a PKG f i l e wi t h suppor t
f or t hr ee l anguages, t he f ol l owi ng l i ne shoul d be used:

( 0x101F617B) , 2, 0, 0, {" UI Q20Pr oduct I D" , " UI Q20Pr oduct I D" ,
" UI Q20Pr oduct I D" }

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 16




9.3.2

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 17
Condition Block Usage
The UI Q SDK document at i on on PKG f i l e f or mat det ai l s t he use of condi t i on
bl ocks f or cont r ol l i ng t he i nst al l er based on devi ce at t r i but es i n t he
\ epoc32\ i ncl ude\ hal _dat a. h f i l e.
Ref er t o Appendi x B - HALDat a At t r i but es f or t he HALDat a at t r i but e set t i ngs
f or t he Mot or ol a A1000.
9.4 J2ME Signing Procedure
The pr ocedur e f or di gi t al l y si gni ng and i nst al l i ng a J 2ME MI Dl et i s as
f ol l ows:

1. I dent i f y t he l ocat i on of t he MI Dl et J AR and J AD f i l es.
2. I dent i f y t he l ocat i on of t he secur e key and cer t i f i cat e on t he PC har d
dr i ve.
3. Run t he si gnmi dl et t ool i n t he X: \ Symbi an\ A920Emul \ epoc32 wi t h t he
f ol l owi ng synt ax:

si gnmi dl et . exe - k <. key f i l e> - s <. cer f i l e> - d <. j ad f i l e> <. j ar f i l e>

wher e <. key f i l e> i s t he pat h and f i l ename of t he pr i vat e key f i l e,
<. cer f i l e> i s t he pat h and f i l ename of t he publ i c key cer t i f i cat e
f i l e, <. j ad f i l e> i s t he pat h and f i l ename of t he J 2ME J AD f i l e, and
<. j ar f i l e> i s t he pat h and f i l ename of t he J 2ME J AR f i l e.
Not e t hat di gi t al keys and cer t i f i cat es ar e not pr ovi ded by Mot or ol a.




10. Emulator Application Install
10.1 Overview
For devel opment t est i ng, appl i cat i ons can be i nst al l ed on t he Mot or ol a A1000
SDK emul at or i n a number of di f f er ent ways. Thi s sect i on out l i nes t he
di f f er ent opt i ons avai l abl e t o t he devel oper .
10.2 C++/EPOC
10.2.1 WINS UDEB Build Target
By bui l di ng on a WI NS UDEB bui l d t ar get , t he devel oper aut omat i cal l y i nser t s
compi l ed appl i cat i ons i nt o t he SDK emul at or envi r onment . The next t i me t he
emul at or i s r un, t he App Launcher wi l l aut omat i cal l y f i nd t he appl i cat i on
and di spl ay i t i n t he mai n menu.
10.2.2 Copying Files Into WINS UDEB Directory
I f t he devel oper has compi l ed f i l es, manual l y copyi ng t he compi l ed f i l es
i nt o PC di r ect or y

\ epoc32\ r el ease\ wi ns\ udeb\ z\ syst em\ apps\ <app name>\

wi l l i nst al l t he appl i cat i on i nt o t he emul at or .
Li ke bui l di ng i n t he WI NS UDEB bui l d t ar get , t he App Launcher wi l l
aut omat i cal l y f i nd t he app and di spl ay i t i n t he mai n menu.
10.2.3 Using Emulator App Installer
I f t he devel oper wi shes t o t est t he i nt egr i t y of a packaged SI S f i l e, copy
t he SI S f i l e i nt o \ epoc32\ wi ns\ c\ and r un t he App I nst al l er f r omt he App
Launcher - >Launcher - >I nst al l on t he WI NS emul at or .
When t he emul at or s App I nst al l er di spl ays t he l ocat i ons t o i nst al l your
appl i cat i on, you wi l l see t wo names wi t h t he har d dr i ve vol ume whi ch t he
emul at or r esi des on.
The f i r st one l i st ed i s t he A: dr i ve mapped t o \ epoc32\ wi ns\ a\ whi l e t he
second one i s t he C: dr i ve mapped t o \ epoc32\ wi ns\ c\ . For pr oper
oper at i on, you must i nst al l appl i cat i ons on t he C: ( 2
nd
) dr i ve.
Not e t hat usi ng t he App I nst al l er t o uni nst al l t he app i s al so possi bl e wi t h
t hi s i mpl ement at i on.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 18




10.3

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 19
J2ME MIDlets
Unl i ke C++/ EPOC appl i cat i ons, J 2ME MI Dl et s cannot be copi ed i nt o t he
emul at or di r ect or i es di r ect l y. Ther ef or e, t o i nst al l J 2ME MI Dl et s, use t he
same st eps out l i ned i n 10. 2. 3 Usi ng Emul at or App I nst al l er .




Appendix A - Remote Access Service PC Setup
Overview
Wi ndows 2000 and NT come wi t h i nt er net access sof t war e whi ch can be set up t o
use a PPP connect i on bet ween t he WI NS emul at or and t he Remot e Access Ser vi ce
( RAS) ser ver .
The UI Q SDK document at i on det ai l s how t o conf i gur e t he SDK emul at or t o use
RAS. Thi s sect i on det ai l s t he st eps on set t i ng up t he RAS ser vi ce on a
Wi ndows 2000 or NT PC.
Restrictions
RAS wi l l not wor k wi t h Wi nsock suppor t enabl ed.
Not e t hat t he Mot or ol a A1000 emul at or uses t he PC COM1 por t . The f ol l owi ng
st eps assume you ar e usi ng t he PC s COM2 por t f or t he RAS ser ver . I f you ar e
usi ng a PC wi t h onl y one COM por t , you cannot use t he same machi ne as bot h
t he emul at or and t he RAS ser ver .

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 20





Copyr i ght 1998 - 2004 Mot or ol a, I nc. 21
Windows 2000 Setup

1. Fr omt he Start menu, choose Programs, Administrative Tools, and sel ect
Computer Management.
As an al t er nat i ve, you can sel ect Settings, Control Panel, and
Administrative Tools f r omt he Start menu and t hen sel ect Computer
Management.

2. I n t he l ef t hand panel of t he Computer Management di al og box, expand
Local User s and Gr oups, and t hen sel ect User s. Ri ght - cl i ck i n t he
panel and sel ect Add New User t o cr eat e a new account . Cr eat e account
wi t h an account name of RasUser and a passwor d of pass. Thi s
cor r esponds t o a pr eexi st i ng i nt er net account i n t he A920 emul at or
cal l ed NT RAS.




3. Doubl e- cl i ck on t he RasUser account t o check t he set t i ngs. Under
Gener al , t he boxes l abel ed User cannot change passwor d and
Passwor d never expi r es boxes shoul d be checked, and t he box l abel ed
Account i s di sabl ed shoul d be unchecked. Under Member Of , t he
account shoul d be a member of Guest s. Cl i ck OK t o save t he
set t i ngs.

4. Fr omt he Start menu, choose Settings, Control Panel, and sel ect Phone
and Modem Options. Cl i ck on t he Modems t ab. I f Communi cat i ons cabl e
bet ween t wo comput er s i s i nst al l ed on COM1, t hen r emove t hat modem. I f
Communi cat i ons cabl e bet ween t wo comput er s i s i nst al l ed on a COM2,
t hen ski p t o st ep 6.
5. Cl i ck Add t o open t he modemwi zar d. I n t he next page, check t he box
l abel ed Don t det ect my modem and t hen cl i ck Next . I n t he f ol l owi ng
page, cl i ck on Communi cat i ons cabl e bet ween t wo comput er s, and t hen
cl i ck Next . I n t he f ol l owi ng page, sel ect t he ser i al por t t hat you
want t o use f or RAS connect i ons. Now, cl i ck Next f ol l owed by Fi ni sh
t o cl ose t he wi zar d.
6. Ri ght - cl i ck on Communi cat i ons cabl e bet ween t wo comput er s, and t hen
sel ect Pr oper t i es. Sel ect a COM2 as t he ser i al por t . Set t he maxi mum
por t speed t o 115200 baud, and t hen cl i ck OK t wi ce t o save t he new
set t i ngs.
7. Fr omt he St ar t menu, choose Settings, Network and Dial-up Connections,
and sel ect Make New Connection t o st ar t t he Net wor k Connect i on Wi zar d.
I n t he f i r st page of t he wi zar d, cl i ck Next . I n t he second page,
sel ect Accept i ncomi ng connect i ons, and t hen cl i ck Next . I n t he
t hi r d page, sel ect Communi cat i ons cabl e bet ween t wo comput er s, and
t hen cl i ck Next . I n t he f our t h page, De- sel ect Do not al l ow vi r t ual
pr i vat e connect i ons, and t hen cl i ck Next . I n t he f i f t h page, make
sur e t hat t he box l abel ed guest i s checked, and t hen cl i ck Next .

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 22




8. I n t he next page, sel ect I nt er net Pr ot ocol ( TCP/ I P) . Doubl e- cl i ck on
TCP/ I P and make sur e t hat speci f y TCP/ I P addr ess checked. Then
ent er a r ange of I P addr esses t hat wi l l be used by t he RAS ser ver and
t he devi ces connect i ng t he ser ver . ( e. g. 10. 0. 0. 1 t o 10. 0. 0. 2 wi l l
assi gn 10. 0. 0. 1 t o t he ser ver and 10. 0. 0. 2 wi l l get assi gned t o one
devi ce when Ras i s st ar t ed, Use t hi s ser ver addr ess i n host s f i l e )
Then, cl i ck OK, cl i ck Next , and t hen cl i ck Fi ni sh t o exi t t he
wi zar d.
Windows NT Setup
Dial-Up Networking
Ensur e t hat Di al - Up Net wor ki ng has been i nst al l ed.
1. Doubl e cl i ck My Computer
2. Doubl e cl i ck t he Dial-Up Networking i con
3. You wi l l be pr ompt ed t o i nser t t he i nst al l at i on CD- ROM t o copy t he
necessar y f i l es
4. When compl et e, a pr ompt wi l l appear t o add a RAS devi ce ( modem) i f none
ar e al r eady i nst al l ed
5. Ti ck t he Don t det ect my modem; I wi l l sel ect i t f r oma l i st
6. Fr omt he l i st , choose Di al - up net wor ki ng ser i al cabl e bet ween 2 PCs .
7. Choose por t COM2. Then sel ect Pr oper t i es , 115200 baud.
8. Then cl i ck Continue on t he Remot e Access Set up box i f no net wor k
pr ot ocol s ar e i nst al l ed choose TCP/IP and cl i ck Continue agai n.
9. Wi ndows NT wi l l t hen i nst al l TCP/ I P Suppor t
10. Fi nal l y you wi l l be pr ompt ed t o r est ar t t he machi ne
Adding RAS
I f you ar e not pr ompt ed f or t hi s i nf or mat i on, you can manual l y add t he
component s.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 23




1. Cl i ck on t he Network i con i n Control Panel
2. Cl i ck t he Ser vi ces t ab
3. Hi ghl i ght Remot e Access Ser vi ce
4. Cl i ck Add...
5. Add Remot e Access Ser vi ce
6. When compl et e a pr ompt wi l l appear t o add a RAS devi ce ( modem) i f none
ar e al r eady i nst al l ed. Cl i ck Yes.
7. I f you ar e not pr ompt ed f or a modem, go t o Modems i n Control Panel.
8. Ti ck t he Don t det ect my modem; I wi l l sel ect i t f r oma l i st
9. Fr omt he l i st , choose Di al - up net wor ki ng ser i al cabl e bet ween 2 PCs .
Choose por t COM2. Then sel ect Pr oper t i es , 115200 baud.
10. I f no net wor k pr ot ocol s ar e avai l abl e Wi ndows NT wi l l pr ompt you t o add
one, sel ect TCP/IP and cl i ck cont i nue
11. Wi ndows NT wi l l t hen i nst al l TCP/ I P Suppor t
12. Fi nal l y you may be pr ompt ed t o r est ar t t he machi ne
To manual l y add anot her modem, cl i ck Add.. on t he Remote Access Setup and
t hen choose Install Modem... or use t he Modems i con i n t he Control Panel
TCP/IP Properties
To set t he TCP/ I P Pr oper t i es, f ol l ow t he bel ow i nst r uct i ons.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 24




1. Fr omt he Start menu, sel ect Settings
2. Open t he Control panel.
3. Cl i ck on t he Network i con
4. Choose t he Services t ab
5. Hi ghl i ght Remote Access Service
6. Cl i ck Properties The Remot e access set up di al og appear s.
7. Hi ghl i ght Di al - up Net wor ki ng Ser i al Cabl e bet ween 2 PCs .
8. Choose Configure. The Por t Usage di al og appear s. Sel ect Dial out
or receive calls .
9. Ret ur n t o t he Remot e access set up di al og. Cl i ck on t he Network
but t on.
10. I n t he Net wor k pr ot ocol s:
11. Check TCP/IP
12. Uncheck I PX/ SPX Compat i bl e
13. Uncheck NetBEUI
14. Under Encryption Settings: choose Al l ow any aut hent i cat i on i ncl udi ng
cl ear t ext
15. Then cl i ck TCP/IP Configure...
16. Check Use static address pool
17. Under Begi n and End, ent er t he upper and l ower l i mi t s of a r ange of I P
addr esses t hat ar e val i d f or your net wor k and ar e not al r eady i n use.
18. Al t er nat i vel y, sel ect This computer only , and use t he r ange 10. 1. 0. 1
t o 10. 1. 0. 254. Thi s wi l l suf f i ce i f you do not wi sh t o access ot her
machi nes apar t f r omyour own PC.
19. Ret ur n t o t he Net wor k Ser vi ces, mul t i - t abbed di al og. ( Whi ch was r eached
f r omt he cont r ol panel by cl i cki ng Net wor k . )
20. I f you wi sh t o access ot her machi nes apar t f r omyour own PC, sel ect t he
Pr ot ocol s t ab, hi ghl i ght TCP/ I P and cl i ck Pr oper t i es . Sel ect t he
Rout i ng t ab and t i ck t he Enabl e I P f or war di ng opt i on.
21. Qui t al l di al og boxes, and r eboot .
RAS User Account

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 25




To cr eat e a RAS user account , t he f ol l owi ng st eps ar e pr ovi ded.
1. Fr omt he Start menu, sel ect Run and ent er t he pr ogr amname MUSRMGR .
2. The User Manager pr ogr amappear s
3. Look f or t he name RasUser i n t he l i st of user names. ( Exact l y as
shown, wi t h no spaces, and wi t h t he same capi t al i zat i on. ) I f i t i s
pr esent , doubl e cl i ck on i t .
4. I f t he name RasUser i s not al r eady i n t he l i st of user names, choose
New User f r omt he User menu. Ent er RasUser i n t he Username box,
exact l y as shown, wi t h no spaces, and wi t h t he same capi t al i zat i on.
5. Ent er some sui t abl e comment , such as EPOC32 Test RAS User i n t he
Ful l Name and Descr i pt i on boxes.
6. Ent er pass i n t he Password and Conf i r m boxes. In lower case.
7. Unt i ck t he User must change password at next logon opt i on.
8. Ti ck t he User cannot change password opt i on.
9. Ti ck t he Password never expires opt i on.
10. Sel ect t he Dialin but t on. Choose Grant dialin permission to user
11. Ret ur n t o t he User Pr oper t i es di al og and cl i ck t he Groups but t on.
Add t he gr oup name User s i nt o t he Member of l i st .
12. Qui t t he User Manager pr ogr am.
Starting RAS Service
To st ar t t he RAS ser vi ce, at t he command l i ne pr ompt , ent er t he f ol l owi ng:
NET START " REMOTE ACCESS CONNECTI ON MANAGER"
NET START " REMOTE ACCESS SERVER"
NET START " SI MPLE TCP/ I P SERVI CES"
NET START EVENTLOG
START RASMON
I t woul d be best t o save t hese commands i n a sui t abl e bat ch f i l e.
RAS shoul d now be r unni ng and shoul d be l i st eni ng t o COM2. Ent er t he command
NET START ; t hi s shoul d i ndi cat e t hat RAS i s r unni ng.
When you connect a comput er t o your PC s COM2 por t , t he RASMON pr ogr am
shoul d di spl ay a CD l i ght when you make a connect i on. You can choose
opt i ons i n t he RASMON pr ogr amwhi ch wi l l di spl ay dat a- t r ansmi t t ed/ r ecei ved
act i vi t y i ndi cat or s.

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 26





Copyr i ght 1998 - 2004 Mot or ol a, I nc. 27
Troubleshooting
Check t hat RAS i s r unni ng by t ypi ng NET START at t he command l i ne pr ompt .
Run t he RASMON pr ogr amt o moni t or act i vi t y on t he por t .
Check t he f ol l owi ng poi nt s i n t he Modems i con i n t he Cont r ol Panel .
1. Cl i ck t he Connection t ab
2. Cl i ck Connect i on
Dat a bi t s: 8
Par i t y: None
St op bi t s: 1
3. Cl i ck Advanced
I n case you use PCMCI A ADAPTER:
Check Use f l ow cont r ol
Check Har dwar e ( RTS/ CTS)
4. Un- Check Use f l ow cont r ol




Appendix B - HALData Attributes
Thi s i nf or mat i on i s pr ovi ded t o t he devel oper f or condi t i on bl ock usage i n
PKG f i l es. The \ epoc32\ i ncl ude\ hal _dat a. h header f i l e may need t o be
consul t ed t o i dent i f y t he appr opr i at e enumor val ue.
Not e however , sever al of t hese val ues set i n t he Mot or ol a A1000 sof t war e may
be par t i al l y cor r ect . For exampl e, ECPUABI = ar mi even t hough Mot or ol a
r ecommends devel oper s use nat i ve bui l d t ar get f or A1000 appl i cat i ons i s
THUMB.
The f ol l owi ng ar e val ues f or t he Eur opean ver si on of t he A1000.
EManuf act ur er = Mot or ol a
EManuf act ur er Har dwar eRev = 0x3
EManuf act ur er Sof t war eRev = 0x001
EManuf act ur er Sof t war eBui l d = 0x7cdac
EModel = 0x10202892
EMachi neUi d = Par agonEur opean
EDevi ceFami l y = quar t z
EDevi ceFami l yRev = 0x001
ECPU = ar m
ECPUAr ch = 0x400
ECPUABI = ar mi
ECPUSpeed = 172032
ESyst emSt ar t upReason = col d
ESyst emExcept i on = 0
ESyst emTi ckPer i od = 15625
EMemor yRAM = 4
EMemor yRAMFr ee = 4
EMemor yROM = 12
EMemor yPageSi ze = 0x1000
EPower Good = 1
EPower Bat t er ySt at us = good
EPower Backup = 1
EPower BackupSt at us = good
EPower Ext er nal = 1
EKeyboar d = f ul l
EKeyboar dDevi ceKeys = 0
EKeyboar dAppKeys = 0
EKeyboar dCl i ck = 1
EKeyboar dCl i ckSt at e = 1
EKeyboar dCl i ckVol ume = 0
EKeyboar dCl i ckVol umeMax = 1
EPen = 1
EPenX = 208
EPenY = 320
EPenDi spl ayOn = 0
EPenCl i ck = 1
EPenCl i ckSt at e = 1
EPenCl i ckVol ume = 0

Copyr i ght 1998 - 2004 Mot or ol a, I nc. 28




EPenCl i ckVol umeMax = 1
EMouse = 0
ECaseSwi t ch = 0
ELEDs = 0
EI nt egr at edPhone = 0
ESyst emDr i ve = 0x2
EDi spl ayXPi xel s = 0
EDi spl ayYPi xel s = 0
EDi spl ayXTwi ps = 0
EDi spl ayYTwi ps = 0
EDi spl ayCol or s = 65536
EDi spl aySt at e = 1
EDi spl ayCont r ast = 0
EDi spl ayCont r ast Max = 0
EBackl i ght = 0
EBackl i ght St at e = 0
EDi spl ayI sMono = 0
EDi spl ayI sPal et t i zed = 0
EDi spl ayBi t sPer Pi xel = 0
EDi spl ayNumModes = 0
EDi spl ayMemor yAddr ess = 0
EDi spl ayOf f set ToFi r st Pi xel = 0
EDi spl ayOf f set Bet weenLi nes = 0
EDi spl ayPal et t eEnt r y = 0
EDi spl ayI sPi xel Or der RGB = 0
EDi spl ayI sPi xel Or der Landscape = 0
EDi spl ayMode = 0
EDi spl ayBr i ght ness = 0
EDi spl ayBr i ght nessMax = 0
EDebugPor t = 0
ELocal eLoaded = 0
ELanguageI ndex = 1
EEnabl eTouchScr een = 0
EDi sabl eTouchScr een = 0
EDi gi t i ser Swi t chOn = 0
EDi gi t i ser Swi t chOf f = 0


The f ol l owi ng ar e val ues f or t he Chi nese ver si on of t he A1000 di f f er ent t han
t he Eur opean ver si on.
EManuf act ur er Sof t war eBui l d = 0x300
EMachi neUi d = Par agonChi nese


Copyr i ght 1998 - 2004 Mot or ol a, I nc. 29