home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 September / CHIP_CD_1997_09_PL.iso / software / testsoft / labwind / demo.1 / readme.cvi < prev   
Encoding:
Text File  |  1996-12-16  |  17.4 KB  |  286 lines
  1.  
  2.           LabWindows/CVI for Windows 95 and NT, Version 4.0.1
  3.                          Documentation File
  4.        (c) Copyright 1993-1996 National Instruments Corporation.
  5.                         All rights reserved.
  6.  
  7.          Product and company names listed are trademarks
  8.           or trade names of their respective companies.
  9.  
  10.  
  11. This file contains installation and programming considerations and 
  12. changes that are too recent to be included in the printed LabWindows/CVI 
  13. documentation.
  14.  
  15.  
  16. Before Installation
  17. -------------------
  18.  
  19. 1.  If you have been using version 3.1 or earlier of LabWindows/CVI, it is 
  20.     recommended that you do not overwrite it. Instead, you can install 
  21.     the 4.0.1 version in a new directory.
  22.  
  23. 2.  If you have been using LabWindows/CVI 3.1 or earlier, you should make
  24.     backup copies of your .UIR files.  Once .UIR files have been saved in
  25.     version 4.0.1, they are partially compatible with version 3.1 and 3.0.1. 
  26.     You can load them into 3.1 and 3.0.1, but if you save them you lose the
  27.     new 4.0.1 features. Once .UIR files have been saved in version 4.0.1, they
  28.     are no longer compatible with version 3.0.
  29.  
  30. 3.  If you are installing on Windows NT, you must have Windows NT version
  31.     3.51 or greater.
  32.  
  33. 4.  The complete Windows SDK is not available in the demo version of CVI. 
  34.  
  35. 5.  If you plan to use GPIB with LabWindows/CVI, you must have a 488.2-                  
  36.     compatible GPIB board from National Instruments. You also must have                    
  37.     installed the NI-488.2 software for Windows 95 or Windows NT.  For                     
  38.     Windows NT, the version 1.0 driver only supports the AT-GPIB\TNT and                   
  39.     AT-GPIB boards.                                                                        
  40.                                                                                           
  41.     If you plan to use GPIB callbacks under Windows 95 or Windows NT, you                  
  42.     must install the alpha or beta NI-GPIB drivers located on the                          
  43.     LabWindows/CVI CD-ROM or get the released versions of this driver                      
  44.     when available from National Instruments.                                              
  45.                                                                                            
  46. 6.  If you plan to use the Data Acquisition Library with LabWindows/CVI,  
  47.     you must have a Data Acquisition board from National Instruments. You 
  48.     also must install the NI-DAQ software from the distribution diskettes 
  49.     for NI-DAQ version 4.8.5 or later.  NI-DAQ 4.9.0 is included on the 
  50.     CD-ROM version of LabWindows/CVI.
  51.  
  52.     When installing NI-DAQ 4.9.0 or later, do so AFTER installing 
  53.     LabWindows/CVI so that the appropiate support files will be 
  54.     copied into the LabWindows/CVI directories.  Select the "LabWindows/CVI"
  55.     option in the NI-DAQ installation.
  56.     
  57.     The 4.8.5 version of NI-DAQ was created prior to the existence of 
  58.     LabWindows/CVI 4.0.1.  Under Windows 95, the "LabWindows/CVI" option 
  59.     in the NI-DAQ 4.8.5 installation copies files into the LabWindows/CVI 
  60.     directory tree that do not work with LabWindows/CVI 4.0.1. 
  61.     To use NI-DAQ 4.8.5 with LabWindows/CVI 4.0.1, do the following. 
  62.  
  63.     - Install NI-DAQ 4.8.5.  Under Windows 95, choose the "Third Party 
  64.       Compilers and DAQWare" option instead of the "LabWindows/CVI" option.
  65.       Under Windows NT, choose the "Install NI-DAQ for Windows NT" option.
  66.      
  67.     - Install the LabWindows/CVI Support Files for NI-DAQ 4.8.5 diskette 
  68.       that comes with LabWindows/CVI.  If you have the CD-ROM version of 
  69.       LabWindows/CVI, the disk image is located on the CD in the \NIDAQ485\ 
  70.       subdirectory.                                                               
  71.  
  72.                                                                                           
  73. 7.  If you plan to use the NI-VXI Library with LabWindows/CVI, you must                 
  74.     have installed the NI-VXI Software Interface drivers.  For Windows                     
  75.     95, you must use the NI-VXI Windows 3.1 drivers with the NI-VXI                       
  76.     Upgrade for Windows 95, or use a native Windows 95 NI-VXI driver.                      
  77.     The NI-VXI Upgrade for Windows 95 contains a thunking DLL to                           
  78.     interface the 32-bit LabWindows/CVI environment to the Windows 3.1                     
  79.     16-bit drivers.                                                                        
  80.                                                                                            
  81.     For Windows NT, National Instruments has NI-VXI drivers for AT-MXI,
  82.     PCI-MXI-2, VXIpc-486 Model 500 Series and VXIpc-850 Series.  Please 
  83.     contact National Instruments for more information.
  84.                                                                                           
  85. 8. If you want to convert LabWindows/DOS programs to run under                         
  86.     LabWindows/CVI, read Chapter 12 of the Getting Started with                            
  87.     LabWindows/CVI manual, entitled "Converting LabWindows for DOS                         
  88.     Applications".                                                                         
  89.                                                                                            
  90.                                                                                           
  91.                                                                                           
  92. Additions and Corrections to Printed Documentation                                     
  93. --------------------------------------------------                                     
  94.                                                                                           
  95. Using NI-DAQ on Windows NT                                                             
  96.  
  97.     Some of the exported function prototypes for the NI-DAQ 4.8.5 DLL 
  98.     for Windows NT are different than the function prototypes for 
  99.     Windows 3.1 and Windows 95.  Please review the Release Notes for more
  100.     information.
  101.                                                                                            
  102.     The NI-DAQ version 4.8.5 interface for Windows NT is different than                    
  103.     the NI-DAQ interface for Windows 95.  To present a unified interface                   
  104.     across Windows 95 and NT, LabWindows/CVI for Windows NT uses the                   
  105.     Windows 95 NI-DAQ interface.                                                           
  106.                                                                                            
  107.     The functions listed in section "Differences in Current NI-DAQ API                     
  108.     for Windows NT" in the LabWindows/CVI for Windows Release Notes are NOT                    
  109.     supported in version 4.8.5 and 4.9.0 of NI-DAQ for Windows NT.  As 
  110.     mentioned, National Instruments will release a new version of NI-DAQ 
  111.     for Windows NT in the future that is equivalent to the Windows 95 
  112.     interface.
  113.                                                                                            
  114.     Use of AT-MIO E Series data acquisition DAQ products is not supported                  
  115.     under Windows NT.  As you may know, Windows NT does not have ISA Plug                  
  116.     and Play (PnP) capability.  This means that Windows NT can neither                     
  117.     recognize nor communicate with ISA PnP boards.  If you have an 
  118.     AT-MIO E Series board and are considering Windows NT you have two options.                                                                               
  119.                                                                                            
  120.     - use Windows 95 until Windows NT has ISA PnP capability,
  121.     
  122.       or
  123.                                                                                           
  124.     - call your National Instruments Inside Sales Representative to                        
  125.       discuss exchange options for your AT-MIO E Series board with a                         
  126.       legacy AT-MIO board.                                                                   
  127.                                                                                            
  128.                                                                                            
  129. NI-DAQ error codes on Windows 95 and NT                                                
  130.                                                                                           
  131.     Two new NI-DAQ functions have been added to handle error codes.                    
  132.                                                                                            
  133.     1) GetNIDAQErrorString                                                                
  134.                                                                                            
  135.     This function converts error codes returned by a Data Acquisition                      
  136.     Library function into a meaningful error message.                                      
  137.                                                                                            
  138.     The function prototype is as follows,                                                  
  139.  
  140.         char *GetNIDAQErrorString (short Error_Code);                                          
  141.                                                                                            
  142.     2)  ConvertToNewNIDAQErrorCode                                                         
  143.                                                                                           
  144.     The error codes returned by NI-DAQ version 4.9.0 and later are                         
  145.     different than those returned by NI-DAQ version 4.8.5 and earlier.                     
  146.     The ConvertToNewNIDAQErrorCode function converts old error codes                       
  147.     into a new error codes.   If you pass a new error code (or an                          
  148.     unknown error code) to this function, the function returns the                         
  149.     value passed in.                                                                       
  150.                                                                                            
  151.     This function is useful if your program checks for specific error                      
  152.     codes and may be used on computers with different versions of NI-                      
  153.     DAQ.                                                                                   
  154.                                                                                            
  155.     Note:  Although version 4.9.0 of the NI-DAQ DLL for Windows NT                         
  156.            returns the old-style error codes, the Data Acquisition                         
  157.            Library automatically converts these to the new error                           
  158.            codes.  This presents a unified interface across Windows                        
  159.            95 and NT.                                                                      
  160.                                                                                            
  161.     The function prototype is as follows,
  162.  
  163.         short ConvertToNewNIDAQErrorCode (short Error_Code);                                   
  164.                                                                                           
  165.                                                                                           
  166. Using GPIB Callbacks on Windows 95 or Windows NT                                       
  167.                                                                                           
  168.     If you plan to use GPIB callbacks under Windows 95 or Windows NT, you                  
  169.     must install an NI-GPIB driver that supports this feature.  Refer to                   
  170.     GPIB Library Chapter in the Standard Library Reference Manual for more 
  171.     information.                               
  172.                                                                                           
  173.                                                                                           
  174. Windows NT NI-GPIB alpha version 1.02 and ibInstallCallback                            
  175.                                                                                           
  176.     Under Windows NT, the NI-GPIB alpha driver does not properly place an                  
  177.     opened board online and CIC until the first device-level call that                     
  178.     requires the device to be online and CIC.  If the board is in this                     
  179.     state and a call is issued to ibInstallCallback, subsequent callbacks 
  180.     do not occur.  To work around this problem, either make the board-level
  181.     call to ibsic, or make a device-level calls (e.g., ibwait 0), and it 
  182.     has a side-effect of placing the connect board online and making
  183.     it CIC.  Note, calls that just configure the device like ibpad do NOT 
  184.     have this side-effect.                          
  185.                                                                                           
  186.                                                                                           
  187. Specifying an Application Icon and Title when creating an executable                   
  188. with a external compiler                                                               
  189.                                                                                           
  190.     Application Icon - The first icon compiled into the executable is the                  
  191.       icon used.  Add a resource to your executable and put your icon in                     
  192.       the resource.                                                                          
  193.                                                                                           
  194.     Application Title - The application title is a string in the string                    
  195.       table for your executable.  Add a resource to your executable, then                    
  196.       create a string table.  Insert a new string with an ID of 65535, and                   
  197.       this string is used as the application title.                                     
  198.                                                                                           
  199.                                                                                           
  200. Instrument Driver Library 
  201.  
  202.     The National Instruments Instrument Driver Library is included on 
  203.     the CD-ROM version of the LabWindows/CVI.  The \Instr\ subdirectory
  204.     contains the following subdirectories.
  205.     
  206.        \camac\    - CAMAC Instrument Drivers
  207.        \gpib\     - GPIB Instrument Drivers
  208.        \serial\   - Serial Instrument Drivers
  209.        \vxi\      - VXI Instrument Drivers
  210.             
  211.     
  212. Using NetDDE on Windows 95 and NT
  213. ---------------------------------
  214.     To use NetNDDE under Windows 95 and NT, you must create a DDE Share.
  215.     A DDE Share exports a DDE server for use by a remote client 
  216.     through NetDDE.  
  217.  
  218.     The method for creating a DDE Share under Windows 95 is
  219.     different than the method under Windows NT.  In both methods, 
  220.     the following terms are used.
  221.  
  222.     - "sharename" is a name that you create and pass as the third parameter 
  223.        to the ConnectToDDEServer function in the DDE Library.
  224.  
  225.     - "topic" is the server topic that is being shared.
  226.  
  227.     - "server" is the server name.  In a LabWindows/CVI application that 
  228.        is acting as a DDE server, it is the string passed as the first 
  229.        parameter to the RegisterDDEServer function.  In other applications, 
  230.        it generally is the name of the server program, for example, "excel".
  231.  
  232. Adding a DDE Share Under Windows 95
  233.  
  234.     To add a DDE Share, run the following command.
  235.  
  236.         cvi\bin\nddeshar  ADD sharename topic server
  237.  
  238.     To remove a DDE Share run the following command.
  239.  
  240.         cvi\bin\nddeshar  DELETE sharename
  241.  
  242.     Note:  When using NetDDE on Windows 95, you must first run 
  243.            \windows\netdde.exe on both the client and server machines.  
  244.            You can add a shortcut to it in your Startup folder so that 
  245.            it runs every time you start Windows 95.
  246.  
  247.  
  248. Adding a DDE Share Under Windows NT
  249.  
  250.     Run winnt\system32\ddeshare.exe.
  251.  
  252.     Choose DDE Shares from the Shares menu.
  253.  
  254.     In the dialog that appears, click on the 'Add A Share' button to bring up
  255.     the DDE Share Properties Dialog.
  256.  
  257.     Type in the sharename in the Share Name edit box.
  258.  
  259.     Leave the 'Old Style' and 'New Style' rows empty.
  260.  
  261.     In the 'Static' row, enter the server and topic in the 'Application Name'
  262.     and 'Topic Name' columns respectively.
  263.  
  264.     Click on the 'Permissions' button to setup the DDE Share Name permissions.
  265.  
  266.     In the Permissions dialog, click on Everyone and then change to type of 
  267.     access to Full Control. 
  268.  
  269.     Click on the OK button to exit the Permissions Dialog.
  270.  
  271.     Click on the OK button to exit the DDE Share Properties Dialog.
  272.  
  273.     In the DDE Shares dialog, click on the line containing the sharename you
  274.     just entered.
  275.  
  276.     Click on the 'Trust Share' button to bring up the Trusted Share Properties
  277.     dialog.
  278.  
  279.     Check the 'Initiate To Application Enable' checkbox.
  280.  
  281.     Click on the OK button to exit the Trusted Share Properties dialog.
  282.  
  283.     Click on the OK button to exit the DDE Shared dialog.
  284.  
  285.     Choose Exit from the Shares menu.
  286.