The Black Box ToolKit mBlack Box ToolKit v2 User Manual

Fuel control terminal

Table of Contents

Quick Links

Download this manual

The Black Box ToolKit

Serious about science: Serious about timing

The mBlack

Box ToolKit v2

User Guide

Rev. RC1 (20180101)

Table of Contents

Troubleshooting

Need help?

Do you have a question about the mBlack Box ToolKit v2 and is the answer not in the manual?

Questions and answers

Summary of Contents for The Black Box ToolKit mBlack Box ToolKit v2

Page 1 The Black Box ToolKit Serious about science: Serious about timing The mBlack Box ToolKit v2 User Guide Rev. RC1 (20180101) Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 2 In no event will The Black Box ToolKit Ltd be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect or inaccuracy in this manual, even if advised of the possibility of such damage.
Page 3: Table Of Contents
7.4 Copying Event Mappings to the Clipboard 8. Analysing Event Marking Data with the Logic Analyser 8.1 Key Parts of the Interface 8.2 Checking a Simple Event Marking Run Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 4 17.2 Basic TTL Input Using a Serial Terminal 17.3 Tips for Using the USB TTL Module Emulator With an Experiment Generator or Your Own Software Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 5 21.1 Timestamp and Event Marking (TEM) – Event Mark & Timing Data Storage 21.2 Standalone Event Marking – No Data Storage 21.3 USB TTL Module Emulation Mode Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 6: Warnings And Cautions
The mBlack Box ToolKit v2 Warnings and Cautions Intended Usage Unless otherwise labelled, all products offered for sale by The Black Box ToolKit Ltd are for academic study and/or research use only. The Black Box ToolKit Ltd, instruments, components, and accessories are designed for educational and research oriented life science applications and investigations.
Page 7: Introduction
This is a proven fact – what’s more, without checking you would never know! Typical sources of error over the idealised conceptual experimental model are shown below for a simple priming study. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 8  You improve your chances of replication and internal consistency  And... above all you improve the quality and respectability of your research Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 9: How Can I Ensure My Event Marking Timing Accuracy Is As Good As It Could Be
What’s more these can be easily exported to packages such as Excel or MATLAB for further analysis. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 10: Frequently Asked Questions
As TTL Event Marks are made the status of all 72 mBBTK channels are timestamped with sub-millisecond accuracy (sensor inputs are also counted as channels). All timestamps are Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 11: Can I Run It Without A Control Pc Or Laptop In Standalone Mode
2.9 How is it Different to a Black Box ToolKit v2? The mBBTK is different to the Black Box Toolkit as the prefix “m” denotes that it is specifically designed for Event Marking whereas the BBTK v2 is designed primarily to assess the accuracy by which an Experiment Generator and accompanying hardware present stimuli and records responses.
Page 12: Worked Examples
Instead, you are advised to use a 1-8 button BBTK USB Response Pad (with or without Voice Key). Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 13 The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 14 The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 15: Worked Example 1: Simple Visual Stimulus Event Marking
5V signal will be present for the duration the stimulus is on screen. In this example, timing data is only captured and recorded for 5 seconds. In a real study you would enter the minimum duration of your experiment. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 17: Worked Example 2: More Complex Stimulus Event Marking
TTLr Out 2 so that when there is a sound a 5V signal will be present for the duration of the sound. Ultimately unique Event Marks for each visual and auditory stimulus will appear on the EEG trace. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 18 One can quite easily envisage how more sensors can be linked to more Event Marking TTL lines, e.g. up to four optos and two microphones could be used. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 19: Worked Example 3: Stimulus Event Marking Combined With An External Start Or Sync Signal
Marked along with a visual stimulus on Opto 1 (TTLr Out 1) and an auditory event on Mic 1 (TTLr Out 2). The actual mappings are shown below in TEM. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 21: Worked Example 4: Stimulus Event Marking Combined With An External Start Or Sync Signal And A Bbtk Usb Response Pad
STIM, visual and auditory stimuli and four response pad buttons. The BBTK USB Response Pad actually supports up to 8x buttons and a Voice Key (each of which can be independently event marked). Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 22 EEG run. Post hoc timing and Event Mark analysis are completely independent of timings and Event Marks recorded by your EEG system that will operate on its own time base. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 23: Worked Example 5: Stimulus Event Marking Combined With An External Start Or Sync Signal And A Bbtk Usb Response Pad With Voice Key
(pink line to single 2.5mm socket on front panel of mBBTK). The TTL from input from the Voice Key (TTLr In 24/VK) can be paired with any TTL Event Marking line. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 24 TTLr Out 4 will be made. When there is a vocal response there will be a 50mS blip on TTLr In 24/VK which will be Event Marked on TTLr Out 8. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 25: Worked Example 6: Stimulus Event Marking Combined With An External Start Or Sync Signal Using A Bbtk Usb To Ttl Module To Replace A Parallel Port
TTL rear input on the breakout board, e.g. TTLr In 1 (orange line below). The mBBTK does not influence this signal and merely records and Event Marks when it was switched on or off, 5V/0V, high/low. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 26 Event Marked along with a visual stimulus on Opto 1 (TTLr Out 1) and an auditory event on Mic 1 (TTLr Out 3). The actual mappings are shown below in TEM. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 27: Worked Example 7: Simple Visual Stimulus Event Marking In Standalone Mode Without Using A Pc
Before you can use an on board profile they need to be created in the Timestamp & Event Marking (TEM) module and transferred to the mBBTK using the Onboard Profile Manager (OPM) as shown below. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 28 If the button is pressed to stop a running profile you will be returned to the main menu, which then displays the list of 10 on board profiles. For more information on running in standalone mode, see section 15 of this manual. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 29: Hardware & Software Requirements
 Bluetooth adapter version 2.1 or above for wireless connections (optional)  Microsoft Windows 7 SP1 or later (32 or 64 bit) | Windows 10 (32 or 64 bit) Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 30: Installing And Configuring The Mblack Box Toolkit
