TouchMCUWorkshop...

Touch MCU Workshop v3.0
使用手冊
2014-07-21
版本: V.1.10 日期: 2014-07-21
目录
第一章开发平台简介与软件安装 (1)
特性 (1)
系统需求 (1)
系统配置 (1)
软件安装 (2)
第二章 Touch MCU Workshop软件功能介绍与操作 (5)
软件开发流程 (5)
快速开始 (5)
软件功能说明 (8)
第三章 Touch MCU Tuning软件功能介绍与操作 (11)
快速开始 (11)
软件功能说明 (12)
第四章元件制作 (16)
元件系统文件制作工具 (16)
附录A (21)
附录B (22)
第一章 开发平台简介与软件安装
盛群Touch MCU Workshop V3为第三代触控按键开发平台，采用直觉式的拖曳方式设定完成项目，该项目也可以当做高级用户的框架 (framework ) 继续开发自己的产品项目。

平台内部集成触控函数库、编译功能与按键信号监测与按键参数调整。

特性
●支持BS82xxx, BS83xxx, BS84xxx Flash 系列MCU
●提供友善直觉的操作接口
●容易调整按键灵敏度与参数设定
●内建编译器
●内建触控与周边元件函数库
●开放高级用户自行增加元件函数库
系统需求
●具有USB 端口的个人电脑
●操作系统：Microsoft Windows® XP 或更新的版本
系统配置
●软件
♦Holtek Touch MCU Workshop ：MCU 按键设定、触控参数设定、程序产生器与编译功能 ♦Holtek Touch MCU Tuning ：按键信号监控、按键灵敏度调整与触控参数调整 ●硬件
♦e-IsoLink ：OCDS 、ICP 、数据传输
♦Target board ：功能验证
软件安装
●步骤一
执行安装程序后欢迎的对话框将会显示如下图，点击“Next”执行安装程序。

●步骤二
设定安装路径，默认的路径是“C:\Program Files\Holtek MCU Development Tools\Touch MCU
Workshop”，点击“Next”继续进行安装。

●步骤三
设定启动菜单程序集路径，默认路径为“Holtek MCU Development Tools\Holtek Touch MCU Workshop”，点击“Next”继续下一个安装步骤。

●步骤四
若要在桌面增加快捷方式可勾选“Create a desktop icon”。

●步骤五
设定确认，若要修改设定可以点击“Back”回到上一个步骤，点击“Install”完成安装程序。

●步骤六
安装程序完成安装后将出现如下图的对话框，若勾选“Launch Holtek Touch MCU Work-shop”，点击“Finish”安装程序将结束并执行“Touch MCU Workshop”。

第二章 Touch MCU Workshop软件功能介绍与操作
软件开发流程
快速开始
创建新项目
1. 在项目窗口里的「项目名称字段」输入项目名称
2. 于「项目位置」字段设定项目放置路径，默认与HT-IDE3000的默认路径相同。

项目建立后
将在此目录下新建一个与项目名称相同的子目录存储相关档案
3. 选择要开发的MCU
4. 选择触控库版本
注：若开启接口时有旧项目可点击“New”进行新项目建立, 再按上述1~4步骤进行操作。

加入按键与元件
●加入按键
方法1：从工具箱拖曳“KEY”元件至IC脚位有标示KEY的位置如下：
放开鼠标左键后将变成下图状态，则原先的PB0将从I/O变成按键功能。

方法2：从工具箱拖曳“KEY”元件至下图虚线处，则按键将从KEY1, KEY2, …依序自动设定。

●加入元件
从工具箱拖曳元件至上图蓝色虚线处即可。

设定按键或元件的属性
从工具箱拖曳按键或元件的同时属性窗口将显示出该按键或元件的属性设定，如下图为按键的门坎值设定。

如果属性窗口是空白的状态代表此元件没有属性需要设定。

变更按键或元件的脚位设定
直接从已设定好的红色脚位拖曳至其他的I/O脚，拖曳时颜色将变成绿色，当颜色变成红色即完成设定（按键需要拖曳至有标示KEYx的脚位），如果拖曳至某跟脚位时颜色没有转换成红色表示无法变更至该脚。

例如要将Scope元件的SDA脚变更至PC7脚，只要直接拖曳SDA至PC7脚当颜色变成红色即可。

软件功能说明
选单功能说明
●New: 建立新的项目
●Open: 开启既有的项目
●Save: 储存目前编辑的项目
●Build: 编译项目
♦Download: 若勾选编译成功后程序将会被下载到板子里。

下载时板子不可外接电源或电池
♦OCDS mode: 勾选后不可将元件的脚位设定到有标示OCDSSDA与OCDSSCK的脚位
●HT-IDE3000: 高级用户可调用HT-IDE3000继续开发项目。

