Version 4.0.x
Version 4.0.x introduced support for multiple printers in a single controller, as well as support for multiple printer types. While all requests will continue to work when the controller only has a single NoLabel or Colorize printer configured, many requests require an extra parameter when more than one printer is configured.
Several requests that are specific to s certain printer type have been renamed. The old names are still supported, but are deprecated.
The settings object has also changed dramatically from earlier versions.
Renamed GPIO signals
All GPIO signals now require a prefix to indicate which equipment the
signal is connected to. The prefix is the eqiupment ID and a
period. The default eqipment ID is MASTER, so the output signal
OUT1 must be specified as MASTER.OUT1.
Renamed GPIO conditions
All GPIO conditions (except always and never) have been renamed to
support multiple printers. Assuming a printer ID of NoLabel, and an
equipment ID of MASTER, the conditions are renamed like this:
| Old name | New name |
|---|---|
printer:ready | printer.Colorize.ready |
printer:green | printer.Colorize.green |
printer:amber | printer.Colorize.amber |
printer:red | printer.Colorize.red |
printer:ink:low | printer.Colorize.ink_low |
printer:ink:empty | printer.Colorize.ink_empty |
label:selected | printer.Colorize.label_selected |
label:ready | printer.Colorize.label_ready |
uv_light:on | printer.Colorize.uv_light1 |
uv_light:on | printer.Colorize.uv_light1 |
input:IN1 | gpio.MASTER.IN1 |
Printer specifier
All requests that directly affect a printer has a new parameter
printer. This parameters is required if more than one printer
is configured, but it is strongly recommended to always be set in
order to avoid problems if a new printer is added later.
The following requests now support a printer attribute:
- getPrinterState (was getState)
- getPrinterStatus (was getStatus)
- waitForImage
- abortPrint
- getCurrentPrintJob
- getPrintQueueLength
- seekPrintQueueCheckpoint
- selectPrintJob
- trigger
- getPrinterSettings
- setPrinterSettings
Renamed requests
| Old name | New name |
|---|---|
| getSettings | getPrinterSettings |
| setSettings | setPrinterSettings |
| disablePrintheadMaintenance | marvin1:disablePrintheadMaintenance |
| enablePrintheadMaintenance | marvin1:enablePrintheadMaintenance |
| haltInkSystem | marvin1:haltInkSystem |
| standbyInkSystem | marvin1:standbyInkSystem |
| startInkSystem | marvin1:startInkSystem |
| stopInkSystem | marvin1:stopInkSystem |
New requests
- getSpeedInfo
- TBD