TDK PowerHap Installation and operating instructions

Piezo Haptic Actuators - PowerHap
Application note for evaluation kit 60 V
Series/Type:
Ordering code: Z63000Z2910Z1Z44
Date: 2019-05-08
Version: 1.6
 TDK Electronics AG 2019. Reproduction, publication and dissemination of this publication, enclosures hereto and the
information contained therein without TDK Electronics' prior express consent is prohibited.
Content of header bars 1 and 2 of data sheet will be automatically entered in headers and footers! Please fill in the table and then
change the color to "white". This ensures that the table disappears (invisible) for the customer PDF.
Don't change formatting when entering or pasting text in the table and don't add any cell or line in and to it!
Identification/Classification 1
(header 1 + top left bar):
Piezo Haptic Actuators - PowerHap
Identification/Classification 2
(header 2 + bottom left header bar):
Application note for evaluation kit 60 V
Ordering code: (top right header bar) Z63000Z2910Z1Z44
Series/Type: (bottom right header bar)
Preliminary data (optional): Preliminary data
Department: PPD PI AE/IE PD
Date: 2019-05-08
Version: 1.6
Prepared by: Roman Puchleitner
Signed by: Harald Kastl, Andreas Pentscher-Stani, Roman Puchleitner

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 2 of 28
Important notes at the end of this document.
1Introduction ...................................................................................................................................................... 4
1.1Ordering code .......................................................................................................................................... 4
1.2Features ................................................................................................................................................... 5
1.3Description ............................................................................................................................................... 5
2Quick start guide .............................................................................................................................................. 6
2.1What is in the box .................................................................................................................................... 6
2.2PCB overview .......................................................................................................................................... 7
2.3Quick start procedure .............................................................................................................................. 7
3Hardware ......................................................................................................................................................... 8
3.1Jumper options ........................................................................................................................................ 8
3.1.1Use BAT power (external power supply connection) .......................................................................... 8
3.1.2Use UPI feature ................................................................................................................................... 9
3.2Piezo actuators ........................................................................................................................................ 9
3.3DIP switch settings ................................................................................................................................ 10
3.4Output configuration options .................................................................................................................. 12
3.4.1Differential output configuration ......................................................................................................... 12
3.4.2Single ended output configuration ..................................................................................................... 12
3.5Breakable units ...................................................................................................................................... 13
4Software ......................................................................................................................................................... 13
4.1Software installation procedure ............................................................................................................. 13
4.2Software operation ................................................................................................................................. 13
5Firmware ........................................................................................................................................................ 14
5.1Identifying the firmware revision number ............................................................................................... 14
5.2Firmware installation / update procedure .............................................................................................. 15
5.3Firmware modification – using PSoC® CreatorTM ................................................................................. 16
5.4Adjusting sensing feedback parameters ................................................................................................ 17
5.4.1Sensing feedback amplitude .............................................................................................................. 17
5.4.2Sensing feedback frequency ............................................................................................................. 17
5.4.3Sensing threshold .............................................................................................................................. 17
5.4.4Response type ................................................................................................................................... 18
6Design reference ........................................................................................................................................... 19
6.1Schematics ............................................................................................................................................ 19
6.2PCB Layout ............................................................................................................................................ 21
6.3Bill of materials ...................................................................................................................................... 23
7FAQ and troubleshooting ............................................................................................................................... 24
8Notes and warnings ....................................................................................................................................... 24

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 3 of 28
Important notes at the end of this document.
9Document history ........................................................................................................................................... 25
Cautions and warnings .......................................................................................................................................... 26
Remark .................................................................................................................................................................. 26
Display of ordering codes for TDK Electronics products ....................................................................................... 26

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 4 of 28
Important notes at the end of this document.
1 Introduction
This evaluation kit was developed to support engineers during their first steps designing applications with the
PowerHapTM piezo actuators for haptic feedback.
The design is not qualified regarding manufacturing and operation over the whole operation temperature range
or lifetime.
This evaluation kit provided by TDK is intended to be used for functional testing only.
Due to their purpose, evaluation driver kits are not intended to be used by the same procedures regarding
returned material analysis (RMA) and process change notification (PCN) as regular products.
The board described is an evaluation driver board dedicated for laboratory environment
only. It operates at voltages up to 100V. This board must be operated by qualified and
skilled personnel familiar with all applicable safety standards.
1.1 Ordering code
The ordering code for this evaluation kit is Z63000Z2910Z 1Z 44.
.

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 5 of 28
Important notes at the end of this document.
1.2 Features
 Plug and play developer kit to experience piezo haptic feedback/sensation
 Including the BOS1901-KIT for the low-power BOS1901 integrated circuit by Boreas Technologies,