执行后Touch MCU Workshop将自
行关闭。

若用户的电脑无安装HT-IDE3000则为反白状态
●Tuning: 调用Touch MCU Tuning进行按键灵敏度与触控参数调整。

若无选用 TUNING组件
(TUNING_IIC, TUNING_UART), 此栏为反白状态。

●Register e-IsoLink: 注册e-IsoLink。

注意e-IsoLink需要注册才可使用。

若已注册则将为反白状态
●Upgrade e-IsoLink F/W: 升级e-IsoLink 韧体
勾选Toolbox, Properties, Global Options, Project, MCU Resource, Output, Help显现相对应的窗口。

Available Language: 选择软件显示的语言。

目前有繁体中文、简体中文与英文供选择。

工具箱窗口（Toolbox）
提供按键或元件供用户添加功能。

项目窗口（Project）
Project Name : 输入项目名称。

执行「储存」后项目名称就不能变更。

Project Location : 设定项目路径。

默认与HT-IDE3000默认值相同。

执行「储存」后项目路径就不能变更。

MCU : 选择要开发的MCU。

Touch Library Version : 选择触控函数库版本。

MCU Configuration Options : 对于一般用户MCU option不需要设定采用预设即可，若要变更MCU option设定请点击下图红框进行变更。

全局设定窗口（Global Options）
全局窗口提供触控参数供用户设定。

触控参数：
註：1. 需要选择进阶模式 (Advance Mode)。

2. 选项会依据触控函数库版本而有所差异。

属性窗口（Properties）
拖曳元件时可顺便到属性窗口设定属性或点击已加入的元件更换该元件属性，如果某元件不需要额外设定则属性窗口是空白的状态。

按键的属性设定如下：
按键触发门坎值（Threshold） : 范围为8 ~ 255，若勾选“Apply all key”后调整门坎值时将一并调整其他按键的门坎值。

第三章 Touch MCU Tuning软件功能介绍与操作
Touch MCU Tuning为按键调校软件，提供用户观察按键信号软件接口并提供按键灵敏度调整与
触控参数调整。

用户调整后可以立即观察到结果。

Tuning 软件除了可以通过Holtek Touch MCU
Workshop调用外也可以单独执行。

快速开始
启动Touch MCU Tuning
●通过Touch MCU Workshop调用后Tuning软件的选单画面
●从启动菜单调用后的软件选单画面如下，需要先选择目标板 (Target board)与e-IsoLink的传输
协议，可在软件的「协议(Protocol)」设定 (预设的协议为IIC) 再选择供应给目标板的电源
软件功能说明
2 3
1
4
1. 按键信号观察区
2. 调校窗口 (Tuner Window)
3. 全局窗口 (Global Option Window)
4. 示波器 (Scope Window)
按键信号观察
从按键信号观察区内可观察目标板的脚位被定义为按键或I/O脚。

若为I/O脚则显示为灰色，
如下图所示。

若为脚位为按键用户可以用鼠标点击切换调校窗口要观察的按键。

按键状态显示
侦测到的实际差值显示在下图绿色里，差值越大绿色区域越多。

当按键被判断为已按下状态则显示为红色，如下图代表KEY1已经被按下表示程序里的按键标
志成立。

按键图标的数值显示说明，如下图
按键编号
补偿电容
触发门槛
背景信号原始信号
调校窗口 (Tuning Window)
调校窗口可以观察单一按键的信号值并可调整按键的灵敏度。

切换要调校的按
键
按键被判断按下
之次数
调校时间
重置时间与次数
按键实际差值
鼠标拖曳调整按
键灵敏度 8~255
全局选项窗口(Global Option Window)
全局选项窗口提供触控参数供用户变更，设定后可立即观察到调整后的结果。

触控参数请参考第二章说明。

示波器 (Scope Window)
示波器可以显示按键的信号值，用户可以勾选示波器右侧清单选择要观察哪些按键的波形。

功能说明：
●自动调整范围 (Auto scale): 勾选让软件自动判定Y轴显示范围，否则需要设定显示的上下限
●开始／停止 (Start/Stop): 启动或停止示波器的显示
●重置 (Reset): 清除波形与重设调校窗口的按键次数与时间
选单功能说明
●开新档案 (New): 建立新的Touch MCU Workshop项目档
●开启旧档 (Open): 开启Touch MCU Workshop专案档
●储存到INC/H (Save to INC/H): 触控设定输出到HXT_REFERENCE.inc
●注册e-IsoLink (Register e-IsoLink): e-IsoLink使用前必须注册, 若为反白状态则表示e-IsoLink
已被注册
●升级韧体 (Upgrade firmware): 升级e-IsoLink韧体
●电源 (Power): 设定e-IsoLink提供给目标板的电源。

