Citizen IF1-EFX1 User manual

IF1-EFX1 / IF1-EFX2
IF2-EFX1 / IF2-EFX2
Ethernet Interface Board
User’s Manual
Ver.2.00
Target firmware V1.15 or later (IFx-EFX1), V2.30 or later (IFx-EFX2)

2
Contents
Contents .......................................................................................................................2
Read before using........................................................................................................4
1. Introduction............................................................................................................7
1-1. Features ............................................................................................................................7
1-2. Model Classification..........................................................................................................8
1-3. Specifications.....................................................................................................................8
1-4. Part Names and Functions ...............................................................................................9
2. Preparation...........................................................................................................10
2-1. Connecting LAN cable..................................................................................................... 10
2-2. Connecting a Peripheral Device...................................................................................... 10
2-3. Connecting the Interface Board Unit.............................................................................. 11
3. Network Settings and Operation.........................................................................13
3-1. Overview.......................................................................................................................... 13
3-2. Panel Button ................................................................................................................... 15
3-3. Printing the Interface Board Configuration ................................................................... 16
3-4. Returning the Interface Board Configuration to Factory Default Settings ................... 17
3-5. Display status by LED .................................................................................................... 18
3-6. Simple Setting Procedure Example for Wired LAN ....................................................... 19
4. Web Manager........................................................................................................20
4-1. Starting the Web Manager.............................................................................................. 20
4-2. HOME Window ............................................................................................................... 21
4-3. STATUS Window............................................................................................................. 22
4-3-1. STATUS>>System Status Tab ..........................................................................................23
4-3-2. STATUS>>Network Status Tab........................................................................................24
4-3-3. STATUS>>Printer Status Tab ..........................................................................................25
4-4. CONFIG Window ............................................................................................................ 26
4-4-1. CONFIG>>General Tab ....................................................................................................27
4-4-2. CONFIG>>User Account Tab ...........................................................................................28
4-4-3. CONFIG>>Maintenance Tab............................................................................................29
5. NetToolK...............................................................................................................30
5-1. Installing the NetToolK................................................................................................... 30
5-2. Information List Window ................................................................................................ 33
5-3. Setup Window ................................................................................................................. 35
5-3-1. “General” Tab.....................................................................................................................35
5-3-2. “Wireless LAN” Tab...........................................................................................................35
5-3-3. “Supported Protocols” Tab.................................................................................................36
5-3-4. “User Account” Tab............................................................................................................36
5-3-5. “Maintenance" Tab ............................................................................................................36
6. XML Print / Peripheral Device Control Function................................................38
6-1. Overview.......................................................................................................................... 38
6-2. CONFIG>>Service Tab ................................................................................................... 39

Contents
3
6-2-1. Media Converter................................................................................................................40
6-2-2. XML Print..........................................................................................................................40
6-2-3. XML Device Control ..........................................................................................................40
6-2-4. XML Device Control / Line Display ..................................................................................41
6-2-5. XML Device Control / Scanner..........................................................................................41
6-2-6. XML Device Control / Speaker..........................................................................................41
6-2-7. XML Config........................................................................................................................41
6-2-8. Submit / Reset Button .......................................................................................................41
6-3. STATUS>>Service Status Tab ........................................................................................ 42
7. SSL/TLS function.................................................................................................43
7-1. Overview.......................................................................................................................... 43
7-2. CONFIG>>SSL/TLS Tab................................................................................................. 45
7-2-1. SSL/TLS tab.......................................................................................................................45
7-2-2. Create Self-Signed Certificate ..........................................................................................46
7-2-3. Update Self-Signed Certificate .........................................................................................47
7-3. To enable SSL/TLS communication using a self-signed certificate ................................ 48
7-3-1. Generating and exporting self-signed certificates ...........................................................48
7-3-2. Example of importing a self-signed certificate in a browser (Chrome)...........................53
7-4. SSL/TLS and certificate related specifications............................................................... 57
7-4-1. SSL/TLS communication specifications ...........................................................................57
7-4-2. Self-signed certificate related specifications....................................................................58
7-4-3. Public CA signed certificate related specifications ..........................................................59
7-4-4. Handling of saved certificates when restoring factory settings/updating firmware ......59
8. Request Print function.........................................................................................60
8-1. Overview.......................................................................................................................... 60
8-2. CONFIG>>Request Print Tab......................................................................................... 61
8-3. STATUS>>Request Print Tab ......................................................................................... 62
8-4. Printing system log ......................................................................................................... 62

