Motorola HANDSET C381P User Manual

Browse online or download User Manual for Mobile phones Motorola HANDSET C381P. Motorola HANDSET C381P User Manual

  • Download
  • Add to my manuals
  • Print
  • Page
    / 130
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews

Summary of Contents

Page 1 - J2ME™ Developer Guide

Technical Manual Version 01.00 Motorola C381p Handset J2ME™ Developer Guide

Page 2 - Table of Contents

1 Introduction 10 1 Introduction Purpose This document describes the application program interfaces used to develop Motorola compliant Java™ 2 Platf

Page 3

25 Auto Launch of Midlets 100 25 Auto Launch of Midlets The Java framework on the device must provide a mechanism to automatically launch midlets ba

Page 4

26 Background Applications 101 26 Background Applications Background Attribute A Motorola specific JAD attribute called background exists. MIDlets w

Page 5

26 Background Applications 102 Figure 13 Java service menu for a MIDlet with background attributes Pressing the EN

Page 6 - Table of Figures

27 Java System Menu 103 27 Java System Menu The Java System menu allows the user to see what version of MIDP and CLDC is being used in the phone. It

Page 7 - Index of Tables

27 Java System Menu 104 View MIDlet Suite Information To view information on any MIDlet suite, the user brings up the MIDlet Manager menu. The user

Page 8

27 Java System Menu 105 highlights the Delete option and SELECTs it to delete the suite. This brings up a confirmation dialog. Upon confirmation by

Page 9 - Table of Code Samples

27 Java System Menu 106 • If the application name is longer than 12 characters, it must be truncated. The “Delete Entire Suite and All data?” text

Page 10 - Introduction

28 Invisible Net for J2ME 107 28 Invisible Net for J2ME Introduction This chapter presents the Invisible Net for J2ME feature for multi line graphi

Page 11 - References

28 Invisible Net for J2ME 108 • URLs associated with J2ME menus or components will be launched using one of the following methods: o HTTP download

Page 12 - Revision History

28 Invisible Net for J2ME 109 o CxD media team will provide or approve any J2ME menu icons or graphics. o Rendering guidelines for J2ME menu prom

Page 13 - Document Overview

1 Introduction 11 in connection with the ability or inability to use the Products, to the full extent these damages may be disclaimed by law. Some s

Page 14

28 Invisible Net for J2ME 110 • A developer may embed a URL within a context-sensitive menu. Because the prompts and URLs in this MRS are variable

Page 15 - J2ME Introduction

29 Download Midlet through PC 111 29 Download Midlet through PC To download MIDlets through a PC, make a connection to a PC through IrDA, Bluetooth,

Page 16 - MIDP 1.0

30 Operator Apps Provisioning 112 30 Operator Apps Provisioning The application provisioning feature uses the existing functionality to deliver a t

Page 17

31 MIDP 2.0 Security Model 113 31 MIDP 2.0 Security Model The following sections describe the MIDP 2.0 Default Security Model for the Motorola C381p

Page 18 - J2ME Applications

31 MIDP 2.0 Security Model 114 MIDletStateChangeException class in the javax.microedition.midlet package All constructors and inherited methods for

Page 19

31 MIDP 2.0 Security Model 115 Trusted MIDlet Suites Trusted MIDlet suites are MIDlet suites in which the integrity of the JAR file can be authentic

Page 20 - Downloading Applications

31 MIDP 2.0 Security Model 116 • No – will not allow the MIDlet suite access to the requested API or function that is protected. (No Access) The pr

Page 21 - Error Logs

31 MIDP 2.0 Security Model 117 Dial a call “Make Phone Call?” CBS “Use CBS?” Receive CBS “Receive CBS?” Table 27 Protected Functionality fot top

Page 22 - OTA and Download

31 MIDP 2.0 Security Model 118 operator, or certificate authority. Only root certificates stored on the handset will be supported by the Motorola C3

Page 23

31 MIDP 2.0 Security Model 119 Inserting Certificates into JAD When inserting a certificate into a JAD, the certificate path includes the signer cer

Page 24 - Application Management

1 Introduction 12 Revision History Version Date Name Reason 00.01 November 09, 2004 C.E.S.A.R. Initial Draft Definitions

Page 25 - System Menu

31 MIDP 2.0 Security Model 120 attribute with this name. The value of each attribute is abase64 encoded certificate that will need to be decoded and

