Katun TCM4 User manual

TCM4
MultiFrequency
Card reader
User Guide
&Technical Manual
V1.2

SAFETY 
This CARTADIS product and
supplies are manufactured and
certified to strict safety
regulations, electromagnetic
regulations and established
environmental standards.
WARNING! 
Any unauthorised alteration,
which may include the addition
of new functions or connection
of external devices, may impact
the product certification.
Please contact your CARTADIS
representative for more
information.
Warningmarkings
All warning instructions marked
on or supplied with the product
should be followed.
Electricalsupply
This product shall be operated
from the type of electrical
supply indicated on the
product's data plate label. If you
are not sure that your electrical
supply meets the requirements,
please consult your local power
company for advice.
To disconnect all electrical
power to the product, the
disconnect device is the power
cord. Remove the plug from the
electrical outlet.
Operator accessible areas
This product has been designed
to restrict operator access to
safe areas only. Operator access
to hazardous areas is restricted
with covers or guards which
would have to be removed
using a tool. Never remove
these covers or guards.
Maintenance
Any operator product
maintenance procedure will be
described in the user
documentation supplied with
the product. Do not carry out
any maintenance on the
product which is not described
in the customer documentation.
Cleaning your product
Before cleaning this product,
unplug the product from the
electrical outlet. Always use
materials specifically designated
for this product. The use of
other materials may result in
poor performance and may
create a hazardous situation. Do
not use aerosol cleaners; they
may be flammable under
certain circumstances.
For more information on
Environment, Health and safety
in relation to this CARTADIS
product and supplies, please
contact the following customer
help lines:
Europe: [phone].
The CE mark applied to this
product symbolises CARTADIS
declaration of conformity with
the following applicable
European Union Directives as of
the dates indicated:
January 1, 1995:
Council directive 73/23/EEC,
amended by Council Directive
93/68/EEC, approximation of
the laws of the member states
related to low voltage
equipment.
January 1, 1996:
Council directive 89/336/EEC,
approximation of the laws of
the member states related to
electromagnetic compatibility.
A full declaration of conformity,
defining the relevant directives
and referenced standards, can
be obtained from your
CARTADIS representative.
WARNING! 
In order to allow this equipment
to operate in proximity to
Industrial, Scientific and Medical
(ISM) equipment, the external
radiation from the ISM equipment
may have to be limited or special
mitigation measures taken.
OCT 2020

Table of contents
Section Page
1. Introduction 3
2. Overview 4
2.1 Supported tags 4
2.2 USB interface 4
2.3 Operation 4
2.3.1 Memory view 4
2.3.2 Startup sequences 5
2.3.3 LEDs and buzzer status specification 6
3. Configuration 7
3.1 TCM4 parameters 8
3.2 Modification 9
3.2.1 By command lines in application mode 9
3.2.2 By a configuration file in bootloader mode 11
4. Firmware 14
4.1 Upgrading TCM4 firmware 14
OCT 2020

1.Introduction
The small-sized Cartadis TCM4 is a reader of contactless cards.
The TCM4 features both low (125 kHz, 134.2 kHz) and high frequency (13.56MHz) antennas, allowing
the user to access a wide range of RFID standards.
Application fields of the TCM4 MultiFreq card reader are:
•Secured print: direct connection to the USB port of many MFDs for identifying the user and
release the prints (with Print2me function available) or making copies.
•Option for the Cartadis cPad terminal: integrated into the designed shape of the cPad, the TCM4
enables the user to be identified by using a card with a solution like Gespage, PaperCut, etc …
•PC applications: entry without error code of a RFID tag, enrolment of a user’s card in a database,
secured access to some applications …
•Point of sale: connection to the cash registers for loyalty management.
•OEM: Cartadis assists its customers by providing a customization service of the TCM4 readers on
the management of the specific RFID cards or USB protocols.
This technical manual provides the information required to get started the TCM4 card reader. It also
describes how to configure your card reader and how to update a new firmware version.
OCT 2020