4
Read before using
Be sure to read this manual carefully before using the product. After you read it, store it in a
safe place so that you can reread it when necessary.
Contents of this manual may be changed without notice.
Reproducing and/or copying the contents of this manual by any means without
permission are prohibited.
We will not be responsible for any adverse occurrence that results from the use of this
manual, regardless if it contains omissions, errors/misprints, etc.
Note that we will not be responsible for (a) loss caused by improper operation or
mishandling of the device by the user, or (b) loss due to operational environment.
Data etc. are basically impermanent; long time or permanent storing/saving of data by
the device is not possible.
Note that we will not be responsible for any loss or loss of profits owing to loss of data
due to breakdown, repairs, inspections, etc.
Please contact us if there are omissions, errors, ambiguities, etc. in this manual.
Refer to this document along with the user manual of the printer.
Trademarks
・Microsoft, Windows 7, Windows 8 and Windows 10 are registered trademarks of
Microsoft Corporation U.S.A.
・CITIZEN is a registered trademark of Citizen Watch Co., Ltd.
・Other company names and product names mentioned here are trademarks or
registered trademarks of those companies.

5
Related SDKs and Documentation
Printing with XML data
* XML Print (For POS printers)
- POS Print SDK(JavaScript)
- CITIZEN XML Print Service JavaScript POS Print SDK Programming Manual
* XML Print (For Label printers)
- Label Print SDK(JavaScript)
- CITIZEN XML Print Service JavaScript Label Print SDK Programming Manual
Network board configuration with XML data
* XML Config (JavaScript)
- Config SDK(JavaScript)
- CITIZEN XML Device Control Service JavaScript Device Control SDK Programming Manual
Peripheral device control using XML data
* XML Device 【JavaScript】
- Device Control SDK (JavaScript)
- CITIZEN XML Config Service JavaScript Config SDK Programming Manual
Peripheral device control using dedicated control port
* Peripheral device control (For POS printer / Windows)
- POS Print SDK (Windows)
- Windows POS Print SDK Programming Manual
* Peripheral device control (For POS printer /Android)
- POS Print SDK (Android)
- Android POS Print SDK Programming Manual
* Peripheral device control (For POS printer /iOS-Swift)
- POS Print SDK (iOS-Swift)
- iOS POS Print SDK (Swift) Programing Manual
* Peripheral device control (For POS printer / iOS Objective C)
- POS Print SDK (iOS-Objective C)
- iOS POS Print SDK (Objective-C) Programing Manual
(Peripheral device control from the label printer can also be performed using the SDK for POS
printers.)
Request printing
-Programmer's Manual for "Request Print" on XML Print Service (Sample program)

6
Term Description
Since different documents are intended for different audiences and assume different levels of
expertise, different terms may be applied for clarity even when the content being explained is the
same. In addition, some terms are easily confused because they are sometimes referred to from the
opposite standpoint depending on their function. The following is a glossary and explanation of terms
that you should pay attention to when reading this document in conjunction with other related
documents.
Printer / Interface board (Wired or Wireless LAN) / Service
Printers that use network and XML related functions have an interface board (wired/wireless LAN)
that is a single board computer. On the memory on that interface board, there are several resident
programs that perform specific functions, which are called services.
For example, the XML Print service receives XML data for printing, converts it into commands and
data for the printer, passes it to the printer, and sends a reply when it is confirmed that the printing is
completed. From the point of view of the terminal sending the data, it is easier to recognize network
and XML-related services as interface boards or printers, so we may use the terms "board,"
"interface board," or "printer" instead of "service" in the explanation.
Web server / Web app server
The Web server is the terminal that sends data to the browser for screen display. The Web server
receives the information of the operations performed on the browser. When a Web server uses a
programming language to process data to be sent and received, the group of programs that process
the data is called a Web application (hereinafter referred to as a Web app), and the terminal in
charge of the function is called a Web app server.
Since there are many cases where a Web server and a Web app server are both used on the same
terminal, the two are not strictly separated and may be referred to as a Web server in the sense of a
Web app server.
Server / Client
In addition to Web server and Web app sever, there are various other types of servers depending on
their functions, which are sometimes referred to simply as servers in the explanation.
The terminal that sends data to the server is called the client. Server and client are sometimes
referred to interchangeably, depending on their function and position.
For example, in the main function of the printer, which is to print the received data, the printer is a
print server from the terminal that sends the print data to the printer. The printer also has the function
of a Web server, which we call a Web manager, for network settings, etc.
On the other hand, when sending a print data request to the Web app server, the printer is in the
position of a client.