Page 26

31 MIDP 2.0 Security Model 121 The Table 30 is a summary of MIDlet suite verification including dialog prompts: Initial State Verification Result

Page 27 - JAD Attributes

Appendix A: Audio Mix Table 122 Appendix A: Audio Mix Table Single tons Tone-Sequence Wav MP3 AMR MIDI Video w/audio Video w/o audio Single to

Page 28

Appendix B: Key Mapping 123 Appendix B: Key Mapping Key Mapping for the C381p The table below identifies key names and corresponding Java assignme

Page 29 - Java.lang Implementation

Appendix B: Key Mapping 124 The following table identifies keys that will be assigned to game actions defined in GameCanvas class of MIDP 2.0. Ac

Page 30 - Network APIs

Appendix C: Memory Management Calculation 125 Appendix C: Memory Management Calculation Available Memory The available memory on the Motorola C381p

Page 31

Appendix D: FAQ 126 Appendix D: FAQ Online FAQ The MOTOCODER developer program is online and able to provide access to Frequently Asked Questions

Page 32 - HTTPS Connection

Appendix E: HTTP Range 127 Appendix E: HTTP Range Graphic Description The following is a graphic description of HTTP Range: Figure 16 Description

Page 33

Appendix F: Spec Sheet 128 Appendix F: Spec Sheet C381p Spec Sheet Listed below is the spec sheet for the Motorola C381p handset. The spec sheet c

Page 34

Appendix F: Spec Sheet 129 Motorola C381pDeveloper Reference Sheet Band/Frequency GSM 850/900/1800/1900 GPRS Region Global Technology

Page 35 - JSR 135 Mobile Media API

1 Introduction 13 RTOS Real Time Operating System SDK Software Development Kit SMS Short Message Service SMSC Short Messaging Service Center SU

Page 36 - ToneControl

Appendix F: Spec Sheet 130 MOTOROLA and the Stylized M Logo are registered in the U.S. Patent &

Page 37 - VolumeControl

1 Introduction 14 Chapter 14 – SMS Messaging as GSM Extension: this chapter describes the SMS Access API. Chapter 15 – User Display Interface: this

Page 38 - Audio Media

2 J2ME Introduction 15 2 J2ME Introduction The Motorola C381p handset includes the Java™ 2 Platform, Micro Edition, also known as the J2ME platform.

Page 39 - Audio/x-tone-sequence

2 J2ME Introduction 16 The Configuration Layer used in the Motorola C381p handset is the Connected Limited Device Configuration 1.1 (CLDC 1.1) and

Page 40

2 J2ME Introduction 17 Resources and API’s Available MIDP 2.0 will provide support to the following functional areas on the Motorola C381p handset:

Page 41 - JSR 120 – Wireless Messaging

3 Developing and Packaging J2ME Applications 18 3 Developing and Packaging J2ME Applications Guide to Development in J2ME Introduction to Developme

Page 42 - SMS Port Numbers

3 Developing and Packaging J2ME Applications 19 in development of a MIDlet. The specifications listed above are designed to work upon devices that h

Page 43 - SMS Notification

Table of Contents 2 Table of Contents TABLE OF CONTENTS ...

Page 44

4 Downloading Applications 20 4 Downloading Applications Method of Downloading The option open to the developer for deploying the MIDlet to a physic

Page 45

4 Downloading Applications 21  904 JAR Size Mismatch  905 Attribute Mismatch  906 Invalid Descriptor  907 Invalid JAR  908 Incompatible Co

Page 46

4 Downloading Applications 22 Mismatch . Download match the size indicated in JAD 902 User Cancelled. OTA JAR Download User cancelled download Ca

Page 47

4 Downloading Applications 23 URL of JAR file Not specified Size of JAR file 8 Bytes Max Applicable Terminal Type not specified Application progr

Page 48

5 Application Management 24 5 Application Management The following sections describe the application management scheme for the Motorola C381p handse

Page 49 - Phonebook Access API

5 Application Management 25 If the user decides to save the data from the current MIDlet, the data will be preserved during the upgrade and the data

Page 50

5 Application Management 26 Refer to the Table 4 Java System menu: Action Description CLDC Version This displays the CLDC version that is being u

Page 51

6 JAD Attributes 27 6 JAD Attributes JAD / Manifest Attribute Implementations The JAR manifest defines attributes to be used by the application man

