Plain English

Toggles the ribbon-detect sensor (TSPL2 PG §SET p148). When ON, the printer halts if it doesn't detect a thermal-transfer ribbon (i.e. assumes thermal-transfer mode); when OFF, the printer assumes direct-thermal media and ignores the ribbon sensor. **Non-persistent — reverts on power cycle.** This is the only SET sub-action whose value isn't kept across reboots.

When to use

Once per power cycle to match the loaded media. Direct-thermal media → OFF; thermal-transfer with ribbon → ON. Re-issue on every boot.

Syntax

SET RIBBON ON | SET RIBBON OFF

Parameters

ParameterDescription
state
Ribbon-detect (case-insensitive). Non-persistent.
  • ON - Thermal-transfer mode — require ribbon present
  • OFF - Direct-thermal mode — ignore ribbon sensor

Example

SET RIBBON OFF

Direct-thermal mode (no ribbon required)

Try it in the playground View all TSPL commands