rusefi
/
jSerialComm
mirror of https://github.com/rusefi/jSerialComm.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

per instance

This commit is contained in:
rusefillc 2022-02-13 14:07:11 -05:00
parent 60b90199bf
commit 80d9ff55a6
1 changed files with 96 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

109
src/main/java/com/fazecast/jSerialComm/SerialPort.java
View File

@ -54,6 +54,10 @@ public final class SerialPort
static private final String tmpdirAppIdProperty = "fazecast.jSerialComm.appid";
static private volatile boolean isAndroid = false;
static private volatile boolean isWindows = false;
/**
* See https://stackoverflow.com/questions/442564/avoid-synchronizedthis-in-java for pros and cons
*/
private final Object lock = new Object();
static
{
// Determine the temporary file directory for Java and remove any previous versions of this library
@ -582,8 +586,9 @@ public final class SerialPort
* @param deviceReceiveQueueSize The requested size in bytes of the internal device driver's input queue (no effect on Linux/OSX)
* @return Whether the port was successfully opened with a valid configuration.
*/
public final synchronized boolean openPort(int safetySleepTime, int deviceSendQueueSize, int deviceReceiveQueueSize)
public final boolean openPort(int safetySleepTime, int deviceSendQueueSize, int deviceReceiveQueueSize)
{
synchronized (lock) {
// Synchronize this method to the class scope as well
synchronized (SerialPort.class)
{
@ -639,6 +644,7 @@ public final class SerialPort
return (portHandle != 0);
}
}
}
/**
* Opens this serial port for reading and writing with an optional delay time.
@ -682,8 +688,9 @@ public final class SerialPort
*
* @return Whether the port was successfully closed.
*/
public final synchronized boolean closePort()
public final boolean closePort()
{
synchronized (lock) {
// Synchronize this method to the class scope as well
synchronized (SerialPort.class)
{
@ -694,13 +701,18 @@ public final class SerialPort
return (portHandle == 0);
}
}
}
/**
* Returns whether the port is currently open and available for communication.
*
* @return Whether the port is opened.
*/
public final synchronized boolean isOpen() { return (portHandle != 0); }
public final boolean isOpen() {
synchronized (lock) {
return (portHandle != 0);
}
}
/**
* Disables the library from calling any of the underlying device driver configuration methods.
@ -709,7 +721,11 @@ public final class SerialPort
* with buggy device drivers. In that case, this function <b>must</b> be called before attempting to
* open the port.
*/
public final synchronized void disablePortConfiguration() { disableConfig = true; }
public final void disablePortConfiguration() {
synchronized (lock) {
disableConfig = true;
}
}
/**
* Disables the library from obtaining an exclusive lock on the serial port.
@ -717,7 +733,11 @@ public final class SerialPort
* This function should never be called except on very specific systems which do not support obtaining
* exclusive locks on system resources.
*/
public final synchronized void disableExclusiveLock() { disableExclusiveLock = true; }
public final void disableExclusiveLock() {
synchronized (lock) {
disableExclusiveLock = true;
}
}
/**
* Allows the library to request elevation of the current user's permissions for use in making certain
@ -740,7 +760,11 @@ public final class SerialPort
* situations, this function may make it easier for your application to automatically apply these
* necessary changes.
*/
public final synchronized void allowElevatedPermissionsRequest() { requestElevatedPermissions = true; }
public final void allowElevatedPermissionsRequest() {
synchronized (lock) {
requestElevatedPermissions = true;
}
}
/**
* Returns the source code line location of the latest error encountered during execution of
@ -751,7 +775,11 @@ public final class SerialPort
*
* @return Source line of latest native code error.
*/
public final synchronized int getLastErrorLocation() { return getLastErrorLocation(portHandle); }
public final int getLastErrorLocation() {
synchronized (lock) {
return getLastErrorLocation(portHandle);
}
}
/**
* Returns the error number returned by the most recent native source code line that failed execution.
@ -761,7 +789,11 @@ public final class SerialPort
*
* @return Error number of the latest native code error.
*/
public final synchronized int getLastErrorCode() { return getLastErrorCode(portHandle); }
public final int getLastErrorCode() {
synchronized (lock) {
return getLastErrorCode(portHandle);
}
}
// Serial Port Setup Methods
private static native void initializeLibrary(); // Initializes the JNI code
@ -1035,8 +1067,9 @@ public final class SerialPort
* @see SerialPortMessageListener
* @see SerialPortMessageListenerWithExceptions
*/
public final synchronized boolean addDataListener(SerialPortDataListener listener)
public final boolean addDataListener(SerialPortDataListener listener)
{
synchronized (lock) {
if (userDataListener != null)
return false;
userDataListener = listener;
@ -1054,12 +1087,14 @@ public final class SerialPort
}
return true;
}
}
/**
* Removes the associated {@link SerialPortDataListener} from the serial port interface.
*/
public final synchronized void removeDataListener()
public final void removeDataListener()
{
synchronized (lock) {
eventFlags = 0;
if (serialEventListener != null)
{
@ -1070,6 +1105,7 @@ public final class SerialPort
}
userDataListener = null;
}
}
/**
* Returns an {@link java.io.InputStream} object associated with this serial port.
@ -1157,14 +1193,16 @@ public final class SerialPort
*
* @return Whether the IO buffers were (or will be) successfully flushed.
*/
public final synchronized boolean flushIOBuffers()
public final boolean flushIOBuffers()
{
synchronized (lock) {
autoFlushIOBuffers = true;
if (portHandle != 0)
return flushRxTxBuffers(portHandle);
return true;
}
}
/**
* Sets all serial port parameters at one time.
@ -1232,8 +1270,9 @@ public final class SerialPort
* @see #MARK_PARITY
* @see #SPACE_PARITY
*/
public final synchronized boolean setComPortParameters(int newBaudRate, int newDataBits, int newStopBits, int newParity, boolean useRS485Mode)
public final boolean setComPortParameters(int newBaudRate, int newDataBits, int newStopBits, int newParity, boolean useRS485Mode)
{
synchronized (lock) {
baudRate = newBaudRate;
dataBits = newDataBits;
stopBits = newStopBits;
@ -1248,6 +1287,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Sets the serial port read and write timeout parameters.
@ -1298,8 +1338,9 @@ public final class SerialPort
* @param newWriteTimeout The number of milliseconds of inactivity to tolerate before returning from a {@link #writeBytes(byte[],long)} call (effective only on Windows).
* @return Whether the port configuration is valid or disallowed on this system (only meaningful after the port is already opened).
*/
public final synchronized boolean setComPortTimeouts(int newTimeoutMode, int newReadTimeout, int newWriteTimeout)
public final boolean setComPortTimeouts(int newTimeoutMode, int newReadTimeout, int newWriteTimeout)
{
synchronized (lock) {
timeoutMode = newTimeoutMode;
if (isWindows)
{
@ -1319,6 +1360,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Sets the desired baud rate for this serial port.
@ -1328,8 +1370,9 @@ public final class SerialPort
* @param newBaudRate The desired baud rate for this serial port.
* @return Whether the port configuration is valid or disallowed on this system (only meaningful after the port is already opened).
*/
public final synchronized boolean setBaudRate(int newBaudRate)
public final boolean setBaudRate(int newBaudRate)
{
synchronized (lock) {
baudRate = newBaudRate;
if (portHandle != 0)
@ -1340,6 +1383,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Sets the desired number of data bits per word.
@ -1349,8 +1393,9 @@ public final class SerialPort
* @param newDataBits The desired number of data bits per word.
* @return Whether the port configuration is valid or disallowed on this system (only meaningful after the port is already opened).
*/
public final synchronized boolean setNumDataBits(int newDataBits)
public final boolean setNumDataBits(int newDataBits)
{
synchronized (lock) {
dataBits = newDataBits;
if (portHandle != 0)
@ -1361,6 +1406,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Sets the desired number of stop bits per word.
@ -1376,8 +1422,9 @@ public final class SerialPort
* @see #ONE_POINT_FIVE_STOP_BITS
* @see #TWO_STOP_BITS
*/
public final synchronized boolean setNumStopBits(int newStopBits)
public final boolean setNumStopBits(int newStopBits)
{
synchronized (lock) {
stopBits = newStopBits;
if (portHandle != 0)
@ -1388,6 +1435,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Specifies what kind of flow control to enable for this serial port.
@ -1424,8 +1472,9 @@ public final class SerialPort
* @see #FLOW_CONTROL_XONXOFF_IN_ENABLED
* @see #FLOW_CONTROL_XONXOFF_OUT_ENABLED
*/
public final synchronized boolean setFlowControl(int newFlowControlSettings)
public final boolean setFlowControl(int newFlowControlSettings)
{
synchronized (lock) {
flowControl = newFlowControlSettings;
if (portHandle != 0)
@ -1436,6 +1485,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Sets the desired parity error-detection scheme to be used.
@ -1451,18 +1501,23 @@ public final class SerialPort
* @see #MARK_PARITY
* @see #SPACE_PARITY
*/
public final synchronized boolean setParity(int newParity)
public final boolean setParity(int newParity)
{
synchronized (lock) {
parity = newParity;
if (portHandle != 0)
{
if (portHandle != 0) {
if (safetySleepTimeMS > 0)
try { Thread.sleep(safetySleepTimeMS); } catch (Exception e) { Thread.currentThread().interrupt(); }
try {
Thread.sleep(safetySleepTimeMS);
} catch (Exception e) {
Thread.currentThread().interrupt();
}
return configPort(portHandle);
}
return true;
}
}
/**
* Sets RS-485 mode and its parameters for the device. This is a wrapper around
@ -1477,10 +1532,12 @@ public final class SerialPort
* @param delayAfterSendMicroseconds The time to wait after sending the last data bit before disabling transmit mode (effective only on Linux).
* @return Whether the port configuration is valid or disallowed on this system (only meaningful after the port is already opened).
*/
public final synchronized boolean setRs485ModeParameters(boolean useRS485Mode, boolean rs485RtsActiveHigh, int delayBeforeSendMicroseconds, int delayAfterSendMicroseconds)
public final boolean setRs485ModeParameters(boolean useRS485Mode, boolean rs485RtsActiveHigh, int delayBeforeSendMicroseconds, int delayAfterSendMicroseconds)
{
synchronized (lock) {
return setRs485ModeParameters(useRS485Mode, rs485RtsActiveHigh, false, false, delayBeforeSendMicroseconds, delayAfterSendMicroseconds);
}
}
/**
* Sets RS-485 mode and its parameters for the device.
@ -1506,8 +1563,9 @@ public final class SerialPort
* @param delayAfterSendMicroseconds The time to wait after sending the last data bit before disabling transmit mode (effective only on Linux).
* @return Whether the port configuration is valid or disallowed on this system (only meaningful after the port is already opened).
*/
public final synchronized boolean setRs485ModeParameters(boolean useRS485Mode, boolean rs485RtsActiveHigh, boolean enableTermination, boolean rxDuringTx,int delayBeforeSendMicroseconds, int delayAfterSendMicroseconds)
public final boolean setRs485ModeParameters(boolean useRS485Mode, boolean rs485RtsActiveHigh, boolean enableTermination, boolean rxDuringTx,int delayBeforeSendMicroseconds, int delayAfterSendMicroseconds)
{
synchronized (lock) {
rs485Mode = useRS485Mode;
rs485ActiveHigh = rs485RtsActiveHigh;
rs485EnableTermination = enableTermination;
@ -1523,6 +1581,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Sets custom XON/XOFF flow control characters for the device.
@ -1535,8 +1594,9 @@ public final class SerialPort
* @param xoffStopCharacter The decimal-based character to use as an XOFF signal.
* @return Whether the port configuration is valid or disallowed on this system (only meaningful after the port is already opened).
*/
public final synchronized boolean setXonXoffCharacters(byte xonStartCharacter, byte xoffStopCharacter)
public final boolean setXonXoffCharacters(byte xonStartCharacter, byte xoffStopCharacter)
{
synchronized (lock) {
xonStartChar = xonStartCharacter;
xoffStopChar = xoffStopCharacter;
@ -1548,6 +1608,7 @@ public final class SerialPort
}
return true;
}
}
/**
* Gets a descriptive string representing this serial port or the device connected to it.