a high voltage driver with digital interface
o Simple power interface for development via USB port
o Standard USB audio to prototype haptic effects in MATLAB®, Python®, Audacity® and
many other software1
o Fully embeddable modular software driver
o Easy generation of high-voltage waveforms up to 70 Vpp for the PowerHap
o Two breakable miniature PCBs with BOS1901 drivers
 TDK PowerHap actuators included in the kit (1 pcs each, with wire):
o 0909H011V060 (previously known as 2.5 G)
o 0904H014V060 (previously known as Lateral Mini 9 x 3.75)
o 1204H018V060 (previously known as Lateral Mini 12 x 4)
1.3 Description
The BOS1901-KIT is a development kit to support users who want to get familiarized with the BOS1901 piezo
haptic driver IC.
The USB powered kit appears as an USB audio device for the computer, which allows the rapid generation of
waveforms using existing audio software like Audacity® for haptic prototyping. Each breakable miniature PCB
gives access to all signals allowing the user to experiment with the BOS1901 using a development platform of
his/her choice.
Figure 1: Simplified BOS1901 - KIT diagram.
------------------------------------------------------------
1 MATLAB® is registered trademark of The MathWorks, Inc.
Python® is a registered trademark of the PSF
Audacity® is a registered trademark of Dominic Mazzoni
BOS1901
breakable PCB
Channel B
BOS1901
breakable PCB
Channel A
SPI
Microcontroller
External
PSU
USB
DEBUG
DIP
Switches

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 6 of 28
Important notes at the end of this document.
2 Quick start guide
2.1 What is in the box
Table 1: Development kit content
Item
#
Item Description Reference
1 Driver board BOS1901 evaluation PCB
2 USB cable Micro USB cable to connect
the evaluation PCB to a
computer
3 TDK piezo actuator* 0909H011V060
(previously known as 2.5 G);
part number
Z63000Z2910Z 1 Z2
4 TDK piezo actuator* 0904H014V060
(previously known as lateral
mini 9 x 3.75);
part number
Z63000Z2910Z 1Z41
5 TDK piezo actuator* 1204H018V060
(previously known as lateral
mini 12 x 4);
part number
Z63000Z2910Z 1Z39
* The actuators are delivered with a black and red wire soldered on the terminals. Please connect the red wire to HV+ and
the black wire to HV-.

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 7 of 28
Important notes at the end of this document.
2.2 PCB overview
Figure 2: BOS1901-KIT Evaluation PCB overview.
2.3 Quick start procedure
 Refer to section for jumper options and for switch settings to ensure the evaluation PCB is in the
intended settings
 Connect the selected actuator to the proper channel on P2A or P2B connector
 Connect the evaluation PCB to a computer using the included USB cable, then wait for LED D1
(green) to light up and LED D2 (red) to turn off after the firmware identification sequence
 Push the sensor with a finger to feel the feedback. Enhance the feedback experience by changing
DIP switch settings.
 Using the Audacity® software, select a waveform to play on the actuator
.
USB
USR
RST µCPU
DIPswitch
BAT
Power
2018
www.boreas.ca
Designed and
M ade in Canada
BOS1901-KIT_V2.3
BOS1901
BOS1901
HV+HV‐ VDD
HV+HV‐ VDD
SB2
SB3
SB1A
SB1B
18
D1 D2
VBUS
GND
MISO
VIO
MOSI
SCK
CS
VBUS
GND
MISO
VIO
MOSI
SCK
CS
GND
VDD
XRES
SWDCLK
SWDIO
ON
OFF
CHANNELA
CHANNELB
P2A
P2B

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 8 of 28
Important notes at the end of this document.
3 Hardware
3.1 Jumper options
The BOS1901-KIT is provided by default with jumpers SB2, SB3 and SB1X set to operate from USB power, UPI
mode off.
Table 2: Jumper options
Function Shorts HW
USB Power
UPI OFF
(default)
SB2
SB3
SB1x
USB Power
UPI ON*
SB2
SB3
SB1x
BAT Power
UPI OFF
SB2
SB3
SB1x
BAT Power
UPI ON*
SB2
SB3
SB1x
* Refer to the section of the jumper settings for details and limitations.
3.1.1 Use BAT power (external power supply connection)
From default state:
 Remove power to the evaluation PCB by unplugging the USB cable
 Cut junction of SB3 jumper
 Put a solder joint on SB2
 Optional, solder a capacitor on C19 if additional decoupling is required on VBUS node
 Plug the USB cable to the evaluation PCB for power and communication to the microcontroller
section
 Apply an external DC source ranging from 3 V to 5 V on connector P5
 Push and release "RST" button (S2), then wait for LED D1 (green) to light up and LED D2 (red) to
