Holtek e-Link for 8-bit MCU OCDS
User’s Guide

Revision: V1.20

Date: �������������July 11, 2017

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

Contents
HT8OCDS-ICE Introduction.................................................................................................... 3
HT8OCDS-ICE Composition.................................................................................................. 3e-Link(for HT8OCDS)........................................................................................................................ 3
Target Board (with EV)....................................................................................................................... 4
HT-HT-IDE3000 Software Update..................................................................................................... 4Hardware Connection........................................................................................................................ 4Connect to the USB Port to Programming Using the HT-IDE3000.................................................... 6

HT8OCDS-ICE Usage Considerations................................................................................... 7
About the HT-HT-IDE3000 Version.................................................................................................... 7
About the e-Link (for HT8OCDS) Version.......................................................................................... 8
System Frequency............................................................................................................................. 8Voltage and Current........................................................................................................................... 9Emulation Function Comparison of HT8OCDS-ICE and e-ICE........................................................11
Multiple Breakpoint Modes.............................................................................................................. 12
RAM Real-time Monitor Function..................................................................................................... 13
OCDS or I/O Selection Option Function.......................................................................................... 14

HT8OCDS-ICE Usage Restriction........................................................................................ 15
HT8OCDS-ICE Switch and Indicators.................................................................................. 16Switch.............................................................................................................................................. 16Indicator........................................................................................................................................... 16e-Link Size............................................................................................................................ 17

Rev. 1.20

2 of 18

July 11, 2017

Contents

HT8OCDS-ICE Usage Flow Description................................................................................ 4

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

HT8OCDS-ICE Introduction
The HT8OCDS-ICE is Holtek’s third generation simulator, especially for use with Flash MCU
devices.
Compared with the e-ICE, the differences are as follows:▀ The EV pin number is the same or has 1 to 2 more pins than the IC pins which can be soldered tothe application board making tests more convenient.
▀ Provides multiple breakpoint functions▀ Provides a RAM real monitor function▀ Wider operating voltage range of 1.7V~5.5V

HT8OCDS-ICE Composition
The HT8OCDS-ICE is composed of an e-Link (for HT8OCDS) + Target Board (with EV)

e-Link(for HT8OCDS)▀ e-Link is the common name for the Holtek ICE series and has the same appearance. Holtek will
provide an e-LinkBox.cmd for the updates for different applications. Here it should be updated
as Holtek 8-Bits MCU OCDS.
▀ e-Link Appearance:

Rev. 1.20

3 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide▀ The EV uses the OCDS (On-Chip Debug Support) structure that requires only two signal lines todebug.

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

Target Board (with EV)
The EV is an IC with an OCDS interface▀ During the debug process, the e-Link will implement a series of operations such as single step,
full speed, stop, breakpoint setting etc. by transmitting instructions to the EV.
▀ During the non-debug process, the EV is the same as an IC and works in the same way.

HT-HT-IDE3000 Software Update
The third generation emulator software still uses the HT-IDE3000 but is only supported by versions
starting from V7.6.
Log on to Holtek official website to download the latest HT-IDE3000.

Hardware Connection▀ e-Link(for HT8OCDS) Pin Assignment

Rev. 1.20

4 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide

HT8OCDS-ICE Usage Flow Description

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

HT8OCDS-ICE Pin Definition
NameDescription

Direction Paremetere-Link→

1.7V~5.5V

e-Link voltage input pin when the external power issupplied to the Target Board.

e-Link←1.7V~5.5V

OCDSCKThe OCDS CLK signal during programming

e-Link→1.7V~5.5V

OCDSDAThe OCDS Data signal during programming

e-Link ↔

1.7V~5.5V

GND

e-Link Grounde-Link ↔

0V

Reserved

Reserved e-Link signal pin

Unknown

Unknown

VDD

