s6145: Documentation updates, and remove the WIP.

This commit is contained in:
Solomon Peachy 2016-01-14 18:05:00 -05:00
parent ef29c8dfa0
commit 23b6773b3a
2 changed files with 28 additions and 55 deletions

52
README
View file

@ -37,6 +37,8 @@
Citizen CW-01
Mitsubishi CP-9550D/DW/DW-S/DZ/DZ-S
Mitsubishi CP-3800DW
Shinko CHC-S6145 (aka Sinfonia CS2)
Ciaat Brava 21 (Rebadged S6145)
Work-in-progress Printers:
@ -50,11 +52,9 @@
Sony UP-CR10L (aka DNP DS-SL10)
Shinko CHC-S1245 (aka Sinfonia E1)
Shinko CHC-S6245 (aka Sinfonia CE1)
Shinko CHC-S6145 (aka Sinfonia CS2)
Shinko CHC-S6145-5A (aka Sinfonia CS2-c)
Shinko CHC-S6145-5A (aka Sinfonia CS2-c)
Kodak 8810
Kodak 7000/7010/7015
Ciaat Brava 21 (Rebadged S6145)
***************************************************************************
@ -374,41 +374,41 @@
Low-level documentation was provided by Sinfonia and CIAAT.
Thank you!
Mostly supported printers:
Verified supported printers:
Shinko CHC-S6145 (aka "Sinfonia CS2")
Ciaat Brava 21
*** VERY IMPORTANT ***
In order to print properly, this backend relies on a proprietary
library (libS6145ImageProcess) to correctly transform the input data
into a format the printer can use.
The Sinfonia CHC-S6145 printer (and its siblings) require the input
data to be transformed using a proprietary library in order to generate
usable output.
This library was provided to the authors of this software in binary
form, without redistribution permissions.
This library (libS6145ImageProcess) was provided to the authors of
selphy_print in binary form, without redistribution permissions. It was
also only made available for x86 and x86_64 platdorms.
If you obtain this library along with *written permission* from
Sinfonia Technology Co. LTD to use and/or redistribute it,
as an additional permission under the GPLv3 section 7, you
may combine and/or redistribute the library along with this software.
Work is under way to reverse-engineer and re-implement this library.
the replacement is called libS6145ImageReProcess, and is not yet
publicly released.
For the full text of the license exception, see the comments in the
header of backend_shinkos6145.c
The backend will automatically attempt to load one of these libraries
at runtime. If neither is available, it will default to a very crude
algorithm that generates pretty poor results not suable for
photographic output.
Ideally, Sinfonia could be convinced to release source code to this
library under a suitable license, but I have been informed they are
unable to do so due to legal considerations.
As selphy_print is released under the terms of the GPL, it cannot
normally be combined with proprietary libraries.
In the mean time, there is a slowly-improving reverse-engineered
version of the library already included. While it is adequate to
demonstrate that the printer functions properly, the quality of the
output is poor, and not suitable for photographic output.
If you own one of these printers, please politely contact Sinfonia
to inquire about access to the libS6145ImageProcess library, and
the possibility of obtaining its source code.
Therefore, the authors of selphy_print grant its users an additional
permission (under section 7 of the GPLv3) to combine and/or redistribute
it with the libS6145ImageProcess library. For the full text of this
license exception, please see the header of backend_shinkos6145.c
If you own a S6145 printer, libS6145ImageProcess can be obtained by
politely contacting your local Sinfonia distributor.
Valid commands:
-c filename Query User tone curve from flash [1]

View file

@ -2347,7 +2347,7 @@ static int shinkos6145_query_serno(struct libusb_device_handle *dev, uint8_t end
struct dyesub_backend shinkos6145_backend = {
.name = "Shinko/Sinfonia CHC-S6145",
.version = "0.15WIP",
.version = "0.15",
.uri_prefix = "shinkos6145",
.cmdline_usage = shinkos6145_cmdline,
.cmdline_arg = shinkos6145_cmdline_arg,
@ -2364,7 +2364,7 @@ struct dyesub_backend shinkos6145_backend = {
}
};
/* CHC-S6145 data format
/* CHC-S6145 spool file format
Spool file consists of an 116-byte header, followed by RGB-packed data,
followed by a 4-byte footer. Header appears to consist of a series of
@ -2383,31 +2383,4 @@ struct dyesub_backend shinkos6145_backend = {
04 03 02 01 [[ footer ]]
* CIAAT Brava 21 data format
This printer is supposed to be a variant of the S6145, but uses a
different spool format -- but seems to use the same command language.
01 40 12 00 II NN NN YY YY XX XX TT 00 00 00 00 00 00 01 MM QQ ZZ
II == Job ID (01-255, backend fills)
NN NN == copies (LE)
YY YY == Columns (LE)
XX XX == Rows (LE)
MM == Overcoat (02 = glossy, 03 = matte, 01 = none)
TT == Type (00 = 4x6, 03 = 5x7, 06 = 8x6, 07 = 2x6)
QQ == Multicut (00 = normal, 01 = none, 02 = 2*4x6,
04 = 2*2x6, 80 = 4x6-notrim)
ZZ == Cyan Average (backend fills)
1844*2434 8x6
1844*2492 4x6*2
1548*2140 5x7
1844*1240 4x6 (and 2x6*2)
1844*1210 4x6-notrim (WTF?)
1844*634 2x6
[[ Followed by XX*YY*3 bytes of image data, RGB ]]
*/