2.Overview
2.1 Supported tags
TCM4 reader supports a wide variety of high and low frequency tags, the list is detailed in the “TCM4
card compatibilities” leaflet.
2.2 USB interface
TCM4 connects to the host device by different types of USB protocols depending on the
configuration:
•USB HID Keyboard Qwerty or Azerty
•USB CDC Serial Emulator.
2.3 Operation
2.3.1 Memory view
The memory is divided into 3 sections as shown in the following diagram:
•Bootloader: The bootloader is the entry point for the firmware after a TCM4 power up or a reset.
Only the bootloader provides functions for programming new firmware. This means that
the bootloader must be entered to program a new firmware.
•Application: TCM4 application.
•Storage: Storage area, where a new firmware file and the configuration file are stored. It
is accessible from host computer through USB mass storage in bootloader mode.
•Bootloader (200
Kbytes) Bootloader:
The bootloader is the
entry point for the
firmware after a
TCM4 power up or a
reset. Only the
bootloader provides
functions for
programming new
firmware. This
means that the
bootloader must be
entered to program a
new firmware.
•Application: TCM4
application.
Storage:
Storage
area, where
a new
firmware
file and the
configuratio
n file are
stored. It is
accessible
from host
computer
Application
(400 Kbytes)
Storage
(400 Kbytes)
OCT 2020

2.3.2 Startup sequences
The diagram on the next page shows the sequences of how bootloader and application are started:
Valid
firmware?
Available firmware
in storage zone?
OCT 2020

2.3.3 LEDs and buzzer status specification
Blue
Red
Buzzer
Signification
4
beeps
Power Up
TCM4 in
bootloader
mode
Normal operation
Blinks
on steps
A copy from host computer to storage zone of
TCM4 on USB mass storage is in progress
Blinks 2, 3
times slowly
and stays ON
A firmware’s update is done (copy of firmware
from storage zone to application zone and
firmware verification)
Blinks every
500ms
TCM4 in
application
mode
Normal operation
Blinks every
500ms
1 beep
Card detected
OCT 2020

3.Configuration
TCM4 has a built-in command line interpreter which allows a set of predefined parameters to be displayed or
modified.
These parameters can be modified or displayed in two different ways:
•from a serial terminal (like Putty) or
•from a configuration file.
The next paragraphs will describe the TCM4 parameters and the way they are configured.
OCT 2020

