Boreas Technologies BOS1901-KIT-B02 User Manual

Hide thumbs

Table of Contents

Quick Links

Download this manual

BOS1901-KIT

User Guide

Features

•

Plug and play development kit to experience

piezoelectric actuator button and haptic

feedback.

•

Low-power BOS1901 integrated circuit, high

voltage driver with SPI digital interface.

•

Power supply via the USB port.

•

Graphical user interface for ease of use.

•

Standard USB audio to prototype haptic

effects in MATLAB®, Python®, Audacity® and

many other softwares

•

Easy generation of high-voltage waveforms

up to 190 Vpp.

•

Two breakable miniature PCBs with BOS1901

drivers for prototyping.

•

Standard

commercial

included in the Kit:

Starter Set: TDK PowerHap™ 1204 lateral

o Premium Set: TDK PowerHap™ 1204

lateral, 0904 lateral, 0909 square,

Bimitech

bending.

Figure 1: BOS1901-KIT overview

MATLAB® is registered trademark of The MathWorks, Inc.

Python® is a registered trademark of the PSF

Audacity® is a registered trademark of Dominic Mazzoni

BT001DDK04.01 – Issue 1

BOS1901 Development Kit

piezo

actuators

Python

PUA3020-5H200

Description

The BOS1901-KIT is a development kit to get

familiar with the BOS1901 Piezo Haptic Driver IC.

The USB-powered kit appears as an USB Audio

device for the computer, which allows quick and

easy generation of waveforms using existing audio

software like Audacity® for haptic prototyping.

The firmware supports autonomous operation for

easy integration into development prototypes.

Each breakable miniature PCB gives access to all

signals allowing the users to experiment with the

BOS1901 using a development platform of their

choice.

Standard commercial piezo actuators are provided

as a starting point to begin experiencing with

haptic feedback.

Table 1: Ordering information

PRODUCT

DESCRIPTION

Starter Set with One Actuator

BOS1901-KIT-B02

(replacement of BOS1901-KIT-B)

Premium Set with Four Actuators

BOS1901-KIT-A02

(replacement of BOS1901-KIT-A)

For details see section 2

PowerHap™ is a trademark of TDK Corporation

Python

is a trademark of Bimitech Inc.

Table of Contents

Summary of Contents for Boreas Technologies BOS1901-KIT-B02

