JSR 82 BT APIs Prof. Dr. S. Heiss / 1. Bluetooth. JSR 82 Java APIs for Bluetooth Wireless Technology

Transcription

1 Prof. Dr. S. Heiss / 1 Bluetooth JSR 82 Java APIs for Bluetooth Wireless Technology

2 Prof. Dr. S. Heiss / 2 JSR 82 Bluetooth APIs Umfangreiche Spezifikation unter: JSR 82 definiert optionale Pakete: javax.bluetooth javax.obex Quelle: Java APIs for Bluetooth Wireless Technology (JSR 82)

3 Prof. Dr. S. Heiss / 3 Bluetooth Protokolle Service Discovery Protocol Object Exchange Protocol RS-232 serial connection over Bluetooth Logical Link Control and Adaption Protocol Host Controller Interface Link Manager Protocol Quelle: Java APIs for Bluetooth Wireless Technology (JSR 82)

4 Prof. Dr. S. Heiss / 4 Der BT-Transceiver LocalDevice DeviceClass

5 Prof. Dr. S. Heiss / 5 LocalDevice Instanz einer Repräsentation des BT-Geräts LocalDevice.getLocalDevice() Eigenschaften des BT-Geräts getbluetoothaddress() getfriendlyname() getdiscoverable() getdeviceclass() DeviceClass getproperty() (siehe folgende Seite) [ispoweron()] (ab JSR 82, v1.1, Absturz bei N95)

6 Prof. Dr. S. Heiss / 6 Device Properties Quelle: Java APIs for Bluetooth Wireless Technology (JSR 82)

7 Prof. Dr. S. Heiss / 7 DeviceClass getserviceclasses() getmajordeviceclass() getminordeviceclass() Quelle: Bluetooth SIG, Assigned Numbers, The Class of Device/Service field

8 Prof. Dr. S. Heiss / 8 DeviceClass - getserviceclasses() 0x Limited Discoverable Mode 0x Positioning (Location identification) 0x Networking (LAN, Ad hoc,...) 0x Rendering (Printing, Speaker,...) 0x Capturing (Scanner, Microphone,...) 0x Object Transfer (v-inbox, v-folder,...) 0x Audio (Speaker, Microphone, Headset,...) 0x Telephony (Cordless telephony, Modem,...) 0x Information (WEB-server, WAP-server,...)

9 Prof. Dr. S. Heiss / 9 DeviceClass - getmajordeviceclass() 0x0000 Miscellaneous 0x0100 Computer (desktop, notebook, PDA,...) 0x0200 Phone (cellular, cordless, payphone,...) 0x0300 LAN/Network Access point 0x0400 Audio/Video (headset, speaker, stereo,...) 0x0500 Peripheral (mouse, joystick, keyboards,..) 0x0600 Imaging (printing, scanner, camera,...) 0x0700 Wearable 0x0800 Toy

10 Prof. Dr. S. Heiss / 10 DeviceClass - getminordeviceclass() - Computer Major Device Class 0x0100 0x00 Uncategorized 0x04 Desktop workstation 0x08 Server-class computer 0x0C Laptop 0x10 Handheld PC/PDA (clam shell) 0x14 Palm sized PC/PDA 0x18 Wearable computer (Watch sized)

11 Prof. Dr. S. Heiss / 11 DeviceClass - getminordeviceclass() - Phone Major Device Class 0x0200 0x00 Uncategorized 0x04 Cellular 0x08 Cordless 0x0C Smart phone 0x10 Wired modem or voice gateway 0x14 Common ISDN Access

12 Prof. Dr. S. Heiss / 12 DeviceClass - getminordeviceclass() - LAN AP Major Device Class 0x0300 0x00 Fully available 0x % utilized 0x % utilized 0x0C 33-50% utilized 0x % utilized 0x % utilized 0x % utilized 0x1C No service available

13 Prof. Dr. S. Heiss / 13 DeviceClass - getminordeviceclass() - Audio/Video Major Device Class 0x0400 0x00 Uncategorized 0x04 Wearable Headset Device 0x08 Hands-free Device 0x0C Reserved 0x10 Microphone 0x14 Loudspeaker 0x18 Headphones 0x1C Portable Audio

14 Prof. Dr. S. Heiss / 14 DeviceClass - getminordeviceclass() - Audio/Video Major Device Class 0x0400 0x20 Car audio 0x24 Set-top box 0x28 HiFi Audio Device 0x2C VCR 0x30 Video Camera 0x34 Camcorder 0x38 Video Monitor 0x3C Video Display and Loudspeaker

15 Prof. Dr. S. Heiss / 15 DeviceClass - getminordeviceclass() - Audio/Video Major Device Class 0x0400 0x40 Video Conferencing 0x44 Reserved 0x48 Gaming/Toy

16 Prof. Dr. S. Heiss / 16 DeviceClass - getminordeviceclass() - Peripheral Major Device Class 0x0500 Keyboard/Pointing Device field (may be combined with lower bit fields in multifunctional devices) 0x00 Not Keyboard / Not Pointing Device 0x40 Keyboard 0x80 Pointing device 0xC0 Combo keyboard/pointing device

17 Prof. Dr. S. Heiss / 17 DeviceClass - getminordeviceclass() - Peripheral Major Device Class 0x0500 0x00 Uncategorized 0x04 Joystick 0x08 Gamepad 0x0C Remote control 0x10 Sensing device 0x14 Digitizer tablet 0x18 Card Reader (e.g. SIM Card Reader) 0x1C Portable Audio

