forked from scream3r/java-simple-serial-connector
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
206 lines (152 loc) · 9.11 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
[VinceOPS] jSSC-2.8.0 - First Fork and Changes (28.01.2015)
Essentially working on Linux (PC & ARM), this fork will contain small fixes/changes which match my projetcs requirements.
In this build:
Fixes:
* DSR "off" event (DSR state 0) was not emitted using (PC) Ubuntu 13.10 and (ARM SF) Debian Wheezy.
* Using the current JVM "arm type" (Soft-Float / Hard-Float) to define which library (sf or hf) should be loaded. Indeed, on MULTIARCH systems (like Debian), it is possible to use a Soft-Float JVM whereas the rootfs is Hard-Float. Reading /proc/self/exe ELF format tells what is the rootfs "arm type", not the JVM (loading an ARMHF library with an ARMSF JVM obviously fails).
Note:
How did I compile the .so libraries on my PC (x86_64) running on Ubuntu 13.10:
* PC (x86_64): g++ jssc.cpp -I/<jdk_path>/include -I/<jdk_path>/include/linux -shared -fPIC -o libjSSC-2.8_x86_64.so
* PC (x86), using g++-multilib: g++ jssc.cpp -I/usr/lib/jvm/jdk1.8.0_25/include -I/usr/lib/jvm/jdk1.8.0_25/include/linux -shared -fPIC -m32 -o libjSSC-2.8_x86.so
* ARM (SF): arm-linux-gnueabi-g++ jssc.cpp -I/<jdk_path>/include -I/<jdk_path>/include/linux -shared -o libjSSC-2.8_armsf.so
* ARM (HF): arm-linux-gnueabihf-g++-4.8 jssc.cpp -I/<jdk_path>/include -I/<jdk_path>/include/linux -shared -fPIC -o libjSSC-2.8_armhf.so
Any version of the ARM toolchain > 4.7 was fine.
Optimisation level 2 (-O2).
============= Previous Builds ==============
///////////////////////////////////////////
//jSSC-2.8.0 Release version (24.01.2014)//
///////////////////////////////////////////
This version contains native libs for Windows(x86, x86-64), Linux(x86, x86-64, ARM soft & hard float), Solaris(x86, x86-64), Mac OS X(x86, x86-64, PPC, PPC64).
All native libs contains in the jssc.jar file and you don't need manage native libs manually.
In this build:
Fixes:
* Important! Fixed bug with port handles potential leakage
Additions:
* Added method "writeString(String string, String charsetName)"
* Added method "getNativeLibraryVersion" in "SerialNativeInterface" class
* Enabled Java and Native libraries versions mismatch check
With Best Regards, Sokolov Alexey aka scream3r.
///////////////////////////////////////////
//jSSC-2.6.0 Release version (01.06.2013)//
///////////////////////////////////////////
In this build:
Note: Linux x86 and x86-64 was builded on Ubuntu 10.04 and don't depends GLIBC-2.15 unlike jSSC-2.5.0
Additions:
* Added os.name - "Darwin" and os.arch - "universal" support. It can be useful for MacOS X developers.
* Added ttyO to Linux RegExp for listing OMAP serial devices.
* Added JSSC_IGNPAR and JSSC_PARMRK properties for enabling IGNPAR and PARMRK flags in _nix termios structure.
///////////////////////////////////////////
//jSSC-2.5.0 Release version (27.04.2013)//
///////////////////////////////////////////
In this build:
Fixes:
* Important! Fixed bug with garbage reading on Linux, MacOSX, Solaris, cause of incorrect using of VMIN and VTIME. Now "read" methods works correctly and are blocking like in Windows
* Important! Fixed error with garbage reading in Windows using jSSC after another application used serial port. To prevent this effect COMMTIMEOUTS structure zeroing added to setParams() method
* Important! The port handle now stored in variable of type "long" instead of "int", to prevent potential problems with type conversions on Win64
* Fixed MacOS X 10.8 bug with native lib loading (*.dylib -> *.jnilib)
* Fixed Linux error with exclusive access to serial port (TIOCEXCL). TIOCNXCL added to closePort() method for clearing exclusive access
* Fixed Windows native lib port name concatenation error
* Fixed native lib extraction path if user home is read only, in this situation lib will be extracted to tmp folder
* Null port name fix. If try to invoke method openPort() for SerialPort(null) object, exception TYPE_NULL_NOT_PERMITTED will be thrown
* Enabled TIOCEXCL support in Solaris
Additions:
* Added ARM Soft & Hard float support (Tested of Raspberry Pi with Oracle JDK(6-7-8))
* Added ttyACM, ttyAMA, rfcomm to Linux RegExp and tty.usbmodem to MacOS X RegExp
* Added precompiled RegExp's for Linux, Solaris, MacOS X for more faster port listing
* Added private common for Linux, Solaris, MacOS X method getUnixBasedPortNames() for listing serial ports
* Rewrited comparator for sorting port names. Now it's a common comparator for Windows, Linux, Solaris and MacOS X
* Added some syntax sugar to SerialPortList class, for changing search path, RegExp and comparator
* Added timeouts for read operations and SerialPortTimeoutException class for catching timeout exceptions
* Added JSSC_NO_TIOCEXCL JVM property for disable using of exclusive access to serial port
* Added termios(_nix) and DCB(Windows) structure cheking on port opening, it helps separate real serial devices from others
* Added "ERR_" constants into SerialNativeInterface
* Added new exception TYPE_INCORRECT_SERIAL_PORT
* Added new exception TYPE_PERMISSION_DENIED. It can be very useful for _nix based system if user have no permissions for using serial device
And other little modifications...
///////////////////////////////////////////
//jSSC-0.9.0 Release version (21.12.2011)//
///////////////////////////////////////////
In this build:
* Added Solaris support (x86, x86-64)
* Added Mac OS X support 10.5 and higher(x86, x86-64, PPC, PPC64)
* Fixed some bugs in Linux native part
* Changed openPort() method
Important Note:
openPort() method has been changed, now if port busy SerialPortException with type: TYPE_PORT_BUSY will be thrown,
and if port not found SerialPortException with type: TYPE_PORT_NOT_FOUND will be thrown.
It's possible to know that port is busy (TYPE_PORT_BUSY) by using TIOCEXCL directive in *nix native library,
but using of this directive make some troubles in Solaris OS, that's why TIOCEXCL not used in Solaris (!)
Be careful with it.
Also Solaris and Mac OS X versions of jSSC not support following events:
ERR, TXEMPTY, BREAK.
Solaris version not support non standard baudrates
Mac OS X version not support parity: MARK, SPACE.
* Included javadoc and source codes
/////////////////////////////////////////
//jSSC-0.8 Release version (28.11.2011)//
/////////////////////////////////////////
In this build:
* Implemented events BREAK and ERR (RXFLAG not supported in Linux)
* Added method sendBreak(int duration) - send Break signal for setted time
* Fixed bugs in Linux events listener
* Fixed bug with long port closing operation in Linux
/////////////////////////////
//jSSC-0.8-tb4 (21.11.2011)//
/////////////////////////////
In this build was fixed a bug in getPortNames() method under Linux.
Not implemented yet list:
* Events: BREAK, ERR and RXFLAG
/////////////////////////////
//jSSC-0.8-tb3 (09.09.2011)//
/////////////////////////////
In this build was implemented:
* purgePort()
And was fixed some Linux and Windows lib bugs.
New in this build:
* getInputBufferBytesCount() - get count of bytes in input buffer (if error has occured -1 will be returned)
* getOutputBufferBytesCount() - get count of bytes in output buffer (if error has occured -1 will be returned)
* setFlowControlMode() - setting flow control (available: FLOWCONTROL_NONE,
FLOWCONTROL_RTSCTS_IN,
FLOWCONTROL_RTSCTS_OUT,
FLOWCONTROL_XONXOFF_IN,
FLOWCONTROL_XONXOFF_OUT)
* getFlowControlMode() - getting setted flow control mode
Some "syntactic sugar" for more usability:
* writeByte() - write single byte
* writeString() - write string
* writeInt() - write int value (for example 0xFF)
* writeIntArray - write int array (for example new int[]{0xFF, 0x00, 0xFF})
* readString(int byteCount) - read string
* readHexString(int byteCount) - read Hex string with a space separator (for example "FF 00 FF")
* readHexString(int byteCount, String separator) - read Hex string with setted separator (for example if separator : "FF:00:FF")
* readHexStringArray(int byteCount) - read Hex string array (for example {FF, 00, FF})
* readIntArray(int byteCount) - read int array (values in int array are in range from 0 to 255
for example if byte == -1 value in this array it will be 255)
The following methods read all bytes in input buffer, if buffer is empty methods will return null
* readBytes()
* readString()
* readHexString()
* readHexString()
* readHexStringArray()
* readIntArray()
============================================
Not implemented yet list:
* Events: BREAK, ERR and RXFLAG
///////////////////////////////
// jSSC-0.8-tb2 (14.07.2011) //
///////////////////////////////
In this build was implemented:
* getPortNames()
* Parity: MARK and SPACE
And was fixed some Linux lib bugs.
Not implemented yet list:
* purgePort()
* Events: BREAK, ERR and RXFLAG
///////////////////////////////
// jSSC-0.8-tb1 (11.07.2011) //
///////////////////////////////
Not implemented yet list:
* getPortNames()
* Parity: MARK and SPACE
* purgePort()
* Events: BREAK, ERR and RXFLAG