7
1. Introduction
Thank you for purchasing the Citizen IF1-EFX1/EFX2, IF2-EFX1/EFX2 Ethernet (LAN) interface
board.
By using the LAN interface board IF1-EFX1/EFX2, IF2-EFX1/EFX2 (hereinafter referred to as the
interface board, this interface board or this board) with our POS printers and barcode printers, each
printer can be directly connected to the network enabling printing from a PC on the network to the
printer. It also enables the PC and printer to communicate with each other, and the printer's operating
status and print settings can be checked from the PC. In addition, depending on the printer, it is
possible to print from XML format data and control peripheral devices connected to this interface
board.
Please note only firmware versions
V1.15 or later (IFx-EFX1)
V2.30 or later (IFx-EFX2).
support the following functions mentioned in this manual.
Raw Port TCP Keep-Alive
SSL/TLS Function
Request Printing
XML Config
For boards with older firmware versions, please refer to the older manual as a reference.
1-1. Features
Support for DHCP, static IP, and ZeroConf methods of IP address acquisition
Configuration through a browser or utility software
Support for Raw 9100 port and LPR printing methods
Panel button to print configuration information and change the configuration mode
LED indicators for connection, operation, and error statuses
Support for printing and peripheral device control by XML data depending on the printer
Secure communication with SSL/TLS function.
"Request Print" allows printing with XMLdata from a Web server on the Internet
XML Config function is available for configuration of the board.

2 Introduction
8
1-2. Model Classification
IF1 type: Applicable to CT-S801(II) / 851(II) / 601(II) / 851(II) / CL-S400DT / 6621 / CL-E7xx
IF2 type: Applicable to CT-D151 / CT-E651 / CT-S251 / 751 / 4500 / CL-E3xxEX
1-3. Specifications
Main board (Network)
Ethernet
Standards 100BASE-TX/10BASE-
T, Full Duplex/Half Duplex auto
negotiation
Port
RJ-45
Network
IP Version
IPv4
Protocols
TCP, UDP, HTTP, HTTPS, ICMP, DHCP, SNMP
Port number for printing
RAW (port 9100 (Changeable)), LPR
IP address setting
Manual, DHCP
Hardware
IF1-EFX1 / IF1-EFX2
IF2-EFX1 / IF2-EFX2
Hardware Compatible printers CT-S801(II) / 851(II) / 601(II) / 651(II)
CL-S400DT /6621 / E7xx
CT-D151/E651/S251/751
CT-S4500/CL-E3xxEX
Operation panel
LED: 4 (2 on panel, 2 on RJ45 connector), Button: 1
USB USB-A connector 0 or 2
USB Specs: USB2.0 High Speed
Software
Software
Setting methods
Browser, PC setting tool, Cloud
Firmware upgrade
Browser, PC setting tool, Cloud
Supported Platforms
Windows 7
、
Windows8, Windows10, HTML5 browser
IF1 type IF2 type
Normal model USB host model Normal model USB host model
Name IF1-EFX1 IF1-EFX2 IF2-EFX1 IF2-EFX2
Number of
USB ports 0 2 0 2
Peripheral
device control Not supported Supported Not supported Supported
SSL/TLS Not supported Supported Not supported Supported
Request print Not supported Supported Not supported Supported

