CANwizard ActiveX: Difference between revisions

From CANopen-Lift
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[de:CANwizard ActiveX]]
= ActiveX-interface for device-specific dialogue views in CANwizard<sup>®</sup> =
= ActiveX-interface for device-specific dialogue views in CANwizard<sup>®</sup> =
== General Information ==
== General Information ==
Line 19: Line 20:
* Provision whether it is a ''selection based adaptor''(for example a modem)
* Provision whether it is a ''selection based adaptor''(for example a modem)
* Provision of the error status of the CANopen-connection (for example Error Passive)
* Provision of the error status of the CANopen-connection (for example Error Passive)
* Bereitstellung der verwendeten EDS-Datei und deren Version
* Provision of the EDS-file used and of its version
* Einbindung des Steuerelementes in den Installationsvorgang des CANwizards
* Incorporating the control element into the installation procedure of the CANwizard
* Senden und Empfangen von SDO-Nachrichten
* Sending and receiving SDO-messages
* Zugriffsfunktionen auf das Objektverzeichnis (Lesen, Schreiben)
* Access function for object dictionary (read and write)
* Zugrifffunktionen für NMT-Zustand und Kommandos
* Access function for NMT status and commands
* Zugriffsfunktionen für Error-Control
* Access function for Error-Control
* Registrierung für den Empfang von PDO-Nachrichten
* Registration for receiving PDO messages
* Aufruf eines fertigen Dialoges zur Parametrierung eines virtuellen Ein-/Ausgangs
* Instigating a finished dialogue for parameterisation of a virtual in/output


==== Funktionen, die das Steuerelement bereitstellt ====
==== Functions made available by the control element ====
Organisatorische Funktionen:
Organisational Functions:
* Methoden zur Erstellung und Zerstörung des Steuerelementes
* Methods to create and destroy the control elements
* Methode zur Abfrage auf „Dokument geändert“
* Method for the query "document changed"
* Methode, um das Steuerelement „offline“ zu schalten
* Method, to switch the control elemenet to "offline"
* Onlinehilfe in deutsch und englisch
* Online help in German and English
* Registrierung des Steuerelementes unter „HKEY_LOCALE_MACHINE\Software\CANopen\CANwizard\PlugIns\VendorId\ProductCode\ControlName“ mit folgenden Werten vom Typ „REG_SZ“:
* Registration of the control element under „HKEY_LOCALE_MACHINE\Software\CANopen\CANwizard\PlugIns\VendorId\ProductCode\ControlName“ with following values by type "REG_SZ":
** „CLSID“: GUID Kennung des Steuerelementes [Zeichenfolge], z. B. „{9E56BE61-C50F-11CF-00A0C90A90CE}“
** „CLSID“: GUID identification of the control element [string], e.g. „{9E56BE61-C50F-11CF-00A0C90A90CE}“
** „CLASSNAME“: Klassenname [Zeichenfolge], z. B. „TESTACTIVEX.TestActiveXCtrl.1“
** „CLASSNAME“: class name [string], e.g. „TESTACTIVEX.TestActiveXCtrl.1“
** „InternalName“: Interne Bezeichnung des Steuerelementes
** „InternalName“: Internal name of the control element
** „PrettyName_de“: Sichtbarer Steuerelementname in deutsch [Zeichenfolge]
** „PrettyName_de“: Visible name of the control element in German [string]
** „PrettyName_uk“: Sichtbarer Steuerelementname in englisch [Zeichenfolge]
** „PrettyName_uk“: Visible name of the control element in English [string]
** „ManufacturerName“: Herstellername und Webkontakt [Zeichenfolge]
** „ManufacturerName“: Name of the manufacturer and web contact [string]
** „Version“: Version des Steuerelementes [Zeichenfolge]
** „Version“: Version of the control element [string]
** „PhoneNumber“: Supportinformation in Form einer Telefonnummer
** „PhoneNumber“: Support information (phone number)
** „E-Mail“: Supportinformation in Form einer E-Mailadresse [Zeichenfolge]
** „E-Mail“: Support information (e-mail address) [string]


[[Bild:CANwizard-ActiveX-Registry.png]]  
[[Bild:CANwizard-ActiveX-Registry.png]]  