Page 52

6 JAD Attributes 28 MIDlet-Info-URL A URL for information further describing the MIDlet suite. MIDlet-<n> The name, icon, and class of t

Page 53

7 Java.lang Implementation 29 7 Java.lang Implementation java.lang support Motorola implementation for the java.lang.System.getProperty method will

Page 54 - Telephony API

Table of Contents 3 JAVA.LANG SUPPORT ...

Page 55

8 Network APIs 30 8 Network APIs Network Connections The Motorola implementation of Networking APIs will support several network connections. The ne

Page 56 - Class Dialer

8 Network APIs 31 SecureConnection interface in the javax.microedition.io.package Supported SecurityInfo Interface in the javax.microedition.io.pac

Page 57

8 Network APIs 32 } while (bytes_read > 0); } catch (Exception ex) { System.out.p

Page 58

8 Network APIs 33 try { is[i] = hc[i].openInputStream(); byteCounts[i] = 0; readLengt

Page 59 - Interface DialerListener

8 Network APIs 34 } catch (Exception ex) { } hc[i] = null; } Code Sample 3 HTTPS Connection

Page 60

9 JSR 135 Mobile Media API 35 9 JSR 135 Mobile Media API JSR 135 Mobile Media API The JSR 135 Mobile Media APIs feature sets are defined for five di

Page 61 - Interface Hierarchy

9 JSR 135 Mobile Media API 36 catch (MediaException e) { System.out.println("FAILED: exception for realize: " + e.toString()); } // A

Page 62 - Serial Port Access

9 JSR 135 Mobile Media API 37 A tone sequence is specified as a list of non-tone duration pairs and user-defined sequence blocks and is packaged as

Page 63 - Extension

9 JSR 135 Mobile Media API 38 StopTimeControl StopTimeControl allows a specific preset sleep timer for a player. The JSR 135 Mobile Media API will i

Page 64 - Deleting a Message

9 JSR 135 Mobile Media API 39 Tone Sequences Audio Audio/x-tone-sequence Table 8 List of audio MIME types Refer to the Table 9 for multimedia fe

Page 65 - User Display Interface

Table of Contents 4 CANVAS FUNCTIONALITY...

Page 66

9 JSR 135 Mobile Media API 40 Note: If two wave plays have the same frequency, they can mix. See Appendix A – mix audio table. Player number limit

Page 67 - Hardware Mapping

10 JSR 120 – Wireless Messaging API 41 10 JSR 120 – Wireless Messaging API Wireless Messaging API (WMA) Motorola has implemented certain features

Page 68

10 JSR 120 – Wireless Messaging API 42 (MessageConnection)Connector.open("sms://:6000"); Messages received with this identifier will the

Page 69

10 JSR 120 – Wireless Messaging API 43 SMS Message Types The types of messages that can be sent are TEXT or BINARY, the method of encoding the messa

Page 70

10 JSR 120 – Wireless Messaging API 44 Feature/Class Implementation JSR-120 API. Specifically, APIs defined in the javax.wireless.messaging package

Page 71 - One-Click Application Access

