lejos.pc.comm
Class NXTCommBluez

java.lang.Object
  lejos.pc.comm.NXTCommBluez

All Implemented Interfaces:

lejos.internal.jni.JNIClass, NXTCommRequest, NXTComm

public class NXTCommBluez
extends java.lang.Object
implements NXTComm, lejos.internal.jni.JNIClass

Implementation of NXTComm using the the jbluez library on Linux or Unix systems. Should not be used directly - use NXTCommFactory to create an appropriate NXTComm object for your system and the protocol you are using.

Field Summary

Fields inherited from interface lejos.pc.comm.NXTComm

LCP, PACKET, RAW

Constructor Summary

NXTCommBluez()

Method Summary

int	available() Request the number of bytes available to read.
void	close() Close the connection
java.io.InputStream	getInputStream() Return an InputStream for reading a stream of data from the NXT over this connection.
java.io.OutputStream	getOutputStream() Return an OutputStream for writing a stream of data to the NXT over this connection.
boolean	initialize(lejos.internal.jni.JNILoader jnil) Return false, if the
boolean	open(NXTInfo nxt) Connect to a NXT found by a search or created from name and address.
boolean	open(NXTInfo nxt, int mode) Connect to a NXT found by a search or created from name and address.
byte[]	read() Read data from a NXT that has an open connection.
NXTInfo[]	search(java.lang.String name) Search for NXTs over USB, Bluetooth or both
byte[]	sendRequest(byte[] request, int replyLen) Send an LCP message to the NXT and receive a reply
void	write(byte[] data) Write data to a NXT that has an open connection.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NXTCommBluez

public NXTCommBluez()

Method Detail

search

public NXTInfo[] search(java.lang.String name)

Description copied from interface: NXTComm

Search for NXTs over USB, Bluetooth or both

Specified by:

search in interface NXTComm

Parameters:

name - name of the NXT or null

Returns:

a NXTInfo object describing the NXt found and the connection to it

close

public void close()
           throws java.io.IOException

Description copied from interface: NXTCommRequest

Close the connection

Specified by:

close in interface NXTCommRequest

Throws:

java.io.IOException

open

public boolean open(NXTInfo nxt,
                    int mode)
             throws NXTCommException

Description copied from interface: NXTComm

Connect to a NXT found by a search or created from name and address.

Specified by:

open in interface NXTComm

Parameters:

nxt - the NXTInfo object for the NXT

mode - the mode for the connection: NXTComm.LCP, NXTComm.PACKET or NXTComm.RAW

Returns:

true if the open succeeded

Throws:

NXTCommException

open

public boolean open(NXTInfo nxt)
             throws NXTCommException

Description copied from interface: NXTComm

Connect to a NXT found by a search or created from name and address.

Specified by:

open in interface NXTComm

Parameters:

nxt - the NXTInfo object for the NXT

Returns:

true if the open succeeded

Throws:

NXTCommException

sendRequest

public byte[] sendRequest(byte[] request,
                          int replyLen)
                   throws java.io.IOException

Description copied from interface: NXTCommRequest

Send an LCP message to the NXT and receive a reply

Specified by:

sendRequest in interface NXTCommRequest

Parameters:

request - the LCP message

replyLen - the reply length expected

Returns:

the reply

Throws:

java.io.IOException

read

public byte[] read()
            throws java.io.IOException

Description copied from interface: NXTComm

Read data from a NXT that has an open connection. Used for stream connections.

Specified by:

read in interface NXTComm

Returns:

the data in a byte[] array

Throws:

java.io.IOException

available

public int available()
              throws java.io.IOException

Description copied from interface: NXTComm

Request the number of bytes available to read.

Specified by:

available in interface NXTComm

Returns:

the number of bytes available

Throws:

java.io.IOException

write

public void write(byte[] data)
           throws java.io.IOException

Description copied from interface: NXTComm

Write data to a NXT that has an open connection.

Specified by:

write in interface NXTComm

Parameters:

data - the data to be written. Used for stream connections.

Throws:

java.io.IOException

getOutputStream

public java.io.OutputStream getOutputStream()

Description copied from interface: NXTComm

Return an OutputStream for writing a stream of data to the NXT over this connection.

Specified by:

getOutputStream in interface NXTComm

Returns:

the OutputStream object

getInputStream

public java.io.InputStream getInputStream()

Description copied from interface: NXTComm

Return an InputStream for reading a stream of data from the NXT over this connection.

Specified by:

getInputStream in interface NXTComm

Returns:

the InputStream object

initialize

public boolean initialize(lejos.internal.jni.JNILoader jnil)
                   throws lejos.internal.jni.JNIException

Description copied from interface: lejos.internal.jni.JNIClass

Return false, if the

Specified by:

initialize in interface lejos.internal.jni.JNIClass

Parameters:

jnil - instance of JNILoader

Returns:

false, if the class is not suitable for this platform

Throws:

lejos.internal.jni.JNIException - if something went wrong loading the JNI library