Revision as of 13:35, 24 June 2014

ActiveX-interface for device-specific dialogue views in CANwizard®

General Information

The software CANwizard® is a tool to diagnose and configure CANopen-networks. It also features special functions of the application profile CiA-417 (Lift Control). Further information is available at the product homepage. The ActiveX-interface offers access to SDO, PDO and NMT-services. Furthermore, a read and write access to the object dictionary is available. Further organisational methods serve as an adaptation of the interface to regional and language settings. The abstraction of the PC-CAN-adaptor used and the access to the CAN-Bus will be provided by the CANwizard® as well.


Range of Functions of the ActiveX-interface

thumb|ActiveX-interface in CANwizard

Functions made available by the container

Organisational Functions:

  • Provision of the language used by the container
  • Provision of the version and the product type of the container
  • Provision of name and type of the used adaptor
  • Provision of the current transmission speed
  • Provision whether it is a selection based adaptor(for example a modem)
  • Provision of the error status of the CANopen-connection (for example Error Passive)
  • Provision of the EDS-file used and of its version
  • Incorporating the control element into the installation procedure of the CANwizard
  • Sending and receiving SDO-messages
  • Access function for object dictionary (read and write)
  • Access function for NMT status and commands
  • Access function for Error-Control
  • Registration for receiving PDO messages
  • Instigating a finished dialogue for parameterisation of a virtual in/output

Functions made available by the control element

Organisational Functions:

  • Methods to create and destroy the control elements
  • Method for the query "document changed"
  • Method, to switch the control elemenet to "offline"
  • Online help in German and English
  • Registration of the control element under „HKEY_LOCALE_MACHINE\Software\CANopen\CANwizard\PlugIns\VendorId\ProductCode\ControlName“ with following values by type "REG_SZ":
    • „CLSID“: GUID identification of the control element [string], e.g. „{9E56BE61-C50F-11CF-00A0C90A90CE}“
    • „CLASSNAME“: class name [string], e.g. „TESTACTIVEX.TestActiveXCtrl.1“
    • „InternalName“: Internal name of the control element
    • „PrettyName_de“: Visible name of the control element in German [string]
    • „PrettyName_uk“: Visible name of the control element in English [string]
    • „ManufacturerName“: Name of the manufacturer and web contact [string]
    • „Version“: Version of the control element [string]
    • „PhoneNumber“: Support information (phone number)
    • „E-Mail“: Support information (e-mail address) [string]

Bild:CANwizard-ActiveX-Registry.png

„Productcode“ und „VendorId” sind hexadezimal auf 8 Stellen formatiert, also z. B. „000000F8\00000101“ für die CAP aus dem Hause BÖHNKE + PARTNER GmbH.

Bild:CANwizard-ActiveX-Registry-Tree.png

Hinweise zur Entwicklung

Offiziell wird diese Schnittstelle erst Bestandteil der Version 1.6 des CANwizard® sein. Sie ist aber zu Entwicklungszwecken bereits erhältlich. Vorraussetzungen zur Implementierung sind Kenntnisse zur Programmierung von Windows®-Anwendungen und Komponenten unter Visual C++, sowie Kenntnisse über HTML/XML zur Erstellung der Onlinehilfe.

Den aktuellen Entwicklungsstand, neue Feature und Fehlerkorrekturen können unter folgendem externen Link eingesehen werden:

CANwizard® Versionsübersicht

Schnittstellendokumentation

Die Dokumentation der ActiveX-Schnittstelle wird nun online auf der Webseite des Produktes gepflegt. Sie finden den aktuellen Stand unter dem folgenden Link: canwizard.de/de/Dokumentation/CANwizard-ActiveX-Schnittstelle

Für Rückfragen stehen Ihnen die Ansprechpartner von Böhnke + Partner GmbH gern zur Verfügung. Die Kontaktdaten finden Sie auf folgender Seite: CANwizard® Ansprechpartner

Lizenzhinweise

Die Schnittstellenbeschreibung, die Header-Datei und das Beispielprogramm stellt der Hersteller unter der freien Lizenz CC-by SA 3.0 zur Verfügung.

Weblinks

[Kategorie: Produkt]