Package jssc
Class SerialNativeInterface
java.lang.Object
jssc.SerialNativeInterface
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
closePort
(long handle) Close portint[]
getBuffersBytesCount
(long handle) Get bytes count in buffers of portint
getEventsMask
(long handle) Get events maskint
getFlowControlMode
(long handle) Get flow control modestatic String
Get jSSC Base Versionstatic String
Get jSSC minor suffix.static String
Get jSSC version.int[]
getLinesStatus
(long handle) Getting lines statesstatic String
Get jSSC native library versionstatic int
Get OS type (OS_LINUX || OS_WINDOWS || OS_SOLARIS)String[]
Get serial port names like an array of Stringlong
Open portboolean
purgePort
(long handle, int flags) Purge of input and output bufferbyte[]
readBytes
(long handle, int byteCount) Read data from portboolean
sendBreak
(long handle, int duration) Send Break singnal for setted durationboolean
setDTR
(long handle, boolean value) Change DTR line stateboolean
setEventsMask
(long handle, int mask) Set events maskboolean
setFlowControlMode
(long handle, int mask) Set flow control modeboolean
setParams
(long handle, int baudRate, int dataBits, int stopBits, int parity, boolean setRTS, boolean setDTR, int flags) Setting the parameters of opened portboolean
setRTS
(long handle, boolean value) Change RTS line stateint[][]
waitEvents
(long handle) Wait eventsboolean
writeBytes
(long handle, byte[] buffer) Write data to port
-
Field Details
-
OS_LINUX
public static final int OS_LINUX- See Also:
-
OS_WINDOWS
public static final int OS_WINDOWS- See Also:
-
OS_SOLARIS
public static final int OS_SOLARIS- See Also:
-
OS_MAC_OS_X
public static final int OS_MAC_OS_X- See Also:
-
ERR_PORT_BUSY
public static final long ERR_PORT_BUSY- Since:
- 2.3.0
- See Also:
-
ERR_PORT_NOT_FOUND
public static final long ERR_PORT_NOT_FOUND- Since:
- 2.3.0
- See Also:
-
ERR_PERMISSION_DENIED
public static final long ERR_PERMISSION_DENIED- Since:
- 2.3.0
- See Also:
-
ERR_INCORRECT_SERIAL_PORT
public static final long ERR_INCORRECT_SERIAL_PORT- Since:
- 2.3.0
- See Also:
-
PROPERTY_JSSC_NO_TIOCEXCL
- Since:
- 2.6.0
- See Also:
-
PROPERTY_JSSC_IGNPAR
- Since:
- 2.6.0
- See Also:
-
PROPERTY_JSSC_PARMRK
- Since:
- 2.6.0
- See Also:
-
-
Constructor Details
-
SerialNativeInterface
public SerialNativeInterface()
-
-
Method Details
-
getOsType
public static int getOsType()Get OS type (OS_LINUX || OS_WINDOWS || OS_SOLARIS)- Since:
- 0.8
-
getLibraryVersion
Get jSSC version. The version of library is Base Version + Minor Suffix- Since:
- 0.8
-
getLibraryBaseVersion
Get jSSC Base Version- Since:
- 0.9.0
-
getLibraryMinorSuffix
Get jSSC minor suffix. For example in version 0.8.1 - 1 is a minor suffix- Since:
- 0.9.0
-
getNativeLibraryVersion
Get jSSC native library version- Returns:
- native lib version (for jSSC-2.8.0 should be 2.8 for example)
- Since:
- 2.8.0
-
openPort
Open port- Parameters:
portName
- name of port for openinguseTIOCEXCL
- enable/disable using of TIOCEXCL. Take effect only on *nix based systems- Returns:
- handle of opened port or -1 if opening of the port was unsuccessful
-
setParams
public boolean setParams(long handle, int baudRate, int dataBits, int stopBits, int parity, boolean setRTS, boolean setDTR, int flags) Setting the parameters of opened port- Parameters:
handle
- handle of opened portbaudRate
- data transfer ratedataBits
- number of data bitsstopBits
- number of stop bitsparity
- paritysetRTS
- initial state of RTS line (ON/OFF)setDTR
- initial state of DTR line (ON/OFF)flags
- additional Native settings. Take effect only on *nix based systems- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
purgePort
public boolean purgePort(long handle, int flags) Purge of input and output buffer- Parameters:
handle
- handle of opened portflags
- flags specifying required actions for purgePort method- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
closePort
public boolean closePort(long handle) Close port- Parameters:
handle
- handle of opened port- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
setEventsMask
public boolean setEventsMask(long handle, int mask) Set events mask- Parameters:
handle
- handle of opened portmask
- events mask- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
getEventsMask
public int getEventsMask(long handle) Get events mask- Parameters:
handle
- handle of opened port- Returns:
- Method returns event mask as a variable of int type
-
waitEvents
public int[][] waitEvents(long handle) Wait events- Parameters:
handle
- handle of opened port- Returns:
- Method returns two-dimensional array containing event types and their values (events[i][0] - event type, events[i][1] - event value).
-
setRTS
public boolean setRTS(long handle, boolean value) Change RTS line state- Parameters:
handle
- handle of opened portvalue
- true - ON, false - OFF- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
setDTR
public boolean setDTR(long handle, boolean value) Change DTR line state- Parameters:
handle
- handle of opened portvalue
- true - ON, false - OFF- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
readBytes
public byte[] readBytes(long handle, int byteCount) Read data from port- Parameters:
handle
- handle of opened portbyteCount
- count of bytes required to read- Returns:
- Method returns the array of read bytes
-
writeBytes
public boolean writeBytes(long handle, byte[] buffer) Write data to port- Parameters:
handle
- handle of opened portbuffer
- array of bytes to write- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
-
getBuffersBytesCount
public int[] getBuffersBytesCount(long handle) Get bytes count in buffers of port- Parameters:
handle
- handle of opened port- Returns:
- Method returns the array that contains info about bytes count in buffers:
element 0 - input buffer
element 1 - output buffer - Since:
- 0.8
-
setFlowControlMode
public boolean setFlowControlMode(long handle, int mask) Set flow control mode- Parameters:
handle
- handle of opened portmask
- mask of flow control mode- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
- Since:
- 0.8
-
getFlowControlMode
public int getFlowControlMode(long handle) Get flow control mode- Parameters:
handle
- handle of opened port- Returns:
- Mask of setted flow control mode
- Since:
- 0.8
-
getSerialPortNames
Get serial port names like an array of String- Returns:
- unsorted array of String with port names
-
getLinesStatus
public int[] getLinesStatus(long handle) Getting lines states- Parameters:
handle
- handle of opened port- Returns:
- Method returns the array containing information about lines in following order:
element 0 - CTS line state
element 1 - DSR line state
element 2 - RING line state
element 3 - RLSD line state
-
sendBreak
public boolean sendBreak(long handle, int duration) Send Break singnal for setted duration- Parameters:
handle
- handle of opened portduration
- duration of Break signal- Returns:
- If the operation is successfully completed, the method returns true, otherwise false
- Since:
- 0.8
-