See Help file after installation for latest info
v. xx.x.x jClamp for Windows 32 bit
version
Upgrade
tips see bottom of text!
Always
backup your jclamp32 directory before a new install!!!!!!!!!!!
pre
v. 6.x.x --> Uninstall jClamp 32 from the Control Panel.
After that use MS msi installation file.
The
file <jc17xxx.exe> is a self-extracting zip. Place it in a temporary
directory (I use <jc_istall>) and run it by
double-clicking. If you use Windows 95
run the <w95.bat> file by double clicking on it. It assumes that your
system directory is <c:\windows\system>. This will update and register
the file <oleaut32.dll> that may be required for installation (only the
first Win95 version needs the update).
Getting started
If you buy jclamp you will need to register. After you install and run jClamp on the computer you want to use, press the registration button after running jClamp. Press the copy info button and paste all the info into an email to me. It looks like this :
----------------------------------------------------------------------------------------------
To: SciSoft Co.
joseph.santos-sacchi@yale.edu
http://www.med.yale.edu/surgery/otolar/santos
Date: 03/17/07
Time: 10:55:24
Application: jClamp32.exe
Version: v. 17.0.0
System: Windows NT 5.1 (Build 2600)
Application path: C:\jClamp32
Registration code: [A40079BD 22585A 26A3654 10196A30 5E72F78]
----------------------------------------------------------------------------------------------
I will send you the hardware license. Alternatively, you can use the fulldemo license on the web for a month to check out the program with hardware, or you can use the built in math model to test the program.
--------------------------------------
At the first start of jClamp a pop-up window will appear showing the following information:
“This is a new method for communicating with a jClamper during experiments without interference during recording. A text file named "jcreadme.txt" can be placed in the jClamp32 directory at any time, e.g., remotely via network. This note will pop up at the start of jClamp or, if jClamp is running, when the Cell Censor is turned off. The note can be printed prior to exiting the window. Upon exiting, the file is deleted, but the information is stored in the file "jcreadme.bak".
Additionally, if a text message is present, the audio file named <jcreadme.wav> located in the jClamp <sounds> directory will be played. You can record your own audio message (using Windows sound recorder, for example) along with the text message or just play a notification sound when the text message opens. Just rename your recorded wav file to <jcreadme.wav> and place in the <sounds> directory.
It is a good way to remind yourself or another jClamper of something important!
When you restart jClamp the next time Windows may attempt to re-install jClamp. This normal and should only happen once.”
--------------------------------------
Because the computer may crash if jclamp
is run with the ini file set to a board that does not
exist in the computer, the default jclamp.ini file is initially set to run in a
built-in math model mode. To run with hardware, you should first set the
board type and address, then disable model in the ini
file under the gain tab, or uncheck the model checkbox while jclamp is running. Anytime you make changes to the ini file you must save the file and restart jClamp, or
press the <re-ini> button on the Bar Menu. It
is probably better to restart jClamp. The settings open in a pop-up window when
you move the mouse over the graphic (default is a spiral ganglion cell –
replace that graphic with a picture of individual jclamp
users – set in ini file) in the upper left region of
the Cell Censor window.
You must make sure the paths in the ini
file match your machine's paths. For example, in the ini
file default the directories are C:/program file/ jclamp32 but yours may be
different. Make sure everything is set right in the ini
file, and then save it as a different name -- like
"your_name.ini". You can specify your ini
file rather than the default jclamp32.ini by doing the following. <"C:\Program Files\jclamp32\JCLAMP32.EXE" my_ini_file.ini
>.
If you find that the file <scrrun.dll> is giving problems, then it may be necessary to register it. Run the following on the command line
"REGSVR32.EXE C:\WINNT\system32\scrrun.dll"
Make sure your windows directories are correct. For win98, it may be "windows/system/".
In Windows
If you are using an old Labmaster DMA board then jClamp is useable without a license. Remember the free license is only available when the ini file is set to use the Labmaster board (under gain tab). Set the proper Port address! The Labmaster board is controlled exclusively through Port I/O with the jClamp VXD or SYS driver. The only differences with the hardware setup required by pClamp is that the ports A0-A7 should all be configured for output. A7 is scope trigger. See the hardware manual. B0 is trigger input. C channels are not used. Cm tracking and gap-free are functional only in Win 95/98, although 2-sine command protocols are supported. Win 2000 performance is superior. Normally, if there is no hardware license the registration window will appear, indicating that the license is software only or that so many days are left in the hardware fulldemo license. For the free labmaster support, there is no license, so the register window will open. If you want to bypass that window you may create a shortcut on the Windows desktop to jclamp32.exe, as you would do for any other program. In the properties window, target line, you should append the word "skip_reg". For example, <"C:\Program Files\jclamp32\JCLAMP32.EXE" skip_reg> is taken from the target line of a shortcut. It will run jclamp but not display the registration window. You could also specify a particular ini file other than the default jclamp32.ini by doing the following. <"C:\Program Files\jclamp32\JCLAMP32.EXE" my_ini_file.ini skip_reg>. Note there is a space after the executable name and between the ini filename and "skip_reg".
Install
the Axon 1200 board driver by running <DrvLnx95.exe> after placing it in
a separate temp directory. Axoscope 8 will install
the drivers for the 1320 series in Win98 and WinNT.
jClamp32
v. x.x.x
After
the board driver installs are complete make sure that your board works with the
application software provided by the board manufacturer. For example, for the Axon boards check with Axoscope 8. The Axon 1200 and 1300 series will work with
jClamp in Win95 and Win98; additionally the 1300 series boards will work in
WinNT 4. The 1300 series boards require the ASPI driver that is present in
Win98, but absent in WinNT. The Axoscope 8
installation disk should have the driver for NT use. Get Axoscope
8 to work before trying jClamp32!
A
new MS Windows installation program is used to install jClamp32. This will likely
be a component of Win2000 but needs to be installed on other systems.
Run <setup.exe> from the extracted jClamp installation directory. This will install the installation program
and bootstrap the installation of jClamp32 from the <jClamp32.msi> compressed
file. Follow the installation instructions.
The default directory for jClamp32 is now <c:\Progam
Files\jClamp32\>. You can change it,
but the <jClamp32.ini> file that provides search paths to parameter files
should be changed to reflect a new directory. If needed, run
<IniEdit32.exe> and make changes before running jClamp32.
Following
installation, any jClamp32 changes, updates or uninstalls can be made by
clicking on the <jClamp32.msi> icon, and following instructions.
The Help file <jClamp32.chm> uses the new MS
HTML help system. You may need to upgrade Internet Explorer to use it. During installation of jClamp32, if a message
states that the
<HHctrl.ocx> cannot be registered, then an
upgrade is needed. IE5 upgrade is available over the internet. If you don’t use
IE then install the minimum configuration.
On
Windows 95, <jClamp32.exe>
may produce a page fault in the kernel upon exiting the program. No harm is
done since jClamp is closed and your data is saved at this point.
The
problem is with a newly released file from Microsoft <scrrun.dll>.
Reboot,
and copy the old version of <scrrun.dll> (located in the temporary
directory you used to unzip the installation package) to the Window's system
directory.
After
registering the software you will receive a hardware license via email. Copy
your hardware license file <jclamp32.lic> to the jClamp32 directory; it
will replace the software only license.
Buy
a real cheap new fast computer to run jClamp!!!
Below is the readme displayed during the installation
jClamp for Windows 32 bit
version
Shortcuts are in the start menu for jClamp32, jClamp Help, jClamp IniEditor and jClamp Logger.
The default ini file <jclamp32.ini> lists the parameter directory as <c:\program files\jclamp32\param>. If this is not the case, then you should open the ini file with IniEditor and change the path, so that jClamp32 will load properly without errors.
Automation with SigmaPlot, Excel, MATLAB and Origin is set to off in <jclamp32.ini> under Tab “misc”. Usage for each must be enabled in the ini file. For Origin you must provide the path in the inifile. In other inifiles that you create you must enable automation if you want to use it.
Upon running jClamp32 a registration screen will appear. You may skip it to run the program for evaluation purposes. To register for the hardware license select the register option and follow the instructions.
After registering jClamp you will receive a hardware license via email. It will be named <your_name.lic>. Make a backup copy for safety purposes. To use it, rename it to <jclamp32.lic>. Copy your hardware license file to the jClamp32 directory, wherever you installed it; the new license will replace the software-only license.
Remember, the A/D - D/A board needs to have been installed correctly prior to installing jClamp. That is, the manufacturer’s application software should work with the board. If the hardware does not appear to work with jClamp then it is likely that the drivers for the particular board were not installed correctly. For the Axon boards, first get Axoscope to work with them. For the 1320 box you need to copy the current version of <Axoutils32.dll> and <axdd132x.dll> (in Axon’s library directory) to the jClamp directory.
In jClamp, help information is displayed at the bottom panel in the main widow when the mouse cursor is placed over a particular window region or button. Run and print out the Help program, too. You may need to upgrade MS Internet Explorer to view the help file. The upgrade is free from MS online.
You will find it useful to use an ini file other than <jclamp32.ini> so that individual users can set preferences. Make a shortcut to jClamp32.exe on the desktop (one was made automatically with setup but it cannot be edited) and change the command line in the properties to <jclamp32.exe my_ini_file.ini>. The program will load up with your ini file automatically.
With the money you save on expensive patch clamp software, buy a new real cheap fast computer to run jClamp!!!
Below is the board support section from the help file
Supported Hardware
CAVEAT: if you have different board types, protocols created with one board selected may not be the same if you use them with another board. This is because specifications, e.g., minimum clock, synchronous digital output, voltage out, can be different. You should set the board type to the board that was used to save the data when viewing the data. You don’t need the board present, but can work in math model mode. Actually, I have tried to make the aforementioned not a requirement. For example, the board type is saved with a data file and I use it to select the board type when analysis mode is in effect, so that data files are matched for board characteristics. In the command utility the board that made the protocol is now exposed, and when loading data files the board that was used is exposed in the window. Nevertheless, it is safest to select the board on startup to look at data generated with a particular board!
The program is written to work with the Power 1401 from CED, 1200, 1200A, 1320 and 1440 series boards from Axon Instruments, the Labmaster DMA from Scientific Solutions, the DAQP-308 PCMCIA card from Quatech, the IOtech daq2000/XP Pro PCI board and the National Instruments E series PCI-MIO-16XE-10, PCI-6052E, PCI-MIO-16E-1, and PCI-MIO-16E-4 boards, and M series USB 6251. NI PCI-6035E and PCI-6024E boards are supported in a limited way (see below).
jClamp also supports video capture using a Video for Windows compatible board. Streaming video capture and playback; record video during data collections; control through script or via Look! video window. Check script command section and check menu on the Look! window. I suggest a Hauppauge video (see www.hauppauge.com) capture card - WinTV PCI - you can get them without the TV tuner for less than $100. The default capture driver is number 0, but now you can provide other numbers in the jClamp ini file under the "misc" tab. Setting the driver number to 999 causes jClamp to skip the check for a board, and no capture will be available
The configuration settings must be set correctly for each AD board.
The Power 1401 from CED (16bit in/out) works in WIndows 95/98.NT/2000/XP Pro. Follow the setup described by CED. Digital in 0 (Event Input 0) is used for triggering -- pulse to low for trigger. Trigger BNC is not used. Digital out 0 (hi byte 0) on front panel is scope trigger. Other digital outs are low byte on expansion connector. Fastest clock supported is 3 usec for synchronous in/out. CED command files must be placed in the jclamp32\CED\ directory. They are ADCMEM, MEMDAC and MEMDAD. Analog output on channel 2 and 3 is controlled with DAX window. CC monitoring for a 3rd and 4th amplifier uses channels 2/2 and 3/3 in/out. Synchronous digital out issupported . Other models may be supported.
The 1200A (12 bit in/out) and 1320/1440 series (16 bit in/out) boards are useable in WIndows 95,98, NT4, 2000/XP Pro. Follow the setup described by Axon. For both boards, digital in 0 is used for triggering -- pulse to high for trigger. Start trigger is not used because it is not directly accessible to third party software, except for the 1440 series. Digital out 7 is scope trigger. The 1200 Axon boards are configured by supplied Axon software (e.g., Axoscope), and the axdd1200.ini file located in the Windows (Win 95 & Win 98) directory is used by jClamp. If there are problems, check the hardware address, interrupts, and DMA channels in Axoscope. Get that to work! The 1200 board may be functional only in Win 95/98.
Unlike the other boards, the 1320 series boards treat the synchronous digital output as another channel; therefore when using these boards the clock will change in the command utility when synchronous digital output is enabled. The 1440 series supports synchronous digital output and multiplexing is not used, so clock remains the same regardless of input channel number.
Under NT or Win2000/XP Pro, the 1200A board does not work well with jClamp -- the drivers supplied by Axon (from SSI) are dysfunctional. Cm tracking does not work, but the 2-sine command protocol it works.
The drivers for all Axon boards are installed with the manufacturer's software program Axoscope. See the instructions supplied with the boards. Get Axoscope to work!
For the 1320 series (1320A, 1321A, 1322A), Axoscope
version 9 must be installed, since the new drivers that are released with this
version are used by jClamp versions greater than 10.9.0. The boards should be occasionally calibrated
with the Axon software Axoscope – see the Axon
documentation. jClamp uses the board’s hardware stored
calibration data. The file
<AxDD132x.dll, ver. 1.1.0.7>
found within the Axoscope 9 directory
must be copied into the jclamp32 directory for the board to work with jClamp.
For the 1440 series, AxDD1440.dll must be copied into the jclamp32 directory. The
Axon Multiclamp Telegraph system is supported – see
telegraphs.
The Labmaster (12 bit in/out) and DAQP-308 (16 bit in/ 12 bit out) must have the Port address set correctly in the jClamp ini file.
jClamp for the Labmaster DMA is free -- no license required. Remember the free license is only available when the ini file is set to use the Labmaster board (under gain tab). Set the proper address! The Labmaster board is controlled exclusively through Port I/O witht the jClamp VXD or SYS driver. The only differences with the hardware setup required by pClamp is that the ports A0-A7 should all be configured for output. A7 is scope trigger. See the hardware manusal. B0 is trigger input. C channels are not used. Cm tracking and gap-free are functional only in Win 95/98, althought 2-sine command protocols are supported. Win 2000/XP Pro performance is superior. Normally, if there is no hardware license the registration window will appear, indicating that the license is software only or that so many days are left in the hardware fulldemo license. For the free labmaster support, there is no license, so the register window will open. If you want to bypass that window you may create a shortcut on the Windows desktop to jclamp32.exe, as you would do for any other program. In the properties window, target line, you should append the word "skip_reg". For example, <"C:\Program Files\jclamp32\JCLAMP32.EXE" skip_reg> is taken from the target line of a shortcut. It will run jclamp but not display the registration window. You could also specify a particular ini file other than the default jclamp32.ini by doing the following. <"C:\Program Files\jclamp32\JCLAMP32.EXE" my_ini_file.ini skip_reg>. Note there is a space after the executable name and between the ini filename and "skip_reg".
The DAQP-308 should be set up according to the manufacturer. The board is controlled exclusively through Port I/O witht the jClamp VXD or SYS driver. The port address is found in the windows Control Panel. That address should be set in the jClamp ini file. Only four (0-3) digital in and out channels are available. Scope trigger in on Ch3. Ch0 is trigger input. Cm tracking and gap-free are functional only in Win 95/98, althought 2-sine command protocols are supported. Win 2000/XP Pro performance is superior.
The IOtech daq2000/XP Pro PCI board (16 bit in/out; 100kHz) should be set up according to the manufacturer. It will work in Win NT and 95/98. It is inexpensive ($500) and quite nice. It has features not present in the other boards. Unfortunately, currently it has a noise problem on the DACs, which may be fixed in the second version.
National Instruments E series PCI-MIO-16XE-10 (10 usec), PCI-6052E (3 usec) boards ( both 16 bit in/out), PCI-MIO-16E-1 (1 usec support, 12 bit in/out) and PCI-MIO-16E-4 (4 usec support, 12 bit in/out) should be set up with version 6.7 of NI-DAQ, which comes with the boards. Inputs should be single ended. Triggering is done on PF10 (TRIG 1). Scope trigger uses digital out 7. Both are setup to have an ADC range of +/- 10 V. Programmable gain is available 1,2,4,10 for PCI-6052E and PCI-MIO-16E-1, and 1,2,5,10 for PCI-MIO-16XE-10.
The PCI-6035E (16 bit in/ 12 bit out) and PCI-6024E (12 bit in/out) are boards that have 5 us analog in but only 100 us analog out. They are supported, but they are functionally limited. Support is for 100 us in and out, so that synchronous in/out can be performed. Gain is limited to 1 or 2, with 20 supported in CC manual gain mode. The slow speed limits CC parameter estimation, since only slow time constant current responses can be fit accurately.
The M series
NI 6251-USB is supported (16 bit in/out), with synchronous digital output. Clocks down to 1 usec for a single
channel. The NI PCI-6221 board is also supported with synch digital and
clock to 4 usec. Programmable gain option is employed
with both.
These boards will be the preferred boards for jClamp starting
6/2007. The NI PCI-6221 board is used by Neobiosystems
to control their PatchMAX 100A and jClamp will work with
their system to provide user friendly patch clamp and two electrode voltage clamp
solutions. When controlling their system you must switch back to math model in
jClamp (accessable in the pop-up window when the
mouse goes over the user graphic in CC). After cell encounters, press their
release button and turn off math model in jclamp to
start clamping! Digital out 1, 2 and 3 are used exclusively by their system and
are set high and disabled in jClamp.
Digital 0 is available for synchronous output with analog out. Out 4,5, and 6 are useable for non-shynchronous
use; 7 is scope output trigger and digital in 6 is for episode or start
triggering. To enable use with their system you must check the NeoBiosystems box under the History tab in the jClamp ini file.
In jClamp ini
editor select <nidaq> for E series boards and <nidaq_mx> for M series boards. The PCI-6052E can
also be used with the <nidaq_mx> drivers.
Synchrounous digital out with analog is not supoported by the E series boards ( so DAX is not supported), although jClamp can provide non synchronous digital out. Board number (eg., 1; obtained from NI Explorer - NiDaq 6.7 drivers for E series; NiDaq mx ver 8.5 for M series) needs to be entered in the jClamp ini file under Gain tab after choosing the NI board. Functional in Win 95/98/NT/2000/XP Pro.
DAX hardware simply connects to the digital out BNCs. The single male BNC connects to ch0, the attached white wire connects to ch1, and the other four BNC assemblies attach to any of the digital out channels ch2-5. A 4.5 - 5 volt power source (central pin positive) drives the DAX. Output from each channel is +/- 5 volts.
Axon 1200 boards can have episodic collections up to 0.5 million pts in W98, and 1 million points in Win NT. Axon 1320 boards have episode lengths up to 1 million pts, as does the IOtech daq2000/XP Pro. Episode time for 1 million pts at 10 us is over 10 sec per episode!! If longer episode lengths are required this may be possible. Contact me. Episodic delivery for the National Instruments is up to 10 million pts (this should be checked with your hardware before using on cells!). CED board and Axon 1440 board is up to 5 million points.
When in dual
voltage output mode, the default setting is 2 analog inputs. For the NI boards
using nidaq_mx drivers, and
for the Axon 1320 and 1440 series boards you may increase the number of inputs
up to 8 channels.
From jClamp help file
Upgrading to a new version is simple with the Microsoft
installer. After downloading the compressed executable jcxxxx.exe,
extract it into a directory on your hard drive, say, jc_install.
The files that are extracted are
installation info
install.htm
files used to install the
Microsoft installer (this only needs to be done once on a system; In Win2000
this is already installed)
setup.exe
setup.ini
InstMsiW.exe
InstMsiA.exe
jClamp installation file (double
clicking on this file will install or upgrade jClamp)
jClamp32.msi
special files for installation on
old Win95 machines
w95.bat
oleaut32.dll
regsvr32.exe
SCRRUN.DLL
When
I install a new version I extract the zip files into the old jc_install
directory over the old files. Then I click on the jclamp32.msi file and remove
the old version. I then click on it again and install the new version. All files that are initially delivered with
jClamp, e.g. jclamp.ini, and parameter files, are replaced; so if you use those
(which you shouldn’t – make your own with new names) make backups. The jClamp32.lic
file is replaced with a software-only licence, so
Hopefully for version 17.0 and above the jclamp32.lic filoe will not be overwritten, nevertheless, back that up
before installing! If your hard ware licence your_name.lic is
in the jClamp directory it will not be touched, and it can be copied and
renamed to jclamp32.lic. You can keep a back up store of the zip
versions for safety.