Note: The VDD, OCDSCK, OCDSDA and GND are the necessary pins of the HT8OCDS-ICE. Even if theexternal power is supplied to the Target Board, the same VDD is still necessary so as to be usedas the reference voltage of the output potential for the e-Link. Simultaneously the Options in theHT-IDE3000 must be set to VDD External.
Pins marked as Reserved in the e-Link are not NC pins for which the user should note that thevoltage is unknown.

▀ HT8OCDS-ICE Hardware Connection

Rev. 1.20

5 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide

e-Link voltage output pin when the power is supplied to theTarget Board.

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

Connect to the USB Port to Programming Using the HT-IDE3000▀ If the connection is successful, the following message will pop up:

﻿Holtek e-Link for OCDS User’s Guide

Online Prompt▀ If the connection failed or no connection, the following message will pop up:

Offline Prompt

Rev. 1.20

6 of 18

July 11, 2017

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

HT8OCDS-ICE Usage Considerations
About the HT-HT-IDE3000 Version
Before using the HT8OCDS-ICE, ensure that the HT-IDE3000 is the latest version.

Windows Screen

Rev. 1.20

7 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide▀ Check the “Help\About HT-HT-IDE3000…” in the function menu for the version information.
▀ If it is version is 7.6 or newer, when the HT-IDE3000 is enabled, the IDE will automaticallydetect if it is the latest version by prompting whether an update is required, or click “Help\CheckLive Update…” for a manual update.

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

Help Window▀ If the e-Link(for HT8OCDS) f/w is an old version, the following message will pop up whenconnecting to the HT-IDE3000▀ If the EV is an old version, the following message will pop up when connecting to the HTIDE3000.

System Frequency▀ The e-Link (for HT8OCDS) is not able to provide the system frequency for the EV. When using
the HT8OCDS-ICE, it is necessary to connect the required HXT, ERC or LXT according toactual application requirements.
▀ Generally the HIRC calibration for the EV has been to the value at 5V when manufactured.
Operation under other voltage points may cause some HIRC deviation.

Rev. 1.20

8 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide

About the e-Link (for HT8OCDS) Version

Holtek e-Link for 8-bit MCU OCDSUser’s Guide

Voltage and Current▀ The OCDS emulation can be powered by e-Link or external power supply. The operating voltageof the HT8OCDS-ICE ranges from 1.7V~5.5V.
● e-Link supplies power to the Target Board and setup the voltage parameters:
e-Link supplies power to the Target Board
﻿Holtek e-Link for OCDS User’s Guide● External power supplies to the Target Board, check the External square:
External power supplies to the Target Board▀ e-Link internal power supply and signal voltage:e-Link internal power supply and signal voltage● The power output circuit contains a MOS switch to implement the switchover between theinternal and external power supply. Users can switch on the MOS to select internal power orswitch off the MOS to select external power supply.
● Signal will be output after passed through the Level shift, a function which can implement thesignal level transformation and isolation. The output signal voltage level is determined by VDD.

Rev. 1.20

9 of 18

July 11, 2017

Holtek e-Link for 8-bit MCU OCDS
User’s Guide▀ e-Link OCDS emulation power supply in HT-IDE3000 flowchart description● If the target board is not powered, e-link will provide power automatically, and the voltage will
be incremented gradually trying to connect with the EV chip. Maintain at the current voltage
value when the connection is success. The e-Link operating voltage is selected by option after
the “Build” is executed to download.
● If the target board is powered (the detected voltage ≥ 1.5V)���������������������������������������
, this�������������������������������������
external voltage should be maintained to connect with the EV chip and download.
﻿Holtek e-Link for OCDS User’s Guide

OCDS Emulation Power Supply Flowchart
Start theHT-IDE3000
Detect the e-Link for
EV connection

The Target Boardis powered (>1.5V)?
NoYes

MOS switches on�e-Link provides power andgrad�a��� increases thevo�tage� tr� to connect withthe EV chip

MOS switches off�tr� to connect with the EVchip

EV chip connected�
exec�te“B�i�d＂todown�oad
Option S�sVo�tse�ects“Externa�＂?

Option S�sVo�tse�ects “Externa�＂?