18 Prof. Dr. S. Heiss / 18 DeviceClass - getminordeviceclass() - Imaging Major Device Class 0x0600 0x00 Uncategorized 0x10 Display 0x20 Camera 0x40 Scanner 0x80 Printer

19 Prof. Dr. S. Heiss / 19 DeviceClass - getminordeviceclass() - Wearable Major Device Class 0x0700 0x04 Wrist Watch 0x08 Pager 0x0C Jacket 0x10 Helmet 0x14 Glasses

20 Prof. Dr. S. Heiss / 20 DeviceClass - getminordeviceclass() - Toy Major Device Class 0x0800 0x04 Robot 0x08 Vehicle 0x0C Doll/Action Figure 0x10 Controller 0x14 Game

21 Prof. Dr. S. Heiss / 21 Device Discovery und Service Search RemoteDevice DiscoveryAgent DiscoveryListener

22 Prof. Dr. S. Heiss / 22 DiscoveryAgent und DiscoveryListener Instanz eines DiscoveryAgents LocalDevice.getLocalDevice().getDiscoveryAgent() Device Discovery DiscoveryListener startinquiry(), cancelinquiry() Service Search DiscoveryListener searchservices(), cancelservicesearch(), selectservice() Cached und Preknown Remote Devices retrievedevices()

23 Prof. Dr. S. Heiss / 23 Device Discovery DiscoveryAgent startinquiry(int accesscode, DiscoveryListener listener) cancelinquiry( DiscoveryListener listener ) DiscoveryListener devicediscovered( RemoteDevice btdevice, DeviceClass cod ) inquirycompleted( int disctype )

24 Prof. Dr. S. Heiss / 24 Device Discovery - DiscoveryAgent startinquiry( int accesscode, DiscoveryListener listener ) Access Codes DiscoveryAgent.GIAC DiscoveryAgent.LIAC

25 Prof. Dr. S. Heiss / 25 Device Discovery - DiscoveryListener devicediscovered( RemoteDevice rd, DeviceClass cod ) inquirycompleted( int disctype ) RemoteDevice DeviceClass

26 Prof. Dr. S. Heiss / 26 Service Search (Service Discovery Protocol - SDP) DiscoveryAgent searchservices( int[] attrset, UUID[] uuidset, RemoteDevice dev, DiscoveryListener listener ) cancelservicesearch( int transid ) selectservice( UUID uuid, int security, boolean master ) DiscoveryListener servicesdiscovered( int transid, ServiceRecord[] records ) servicesearchcompleted( int transid, int code )

27 Prof. Dr. S. Heiss / 27 Service Search - DiscoveryAgent searchservices( int[] attrset, UUID[] uuidset, RemoteDevice dev, DiscoveryListener listener ) Abfrage aller vom RemoteDevice dev zur Verfügung gestellten Services, die alle in uuidset vorhandene UUIDs in dem entsprechenden SDDB-Eintrag enthält. attrset: Attribute, die zusätzlich zu den Default- Attributen in den aufgrund des searchservices() Requests in den Aufrufen der Method servicesdiscovered() des listener Objekts in den ServiceRecord Parametern enthalten sein sollen.

28 Prof. Dr. S. Heiss / 28 Service Search BT Service Attributes Wichtige Service-Attribute (BT Assigned Numbers) Default- Attribute Base attribute ID value for the primary language is 0x0100 Quelle: JSR 82 JavaDoc für das Interface ServiceRecord der Forum Nokia Library (

29 Prof. Dr. S. Heiss / 29 UUIDs Universally Unique Identifier Wichtige UUIDs für Protokolle und Serviceklassen (BT Assigned Numbers) UUID Quelle: JSR 82 JavaDoc für die Klasse UUID der Forum Nokia Library (

30 Prof. Dr. S. Heiss / 30 Service Search - DiscoveryAgent searchservices( int[] attrset, UUID[] uuidset, RemoteDevice dev, DiscoveryListener listener )

31 Prof. Dr. S. Heiss / 31 Service Search DiscoveryListener servicesdiscovered( int transid, ServiceRecord[] records ) servicesearchcompleted( int transid, int code ) ServiceRecord

32 Prof. Dr. S. Heiss / 32 ServiceRecord und DataElement ServiceRecord getattributeids() DataElement getattributevalue( int attrid ) DataElement getconnectionurl( int requiredsecurity, boolean mustbemaster ) Quelle: JSR 82 JavaDoc für die Klasse DataElement der Forum Nokia Library (

33 Prof. Dr. S. Heiss / 33 BT-Verbindungen (Server und Client) Generic Connection Framework DiscoveryAgent DiscoveryListener

34 Prof. Dr. S. Heiss / 34 BT-Server Generic Connection Framework (GCF) Server Loop javax.microedition.io.connector open( String url ) StreamConnectionNotifier acceptandopen() StreamConnection

35 Prof. Dr. S. Heiss / 35 BT-Server Generic Connection Framework (GCF) Connection Loop StreamConnection

36 Prof. Dr. S. Heiss / 36 BT-Client Generic Connection Framework (GCF) Verbindungsaufbau mit der URL, die vom entsp. ServiceRecord der Servicesuche bekannt ist javax.microedition.io.connector open( String url ) StreamConnection