ESC/Label Command Reference Guide

ESC/Label Command Reference Guide

Command Reference Guide M00097711 Rev. L

Page 1

Trademarks

Cautions 1. No part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Seiko Epson Corporation. 2. The contents of this document are subject to change without notice. Please contact us for the latest information. 3. While every precaution has been taken in the preparation of this document, Seiko Epson Corporation assumes no responsibility for errors or omissions. 4. Neither is any liability assumed for damages resulting from the use of the information contained herein. 5.

Neither Seiko Epson Corporation nor its affiliates shall be liable to the purchaser of this product or third parties for damages, losses, costs, or expenses incurred by the purchaser or third parties as a result of: accident, misuse, or abuse of the product(s) to which this document relates or unauthorized modifications, repairs, or alterations to the product(s) to which this document relates, or (excluding the U.S.) failure to strictly comply with Seiko Epson Corporation’s operating and maintenance instructions. 6.

Seiko Epson Corporation shall not be liable against any damages or problems arising from the use of any options or any consumable products other than those designated as Original EPSON Products or EPSON Approved Products by Seiko Epson Corporation Trademarks Zebra Technologies Corporation and ZPL II are the registered trademarks or trademarks of Zebra Technologies Corporation. All other trademarks are the property of their respective owners and used for identification purpose only. ©Seiko Epson Corporation 2016–2024 ESC/Label Command Reference Guide Rev. L Page 2

Page 2

About this Document

About this Document (1) Scope of this document This document describes ESC/Label commands. ESC/Label commands are used to control Epson’s label printers. This document is designed for those who use ESC/Label commands to develop programs to control printers. Please refer to the ESC/Label Application Development Guide when developing programs. Refer to the attached Command List for commands used and definition ranges for each model. (2) Content of the specification The content of this document is outlined below. Content of the specification (3) Definitions (a) Hexadecimal values are expressed with numbers 0 – 9 and letters A – F, along with the letter H (first letter of HEX). (4) Example:

1AH (a) Outside of command code descriptions, commands are enclosed within double quotation marks and command codes are enclosed in parentheses. Example: “^F(C” (field color settings) (b) Units are expressed by the unit name enclosed in square brackets. Examples: [dot], [mm] (c) The following are enclosed in angle brackets. Control codes Examples: , Non-alphanumeric characters Example: Comma Uniquely defined terms Example: ESC/Label Command Reference Guide Rev.

L Page 3 Item Description About this Document Positioning and content of this document, definitions (terminology, expressions) 1 Commands Outline Characteristics, configuration, basic specifications, and usage examples of ESC/Label commands 2 Primary Functions Key features of the ESC/Label command 3 Detailed Command Specifications Detailed specifications of the ESC/Label command Appendix The list of the mode and the setting Command List (Attachment) Indicates commands used by model and their corresponding parameter definition ranges in the commands included in the ESC/Label commands.

Page 3

TABLE OF CONTENTS

TABLE OF CONTENTS 1 Commands Outline .......................................................................................................................................................... 8 1.1 Characteristics .......................................................................................................................................................... 8 1.2 Structure ....................................................................................................................................................................

9 1.3 Command Basic Specifications ............................................................................................................................ 10 1.3.1 Format Commands and Control Commands ............................................................................................... 10 1.3.2 Basic Data Format for the Command............................................................................................................. 10 1.3.3 Command Syntax ..............................................................................................................................................

12 1.3.4 About Saving the Graphics and Label Formats in the Printer .................................................................... 12 1.4 Example of Command Use ................................................................................................................................... 13 1.4.1 Basic Label Printing........................................................................................................................................... 13 1.4.2 Color Label Printing ..........................................................................................................................................

14 1.4.3 Serialized Printing ............................................................................................................................................. 15 1.4.4 Saving a File for a Label Format ...................................................................................................................... 16 1.4.5 Printing Using the Label Format File ............................................................................................................. 17 1.4.6 Getting Status .....................................................................................................................................................

18 2 Primary Functions .......................................................................................................................................................... 19 2.1 Fonts ........................................................................................................................................................................ 19 2.1.1 Font Type ............................................................................................................................................................

20 2.1.2 Special Symbols .................................................................................................................................................. 21 2.2 Media Settings ........................................................................................................................................................ 22 2.2.1 Media Coating Type .......................................................................................................................................... 22 2.2.2 Media Form ........................................................................................................................................................

22 2.2.3 Label Edge Detection ........................................................................................................................................ 23 2.2.4 Media Source ...................................................................................................................................................... 23 2.2.5 Media Shape ....................................................................................................................................................... 23 2.3 Errors .......................................................................................................................................................................

24 2.4 Print Area ................................................................................................................................................................ 25 2.4.1 Leading Edge and Direction Definitions ........................................................................................................ 26 2.4.2 Base Position Definitions ................................................................................................................................. 27 2.4.3 Maximum Printable Area .................................................................................................................................

28 2.4.4 Printable Area and Mount Settings ................................................................................................................ 29 2.4.5 Print Area and Margin Settings ....................................................................................................................... 30 2.4.6 Print Requests Outside the Print Area ........................................................................................................... 31 2.4.7 Print Area Settings Using ZPL II Commands ...............................................................................................

32 2.5 Getting and Setting Printer Information ............................................................................................................ 33 2.5.1 Method for Setting Printer Information ........................................................................................................ 34 2.5.2 Method for Getting Printer Information ....................................................................................................... 35 2.6 Designating Color ..................................................................................................................................................

37 2.7 Field Color Reversal .............................................................................................................................................. 39 2.8 Printing Graphics ................................................................................................................................................... 41 2.8.1 Registering a Graphic in a Printer and Printing It ........................................................................................ 41 2.8.2 Embedding a Graphic in the Field and Printing It .......................................................................................

42 3 Detailed Command Specifications ............................................................................................................................... 43 ^A ..................................................................................................................................................................................... 44 ^A@ ..................................................................................................................................................................................

Page 4