YesPower is s�pp�ied
externa���� start todown�oadNoYes

Warning：
Interna� power setting isse�ected� b�t Target BoardPower is detected ! P�ease
remove this power!

Warning：Externa� power setting isse�ected� b�t the vo�tage va��eof VDD is not detected. P�easecheck target board power!

Noe-Link provides vo�tage
setting in the optionS�sVo�t � start todown�oad▀ If the external power is selected in the Option, the power will not switch immediately whenconnected to e-Link, it will only take effect when the “External” option is selected in the HTIDE3000 when executing the “Build” to download.
Select External Power Supply

Rev. 1.20

10 of 18

July 11, 2017

Holtek e-Link for 8-bit MCU OCDS
User’s Guide▀ When e-Link is selected to supply power to Target Board, if there is still an external power
supply to Target Board, in the HT-IDE3000 Build process, the prompt window which requires
the removal of the external power supply will pop up to avoid power conflict.
power supply prompt window▀ When the e-Link supplies power to the Target Board, if the current load is large, some VDD
output errors may occur.
eg: When the load current is 100mA~200mA, the actual VDD output will have a rather low
value of 0.1V~0.2V.
It is recommended to configure the VDD together with the consideration of this error range.

Emulation Function Comparison of HT8OCDS-ICE and e-ICE
Differences between the HT8OCDS-ICE and e-ICE.
Description
FW Update

The emulator can update the FW through the HTIDE3000.

Need to change MEV

Pin Assignment

Pins can be soldered on to the application board for
direct adjustment.
Good signal connection, quick and convenient

The EV is of 128QFP or
208QFP Requires DuPont lineor other connectors to connect
with the application board.

Break Point

Total of 7 Breakpoint modules;
Breakpoint setting during free run;
Breakpoint setup available in ROM, RAM, EEDATA;
Diverse Breakpoint format

Breakpoint number unlimited;
No Bbreakpoint setting during
free run;
Breakpoint setting only in ROM;

RAM Monitor

Supported

Not supported

HALT

Available at any location

Cannot be placed at the last
address of ROM Bank0OCDSDA/ OCDSCK Pin Share function unavailable during rogramming

Rev. 1.20

Paremeter

Trace

Not supported

SysFreq

e-Link not provided

Reset Pin

Reset circuit required when executing the Resetfunction

No restriction
Instruction tracing

11 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide▀ In pratical applications, if the external power is selected, it is recommended that external powershould be connected before connecting with the e-Link, otherwise the e-Link will provide power
automatically when the external power is not detected, which will result in conflict after theexternal power is supplied.

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

Multiple Breakpoint Modes▀ An Auto Break can be setup when any of the following conditions is satisfied, just tick in theEvent condition box.
PC \ Stack \ Cycle Count Overflow \ Stack Underflow \ LVR \ Wakeup
Breakpoint Setting Window

Rev. 1.20

12 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide▀ In the HT-IDE3000 tool menu, select “Debug\Breakpoints” or use shortcut “Ctrl+B”▀ Although only seven breakpoint modules are available, each breakpoint module can setup theobject control and control range:
Code type: When the PC access an address or a range is setup, it will break automatically.
Data\EEData type: when an address or a range of RAM/EEData is read / written, it will breakautomatically.

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

RAM Real-time Monitor Function▀ In the HT-IDE3000 tool menu, select “Debug\RAM Monitor”▀ Set the RAM monitor range, and tick it▀ Monitor up to 256 RAM unit at the maximum , each group monitor addresses can not be repeated▀ Click “start” to begin to monitor the RAM status
﻿Holtek e-Link for OCDS User’s Guide▀ Move “Update Speed” to control the refresh rate
RAM Monitor Window

Rev. 1.2013 of 18

July 11, 2017

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

OCDS or I/O Selection Option Function▀ OCDS or I/O Selection option usage
After e-Link connects successfully, click “Tools\Switch OCDS Mode” in the HT-IDE3000 menu,
the OCDS Mode selection screen will pop up.
OCDS Mode selection