有5V、3.3V或外部供电选择
●协定 (Protocol): 选择目标板与e-IsoLink间的通信协议，有IIC与UART两种。

若用户在
Touch MCU Workshop中选择“TUNING_IIC”元件则使用的协议为IIC；如果选择“TUNING_ UART”元件则使用的协议为UART
第四章元件制作
Touch MCU Workshop为开放性平台，高级用户可以自行制作元件函数库，该元件也可以分享给
其他用户使用。

元件系统文件制作工具
元件制作需先制作系统文件。

系统文件描述元件的功能与元件使用的代码档案，用户可从启动
菜单程序集执行“Component Library System File Maker”将元件系统文件制作工具调用起来。

制作工具使用说明
●步骤1 – 脚位设定
♦设定元件名称，元件名称将出现在Touch MCU Workshop的工具箱(Toolbox)内
♦指定元件函数库放置路径的文件夹名称。

文件夹内需要放置元件系统文件与相关的程序代码档案与元件说明文件。

其根目录为平台安装路径下的 McuLibrary\Peripherals目
录，例如平台安装路径为“C:\Program Files\Holtek MCU Development Tools\Touch MCU
Workshop”则文件夹要放置到“C:\Program Files\Holtek MCU Development Tools\Touch
MCU Workshop\McuLibrary\Peripherals”里
♦「元件脚位设定」设定元件的脚位要与MCU I/O脚结合，这些设定也影响软件的显示。

若元件没有脚位对应则不需要设定
♦设定「元件脚位设定」完后，可以依序点击至右侧进行细部设定
●步骤2 – 全局选项
定义的数值设定后软件的显示画面如下圖。

●步骤3 –函数库
♦选择开发的程序语言: C语言或汇编语言。

C语言的编译程序目前只能使用V2版
♦在原始码档案里面设定元件所要使用的元件程序代码档案。

「加入HT-IDE3000项目」若选择“Yes”等同于HT-IDE3000将档案加到项目里如下图
♦若原始码档案内容为空白，将在第一次执行「储存」时产出以元件目录名称命名的 .C/.ASM、.
AEX与.CEX并且自动加入。

例如：元件目录设定为“LEDX4_V10”且开发语言选择“asm”则将于元件目录内产出“LEDX4_V10.asm”, “LEDX4_V10.AEX”与“LEDX4_ V10.CEX”
♦元件需要设定支持的MCU请在“Misc”区域设定MCU名称
♦元件说明文件可以在「说明文件」区设定。

说明文件档案建议使用PDF檔建立并须放置在元件函数库放置路径的文件夹内
元件程序撰写
●程序架构: 用户需要实作两个子程序以元件名称命名
♦<元件名>_INITIAL: 负责开机时元件的初始化工作
例如LEDX4_V20_INITIAL。

♦<元件名>: 元件功能的程序进入点
例如 LEDX4_V20。

●文件名命名规则: 档名请命名与文件夹同名
●档案架构: 至少需要提供3种档案，扩展名如下:
♦.C/.ASM: 放置元件的主程序。

若开发语言为C则扩展名为.C，若为汇编语言则为.ASM ♦.AEX: 使用汇编语言语法放置对外输出的label
例如:
EXTERN _LEDX4_V20_INITIAL:NEAR
EXTERN _LEDX4_V20:NEAR
♦.CEX: 使用C语言语法放置对外输出的函数名
例如:
extern void LEDX4_V20_INITIAL();
extern void LEDX4_V20();
e-IsoLink F/W将会自动识别评估板使用的MCU类型自动定义e-IsoLink的脚位功能。

如下两种：(A)
(B)
MCU使用的脚位如下：
评估板底板使用注意事项：
评估板底板若接电池, 在进行下载 (刻录) 前或下载时不可以开启电源否则会影响刻录。

评估板底板接电池后启动电源若无任何操作将于约2分钟后自动关闭电源。

Copyright© 2014 by HOLTEK SEMICONDUCTOR INC.
使用指南中所出现的信息在出版当时相信是正确的，然而盛群对于说明书的使用不负任何责任。

文中提到的应用目的仅仅是用来做说明，盛群不保证或表示这些没有进一步修改的应用将是适当的，也不推荐它的产品使用在会由于故障或其它原因可能会对人身造成危害的地方。

盛群产品不授权使用于救生、维生从机或系统中做为关键从机。

盛群拥有不事先通知而修改产品的权利，对于最新的信息，请参考我们的网址.。