OCT 2020
3.1 TCM4 parameters
The TCM4 parameters and their possible values are described below:
Parameter
name
Description
Default values
General parameters
comusb
USB Communication Type (CDC/HID Keyboard Azerty or Qwerty.
1: HID keyboard QWERTY
2: HID keyboard AZERTY
3: CDC (serial port emulation)
1: HID Keyboard Qwerty
freq
The TCM4 can scan all types of cards or be restricted to one or
several types of card technologies. The values of this parameter can
be summed (mask) to scan several types of cards. The following
values are configured in hex format.
Possible values are (minimum 4 digits entry):
0000: Lock first (card type of the first card detected by TCM4 after
power up will be applied as filter)
0001: ISO 14443 13.56Mhz (Mifare) type A
0002: ISO 14443 13.56Mhz (Mifare) type B
0004: ISO 15693 ICODE 13.56Mhz
0100: iCLASS 13.56Mhz
0400: IZLY complete format 13.56Mhz (requires a TCM4-Izly)
0800: FELICA 13.56Mhz
1000: IZLY short format 13.56MHz (requires a TCM4-Izly)
10000: IZLY long format 13.56MHz (requires a TCM4-Izly)
40000: NFC for Smartphone with CartadisID application
0010: EM (Electronic Marin) 125Khz
0020: HID Prox 125Khz
0040: HITAG 125Khz
2000: Indala 125Khz
8000: StartProx
FFFF FFFF : All card types
0000: Lock first
nobuzz
Disable/Enable buzzer.
0: Buzzer is enabled (beeps at each card detection)
1: Buzzer disabled
0: Buzzer enabled
UID reading mode parameters
niboffset
Skip niboffset digits in the IUD card. This parameter allows to reduce
the size of an UID when all the cards have the same prefix
0
niblen
When the size of IUD is greater than the “niblen”, it is truncated and
only the “niblen” digits from the right of the UID are kept
64
swap
Swap MSB/LSB of UID.
0: No swap
1: Swap MSB/LSB
0: Disabled
uidindec
Converts the hex UID card in decimal format.
0: Disabled
1: Converts the UID card in decimal
0: Disabled

OCT 2020
uidcase
Forces UID card upper case or lower case.
0: Disabled
1: Upper case
2: Lower case
0: Disabled
rm0head
Removes 0 at the head of the UID
0: Disabled
padding
Adds 0 at the head of UID if UID length < padding, number of 0 to
add = padding - uid length
0: Disabled
evensize
Adds 00 at the head of UID card if UID length (in bytes) is odd. If
enabled, all commands niboffset, niblen, uidindec, rm0head,
padding will be ignored
0: Disabled
Mifare sector reading parameters
ulen
Number of bytes to read data in a sector of a Mifare tag
0: Disabled
usector
Sector number in which reading data
0
uoffset
Skips uoffset bytes from the beginning of sector
0
ukeya
Key A for reading data from a sector of Mifare card
0x00 0x00 0x00
0x00 0x00 0x00
HID parameters
hidmode
Decoding mode of HID tag
0: normal
26: 26 bits mode
254: Mixed mode (26 bits + Normal)
0: Normal mode
hidsite
Site code (8 bits in hexadecimal) using when hidmode is set to 26
bits mode
0
Miscellaneous
debug
Enable/Disable debug mode. With this mode the message sent to
the host computer via USB gives extra information about the card
technology in form:
Detected frequency (13.56Mhz/125kHz)-Tag type[filter value to
configure]-UID length in bytes-UID
Ex: 1356Mhz-TAG_FELICA[0x00000800]-8 bytes-0127006853DD8FC7
125kHz-TAG_HITAG_2[0x00000040]-4 bytes-1C94345B
3.2 Modification
3.2.1 By command lines in application mode
Application mode means the TCM4 reader is running the application (as opposite to the bootloader
mode).
It is only possible to communicate with the TCM4 over a virtual PC serial port when the TCM4 is in
application mode, that is to say when the blue LED is blinking.

would like
OCT 2020
All TCM4 parameters can be modified or displayed by using a serial terminal (like Putty on Windows).
No matter how your TCM4 is configured, as soon as it is connected to a PC, it declares itself as a USB
composite device CDC and HID.
•The serial port of the PC must be configured as below:
•All TCM4 commands are shown in entering “help” or “?”.
In the following screen shot, the first column indicates whether the parameter can be modified
when TCM4 is in application mode (“For_App”), bootloader mode (“For_Boot”) or whatever
the mode (“For_All”).

3.2.2 By a configuration file in bootloader mode
You can identify your TCM4 is in bootloader mode when the blue LED is on and not blinking.
If you wish to switch from “application mode” to “bootloader mode”, you need to enter the
command "gobootload" in a serial terminal like Putty, see above.
Once your TCM4 is in bootloader mode, you can read/write the parameters of TCM4 by using a
configuration file.
•As soon as TCM4 is in bootloader mode, it is mounted to the host computer and it behaves
like a USB key with the name “TCM4 BOOT”.
OCT 2020

•Configuration file’s name is config.cmd, it contains different commands to run. After the
execution of config.cmd file, you will find 2 files in the TCM4 BOOT directory: config.done
and config.log which are the results of all runned commands.
Hereafter is an example of a configuration file and result file:
OCT 2020

•To execute commands in a configuration file from TCM4, the following instructions have to
be followed:
oNavigate to the newly mounted TCM4 drive (TCM4 BOOT).
oDelete config.done file and config.log file.
oCopy a new config.cmd file to the TCM4 BOOT.
oTCM4 should automatically un-mount and re-mount itself.
oIf the execution of configuration file was successful, you will get a new config.done file
and config.log file. Consult config.log file to know the result.
OCT 2020

OCT 2020
4.Firmware
4.1 Upgrading TCM4 firmware
TCM4 firmware can be updated via USB interface by switching to bootloader mode.
As you know, in this mode, TCM4 is mounted as a USB stick.
To remind you, the bootloader mode is entered by doing the command “gobootload” in a serial
terminal in application mode. When TCM4 is in bootloader mode, a firmware file
(TCM4_Firmware_vx.x.x.ctd) and a status of previous update operation are visible in the device root.
To upgrade a new TCM4’s firmware, the following instructions have to be achieved:
•Navigate to the newly mounted TCM4 (TCM4 BOOT)
•Delete TCM4_Firmware_vx.x.x.ctd file
•Copy a new firmware file to TCM4 BOOT
•TCM4 should automatically un-mount and re-mount itself.
The update was successful if the FwUpdate_Success.stt status file is present.
All the firmware update status are detailed below:
Status
Description
FwUpdate_NoFwFile.stt
No firmware file in storage zone
FwUpdate_SameFw.stt
Firmware file is the same as the firmware in application zone
FwUpdate_Success.stt
Update operation is successful
FwUpdate_Failed.stt
Update operation has failed
FwUpdate_FwCorrupted.stt
Firmware file is corrupted