10 JSR 120 – Wireless Messaging API 45 byte[] newBin = new byte[size]; for (int i = 0; i < size; i++) { nextByte = (rand.nextI

Page 72 - Softkey Labels

10 JSR 120 – Wireless Messaging API 46 Setting of address without port number: message.setAddress("sms://+18473297274"); Sending of messa

Page 73 - Browser

10 JSR 120 – Wireless Messaging API 47 byte[] newBin = createBinary(msgLength); binMsg.setPayloadData(newBin); int num = connClient.numberOfSegmen

Page 74

10 JSR 120 – Wireless Messaging API 48 " + e.toString()); } } } Code Sample 5 JSR 120 Wireless Messaging API

Page 75 - Downloading MIDlets

11 Phonebook Access API 49 11 Phonebook Access API Phonebook Access API Using the Phonebook Access API, an application will be able to locate and u

Page 76

Table of Contents 5 27 JAVA SYSTEM MENU...

Page 77 - Different Error Checks

11 Phonebook Access API 50 In the Motorola C381p, Phonebook API permissions have been added to the MIDP 2.0 security framework “com.motorola.phonebo

Page 78

11 Phonebook Access API 51 Sample of code for calling of ‘getNumberRecords(int device)’ method: // get total number of records int numberRecsInPhon

Page 79 - Figure 7 Memory full error

11 Phonebook Access API 52 int maxTelNoLengthSim = PhoneBookRecord.getMaxTelNoLength(PhoneBookRecord.SIM_MEMORY); int maxTelNoLengthAll = PhoneBoo

Page 80

11 Phonebook Access API 53 buffer = new String("BEGIN:VCARD\r\nN:;" + new String(name) + "\r\nTEL;TYPE=WORK:1\r\nEND:VCARD\r\n"

Page 81

12 Telephony API 54 12 Telephony API The Telephony API allows a MIDlet to make a voice call, however, the user needs to confirm the action before an

Page 82

12 Telephony API 55 Summary static byte PHONE_VOICECALL_CONNECT Phone call was connected event static byte PHONE_VOICECALL_DISCONNECT

Page 83

12 Telephony API 56 PHONE_VOICECALL_CONNECT public static final byte PHONE_VOICECALL_CONNECT Phone call was connected event PHONE_VOICECALL_DISC

Page 84

12 Telephony API 57 void sendExtNo(String extNumber) send extension number. void setDialerListener(DialerListener listener)

Page 85 - UDP Support

12 Telephony API 58 startCall public void startCall(String telenumber) throws IOException start a phone call using given telephone nu

Page 86 - Shared JAD URLs

12 Telephony API 59 endCall public void endCall() throws IOException end or cancel a phone call Throws: IOException - if the call cou

Page 87

Table of Figures 6 Table of Figures Figure 1 Java Platform...1

Page 88 - Downloading through Browser

12 Telephony API 60 } Asynchronous callback for receive phone call event public void notifyDialerEvent(Dialer dialer, byte event) {

Page 89 - Downloading through MMS

12 Telephony API 61 notifyDialerEvent public void notifyDialerEvent(Dialer dialer, byte event) Called by the platf

Page 90 - Get URL from Flex API

13 Serial Port Access 62 13 Serial Port Access The Serial Port RS232 API is incorporated into any J2ME device allowing connection to the J2ME serial

Page 91 - Security Policy

14 SMS Messaging as GSM Extension 63 14 SMS Messaging as GSM Extension The SMS APIs for J2ME environment enable the following functionality: • Crea

Page 92 - Multiple Key Press

14 SMS Messaging as GSM Extension 64 Viewing a Message The APIs should provide a way to get a list of messages that is associated with a specific a

Page 93

15 User Display Interface 65 15 User Display Interface The J2ME standard allows specific Canvas, Hardware Mapping and External Event Interaction fun

Page 94 - Table 20 ITAP feature/class

15 User Display Interface 66  All color types are supported, although the appearance of the image will be dependent on the capabilities of the dev

Page 95 - LCDUI API

15 User Display Interface 67 Hardware Mapping The J2ME standard provides a minimum key set that is determined to be available on all devices. These

Page 96

15 User Display Interface 68 The handset controls the rendering and positioning of these global commands, but the J2ME application determines the a

Page 97

15 User Display Interface 69 Figure 2 Active Global Commands - Back, Cancel, OK, Help & Stop Example 2: Upon start-up, the

Page 98

Index of Tables 7 Index of Tables Table 1 Error Logs ...

Page 99 - Table 23 LCDUI feature/class

15 User Display Interface 70 Volume Key Volume keys will not be supported in the first release of J2ME, Java 1.0. In following releases, when the

Page 100 - Auto Launch of Midlets

16 One-Click Application Access 71 16 One-Click Application Access The one-click access to J2ME applications Implementation allows the user to more

Page 101 - Background Applications

16 One-Click Application Access 72 • Large Icons - Until a better solution can be implemented, a generic large animated icon must be created for di

Page 102 - Flip Behaviors

17 Download MIDlet Through Browser 73 17 Download MIDlet Through Browser The Download MIDlet Through Browser requires the browser to be connected be

Page 103 - Java System Menu

17 Download MIDlet Through Browser 74 Star Active Browser Session from Main Menu The Figure 4 describes Staring Active Browser Session from Main Men

Page 104 - Deleting MIDlet Suites

17 Download MIDlet Through Browser 75 Downloading MIDlets The Figure 5 represents J2ME Application (MIDlets) Download and Installation. Figu

Page 105

17 Download MIDlet Through Browser 76 • If the DOWNLD softkey is selected, the handset starts downloading the application. The handset displays “Do

Page 106

17 Download MIDlet Through Browser 77 • During the installation process, if the flip is closed on a flip handset, the installation process will con

Page 107 - Invisible Net for J2ME

17 Download MIDlet Through Browser 78 provided in all MIDlets. Two separate prompts will be displayed depending on whether these attributes are pres

Page 108

17 Download MIDlet Through Browser 79 Figure 7 Memory full error Rules: • If Mot-Data-Space-Requirements and Mot-Program-Space-Requirements at

Page 109 - Hardware Requirements

Index of Tables 8 Table 26 Security feature/class support for MIDP 2.0... 114 Table 27 Protected Functionality fot top line of pr

Page 110

17 Download MIDlet Through Browser 80 Figure 8 Mot-Data-Space & Mot-Program-Space attributes are not present or are incorretct Rules: • If M

Page 111 - Download Midlet through PC

17 Download MIDlet Through Browser 81 Figure 9 Memory Full help message during installation process Rules: • The installation process is cancel

Page 112 - Operator Apps Provisioning

17 Download MIDlet Through Browser 82 Figure 10 Same Version of Application already exists on the handset Rules: • Handset checks for MIDlet-Nam

Page 113 - MIDP 2.0 Security Model

17 Download MIDlet Through Browser 83 Figure 11 Latest (Newer) Version of Application exists Rules: • If the latest or newer version of applica

Page 114 - Untrusted Domain

18 Lightweight Windowing Toolkit 84 18 Lightweight Windowing Toolkit LWT integrate with the LCDUI API within the MIDP and enhance the capabilities

Page 115 - Trusted MIDlet Suites

19 UDP Support 85 19 UDP Support This functionality is to enable J2ME applications access to Generic UDP Transport Service. • This enhancement all

Page 116 - Party Domain

20 Shared JAD URLs 86 20 Shared JAD URLs Overview Actually, users are able to download J2ME applications. The first step is to download the JAD f

Page 117 - Signing a MIDlet Suite

20 Shared JAD URLs 87 Accessing Tell-A-Friend from SMM The MIDlet Manager menu lets the user perform certain actions on the selected MIDlet suites.

Page 118 - Signer of MIDlet Suites

20 Shared JAD URLs 88 Figure 12 the MIDlet Manager and the context-sensitive menus Downloading through Browser Rules: • When downloading a J2ME a

Page 119

20 Shared JAD URLs 89 Downloading through MMS Rules: • When downloading an application via MMS, JAM shall use the JAD attribute Mot-Midlet- URL if

Page 120

Table of Code Samples 9 Table of Code Samples Code Sample 1 Java.lang support ...2

Page 121

21 Get URL from Flex API 90 21 Get URL from Flex API Overview This feature allows accessing URL stored in FLEX by a Java application. Carriers fle

Page 122 - Audio Mix Table

21 Get URL from Flex API 91 Security Policy Only trusted applications will be granted permission to access this property.

Page 123 - Key Mapping

22 Multiple Key Press 92 22 Multiple Key Press Multi-button press support enhances the gaming experience for the user. Multi-button press support gi

Page 124

22 Multiple Key Press 93 key. Map the DOWN_PRESSED field in javax.microedition.lcdui.GameCanvas to the bottom position of the key Supported Map the

Page 125 - Calculation

23 iTAP 94 23 iTAP Intelligent Keypad Text Entry API When users are using features such as SMS (short message service), or “Text Messaging”, they ca

Page 126 - Appendix D:

24 LCDUI 95 24 LCDUI LCDUI API The Table 21 lists the specific interfaces supported by Motorola implementation: Interface Description Choice Choic

Page 127 - HTTP Range

24 LCDUI 96 visual and interactive elements into Forms. DateField A DateField is an editable component for presenting date and time (calendar) info

Page 128 - Spec Sheet

24 LCDUI 97 Will provide and play an audible sound when the play Sound() method is called with an AlertType of WARNING Supported Will provide and pl

Page 129 - Motorola C381p

24 LCDUI 98 package All fields, methods, and inherited methods for the Display class in the javax.microedition.lcdui package Supported Maximum color

Page 130

24 LCDUI 99 All fields, constructors, methods, inherited fields, and inherited methods for the TextField class in the javax.microedition.lcdui packa

Comments to this Manuals

No comments