2 Introduction
9
1-4. Part Names and Functions
IF1-EFX1 （No USB Port）IF1-EFX2 （USB 2 Port）
IF2-EFX1 （No USB Port）IF2-EFX2 （USB 2 Port）
①RJ45 connector (compatible with 10Base-T/100Base-TX)
Connection for LAN cable
②Ethernet transmission speed LED indicator (green)*1
Shows Ethernet transmission speed with steady/blinking light.
③Ethernet status indicator LED (yellow)*1
Shows Ethernet connection status (disconnected, receiving data, etc.).
④Ethernet status LED indicator (green)*1
⑤Ethernet status LED indicator (red)*1
Shows transmission, connection and error statuses with steady/blinking lights combinations.
⑥Panel button*2
Used to operate the Interface board.
⑦USB connector (First)
⑧USB connector (Second)
Connect an approved peripheral device to a USB port.
*1 See 3-5, Display status by LED (page 18) for indicator details.
*2 See 3-2, Panel Button (page 15) for panel button operations.
10/100BAS
SW
10/100BAS
E
①
②
③
⑥
④
⑤
② ③
⑦
⑤ ⑥
① ⑧
④
①
⑥
④ ⑤
②
③
①
⑦
⑥
④
⑤
②
③
⑧

10
2. Preparation
2-1. Connecting LAN cable
Connect a LAN cable to the RJ45 connector of
this interface board. (Diagram on right shows a
typical example)
2-2. Connecting a Peripheral Device
The following restrictions apply to peripheral devices. Please use them properly.
• The connection of unsupported peripherals to the USB port is prohibited. (please inquire about
which devices are supported).
• Connecting a tablet or other device to USB ports for supplying power is also prohibited.
• Do not insert or remove peripheral devices from the USB port while the printer power is on.
• Connection through a USB hub is prohibited.
• In the case of the IFx-EFX2 which has two USB ports, connecting to both the left and right ports is
possible, but connecting two of the same type of device (two displays, two scanners, etc.) is
prohibited.
Network cable
RJ45 connector
LAN cable

2 Preparation
11
2-3. Connecting the Interface Board Unit
1) The interface board can be used by connecting it to the main board of the printer.
It is connected by plugging the printer interface connector into the connector on the printer's main
board. It is possible to replace the other interface with the LAN interface, but extra caution is required.
(Diagram below shows a typical example)
2) If another interface board is installed in the printer, remove
it.
• Malfunctions may occur if the interface board is removed or re-inserted.
• To install the interface board, please contact your dealer or service person.
• If you replace the interface board by yourself, do so at your own risk, taking care to avoid
static electricity, etc.
Warning
Printer interface connector
Operation panel

2 Preparation
12
3) Insert the interface board into the interface slot of the
printer.
4) Connect the interface connector of the board to the
interface connector inside the printer.
5) Fix the interface board in place with screws.
Interface slot

13
3. Network Settings and Operation
3-1. Overview
To use this interface board connected to a network, you need to connect to the network and
configure the settings for communication in addition to configuring the settings of the printer.
There are 3 methods to configure the settings for a network connection.
Web Manager
Connect to this interface board from a browser and then configure the settings on the dedicated
settings screen.
NetToolK
Connect to this interface board from a dedicated tool for Windows and then configure the settings.
You can check the current state and restore the initial state by operating the panel button.
See the next captor for an explanation of the panel button.
Furthermore, you can check the communication and other statuses from the LEDs on the
interface. See “3-5 Display status by LED”.

2 Network Settings and Operation
14
XML Config
By sending XML format data to this interface board, you can configure some of the board's
functions.
The functions that can be configured or updated are
SSL/TLS settings
Request printing settings
Firmware update
Details are beyond the scope of this manual. Therefore, please refer to the manual of XML
Config SDK for details.
JavaScript and Excel VBA macros are available as sample programs for this function.
The timeout setting for this function is present in the 6-2 CONFIG>>Service Tab.
Warning
After the firmware upgrade starts, do not disconnect power or transmission to the printer until the
upgrade is complete.
When updating the firmware, it is necessary to obtain the correct firmware data from us.
If the firmware is not updated correctly, this interface board may not boot.

