|
1 | 1 | Java Fiscal Device API |
2 | 2 | ====================== |
3 | 3 |
|
4 | | -Copyright 2003, Rodrigo Balerdi. |
| 4 | +Copyright 2003, 2004, 2015, Rodrigo Balerdi. |
5 | 5 | Licensed under the [GNU General Public License (GPL) Version 2](http://www.gnu.org/licenses/gpl-2.0-standalone.html). |
6 | 6 |
|
7 | 7 | 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 |
30 | 30 | Update |
31 | 31 | ------ |
32 | 32 |
|
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. |
34 | 34 |
|
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/). |
36 | 36 |
|
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. |
38 | 40 |
|
39 | 41 | Download |
40 | 42 | -------- |
|
0 commit comments