In the OCDS Mode selection screen, the current EV mode is default. Users select the OCDS
mode or the Real IC mode according to their needs, click OK to complete switch.
Note: when switching mode, the power supply to the Target Board must be removed.
▀ If the EV has no OCDS or I/O Selection option, when e-Link connects successfully, the HTIDE3000 menu “Tools\Switch OCDS Mode” in gray is unavailable.
When e-Link is online, the pin-shared function of OCDSDA/OCDSCK is invalid.
When e-Link is offline, the pin-shared function of OCDSDA/OCDSCK is the same as the ICpins function.

Rev. 1.20

14 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide▀ When OCDSDA/OCDSCK is pin-shared with I/O, most of the EV can divide the shared pins
into the OCDSEV mode and the Real IC mode through the OCDS or I/O Selection option;
OCDSEV mode: whether e-Link is online or offline, the pin-shared function of OCDSDA/OCDSCK is invalid;
Real IC mode: when e-Link is offline, the pin-shared function of OCDSDA/OCDSCK is thesame as the IC pins function; when e-Link is online, the function is still invalid;
Note: When the EV is setup to be in the Real IC mode, then if the target board power isexternally supplied, no emulation can be carried out. However if emulation is required,
then the external power must be first removed and it must be switched to the OCDS mode.

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

HT8OCDS-ICE Usage Restriction▀ EV and IC Pin Assignment
OCDSDA\OCDSCK may be pin-shared with an I/O or alone, so the pin number of the EV
maybe the same or 1~2 pins more than that of the IC.
▀ OCDSDA/OCDSCK can not connect to capacitor, when OCDSCK is pin-shared with the resetpin, please refer to the following reset circuit.

OCDSCK should
be connected here

▀ When e-Link supplies power to the Target Board, the maximum current consumption is 200mA.
If the power consumption of the Target Board exceeds 200mA, the external power supply to theTarget Board should be selected.
▀ When e-Link supplies power to the Target Board, the maximum capacitance which the VDD pinlinks to is 100uF.

Rev. 1.20

15 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide

Recommended Reset Circuit

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

HT8OCDS-ICE Switch and Indicators
SwitchThe switch is used to reset the HT8OCDS-ICE.

Indicator▀ ErrorRed means that the e-Link operation has an “error”
Continuously on: Abnormal operation
Continuously off: Normal operation▀ Active
Blue means the “duty load” of the e-Link
Slow Flashing: Idle, standing by ready at an interval of 1s (HT-IDE3000 not operational)
Flasghin: Busy, the flash frequency and duration depends upon the number of duties.

Rev. 1.20

16 of 18

July 11, 2017

﻿Holtek e-Link for OCDS User’s Guide▀ Status
Yellow shows if the e-Link is providing power “to the Target Board”.
Continuously on: Power to the Target Board
Continuously off: No power to the Target Board

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

e-Link Size
▀ Back and side e-Link dimensions (unit: mm)

﻿Holtek e-Link for OCDS User’s Guide▀ e-Link back slot dimensions (unit: mil)Rev. 1.20

17 of 18

July 11, 2017

Holtek e-Link for 8-bit MCU OCDS
User’s Guide

﻿Holtek e-Link for OCDS User’s Guide

Copyright© 2017 by HOLTEK SEMICONDUCTOR INC.
The information appearing in this Data Sheet is believed to be accurate at the timeof publication. However, Holtek assumes no responsibility arising from the use ofthe specifications described. The applications mentioned herein are used solely forthe purpose of illustration and Holtek makes no warranty or representation that suchapplications will be suitable without further modification, nor recommends the use ofits products for application that may present a risk to human life due to malfunction
or otherwise. Holtek's products are not authorized for use as critical components inlife support devices or systems. Holtek reserves the right to alter its products without
prior notification. For the most up-to-date information, please visit our web site at
http://www.holtek.com/en/.

Rev. 1.2018 of 18

July 11, 2017