Page 1 Premium Set: TDK PowerHap™ 1204 lateral, 0904 lateral, 0909 square, PRODUCT DESCRIPTION Bimitech Python PUA3020-5H200 Starter Set with One Actuator BOS1901-KIT-B02 bending. (replacement of BOS1901-KIT-B) Premium Set with Four Actuators BOS1901-KIT-A02 (replacement of BOS1901-KIT-A) For details see section 2 Figure 1: BOS1901-KIT overview MATLAB®...
Page 2: What's In The Box
BOS1901-KIT User Guide What's in the Box The BOS1901-KIT is currently available in two distinct packages: Premium Set and Starter Set. The following tables show the content of each set. Table 2: Premium Set BOS1901-KIT-A02 development kit content # ITEM DESCRIPTION REFERENCE Evaluation PCB...
Page 3 2.54 mm pitch header connector for connection to header connector external system (J3 connector on PCB). Würth Electronik part number 61300611021 (6-pin) or equivalent. Table 3: Starter Set BOS1901-KIT-B02 development kit content # ITEM DESCRIPTION REFERENCE Evaluation PCB BOS1901-KIT Board...
Page 4: Board Overview
BOS1901-KIT User Guide Board Overview The purpose of this section is to show the location of the components that allow you to interact with the BOS1901-KIT board. This section is in a way the definition of the user interface provided by the development board.
Page 5 BOS1901-KIT User Guide Operation Mode LED Details This section describes the meaning of the different colors and state transitions of the operation mode LED. Table 5: Operation mode LED detail Pattern Color Description 1 second on, 1 second off Green In Haptic mode and working normally.
Page 6 BOS1901-KIT User Guide Your First Piezoelectric Actuator Button Experience The BOS1901 and a piezoelectric actuator can be used together to implement the equivalent of a button. Before being shipped, the BOS1901-KIT board is set up in this button mode, so that you can experience it without additional extensive configuration or software installation.
Page 7: Get Started
BOS1901-KIT User Guide Get Started The purpose of this section is to give instructions on where to get the latest versions of Boréas software and firmware. Keeping the software up to date ensures the latest features available are taken advantage of. Creating a Boréas Account Relevant documentation and software are available in the support section of Boréas website.
Page 8 BOS1901-KIT User Guide Upgrade Development Kit Firmware The native BOS1901-KIT board firmware includes an over-USB firmware upgrade mechanism. The BOS1901-KIT software will upgrade the firmware if needed on next connection with the development kit. 1) Connect the development kit to a PC using the USB cable. 2) Start the BOS1901-KIT software.
Page 9: Product Overview
BOS1901-KIT User Guide Product Overview The BOS1901-KIT has been designed to meet a multitude of needs. The main objective is to demonstrate the capacity of the BOS1901 but also to help integrators in the development of haptic effects and in its product prototyping. The BOS1901-KIT is delivered with a graphical user interface (GUI) for ease of use but it is not required to operate.
Page 10 BOS1901-KIT User Guide The BOS1901-KIT development kit can be used as a basis for the development of a prototype. It is possible to connect an external SPI master without separating the breakable mini-boards from the BOS1901-KIT. This operation requires a good knowledge of the electrical design of the BOS1901-KIT. For more details about the hardware refers to section 9.
Page 11: Software Installation
BOS1901-KIT User Guide Boréas Development Kit Software v2.9.x Overview Boréas Development Kit software is a desktop application intended to ease evaluation of the BOS1901. In Haptic mode, the tool can be used to: • Play a sinusoidal waveform on-demand. • Configure the BOS1901-KIT board to play a sinusoidal waveform when: o a signal is received on the pin IO1.
Page 12: Disconnected State
BOS1901-KIT User Guide Disconnected State At start-up, the application is in disconnect state. The communication port is not connected with the BOS1901-KIT board. A drop-down list allows the user to select the BOS1901-KIT board to use. (1 entry per board connected to the PC). Figure 5 Application window in disconnected state To transition to the connected state: 1.
Page 13: Connected State
BOS1901-KIT User Guide Connected State Figure 6 Application window when connected (Haptic mode) Left Section (A): Menu The left menu is used to present information about the BOS1901-KIT board : • Firmware and software version • Operation mode (Haptic or Audio) •...
Page 14 BOS1901-KIT User Guide 8.5.1 Haptic Mode 8.5.1.1 Panel Overview Figure 7:Panel overview – Haptic mode Section A: Drivers Identification The top of the right panel provides information about the driver connected to the microcontroller. The associated chip ID will appear and the driver is marked as “Connected”. Section B: Buttons Sync.
Page 15 BOS1901-KIT User Guide Section C: Channel Selection Tabs Select the channel to configure (channel A or channel B) Section D: Basic and Registers Tabs The basic panel provides functionalities to configure the BOS1901-KIT board (configure waveform, sensing parameters and triggers). The register panel provides a read and write access to the registers of the BOS1901.
Page 16 BOS1901-KIT User Guide 8.5.1.2 Play a Waveform - Manual Trigger Description User configures a sinusoidal waveform and plays it on a piezo actuator (channel A or B) by pressing the Play button in the application. Prerequisites • Software is connected to the BOS1901-KIT board in Haptic mode. Figure 8:Play waveform –...
Page 17 BOS1901-KIT User Guide 8.5.1.3 Play a Waveform - External Trigger (GPIO) Description User configures the BOS1901-KIT board to play a sinusoidal waveform on the detection of a falling edge on the IO1. Prerequisites • Software is connected to the BOS1901-KIT board in Haptic mode. Figure 9:Play waveform –...
Page 18 BOS1901-KIT User Guide 8. (Optional): Press the save in memory button to persist the configuration of the BOS1901-KIT board in memory. 9. (Optional): If the waveform parameters are changed after the GPIO interrupt box is checked, the Send configuration button must be pressed again to send the waveform configuration to the BOS1901-KIT board.
Page 19 BOS1901-KIT User Guide Note: When the sync mode is enabled, one channel becomes the master (the one in which the sync mode has been enabled). The configuration of the waveform and the trigger can only be done from the master channel. 8.5.1.5 Button Emulation Mode Description User configures the parameters of a sinusoidal waveform and the parameters of a sensing algorithm...
Page 20 BOS1901-KIT User Guide Note: After the detection of a press, the sensing algorithm waits a maximum of 3 seconds before it returns to the state where it is waiting for the detection of the press event. 8.5.1.6 Registers Access Description User read and optionally write registers of the connected BOS1901.
Page 21 BOS1901-KIT User Guide 8.5.2 Audio Mode 8.5.2.1 Panel Overview Figure 13:Panel overview - Audio mode When the BOS1901-KIT board is in Audio mode, it is detected by Windows as a speaker device. When this device is selected, all audio output from the PC will be sent to the board. Make sure to deselect the Boreas DevKit to avoid the PC from playing system sounds on the actuator.
Page 22 BOS1901-KIT User Guide To change the audio limiting configuration, open the BOS1901-KIT software while the board is in audio mode and set the Min and or Max values of the Amplitude field and press the Save button to send the new values to the BOS1901-KIT. 8.5.2.3 Audio Limiting Illustrated Original signal without audio limiting: Figure 15:Original audio signal...
Page 23 BOS1901-KIT User Guide 8.5.3 IC Status Monitoring As displayed above, when the application is connected to the BOS1901-KIT board it shows all detected BOS1901 errors in the bottom section of the left panel. Figure 17 Errors shown in the left panel Possible IC errors: Table 10: BOS1901 errors Reported Error Message...
Page 24: Design Overview
BOS1901-KIT User Guide Hardware The purpose of this section is to provide information on the hardware design of the BOS1901-KIT PCB to help the integrator evaluate BOS1901 and to use it in a prototype. Design Overview The board is composed of two distinct sections: a microcontroller section on the left and a BOS1901 driver section on the right.
Page 25: Hardware Features
BOS1901-KIT User Guide Hardware Features In this section, we will discuss the various hardware configurations. Except for section 9.2.1, it is assumed that the microcontroller section and the driver section have not been separated. Some functionality in this section requires modifications to the PCB and requires a soldering iron. Disconnect the supply before making any changes to the board.
Page 26 BOS1901-KIT User Guide 9.2.2 Probe Hooks Probe hooks are available around the board to ease connection of instruments for measurement of supplies when debugging. At the separation line between the microcontroller section on the left and the driver section on the right lies a header pins connector. This connector allows to probe supply levels and SPI communication digital.
Page 27 BOS1901-KIT User Guide By default, the GPIOs are in the microcontroller 3.3 V supply domain. To use these GPIOs with a system operating in another voltage domain requires modification of the BOS1901-KIT PCB configuration. Table 12: GPIOs supply voltage solder bridge configuration GPIOs Supply Source SB5 State +3.3V (MCU supply)
Page 28 BOS1901-KIT User Guide 9.2.5 Power Supply Source and UPI Mode Operation The driver section of the PCB can be supplied using two different sources: the USB connector and the P1 white connector. By default, the USB connector is the power source, and UPI mode is disabled. Figure 23: Driver power supply and UPI mode configuration resistors location Table 14: Driver power supply and UPI mode configuration options Driver Section Supply...
Page 29 BOS1901-KIT User Guide 9.2.6 Piezo Actuator Low-Pass Filter Two 0603 resistors ROx are in series with each BOS1901 output channels OUTx. They can be used to create a low-pass filter with the actuator and filter out audible noise. Resistor values to use are determined by the desired cut-off frequency and the actuator capacitance.
Page 30 BOS1901-KIT User Guide Piezo Actuators One TDK actuator is provided with the BOS1901-KIT Starter Set and four with the Premium Set, one from Bimitech and the others from TDK. For each piezoelectric actuator available with the BOS1901- KIT, Boréas provides recommended presets. Each preset is available in the GUI and is identified by the brand and model number of the piezo actuator.
Page 31 BOS1901-KIT User Guide 9.3.3 Bimitech Actuator Clamp Assembly The Bimitech actuator must be assembled using the provided clamp to be operated properly. There are two possible configurations, shown in the figures below. Use both screws to tighten the clamp part of the assembly.
Page 40: Pcb Layout
BOS1901-KIT User Guide 10.2 PCB Layout Figure 26: Layout view - Top Overlay (not to scale) Figure 27: Layout view - Top Layer (not to scale) BT001DDK04.01 – Issue 1 © All rights reserved 2021 Boréas Technologies Inc...
Page 41: Bill Of Materials
BOS1901-KIT User Guide 10.3 Bill of Materials The following is a list of the components that populate the evaluation PCB. Due to availability, some components with equivalent performance/characteristics may be installed on the actual evaluation PCB. If the exact part number is not available, the components can be replaced by ones with equivalent package and specifications.
Page 42 TPGND2, TPVBUS1, TPVDDA1, TPVDDB1 PC TEST POINT NATURAL Harwin Inc. S2761-46R TPGND3 PC TEST POINT COMPACT Keystone Electronics 5016 PIEZO HAPTIC DRIVER U1A, U1B 190V Boreas Technologies BOS1901CW BT001DDK04.01 – Issue 1 © All rights reserved 2021 Boréas Technologies Inc...
Page 43 BOS1901-KIT User Guide DESIGNATOR QTY VALUE DESCRIPTION MANUFACTURER PART NUMBER IC REG LINEAR 3.3V 300MA SOT23-5 STMicroelectronics LDS3985M33R IC USB SWITCH DPDT 10MSOP ON Semiconductor FSUSB42MUX GigaDevice IC FLASH 32MBIT Semiconductor (HK) SPI/QUAD 8USON Limited GD25Q32CNIGR IC BUF NON-INVERT 5.5V U40, U41 14TSSOP Nexperia USA Inc.
Page 44: Faq And Troubleshooting
BOS1901-KIT User Guide 11 FAQ and Troubleshooting Please refer to Boréas website for FAQ and Troubleshooting information, which will be maintained throughout the BOS1901-KIT lifecycle. It will also contain application note documents that will be helpful for the user writing his/her own code to operate the BOS1901. 12 Notice and Warning Danger High Voltage! Electric shock possible when connecting board to live wire.
Page 45: Ordering Information
(Starter Set) PCB 30x25 1 Actuator 14 Document History ISSUE DATE Document Number CHANGES May 2021 BT001DDK04.01 Original Version New product part numbers BOS1901-KIT-B02/- A02 in replacement of BOS1901-KIT-B/-A. BT001DDK04.01 – Issue 1 © All rights reserved 2021 Boréas Technologies Inc...
Page 46 BOS1901-KIT User Guide Appendix A. Button Emulation: Sensing Algorithm The purpose of this section is to provide more details about the algorithm used for the detection of press and release events on the piezoelectric actuator. The / by the graphical user interface are represented in this diagram.
Page 47 BOS1901-KIT User Guide This image shows the differential voltage between both terminals of the piezoelectric actuator during a press event and feedback. On this scale it is impossible to see the details of the press event because it occurs at much lower voltages and over a longer period. Figure 29: Sensing algorithm: flow chart.
Page 48 BOS1901-KIT User Guide After the feedback, there is a stabilization phase. The output of the BOS1901 is maintained to 0 V for a period of time. Here an example with a stabilization time of 20 ms: Figure 31: Sensing algorithm: stabilization BT001DDK04.01 –...
Page 49 BOS1901-KIT User Guide Appendix B. Firmware Upgrade using STM32CubeProgrammer The BOS1901-KIT board supports a standard USB endpoint named "Device firmware upgrade" (DFU). This endpoint is used to transfer firmware to the development kit using the USB port and a DFU transfer software.
Page 50 BOS1901-KIT User Guide Procedure 1. Select USB connection mode in the drop box. 2. Refresh the Port list using the button: 3. Select USB1 port in the Port drop box. (Note: If more than one development kit are connected on the same PC the Port drop box will contains more than one entry.
Page 51 BOS1901-KIT User Guide Figure 35: STM32CubeProgrammer upgrade completed dialog. 10. Move the Boot Select switch in Flash Memory (FM) position. 11. Reset the development kit using the RST button. BT001DDK04.01 – Issue 1 © All rights reserved 2021 Boréas Technologies Inc...
Page 52: Software Installation Procedure
BOS1901-KIT User Guide Appendix C. Audio Mode using Audacity® Software This appendix explains how Audacity® software can be used to create and play waveforms on the BOS1901-KIT. Software Installation Procedure Audacity is free of use and can be found at: link Please follow the Audacity®...
Page 53 BOS1901-KIT User Guide 4. Select dc-offset in the plugin list and click on Enable button, then click on OK. Figure 38: Plugin management window BT001DDK04.01 – Issue 1 © All rights reserved 2021 Boréas Technologies Inc...
Page 54 BOS1901-KIT User Guide Use Audacity to Play WAV Files Description Download waveform samples from Boréas website and use Audacity® to play them on the BOS1901-KIT. Prerequisites • BOS1901-KIT board is in Audio mode. Refer to section 8.5.2 for more information regarding Audio mode.
Page 55 BOS1901-KIT User Guide Use Audacity and dc-offset Plugin to Create a New Waveform. Description In this example, we explain how Audacity can be used to create a new sinusoidal waveform in the range of the TDK piezo supplied with the kit (-10 V to 60 V). In this example the waveform parameters are: •...
Page 56 BOS1901-KIT User Guide To create the waveform with the parameters mentioned in the description, use the following tone values: Figure 41: Tone parameters The amplitude value is calculated with the following formula: ( 60 ) V − ( −10 ) �� Peak to Peak Amplitude =>...
Page 57 BOS1901-KIT User Guide Information relating to products and circuits furnished herein by Boréas Technologies Inc. is believed to be reliable. However, Boréas Technologies assumes no liability for errors that may appear in this document, or for liability otherwise arising from the application or use of any such information which may result from such application or use.

This manual is also suitable for:

Bos1901-kit-a02

Boreas Technologies BOS1901-KIT-B02 User Manual

Quick Links

Related Manuals for Boreas Technologies BOS1901-KIT-B02

Summary of Contents for Boreas Technologies BOS1901-KIT-B02

This manual is also suitable for:

Table of Contents