3. Network Settings and Operation
15
3-2. Panel Button
The panel button on the operation panel is used to operate the Interface board. It allows you to print
the setting information of this interface board and restore the initial state. (Diagram is of IF1-EFX1
and IF1-EFX2)
Starting the Interface Board
Turn on the printer. The Interface board starts working approximately 20 seconds after the printer
turns on.
Printing the Interface Board Configuration
Press the panel button. See 3-3, Printing the Interface Board Configuration (page 16) for details.
Switching to Setting Mode
Press and hold the panel button. The buzzer*will sound once, signaling a switch to setting mode.
・Setting mode enables the reading of the factory default settings. See 3-4, Returning the Interface
Board Configuration to Factory Default Settings (page 17) for details
・If there is no activity for three seconds in the setting mode, the buzzer*will sound once, signaling a
return to normal mode.
* If the printer to which this interface board is connected is set to not buzz, the buzzer will not
sound.
System log printing
If printing etc. does not work as expected, you may be able to check the situation by checking
the system log of this board. The system log can be printed using the panel buttons.
Please refer to Chapter 5 "Useful Functions for Request Print" in the "Programmer's Manual for
"Request Print" for a description of system log printing.
When the operation is complete, the interface board will restart automatically.
When automatically obtaining the IP address from the DHCP server is set, an IP address that
differs from the previous one may be assigned.
Warning
Panel button
10/100BAS
E
SW
10/100BAS
Panel button

2 Network Settings and Operation
16
3-3. Printing the Interface Board Configuration
Press the panel button to print out the configuration of the interface board from the printer.
①Title of the printout.
②Model name, hardware revision, and
firmware version of the interface board
③System information of the interface board
The LAN board name, serial number, and
MAC address are printed.
④Network information of the interface board
⑤Ethernet information. Printed when
connected by Ethernet.
⑥Printer information. The name of the
manufacturer and the model name of the
printer connected to the interface board are
printed.
⑦Configuration information of the interface
board. The information stored in the
interface board is printed and may be
different from the connection status of the
current network. Check the connection
status using the network information of ④
⑧Information on the connection status of XML-
controlled peripheral devices.
⑨SSL/TLS function setting information.
⑩Setting information for the Request Print
function.
I/F Board
Information
IFx-EFX1(Rev1.1.2): Ver 1.15
System
LAN Board Name : Net Printer
Serial Number : 100123
MAC Address : 00:01:02:0a:0b:0c
Current Network Status
IP Address : 192.168.0.2 (DHCP)
Subnet Mask : 255.255.255.0
Gateway : 192.168.0.1
DHCP Server : 192.168.0.1
Ethernet Status
Speed & Duplex : Auto (100BaseTx Full)
Printer Status
Manufacturer : CITIZEN
Model : CT-S801
User Configuration
DHCP : Enable
IP Address : 192.168.0.10
Subnet Mask : 255.255.255.0
Gateway : 192.168.0.1
Print Port : 9100
Receive Timeout : 180
XML Device Information
Display Status : Offline
Scanner Status : Offline
Speaker Status : Offline
SSL/TLS
Certificate : Self-Signed
Self-Signed : Not Exist
CA-Signed : Not Exist
Request Print
Service Status : Disable
Current URL :
http://www.example.net/test.php
Proxy Address : 192.168.100.190
Proxy Port : 8080
Interval : 10 sec
ID : AA-BB-CC-DD-EE-FF
DNS1 : 192.168.10.1
DNS2 : 8.8.8.8
①
②
③
④
⑤
⑥
⑦
⑧
⑨
⑩

3. Network Settings and Operation
17
3-4. Returning the Interface Board Configuration to Factory Default Settings
1) Press and hold the panel button to switch to setting mode.
2) After the interface board has switched to setting mode, press and holds the panel button again
within three seconds. The following message is printed, and the interface board returns to factory
default settings.
I/F Board
Information
--!Caution!--
Print Server will
automatically restart.
When the operation completes, this interface board restarts automatically.
When automatically obtaining the IP address from the DHCP server is set, an IP address that
differs from the previous one may be assigned.
Warning