turn off
Note: the “USR” button (S1) has reserved usage on the current firmware.
SB2
BOS1901
BAT
USB
SB3
VBUS
VDD
SB1x

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 9 of 28
Important notes at the end of this document.
3.1.2 Use UPI feature
Warning - With UPI enabled, the energy recovery feature of the BOS1901 will accumulate energy in
C1A/C1B capacitor, causing COM voltage to increase. The user should make sure that VDD voltage
never exceeds the 5.5 V limit otherwise it may permanently damage the BOS1901. For instance, due to
its larger capacitance, it is not recommended to use the PowerHap™ actuators with 5 V supply and UPI
feature ON. Please refer to BOS1901 data sheet section 6.2.10 for more details.
From default state:
 Remove power to the evaluation PCB by unplugging the USB cable
 Remove solder joint on one or both SB1X, depending on the choice of UPI configuration
 Plug the USB cable to the evaluation PCB, wait for LED D1 (green) to light up and LED De (red) to
turn off
3.2 Piezo actuators
TDK PowerHap™ piezo actuator specifications:
Type Cymbal design
Polarity Red wire on "HV+" terminal
Black wire on "HV-" terminal
Range Unipolar -10 V to +60 V, use with switch SW1 at "OFF" position
(refer to section DIP Switch settings)

It is of utmost importance to not use the TDK PowerHap™ actuators in full-scale mode as it can get
damaged unless the waveform is properly designed to limit the output voltage between -10 V and +60 V.
Example waveforms are provided on Boréas website (www.boreas.ca/bos1901-kit).
Refer to section for a special output configuration, in which two TDK actuators can be connected on a single
BOS1901 circuit:
‐ "Load 1" with red wire connected to "HV+" and black wire on "VDD"
‐ "Load 2" with red wire connected to "HV-" and black wire on "VDD"
‐ Use of full-scale mode with output voltage limited to +60 V
‐ Toggle SW2 to single ended mode (ON)

Piezo Haptic Actuators - PowerHap Z63000Z2910Z1Z44
Application note for evaluation kit 60 V
Preliminary data
PPD PI AE/IE PD 2019-05-08
Please read Cautions and warnings and Page 10 of 28
Important notes at the end of this document.
3.3 DIP switch settings
The evaluation PCB is provided by default with S3 DIP switch set to unipolar operation with only channel A
enabled. It is recommended to toggle these switches only when not playing waveforms.
Table 3: DIP switch settings
DEFAUL
T
SWITCH OFF ON
OFF SW1 Unipolar (-10V/+60V) Full-scale (-95V/+95V)
OFF SW2 Differential out config* Single ended config*
ON SW3 Only channel A ON Both channels ON
ON SW4 Press-release feedback
on channel B
Multipress feedback on channel B
ON SW5 100 Hz feedback 180 Hz feedback
ON SW6 75% amplitude feedback 100% amplitude feedback
ON SW7 Low sensitivity feedback High sensitivity feedback
OFF SW8 Future use Future use
* Refer to the according section for more details on output configurations.
SW1 The output ranges listed for SW1 settings are for full amplitude input signal, for example -1 to +1 when
using Audacity® software. When using TDK PowerHap™ 2.5G piezo actuator, set SW1 to OFF.
More precisely, this switch sets the maximum and minimum values allowable for the selected range. It
does not affect the gain and offset conversion between the input signal and the output voltage. If the
requested voltage is out the range, the firmware will clip the signal to the limits of the range. Therefore,
a single conversion equation is used for the same voltage in both ranges. The relation between the
input signal value and the output voltage is:
𝑆𝑖𝑔𝑛𝑎𝑙  𝑉𝑜𝑙𝑡𝑎𝑔𝑒
95 𝑉
Thus signals of +1, -1 and 0 correspond to 95 V, -95 V and 0 V respectively. To generate a 60 V
output, the signal should be 60 V/95 V = 0.631.
SW2 Refer to the according section for configuration details. Sensing is not possible in single-ended
configuration.
SW3 SW3 determines how many channels are active. Set SW3 to OFF to activate only channel A. Set SW3
to ON to activate both channels. When a channel is activated it can sense pressure and give
feedback, and it can play waveforms.
SW4 When both channels are active (SW3 is ON), set SW4 to OFF to have both channels feedback a
single click. Setting SW4 to ON will maintain channel A to feedback single clicks but channel B will
give three feedback response levels depending on the exerted pressure. A low-level pressure triggers
a single light click, medium pressure triggers a stronger click, and a high pressure triggers a longer
feedback.
SW5 SW5 sets the frequency of the feedback response when the actuator is pressed and released.