Skip to content

Commit 5ecfcf4

Browse files
committed
Update README.md
1 parent 2198cfb commit 5ecfcf4

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

README.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Java Fiscal Device API
22
======================
33

4-
Copyright 2003, Rodrigo Balerdi.
4+
Copyright 2003, 2004, 2015, Rodrigo Balerdi.
55
Licensed under the [GNU General Public License (GPL) Version 2](http://www.gnu.org/licenses/gpl-2.0-standalone.html).
66

77
The Java Fiscal Device API is a medium-level API to communicate with fiscal devices such as fiscal printers. It handles the communication protocol and the formatting and parsing of the protocol packets, and provides event-based notification for certain events such as out-of-paper events. It was made for Hasar printers but also works fine with Epsons, after some small protocol differences were accommodated.
@@ -30,11 +30,13 @@ There is also a [very basic sample](https://github.com/Lanchon/Java-Fiscal-Devic
3030
Update
3131
------
3232

33-
This software depends on an implementation of its own `FiscalPort` interface to communicate with devices. It includes a `SerialFiscalPort` implementation for serial ports that is a thin wrapper over Sun's Java Communications API (`javax.comm`). Unfortunately Sun has deprecated this API without providing an alternative and some operating systems are no longer supported. However there are some free and commercial implementations of `javax.comm`, for example [RXTX](http://rxtx.qbang.org/). There are also other serial port drivers over which a `FiscalPort` could be more or less trivially implemented; see [java-simple-serial-connector](https://code.google.com/p/java-simple-serial-connector/) and [serial-comm](https://code.google.com/p/serial-comm/).
33+
This software depends on an implementation of its own `FiscalPort` interface to communicate with devices. Originally it only included a `SerialFiscalPort` implementation for serial ports that is a thin wrapper over Sun's Java Communications API (`javax.comm`). Unfortunately Sun has deprecated this API without providing an alternative and some operating systems are no longer supported.
3434

35-
Please contribute your drivers to the project. They will be accepted if they are tested to work and implement `FiscalPort` and `FiscalPortSource` classes in their own package, in the style of package `com.taliter.fiscal.port.serial`. (Modifications to the current driver will not be accepted unless they are bug fixes.)
35+
This is why I have added `RXTXFiscalPort` with support for two alternative serial port drivers, [RXTX](http://rxtx.qbang.org/) and [nrjavaserial](https://github.com/NeuronRobotics/nrjavaserial). RXTX is known to have [issues](http://stackoverflow.com/questions/12317576/stable-alternative-to-rxtx), especially the old 'stable' release, so nrjavaserial might be a better bet. There are also other serial port drivers over which a `FiscalPort` could be more or less trivially implemented; see [java-simple-serial-connector (jSSC)](https://code.google.com/p/java-simple-serial-connector/) and [jSerialComm](http://fazecast.github.io/jSerialComm/).
3636

37-
I no longer have access to fiscal devices and thus I cannot test. For this reason I cannot implement `FiscalPort`s that wrap these new serial port drivers. However this API is still being maintained: no bugfix releases were made in 10 years because, although it has many users, no bugs were ever reported against it. Debugging would be harder now without test devices but I will still try my best to fix the code if a bug is reported.
37+
Please contribute your drivers to the project. It will be required that they are tested to work and implement `FiscalPort` and `FiscalPortSource` classes in their own package, in the style of package `com.taliter.fiscal.port.serial`.
38+
39+
I no longer have access to fiscal devices and thus I cannot test. For this reason I cannot implement `FiscalPort`s that wrap these new serial port drivers. However this API is still being maintained: no bugfix releases were made in 12 years because, although it has many users, no bugs were ever reported against it. Debugging would be harder now without test devices but I will still try my best to fix the code if a bug is reported.
3840

3941
Download
4042
--------

0 commit comments

Comments
 (0)