2 Network Settings and Operation
18
3-5. Display status by LED
(Diagram shows a typical example. There are interface boards where the positioning of LEDs differs,
but the order from left to right is the same.)
Green Yellow Green Red
①Ethernet transmission speed indicator
Transmission speed
LED (green)
100 Mbps
On
10 Mbps / Disconnected
Off
②Ethernet connection/transmission status indicator
Connection status
LED (yellow)
Connected
On
Disconnected
Off
Transmitting data
Flashing
③LAN status indicator
Connection Status LED (green) LED (red) Description
Printer disconnected Off - Not connected to printer.
Printer
connection
Network: disconnected On Off Connected to printer.
Ethernet connecting On Flashing
(1-second cycle)
Seeking IP address from DHCP server via
Ethernet.
Ethernet working On On Network operation via Ethernet.
Resource error Alternating blinking (1-second cycle) The interface board is malfunctioning.
System error Alternating blinking (0.2-second cycle) The interface board is malfunctioning.
10/100BASE

3. Network Settings and Operation
19
3-6. Simple Setting Procedure Example for Wired LAN
If you do not know much about network settings, configure the settings about the corresponding
procedure below.
However, the instructions in the procedure may not necessarily be appropriate for your network
environment.
■ Configuration where an IP address is assigned from a DHCP server
1) Connect the LAN cable to the interface board. The LAN cable must be connected to, for example,
an enabled network environment in which a DHCP server exists.
2) The IP address is automatically obtained from the DHCP server within 90 seconds after powering
on the printer and starting up this interface board.
Press the panel button to print out the configuration information and check the assigned IP
address. See 3-3, Printing the Interface Board Configuration (page16) for details.
3) Once the conditions for the printer to join the network are in place, configure the wired LAN
settings in Web Manager.
Connect to Web Manager of the printer from the browser of a PC connected to the same network.
See “4 Web Manager” (page 20) for details.
Instead of Web Manager, you can also use NetToolK, a network configuration tool for Windows.
See “5 NetToolK” (page 30) for details.
■ Configuration using a static IP address
The procedure differs for the part of step 2) above. Since the IP address assigned by the DHCP
server is not used, the ZeroConf function assigns an IP address of 169.254.XX.YY (XX.YY varies
depending on the environment). Press the panel button to print the setting information and then
confirm the assigned IP address.
Adjust the IP address of your PC so that it can connect to the IP address of the printer.
The subsequent procedure is the same as step 3) above.

20
4. Web Manager
The interface board is equipped with a Web manager function, which allows accessing the interface
board from a Web browser to check the status of the interface board and change its settings.
4-1. Starting the Web Manager
In the address bar, enter the IP address and then press Enter.
If the SSL/TLS feature is enabled, you can also connect using “https”.
Web Manager Window Layout
Web Manager consists of following windows and tabs. It differs depending on supported functions.
*1 If the XML/Peripheral control functions are available, the Service Status tab will appear on the
STATUS windows and the Service tab will appear on the CONFIG windows.
*2 If the SSL/TLS function is available, the SSL/TLS tab will appear in the CONFIG window.
*3 If Request Print function is available, Request Print tab will appear on STATUS / CONFIG window.
For details, see "6 XML Print / Peripheral Device Control Function," "7 SSL/TLS function," and "8
Request Print function," respectively.
・The configuration window of the interface board cannot be displayed if the network settings of your computer and the
interface board differ. Ensure that the IP address of the interface board matches the settings of your network.
・The IP address of this interface can be confirmed as described in “Printing the Interface Board Configuration”.
Warning
* The image to the left is a sample. Enter the
actual allocated value for the IP address.
HOME
STATUS
CONFIG
System Status
Network Status
Printer Status
General
Service ※1
SSL/TLS *2
User Account
Service Status *1
Request Print *3
Request Print *3
Maintenance