Getting Started – VISASCOPE – Version 2.3
Transcrição
Getting Started – VISASCOPE – Version 2.3
Getting Started – VISASCOPE – Version 2.3 September 15, 2014 General Informations for the Installation of VISASCOPE For general information and a short description of the installation of VISASCOPE see chapter 1, page 3 In case of problems or questions, please contact www.visatronic.de Allgemeine Hinweise zur Installation des VISASCOPE Allgemeine Informationen und Kurzanleitung zur Installation des VISASCOPE finden Sie in Kapitel 2, Seite 11 Wenn Sie Probleme oder Fragen haben, kontaktieren Sie bitte www.visatronic.de Informations génerales pour l’installation du VISASCOPE Informations génerales et explications brèves pour l’installation du VISASCOPE dans le chapitre 3, page 19 En cas de problèmes, ou si vous avez des questions, contactez svp. www.visatronic.de 1 Getting Started – VISASCOPE – Version 2.3 Contents 1 VISASCOPE - General information 3 1.1 GUI-Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.2 Installation under WINDOWS . . . . . . . . . . . . . . . . . . . . . . . 3 1.2.1 Installation of PC-Software (GUI-Interface) . . . . . . . . . . . 3 1.2.2 Installation of the USB-Driver (virtual COM Port Driver) . . . 4 Installation under LINUX . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.3.1 Installation of PC-Software (GUI-Interface) . . . . . . . . . . . 7 1.3.2 Configuration of USB-Interface . . . . . . . . . . . . . . . . . . 8 1.4 Connection of the Power Supply Unit . . . . . . . . . . . . . . . . . . 9 1.5 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.3 2 VISASCOPE - Allgemeine Informationen 11 2.1 GUI-Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.2 Installation unter WINDOWS . . . . . . . . . . . . . . . . . . . . . . . 11 2.2.1 Installation der PC-Software (GUI-Interface) . . . . . . . . . . 11 2.2.2 Installation des USB-Treibers (virtueller COM-Port-Treiber) . 12 Installation unter LINUX . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.3.1 Installation der PC-Software (GUI-Interface) . . . . . . . . . . 15 2.3.2 Konfiguration der USB-Schnittstelle . . . . . . . . . . . . . . . 16 2.4 Anschließen des Netzteils . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.5 Dokumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.3 3 VISASCOPE - Informations Génerales 19 3.1 Logiciel GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 3.2 Installation sous WINDOWS . . . . . . . . . . . . . . . . . . . . . . . 19 3.2.1 Installation du logiciel sur l’ordinateur (GUI-Interface) . . . . 19 3.2.2 Installation du USB-Driver (Virtual COM-Port-Driver) . . . . 20 Installation sous LINUX . . . . . . . . . . . . . . . . . . . . . . . . . . 23 3.3.1 Installation du logiciel sur l’ordinateur (GUI-Interface) . . . . 23 3.3.2 Configuration de connnection USB . . . . . . . . . . . . . . . . 24 3.4 Connection de bloc d’alimentation . . . . . . . . . . . . . . . . . . . . 25 3.5 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 3.3 www.visatronic.de 2 Getting Started – VISASCOPE – Version 2.3 1 1.1 VISASCOPE - General information GUI-Software The graphical user interface (GUI) on the PC is written in software language TCL/TK, version 8.5 . For installing the GUI, only some folders and files are required which can be copied easily with the specified installation program. You can download the actual version of the GUI-Software at http://www.eit.hs-karlsruhe.de/visascope/. 1.2 Installation under WINDOWS WINDOWS Operating systems from WINDOWS 2000 on are supported (XP, VISTA, WINDOWS 7). 1.2.1 Installation of PC-Software (GUI-Interface) During installation, nothing will be entered in the registry, however, all required ICONS are created on the desktop and in the program menu. Please, start the installation by double-clicking file setup-for-windows.exe. After selection of the language, you will be guided through the installation interactively. Normally, programs are installed in folder C:\Programm Files. But with VISTA or Windows 7, you might have problems with the privileges for installing in folder C:\Programm Files. Therefore, C:\Dokuments and Settings respectively C:\user\<username>\... in Windows 7 is suggested as standard during installation. If You want, you can change it during the installation. www.visatronic.de 3 Getting Started – VISASCOPE – Version 2.3 Executable Programm: There are two options to install the GUI: 1. On the PC, the software TCL/TK from Aktive State is not installed. In this case, You can use the wrapped version of GUI as an .exe file (visascope.exe). In this file, the GUI source-code together with the TCL7TK basic functions are packed. Howewer, this wrapped version is much slower than option 2. 2. First of all, You have to install the TCL/TK software from Active State ( http://www.activestate.com/ : Active TCL ). During the installation of the GUI, You specify the installation-path of this program. Thus, You indicate that You will use the installed TCL/TK. With this option, the execution time will be about two times faster compared to option 1. Aero Design under VISTA and Windows 7: In VISTA and Windows 7 You can use the so called Aero-Design. In order to store the Oscilloskop-screen in a picture-file (.jpg .png ...) You have to switch off the AeroGlass effect, i.e. the transparent view of the Window frames. This can be done by the Aero-Glass Switcher. (Attention! It is not sufficient to deactivate the tranparency in the Desktop Settings!) During Installation there will be offered three Aero-Glass Switcher. We recommend to install all three and You select the most convenient version. The company Windows 7 Tuning allowed us to deliver there own Aero-Glass Switcher in the installation software. The newest version can be downloaded from http://www.windows7-tuning.de. In case you use the classical desktop design or earlier versions of Windows, You do’nt need the Aero-Glass switcher. 1.2.2 Installation of the USB-Driver (virtual COM Port Driver) Please install the PC-Software (GUI-Interface) before You install the USB-Driver. Please connect VISASCOPE and PC via the USB-cable. At this time, the VISASCOPE does not have to be connected with the power supply unit, yet. The PC recognizes the new hardware and starts the installation of the driver. In any case, you should avoid an automatic installation of the driver: On the CD, you will find the required USB driver in folder USB_Driver. When asked for it, specify this folder during the installation of the USB driver. The following screenshots show the installation procedure. www.visatronic.de 4 Getting Started – VISASCOPE – Version 2.3 After having connected the USB cable, you will find the menu shown to the right. Choose the lowest option. In the next menu, you have to specify that you want to install the software from a certain list or source. In any case, avoid the automatic search! In the next menu, use the button "Browser" to specify the folder in which the desired driver ist stored. Therefore, specify folder USB_Driver www.visatronic.de 5 Getting Started – VISASCOPE – Version 2.3 Depending on the settings of the operating system and the USB driver installations, you might be asked for file FTSER2K.SYS . In this case, specify folder USB_Driver\i386 in which this file is located. Confirm with OK. During installation, it might happen that a warning appears as shown on the right side: The software you are installing has not pass windows logo testing Ignore this warning and continue installation. Now, the installation of the driver should be finished. Depending on operating system and settings, WINDOWS might like to install the driver, again. In this case, repeat the procedure. During this installation procedure, as well, do NOT search for the drivers automatically via WINDOWS but specify the path in which the USB driver is located, as shown above. www.visatronic.de 6 Getting Started – VISASCOPE – Version 2.3 1.3 Installation under LINUX The installation setup-program is adapted to the operating systems Ubuntu and openSUSE. The operation under other operting systems is possible, however, the USB configuration has to be realized manually. 1.3.1 Installation of PC-Software (GUI-Interface) The graphical user interface (GUI) on the PC is written in software language TCL/TK, version 8.5 . For installing the GUI, only some folders and files are required which can be copied easily with the specified installation program. In order to install the software, you must have administrator rights. Please, start the installation by double-clicking file setup-for-linux. Eventually, you must change the mode with the command chmod 755 setup-for-linux in order to make this file executable. After selection of the language, you will be guided through the installation interactively. Normally, programs are installed in folder /opt. If necessary, You can change this location during the installation process. In the installation-folder, the directory Visatronic is generated. In this folder, the Visascope software is located in the folder visascope-versionnummer. If You install new versions of Visascope, the old versions remain and will not be erased. If necessary, You can erase old versions by removing the corresponding folder. In order to start the VISASCOPE from the terminal, in /usr/bin symbolic links are generated. You can start the VISASCOPE with the commands vs or Visascope or visascope www.visatronic.de 7 Getting Started – VISASCOPE – Version 2.3 Executable Programm: There are two options to install the GUI: 1. On the PC, a TCL/TK from Aktive State is not installed. In this case, You can use the wrapped version of GUI as .exe file (visascope.exe). In this file, the GUI source-code together with the TCL7TK basic functions are packed. Howewer, this wrapped version is much slower than option 2. 2. You have to install first the TCL/TK software from Active State ( http://www.activestate.com/ : Active TCL ). Most of the Linux versions have already installed TCL/TK and you must not install separately. During the installation of the GUI, You specify the installation-path of this program. Thus, You indicate that You will use the installed TCL/TK. With this option, the execution time will be about two times faster compared to option 1. 1.3.2 Configuration of USB-Interface The Linux-Kernel from Version 2.6.31 on contains already the USB-Driver. However, the VISASCOPE has its own PID (VID=0403 PID=d4f2). This PID must be configured correctely, otherwise, the USB-port will not be recognized. The SetupProgramm realizes this configuration. Unfortunately, the different Linux versions differ in this point. Thus, in case of problems, You must solve the problem of PID configuration manually. A detaild description of the configuration is listed below and might help You in case of problems. In order to configure the PID of the VISASCOPE PID the modul ftdi_sio with the VISASCOPE PID has to be loaded during system start. You have to make the following steps (root administartion rights required) • in the folder /etc/modprobe.d you have to generate an ascii file named visascope.conf. This file has one line with the content options ftdi_sio vendor=0x0403 product=0xd4f2 • The USB-configuration should be activated during system start. To ensure this operation, the following file have to be modified. Depending from the operation system You have to modify: Ubuntu: The file /etc/modules must be augmented by two lines: # visascope ftdi_sio openSUSE: The file /etc/configsys/kernel contains one line: MODULES_LOADED_ON_BOOT="" . Eventually, between the double-quotes, there are already listed some modules. Please let these modules unchanged and append the modulname ftdi_sio. If there are no text between the two double-quotes, insert ftdi_sio. Now, this line ich changed to www.visatronic.de 8 Getting Started – VISASCOPE – Version 2.3 MODULES_LOADED_ON_BOOT="ftdi_sio" (without additional modules). If more modules have to be loaded during ssytem-start, they must be separated by blanks. It is also possible to change this line with the System-Editor: Yast => System => /etc/sysconfig-Editor => System => Kernel => MODULES_LOADED_ON_BOOT. Add now the new module name (ftdi_sio). • After generating the file visascope.conf in the folder /etc/modprobe.d , You can configure immediately the USB-driver by invoking the command modprobe ftdi_sio . Thus, You dont need to restart the Operating system. Ubuntu 14.04 (Trusty Tahr): Sometimes, the USB-port will not be detected in Ubuntu 14.04. In this case, You might add in the file /etc/rc.local the following line echo 0403 d4f2 >/sys/bus/usb-serial/drivers/ftdi\_sio/new\_id Thus, You insert in the file /sys/bus/usb-serial/drivers/ftdi_sio/new_id the vendor and product ID of the USB-device. Unfortunately it is not sufficient to add the VID and PID via editor into /sys/bus/usbserial/drivers/ftdi_sio/new_id. This file will be written at each user-login. The command in the file /etc/rc.local guarantees that after each login this file will be updated. Thus, the vendor and product ID are available. 1.4 Connection of the Power Supply Unit On the rear side of the VISASCOPE , you will find a DC connector for connecting the DC power supply unit (13V DC, 1A ). Please, make sure that the middle contact is connected with the positive voltage. If you interchange the polarity, a short-circuit will occur which will destroy the power supply unit. 1.5 Documentation There are different descriptions available in folder docu: • VISASCOPE _Programmers_manual.pdf (Description of the interface in English, this documentation is required by users who would like to control the VISASCOPE using their own software) • VISASCOPE _description.pdf (Description of all connectors of VISASCOPE and technical description) www.visatronic.de 9 Getting Started – VISASCOPE – Version 2.3 You need the Acrobat Reader, Version 5.0 oder higher in order to read these files. • Under WINDOWS, these files are accessible in the startmenu: Start -> Programs -> Visascope • Under LINUX, thes files are located in the folder visascope-versionsnummer/docu . E.g. in /opt/Visatronic/visascope-2.3/docu www.visatronic.de 10 Getting Started – VISASCOPE – Version 2.3 2 2.1 VISASCOPE - Allgemeine Informationen GUI-Software Die graphische Oberfläche auf dem PC (Graphic-User-Interface = GUI) ist in der Programmiersprache TCL/TK, Version 8.5 erstellt. Zur Installation sind nur einige Dateien und Unterordner nötig, die mit dem angegebenen Installationsprogramm einfach kopiert werden können. Die aktuelle Version des GUI-Software können Sie unter http://www.eit.hs-karlsruhe.de/visascope/ herunterladen. 2.2 Installation unter WINDOWS WINDOWS-Betriebssysteme ab WINDOWS 2000 (XP, VISTA, WINDOWS 7) werden unterstützt. 2.2.1 Installation der PC-Software (GUI-Interface) Registry-Einträge werden bei der Installation nicht vorgenommen. Es werden jedoch alle nötigen ICON’s auf dem Desktop und im Programmenü erstellt. Starten Sie durch Doppelklicken das Programm setup-for-windows.exe. Nach Auswählen der gewünschte Sprache werden Sie interaktiv durch die Installation geführt. Es ist üblich, die Installation von Programmen im Ordner C:\Programme vorzunehmen. Unter VISTA und Windows 7 treten jedoch häufig Probleme mit der Berechtigung bei der Installation im Ordner C:\Programme auf. Daher wird bei der Installations standardmäßig der Ordner www.visatronic.de 11 Getting Started – VISASCOPE – Version 2.3 C:\Dokumente und Einstellungen bzw. C:\Benutzer\<name>\... vorgeschlagen. Auf Wunsch können Sie diesen jedoch bei der Installation ändern. Ausführbares Programm: Es gibt zwei Optionen, das GUI zu installieren: 1. Sie haben auf dem PC das Programm TCL/TK von Aktive State nicht installiert. Dann können Sie die gepackte Version des GUI als .exe Datei verwenden. In dieser Datei befindet sich der GUI Quellcode zusammen mit den Basisfunktionen von TCL/TK. Diese gepackte Version des GUI ist allerdings langsamer, als Option 2. 2. Installieren Sie zunächst auf dem PC das Programm TCL/TK von Active State ( http://www.activestate.com/ : Active TCL ). Dann können Sie bei der Installation des GUI angeben, dass Sie das installierte Programm TCL/TK benutzen wollen. Damit läuft das GUI ca. doppelt so schnell wie bei Option 1. Aero Design unter VISTA und Windows 7: In VISTA und Windows 7 besteht die Möglichkeit für die Desktopdarstellung das Aero-Design zu verwenden. Damit man den Oszilloskop-Bildschirm in eine Bilddatei abspeichern kann, muss der sog. Aero-Glass Effekt, also die transparente Darstellung des Fensterrahmens abgeschaltet werden. Diesen kann man mit dem Aero-Glass Switcher ein und ausschalten. (Vorsicht! es genügt nicht, bei der Einstellung des Desktops die Transparenz zu deaktivieren). Bei der Installation des GUI werden drei verschiedene Aero-Glass Switcher angeboten. Am besten installieren Sie alle drei und wählen Sie den aus, der Ihren Vorstellungen am besten entpricht. Die Fa. Windows 7 Tuning hat freundlicherweise ihren Aero-Glass Switcher zur Verfügung gestellt. Die neueste Version kann unter http://www.windows7-tuning.de heruntergeladen werden. Falls Sie das klassische Destop Design verwenden oder auch eine frühere Windows Version benutzen, ist der Aero-Glass Switcher nicht erforderlich. 2.2.2 Installation des USB-Treibers (virtueller COM-Port-Treiber) Bitte installieren Sie den USB-Treiber erst dann, wenn Sie die PC-Software (GUIInterface) installiert haben. Verbinden Sie das VISASCOPE mit dem PC über das USB-Kabel. Das VISASCOPE muss jetzt noch nicht über das Netzteil mit Spannung versorgt werden. Der PC erkennt die neue Hardware und beginnt mit der Installation des Treibers. Auf keinen Fall sollten Sie automatisch installieren lassen: Auf der CD befinden sich der USB-Treiber im Ordner USB_Driver. Diesen Ordner geben Sie bei der www.visatronic.de 12 Getting Started – VISASCOPE – Version 2.3 Installation an, sobald Sie danach gefragt werden. Die folgenden Screenshots zeigen Ihnen, wie bei der Installation des Treibers vorgegangen werden muss: Nach Anschliessen des USBKables wird man das Menü vorfinden, wie rechts gezeigt ist. Wählen Sie den unteren Auswahlpunkt. Beim nächsten Menüpunkt müssen Sie angeben, dass Sie die Software von einer bestimmten Liste oder Quelle nehmen wollen. Lassen Sie unter keinen Umständen automatisch suchen! Beim nächsten Menüpunkt gehen Sie auf Durchsuchen . Sie müssen genau den Ordner angeben, in dem sich der gewünschte Treiber befindet. www.visatronic.de 13 Getting Started – VISASCOPE – Version 2.3 Sie müssen daher den Ordner USB_Driver angeben. Je nach Einstellungen im Betriebssystem und USB-Treiberinstallationen kann manchmal nach der Datei FTSER2K.SYS gefragt werden. In diesem Fall müssen Sie den Ordner USB_Driver\i386 angeben, in dem sich die gewünschte Datei befindet. Dann mit OK bestätigen. Während der Installation wird nebenstehende Warnung ausgegeben. Ignorieren Sie diese, und setzen Sie die Installation fort. www.visatronic.de 14 Getting Started – VISASCOPE – Version 2.3 Damit sollte die Treiberinstallation abgeschlossen sein. Je nach Betriebssystem und Einstellung kann es vorkommen, dass WINDOWS den Treiber nochmal installieren will. Dann wiederholen Sie die Prozedur. Auch dann ist es wichtig, WINDOWS nie automatisch nach den Treibern suchen zu lassen, sondern immer wie oben gezeigt den Pfad anzugeben, in dem sich der USB-Treiber befindet. 2.3 Installation unter LINUX Die Installationssoftware ist für die Betriebssysteme Ubuntu und openSUSE ausgelegt. Bei anderen Betriebssystemen muss die Einbindung der USB-Schnittstelle manuell erfolgen. 2.3.1 Installation der PC-Software (GUI-Interface) Die graphische Oberfläche auf dem PC (Graphic-User-Interface = GUI) ist in der Programmiersprache TCL/TK, Version 8.5 erstellt. Zur Installation sind nur einige Dateien und Unterordner nötig, die mit dem angegebenen Installationsprogramm einfach kopiert werden können. Zur Installation ist es nötig, Administratorrechte zu besitzen, sonst können Sie die Installation nicht durchführen. Starten Sie durch Doppelklicken das Programm setup-for-linux. Gegebenenfalls muss durch das Kommando chmod 755 setup-for-linux diese Datei ausfürbar gemacht werden. Nach Auswählen der gewünschte Sprache werden Sie interaktiv durch die Installation geführt. Es ist üblich, die Installation von Programmen im Ordner www.visatronic.de 15 Getting Started – VISASCOPE – Version 2.3 /opt vorzunehmen. Auf Wunsch können Sie diesen jedoch bei der Installation ändern. Im Installationsordner wird die Directory Visatronic angelegt. Unter diesem Ordner wird die Software in den Ordner visascope-versionsnummer abgelegt. Beim Installieren neuer Versionen werden die alten Versionen nicht glöscht. Wenn gewünscht, muss man dies manuell löschen. Ausführbares Programm: Es gibt zwei Optionen, das GUI zu installieren: 1. Sie haben auf dem PC nicht TCL/TK von Aktive State installiert. Dann können Sie die gepackte Version des GUI als .exe Datei starten. In dieser Datei befindet sich der GUI Quellcode zusammen mit den Basisfunktionen von TCL/TK. Diese gepackte Version des GUI ist allerdings langsamer, als Option 2 2. Sie installieren zunächst auf dem PC das Programm TCL/TK von Active State ( http://www.activestate.com/ ). Meistens benötigen Sie die Installation nicht, da in vielen LINUX-Distributionen TCL/TK bereits installiert ist. Dann können Sie im Installationsprogramm angeben, dass Sie das installierte Programm TCL/TK benutzen wollen. Damit läuft das GUI ca. doppelt so schnell wie bei Option 1 Um das VISASCOPE von der Konsole aus starten zu können, werden unter /usr/bin entsprechende symbolische Links angelegt. Mit den Kommandos vs oder Visascope oder visascope lässt sich das VISASCOPE von der Konsole aus starten. 2.3.2 Konfiguration der USB-Schnittstelle Im Linux-Kernel ab Version 2.6.31 ist der USB-Treiber bereits installiert. Das VISASCOPE hat jedoch eine eigene PID (VID=0403 PID=d4f2). Diese muss über eine entsprechenden Konfigurationsdatei dem Betriebssystem mitgeteilt werden. Das Setup-Programm nimmt diese Konfiguration vor. Leider unterscheiden sich die verschiedenen Linux-Distributionen gerade in diesem Punkt, so dass im Folgenden der Mechanismus dieser Einbindung beschrieben ist, um im Falle eines Problems diese Einbindung manuell vornehmen zu können. Zur Einbindung der VISASCOPE PID muss beim Systemstart das modul ftdi_sio geladen werden. Diesem Modul muss die zusätzliche PID des VISASCOPE mitgeteilt werden. Folgende Maßnahmen sind nötig, für die allerdings Administratorrechte benötigt werden: • im Ordner /etc/modprobe.d ist die Textdatei visascope.conf zu erstellen. Diese enthält eine einzige Zeile mit dem Inhalt options ftdi_sio vendor=0x0403 product=0xd4f2 www.visatronic.de 16 Getting Started – VISASCOPE – Version 2.3 • Die USB-Konfiguration soll beim Systemstart aktiviert werden. Hierzu sind je nach Betriebssystem - folgende Dateien zu ergänzen: Ubuntu: die Datei /etc/modules erhält zwei zusätzliche Zeilen: # visascope ftdi_sio openSUSE: die Datei /etc/configsys/kernel enthält eine Zeile: MODULES_LOADED_ON_BOOT="" . Möglicherweise stehen zwischen den beiden Anführungszeichen bereits andere Module. Diese müssen bestehen bleiben. Man ergänzt (einen evtl. bereits bestehenden Eintrag) durch ftdi_sio, so dass diese Zeile dann z.B. MODULES_LOADED_ON_BOOT="ftdi_sio" (ohne weitere Module) lautet. Bei mehreren Modulen müssen diese durch Leerzeichen abgetrennt sein. Man kann diesen Eintrag auch mit dem Systemeditor vornehmen: Yast => System => /etc/sysconfig-Editor => System => Kernel => MODULES_LOADED_ON_BOOT. Dort den Namen des Moduls (ftdi_sio) eintragen. • Nachdem die Datei visascope.conf im Ordner /etc/modprobe.d erzeugt wurde, kann man mit dem Kommando modprobe ftdi_sio das Laden des Mouls ftdi_sio sofort vornehmen und muss nicht das System erst herunterfahren. Ubuntu 14.04 (Trusty Tahr): Falls in Ubuntu 14.04 die USB-Schnittstelle nicht erkannt wird, kann man in der Datei /etc/rc.local die Zeile echo 0403 d4f2 >/sys/bus/usb-serial/drivers/ftdi\_sio/new\_id einfügen. Damit wird in der Datei /sys/bus/usb-serial/drivers/ftdi_sio/new_id die Vendor-ID und Product-ID eingefügt. Leider genügt es nicht, VID und PID mit dem Editor einfach in /sys/bus/usbserial/drivers/ftdi_sio/new_id einzufügen, da diese Datei bei jedem User-Start neu beschrieben wird. Das entsprechende Kommando in der Datei /etc/rc.local sorgt dafür, dass bei jedem Login diese Datei neu beschrieben wird und die Vendor und Produkt-ID dann zur Verfügung steht. www.visatronic.de 17 Getting Started – VISASCOPE – Version 2.3 2.4 Anschließen des Netzteils Auf der Rückseite des VISASCOPE ist eine DC-Stiftbuchse vorgesehen, an die das Steckernetzteil (13V DC, 1A ) angeschlossen werden kann. Achten Sie darauf, dass der Mittelstift mit dem Pluspol der Spannung verbunden ist. Falls Sie die Polarität vertauschen, wird die Spannung kurzgeschlossen, so dass das Netzteil zerstört werden kann. 2.5 Dokumentation verschiedene Beschreibungen befinden sich im Ordner docu: • VISASCOPE _Programmers_manual.pdf (Beschreibung der Schnittstelle in englisch, Diese Dokumentation ist notwendig für diejenigen, die das VISASCOPE über eigene Software ansteuern wollen) • VISASCOPE _beschreibung.pdf (Beschreibung der Anschlüsse des VISASCOPE und technische Dokumentation) Sie benötigen den Acrobat-reader, Version 5.0 oder höher, um diese Dateien zu lesen. • Unter WINDOWS sind diese Dateien im Programmmenü zugänglich • Unter LINUX stehen diese Dokumente im Installationsordner unter visascope-versionsnummer/docu . Also z.B. in /opt/Visatronic/visascope-2.3/docu www.visatronic.de 18 Getting Started – VISASCOPE – Version 2.3 3 3.1 VISASCOPE - Informations Génerales Logiciel GUI La surface graphique sur l’ordinateur (Graphic-User-Interface = GUI) est écrit en langue de programmation TCL/TK, Version 8.5 . Pour installer le logiciel, il faut seulement copier quelques fichiers et classeurs. Le logiciel d’installation le fait pour vous automatiquement. La version actuelle du logiciel peur être téléchargée de http://www.eit.hs-karlsruhe.de/visascope/. 3.2 Installation sous WINDOWS Les systèmes d’exploitation à partier de WINDOWS 2000 sont possible (XP, VISTA, WINDOWS 7). 3.2.1 Installation du logiciel sur l’ordinateur (GUI-Interface) Il n’est pas nécessaire d’entrer dans le Registry, quand-même, quelques ICON sont généres dans le desktop et dans le classeur des programmes pour faciliter l’utilisation. Démmarez l’installation de GUI avec un double-click de setup-for-windows.exe. Après la sélection de langue, le programme vous guide dans l’installation. Normalement, les programmes sont installées dans le classeur C:\Programme (òu C:\Programm Files) . Dans le système VISTA òu Windows 7, on a souvent des problèmes avec la pérmission d’écrire dans le classeur C:\Programme. www.visatronic.de 19 Getting Started – VISASCOPE – Version 2.3 C’est pourquoi, le classeur C:\Dokumente und Einstellungen respectivement C:\user\<username>\... en Windows 7 est proposé. Mais vous pouvez choisir un autre classeur, si vous le souhaitez. logiciel executable: il y a deux version d’installation: 1. Vous n’avez pas installé le programme TCL/TK de Aktive State. En ce cas, vous pouvez vous servire de la version emballée (wrapped version), qui est disponible comme fichie executable (visascope.exe). Dans ce fichier se trouve le code de source ensemble aved les fonctions fundamentales de TCL/TK. Cette version emballée de GUI a besoin plus de temps d’execution par rapport à l’option 2. 2. Installez sur votre ordinateur le programme TCL/TK de Active State ( http://www.activestate.com/ : Active TCL ). Pendant l’installation de GUI, vous pouvez indiquer, que vous souhaitez l’usage de TCL/TK installé. Dan ce cas, le temps d’execution est environ deux fois plus vite que l’option 1. Aero Design en VISTA et Windows 7: En VISTA et Windows 7 vous avez l’option de utiliser le Aero-Design. Afin que vous pourriez sauvegarder l’écran de l’oscilloscope dans un fichier d’image (.jpg .png ...), l’effect Aero-Glass (ça veut dire la vue transparente des cadres de fenêtres) doit être éteint. Vous pouvez allumer et éteindre ce effet aved l’aide de Aero-Glass Switcher. (Attention! Il ne suffit pas d’ éteindre la transparence eans l’ajustement de desktop). Pendant l’installation de GUI trois Aero-Glass Switcher sont offert. Il est recommendable d’installer les troi et vous choisissez la version qui vous plaît. Windows 7 Tuning nous a mis à la disposition son Aero-Glass Switcher. La plus nouvelle version est téléchargeable sur http://www.windows7-tuning.de. En cas vous utilisez le surface classique òu vous utilisez une ancienne version de Windows, le Aero-Glass Switcher n’est pas necessaire. 3.2.2 Installation du USB-Driver (Virtual COM-Port-Driver) Il faut installer le logiciel de PC (GUI-Interface) avant que vous installez le driver USB. Branchez le VISASCOPE avec l’ordinateur en utilisant le cable USB. Le VISASCOPE ne doit pas être alimenté avec le block d’alimentation. L’ordinateur reconnait le VISASCOPE et commanec d’installer le USB-driver. En tout cas, il faut absolument éviter de chercher le driver automatiquement: Vous trouvez le USB-driver dans le classeur USB_Driver. Il faut donner le nom de ce classeur pendant ’installation, si le procecure d’installation le demande. L’illustration suivante montre l’installation correcte. www.visatronic.de 20 Getting Started – VISASCOPE – Version 2.3 Après la connection du VISASCOPE avec l’ordinateur, vous trouvez le menu, motré a la droite. Vous devez choisir le sélection en bas (par utiliser le WINDOWS-update) Dans le menu prochain, il est nécessaire de choisir le USBdriver d’une certain source Évitez an tout cas de chercher automatiquement! Le menu prochain vous donne la possibilité de choisir le classeur avec le driver. www.visatronic.de 21 Getting Started – VISASCOPE – Version 2.3 Specifiez le classeur USB_Driver . Dépendant du système et de la configuration USB, il peut passer, que le système vous demande de specifier la location du fichier FTSER2K.SYS . En ce cas, vous devez specifier le classeur USB_Driver\i386 dans lequel se trouve ce fichier. Pendant l’installation vous obtenez l’avertissement suivante. Continuez l’installation et ignorez cet avertissement www.visatronic.de 22 Getting Started – VISASCOPE – Version 2.3 Maintenant, l’installation du driver USB est fini. Dépendant du système d’opération, il peut passer, que le system vous demande d’installer encore une fois. Dans ce cas, repetez l’installation. N’oubliez pas de specifier toujour le classeur de Driver (USB_Driver ) et évitez la recherche automatique. 3.3 Installation sous LINUX Le logiciel est prévu pour les systèmes Ubuntu et openSUSE. En cas d’autres systémes d’exploitation, la connection USB doit être installée individuellement. 3.3.1 Installation du logiciel sur l’ordinateur (GUI-Interface) La surface graphique sur l’ordinateur (Graphic-User-Interface = GUI) est écrit en langue de programmation TCL/TK, Version 8.5 . Pour installer le logiciel, il faut seulement copier quelques fichiers et classeurs. Le logiciel d’installation le fait pour vous automatiquement. Pour l’installation, il faut que vous aviez des droits d’administration. Démmarez l’installation de GUI avec un double-click de setup-for-linux. Eventuellement il faut changer le mode de fichier avec le commande chmod 755 setup-for-linux pour faire un fichier executable. Après la selection de la langue, le logiciel vous guide pendant l’installation. il est recommendable, d’installer le logiciel dans le classeur /opt. Mais vous pouvez choisir un autre classeur, si vous le souhaitez. Dans le classeur d’installation, le classeur Visatronic est généré. Sous ce classeur, on trouve un autre classeur visascope-numéro-de-version dans lequel le logiwww.visatronic.de 23 Getting Started – VISASCOPE – Version 2.3 ciel est copié. Si vous installez des nouvelles version, les anciennes versions ne sont pas éffacés. Sie vous desirez, effacez les aciennes versions manuellement. logiciel executable: il y a deux version d’installation: 1. Vous n’avez pas installé le programme TCL/TK de Aktive State. En ce cas, vous pouvez vous servire de la version emballée (wrapped version), qui est disponible comme fichie executable (visascope.exe). Dans ce fichier se trouve le code de source ensemble aved les fonctions fundamentales de TCL/TK. Cette version emballée de GUI a besoin plus de temps d’execution par rapport à l’option 2. 2. Installez sur votre ordinateur le programme TCL/TK de Active State ( http://www.activestate.com/ : Active TCL ). Normallement, dans les distributions de Linux, TCL/TK est deja installé et vous n’êtes pas obligés de l’installer. Pendant l’installation de GUI, vous pouvez indiquer, que vous souhaitez l’usage de TCL/TK installé. Dan ce cas, le temps d’execution est environ deux fois plus vite que l’option 1. Pour démmarer le VISASCOPE à partir d’un terminal, sous /usr/bin vous trouvez les links symboliques. Avec les commandes vs où Visascope où visascope vous pouvez demmarer le VISASCOPE . 3.3.2 Configuration de connnection USB dans le Linux-Kernel à partir de version 2.6.31 le USB-driver est déjà installé. Le VISASCOPE a un propre nombre PID (VID=0403 PID=d4f2). Ce PID doît être communique au USB-driver par un fichier de configuration. Le logiciel de setup fait ce configuration. Malheureusement, les different versions de Linux traitent ce configuration dans different manières. C’est pourqui dans les explanations suivantes, vous trouvez une déscription détailée pour que vous pouviez vous débrouiller en cas de problèmes. Pour implemnenter le PID du VISASCOPE PID, le modul ftdi_sio doît être initialiser pendant le démmarage du système. Les action suivantes sond neccesaires (droits d’administrations) • Dans le classeur /etc/modprobe.d vous ajoutez le ficher de configuration visascope.conf. Ce fichier a une seule ligne: options ftdi_sio vendor=0x0403 product=0xd4f2 www.visatronic.de 24 Getting Started – VISASCOPE – Version 2.3 • Le configuration de PID doît être activé pendant le démmarage du système. Dépendant du système d’operation, il faut und modification des fichers suivantes: Ubuntu: Vous ajoutez dans le fichier /etc/modulesdeux lignes : # visascope ftdi_sio openSUSE: Le fichier /etc/configsys/kernel contient une ligne: MODULES_LOADED_ON_BOOT="" . Probablement, yous trouvez entre les deux guillemets déjà autre modules. Laissez ces modules. N’éffacez pas ces entrées. Vous ajoutez le modul ftdi_sio, afin que cett ligne se présente comme MODULES_LOADED_ON_BOOT="ftdi_sio" (sans modules supplementaires). Plusieur modules doivent être séparées par espace. Alternativement, vous pouvez faire cette modification avec le System-Editor: Yast => System => /etc/sysconfig-Editor => System => Kernel => MODULES_LOADED_ON_BOOT. Ajoutez le module (ftdi_sio). • Si le fichier visascope.conf dans le classeur /etc/modprobe.d est généré, vous pouvez démmarer le module avec le commande modprobe ftdi_sio sans re-démmarer le système.. Ubuntu 14.04 (Trusty Tahr): Souvent, la connection USB n’est pas reconnue en Ubuntu 14.04. En ce cas, vous inserez la ligne echo 0403 d4f2 >/sys/bus/usb-serial/drivers/ftdi\_sio/new\_id dans le fichier /etc/rc.local. Avec ce commande, le fichier /sys/bus/usb-serial/drivers /ftdi_sio/new_id est généré, qui contient le vendor et product ID. Malheureusement, il ne suffit pas de inserer le VID and PID avec l’aide d’un éditeur de texte dans le fichier /sys/bus/usb-serial/drivers/ftdi_sio/new_id. Ce fichier est géneré pendant le procedure de login. Le commande dans le fichier /etc/rc.local assures l’actualisation pendent la procedure de login. 3.4 Connection de bloc d’alimentation En derrière de VISASCOPE , vous trouvez le prise DC, òu on peut brancher le block d’alimentation (13V DC, 1A ). Faites attention, que le borne milieux de la fiche est le borne positive. www.visatronic.de 25 Getting Started – VISASCOPE – Version 2.3 Sie vous interchangez la polaritée, la tension sera court-circuité et le block d’alimentation sera détruit. www.visatronic.de 26 Getting Started – VISASCOPE – Version 2.3 3.5 Documentation Vous trouverez dans le classeur docu les documentations: • VISASCOPE _Programmers_manual.pdf (Déscription d’interface en anglais, neaessaire pour des utilisateurs, qui desirent de commander le VISASCOPE avec leurs propre logiciel) • VISASCOPE _description.pdf (Déscriptions des bornes de VISASCOPE et explanations techniques) Vous avez besoin de Acrobat-reader, au moins version 5.0, pour lire les documents. • Sous WINDOWS, ces fichiers sont disponible dans le menu de start: Start -> Programs -> Visascope • Sous LINUX, ces fichiers se trouvent dans le classeur visascope-versionsnummer/docu . Par example en /opt/Visatronic/visascope-2.3/docu www.visatronic.de 27