PC Software. Once the mBBTK setup starts you will be presented with a Welcome dialog. To begin installing click Next. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 31 Windows 8, the PC Software will be installed to "C:\mBBTKv2\" by default. When you are happy with your choices click Next to start the installation. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 32 A Black Box ToolKit mBBTK v2 folder should have been installed on the Start menu. Depending on which version of Windows you have this may look slightly different. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 33: Powering Up The Mblack Box Toolkit
When you are not using the mBBTK you are advised to turn off the power to it using the rear rocker switch and turn of the power at your power outlet. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 34: Installing The Mblack Box Toolkit Virtual Serial Port Driver
USB Serial Port COM number. In this example, COM4. This is the serial port you would connect to the mBBTK through to control it and upload data. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 35: Troubleshooting Installation Of The Serial Port Driver
Operating System does not automatically prompt you. Run the 64 bit version for 64 bit Operating Systems. Run the 32 bit version for 32 bit Operating Systems. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 36: Choosing Which Serial Port To Use To Control The Mbbtk
Rescan to add them. If your mBBTK cannot be automatically detected, consult the troubleshooting section of this guide. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 37 Generally you should say Yes to this request. This sets the detection, or trigger levels, for the mBBTK’s various sensors. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 38: Configuring The Serial Port Driver If Using The Mbbtk In Usb Ttl Module Emulation Mode
(VCP) sends and receives data too slowly for event marking directly from an Experiment Generator and needs to be manually set to 1mS. If you have not configured the Serial Port Driver correctly the Black Box ToolKit Ltd cannot be held responsible for inaccurate event marking when using an Experiment Generator.
Page 39 To apply the new settings click OK. To close the Properties dialog click on OK again. For details of using the mBBTK in USB TTL Module Emulation Mode, see section 16. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 40: Rebooting Your Mblack Box Toolkit
If you continue to have problems connecting quit the PC Software, carry out steps 1 through 3 and then restart the PC Software on your host PC. For more tips, consult the dedicated troubleshooting section of this guide. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 42: Setting Sensor Activation Thresholds
In the case of Mics, if the desk in front of them is gently tapped the appropriate LED should flicker. If you set your thresholds too low timing accuracy may be suboptimal. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 44: Reusing Activation Thresholds - Using Your Own Default Values
Click MTL Thresholds to use those values. Unless you Save these levels, they will only apply to this session. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 45 Logic Analyser. Alternatively press CTRL+R to bring up a Summary Report. You can also produce a Summary Report by clicking on the toolbar button. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 47 Event Mark Output select a Trigger from the drop down and then select a mapped TTL Event Mark Output. Click on Add to add that mapping to the list. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 48 The Done button allows you to analyse any captured timing and event marking data that has been uploaded. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 49: Event Marking With Tem: A Worked Example
The TEM dialog will then be shown. From the Triggers drop down select the Trigger input sensor or line, in this case Resp Pad 1. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 51 Start. Once running the LCD will change to show the time that the mBBTK is running in Event Marking mode and capturing timing data. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 52 Click on Done to view the timing data from the 48 sensors or to cancel click on the red X exit button top right of the TEM dialog box. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 53: Loading And Saving Event Marking Mappings In Tem
As dialog box will be displayed. To start over with a new TEM file click on the New toolbar icon, press CTRL+N or use the File | New menu. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 54: Copying Event Mappings To The Clipboard
CTRL+C or select Edit | Copy Mappings To Clipboard from the Edit menu. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 55 TABs. The first column is a numerical reference, the second the Trigger and the third the TTL Event Mark to be generated. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 56: Analysing Event Marking Data With The Logic Analyser
CRT or Mics and Audio Pass-Throughs were smoothed. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 57: Checking A Simple Event Marking Run
Hypothetically, a commercial Experiment Generator might also be recording the same button presses and data via a scripted paradigm (this represents your experiment in this Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 58 Logic Analyser plot. You can do this by right clicking anywhere on the plot and clicking Measure from the Context Sensitive Menu (or you can press the shortcut key M). Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 60 The Line by line Analysis spreadsheet will automatically highlight the onset. If two different lines are highlighted by each cursor then two onset cells will be highlighted. Remember Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 61 Best of all you don’t have to be that accurate with your cursors when Highlighting as the PC Software will automatically find the nearest associated onset relative to each cursor! Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 62: Additional Features Of The Logic Analyser
If you have a lot of data (or a slow computer), you might Show Measurement want to turn off the Tooltip to make manipulating the plot Tooltip Tooltips faster. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 63: Using The Pan Jog Dial
Press CTRL+R to bring up a Summary Report. You can also produce a Summary Report by clicking on the toolbar button. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 64: Copying A Logic Analyser Plot To The Clipboard
You can save as many versions as you like, e.g. if you have zoomed and measured elapsed time you might want to save that view. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 65: Line Change Graphs
PNG file, right click and select Copy or Export. Alternatively press CTRL+C for copy or CTRL+E for export. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 66: Overview Of Connectivity Options Opto-Detectors, Microphones, Audio Pass-Through's, Response Pad & Ttl I/O
When connecting headphones connect a through In / stereo lead from a soundcard to the APT In and jack your headphones to APT Out Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 67 BBTK USB Response Pad, the TTLf In LED will illuminate. Any button can be paired to a TTL Event Mark as part of your mapping list. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 68 Voice Key. Use of generic legacy response pads may compromise timing and event marking accuracy. In addition, the Black Box ToolKit Ltd cannot be held responsible for any damage to your own response pad, or the mBBTK, howsoever caused.
Page 69: Rear Connectors
PSU from a reputable manufacturer and of known quality. The Any damage caused by a user’s own PSU is not PSU should also be grounded. covered by our standard warranty. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 70 As different researchers will need cabling of different lengths we have chosen this approach as it offers the most flexibility for prototyping. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 71 Connects from the rear of the mBBTK marked Connects from the rear of the mBBTK marked 24x TTL Event Mark Outputs 24x TTLr Inputs Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 72 The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 73: Opto-Detectors
If you alter the brightness/contrast of the display in question, you should set the threshold values again. Once you are happy with your Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 74 Profiles are manufactured to exactly fit your monitor and come in a range of materials and colours. For more information and a quote, feel free to contact us. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 75 1-2mS depending on the phosphor decay time. This is the width of each short on period or refresh blip. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 76 Only BBTK supplied Optos are designed to offer reliable detection of visual stimuli and accurate timing. You should NOT use any other photodiode with the mBBTK. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 77: The Mbbtk Digital Microphones
If Mic thresholds are set too low or Mics are physically positioned incorrectly relative to your sound producing hardware/speakers event marking is likely to be suboptimal. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 78 Only BBTK supplied mics are designed to offer reliable detection of audio signals and accurate timing. You should NOT use any other microphone with the mBBTK. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 79: Audio Pass-Through
Sensitivity thresholds should be set as high as possible to ensure that APTs trigger as early as possible after the start of a sound. If APT thresholds are set too low Event Marking is likely to be suboptimal. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 80 Once you are happy with your thresholds you can save them in the Sensor Threshold Manager as the default settings. Alternatively, you can reload them from a saved Marking Time Log file. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 81: The Bbtk Response Pad
TTL Event Mark Outputs and are paired as mappings in TEM in the normal way. Up to 8 response pad buttons are supported per BBTK USB Response Pad. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 82: Advanced Use Of The Bbtk Response Pad
TTL out signal which gives a 50mS pulse when any button is pressed or Voice Key activated. For more details, consult the guide supplied with your Response Pad. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 83: Ttl Event Marking Using The 9-Way Male D On The Back Of The Response Pad Itself
BBTK USB Response Pad. The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 84: Button And Voice Key Debouncing
You should be able to observe this difference when you review the RTs recorded by your experiment generator versus the true RTs event marked by the mBBTK! Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 85: Tools & Utilities
TTL front and rear input lines along with the button inputs for a simple dumb push-to-make response pad are shown as a schematic mirroring the pinout of each physical socket on the mBBTK. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 86: Event Marking Ttl Output Check
OLCs toolbar icon, select Tools | Output Line Check or press F3. The mBBTK will show that the OLC is running and OLC dialog will appear. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 87 To stop checking TTL Event Marking output lines click on the Done button. Note this utility is streaming signals live between your PC and the mBBTK so there may be a noticeable lag. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 88: Sensor Check Utility
When the SCU starts, you will be presented with a virtual PC and several Opto event marker areas over which you can place an Opto-detector. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 89: Checking Optos With The Scu
Test. This will show two Opto event markers on screen each time a bitmap is displayed. Two bitmaps will then alternate at the chosen duty cycle. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 90: Checking Mbbtk Digital Mics
When each tone plays, the relevant event Opto event marker will turn white for the duration of the tone. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 91: Checking Cross Modal Sensors
Modal test and pressing multiple keys on the keyboard as rapidly as possible. You should be able to notice that timing begins to drift noticeably! Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 92: Setting Default Options
These new line labels will then be used as the default and saved with each new Marking Time Log (MTL) File. They will also be shown in summary reports. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 93 Whilst settings transferred from the PC are stored in Non Volatile RAM on board the mBBTK, storing Standalone Defaults is not the same as restoring factory defaults. details restoring factory default settings consult troubleshooting section. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 94: Where Are Configuration Options Stored For The Pc Software
The update server URL should not be changed this enables automatically check for updates to the PC Software or mBBTK firmware. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 95 Do not edit keys, as they will not make the line names change. Entries not described above are generally to do with internal housekeeping and the Microsoft .NET framework. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 96: Exporting Data
Excel or SPSS for example. The first spreadsheet you can export is the Raw Line Change Data (A) and the second the Line by Line Analysis (B) Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 97 Mic or Audio Pass-Through. This ONLY applies to the Raw Data Spreadsheet as this correction is automatically applied in the Line by line Analysis Spreadsheet. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 98: Producing Summary Timing Reports
Reports from any Marking Time Log file. produce report select Summary Report from the Self- Certify menu, press CTRL+R or click on the toolbar button. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 99 If you wish, you can open the report in a web browser by clicking on the link. This gives you the opportunity to save the report as a single MHT file (MIME HTML). Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 100: Using The Mbbtk In Standalone Mode Without A Pc: The Onboard Profile Manager
Start the Onboard Profile Manager by clicking on its toolbar button, pressing CTRL+F12 or from the Timestamp menu. The OPM dialog will then be shown. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 102 Edit Lines or Timestamp & Event Marking (TEM) toolbar icon. If you wish to cancel editing click on the Cancel button. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 103 To save the set of 10 currently loaded standalone profiles to the local PC click on the Save or Save As toolbar buttons, or select File | Save / File Save As... Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 104: Creating A Standalone Profile: A Worked Example
To add it to your list of Trigger to Event Mark mappings click on the Add button. Once added it will then appear in the list and be previewed graphically to the left. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 105 Event Marks on to Triggers and also that you have set the activation thresholds for the Opto-detector correctly in the Sensor Threshold Manager (STM). Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 106 When triggering from visual stimuli you are advised to use a white block on a black background at the point where you wish to position the Opto-detector. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 107 When you switch to the OPM module, the profile you have just created in TEM will be previewed as a list of mappings. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 108 These thresholds will be stored with the profile when downloaded to the mBBTK for standalone use. In this case, Opto 1 has been set to 80/127. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 109 If you wish to edit the profile again you need to double click on its row. To change Trigger to Event Mark mappings you will need to switch back to the TEM module. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 111: Using The Mbbtk In Standalone Mode Without A Pc For Continuous Event Marking
To load and run the profile press the Rotary Button. The profile will then be loaded ready to be run. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 112 Once you have pressed the button release it immediately. The mBBTK will now reboot and initialise to its defaults. That is, default sensor thresholds, or 50% for each sensor input. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 113 To run a standalone profile again press the Rotary Button and select it. Alternatively connect to a host control PC using the PC Software. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 114: Using The Mbbtk In Bbtk Usb Ttl Module Emulation Mode
(VCP) sends and receives data too slowly for event marking directly from an Experiment Generator and needs to be manually set to 1mS. If you have not configured the Serial Port Driver correctly, the Black Box ToolKit Ltd cannot be held responsible for inaccurate event marking. Once configured you should run the BBTK USB TTL Emulator Configuration Utility from the mBBTK PC Software.
Page 115 Latency Timer (msec) of 1mS using the drop down box. To apply the new settings click OK. To close the Properties dialog click on OK again. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 116: Validating Event Marking Latency
USB TTL Module Emulator Check from the Tools menu. Once in USB TTL Module emulator mode the LCD will change to show this. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 117 Module emulator for live Event Marking, as timing consistency cannot be reliably attained. In this case the mean latency to event mark is: M = 0.25mS, SD = 0.02mS Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 118 Should the Serial Port Driver latency be set to 1mS and your PC still doesn’t pass the latency Auto Test you are advised not to use the Module emulator for time critical Event Marking. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 119: Checking Input Latency
If you are not using the mBBTK Breakout Board these correspond to pins 1~8 on each 25- way D on the rear of the mBBTK. You should use pin 25 on each 25-way D as a common ground. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 120: Checking Ttl Inputs Coming From Connected Equipment
Two byte Hex values can range from 00~FF (hex), 0~255 (dec), 00000000~11111111 (bin) to represent the status of each Input Line on the Input Port. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 121: Checking Ttl Event Mark Outputs Going To Connected Equipment
00000000~11111111 (bin) to represent the status of each Output Line on the Output Port. To clear all lines at once (0V) click on the New toolbar button or press CTRL+N. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 122: Resetting The Usb Ttl Module Emulator
To reset the Module and Serial Port click on the Reset toolbar icon or press CTRL+R. Doing this is equivalent to sending a Break in standard serial communications. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 123: Using The Usb Ttl Module Emulator Programmatically From An Experiment Generator Or Your Own Software
When connected you will need to initialise it by sending the Module two RR bytes, which resets the serial port and clears all TTL Output Lines. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 124 Output Line on the rear Event Mark Port. To convert from a binary on|off bit pattern simply convert to hex using a calculator. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 125: Basic Ttl Input Using A Serial Terminal
The information below summarises a series of tips for using the USB TTL Module Emulator effectively for simple Event Marking. WARNING: The Black Box ToolKit Ltd cannot be held liable for any damage caused to devices through use of the USB TTL Module Emulator and mBBTK v2 howsoever caused.
Page 126  To retrieve the firmware version number send the byte pair VE to the module. Firmware updates may be available from the mBBTK area of our support website Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 127 Experiment Generator to output the serial bytes required at the time you request them. This may or may not be accurate. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 128: Using The Ttl Emulator: Worked Examples Using E-Prime
Black Box ToolKit v2 or the mBBTK v2 which is specifically designed for event marking physical stimuli across multiple modalities and TTL I/O channels.
Page 129 InLine scripts to initialise and reset the TTL Module. Both pieces of script reset the TTL Module and clear any TTL inputs or outputs. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 130 Typically, you would select the OnsetTime option for the Stimulus image object. For further information on the available events, you should consult Psychology Software Tools website. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 131 Knowledge Base, e.g. http://www.pstnet.com/support/kb.asp?TopicID=1318. Please note that the Black Box ToolKit Ltd cannot provide support for third party software such as E-Prime. Example scripts downloaded from our support website are provided on an “as is” basis. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 132: Input Triggering Using Your Own Scripts
= Serial.ReadBytes(incomingBytes) Do While Serial.InputCount = 'look for incoming bytes on the serial port that indicates a trigger signal bytesRead = Serial.ReadBytes(incomingBytes) Loop Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 133 For more details on using InLine script calls, you should consult the E-Prime® User Guide and online Knowledge Base, e.g. http://www.pstnet.com/support/kb.asp?TopicID=1318. Please note that the Black Box ToolKit Ltd cannot provide support for third party software such as E-Prime. Example scripts downloaded from our support website are provided on an “as is”...
Page 134: Troubleshooting
Once you start PSR, a recording toolbar will appear. To start to record click Start Record or press ALT+A. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 135 Zip file to your hard drive. If you have software that can open a Zip file installed on your PC, you can open it up and look inside. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 136 UI Elements: Name, Keypad buttons to TTL 1-8.mtl, Items View, PSR recording as it may be too large to DirectUIHWND, ShellView, SHELLDLL_DefView, CtrlNotifySink, email. support@blackboxtoolkit.com DirectUIHWND, DUIViewWndClassName, Open, #32770 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 137: Changing The Virtual Serial Port Manually And Reducing Transmission Speed
Tools | Options. Alternatively, you can install the PC Software twice into two different folders. This will allow you to have two separate XML configuration files and therefore multiple COM ports. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 139 If the PC Software will not connect to the mBBTK you can check that the correct settings stores mBBTK v2.exe.config XML file as shown. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 140: Carrying Out A Mbbtk Memory Diagnostic Check
A check character will then be randomly generated by the PC Software and sent to the mBBTK. This character will be written to every memory cell. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 142: Updating Pc Software
All your default threshold settings, line labels and other details are stored in this file. In the control panel you should click on the Uninstall a program link Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 143: Updating Firmware
Simply update the PC Software by uninstalling and reinstalling it. 19.7 Updating Firmware To determine which firmware you have select Help | About Hardware. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 144 LEDs to the right on the front panel will illuminate. The Bluetooth Sync LED will flash and the Sync LED will be unlit. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 145 Should you not have backed up your existing firmware.bin file a copy of the version your mBBTK shipped with can be found in the firmware folder under where the mBBTK PC software was installed, e.g. C:\mBBTK\firmware. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 146: Restoring Factory Settings
The wired Virtual COM Port should not have changed but you may need to reselect it from the Startup Options dialog under the Tools menu. Default connection speed is 115,200 bps. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 147: Technical Specifications
Experiment Generator (timing may not be accurate due to your Experiment Generator taking over timing duties and the mBBTK running in dumb mode) Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 148: Software Specifications
 regional options Digital sensor activation thresholds stored with each capture  Highlight timing data in spreadsheets from the logic analyser by pressing H Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 149: Pinout For Front Ttl In/Bbtk Usb Response Pad 9-Way Male D
The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 150: Pinout For Front Dumb/Legacy Push-To-Make Response Pad 9-Way Female D
Voice Key. Use of generic legacy response pads may compromise timing and event marking accuracy. In addition, the Black Box ToolKit Ltd cannot be held responsible for any damage to your own response pad or the mBBTK howsoever caused.
Page 151: Pinout For Front 2.5Mm One Shot Ttl Socket/Bbtk Usb Response Pad Voice Key
The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.
Page 152: Pinout For Rear Ttl In (Male) & Ttl Event Mark Output (Female) 25-Way D's
The BBTK Ltd cannot be held responsible for any damage to your own equipment, or to the mBBTK, howsoever caused. Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved. Release Candidate 1...
Page 153: Timing Specifications
Experiment Generator may be capable of on your own hardware with your own scripts. Sampling Rate Mean TTL Out Mean TTL In μ 38kHz 210μ Release Candidate 1 Copyright © 2012 - 2018 The Black Box ToolKit Ltd. All rights reserved.