CANwizard ActiveX: Difference between revisions

From CANopen-Lift
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by the same user not shown)
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]]  


'''„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.'''
'''„Product code“ and „VendorId” are formatted hex decimally for 8 digits, for example, „000000F8\00000101“ for the CAP by BÖHNKE + PARTNER GmbH.'''


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


== Hinweise zur Entwicklung ==
== Information regarding development ==
Offiziell wird diese Schnittstelle erst Bestandteil der Version 1.6 des CANwizard<sup>®</sup> sein. Sie ist aber zu Entwicklungszwecken bereits erhältlich. Vorraussetzungen zur Implementierung sind Kenntnisse zur Programmierung von Windows<sup>®</sup>-Anwendungen und Komponenten unter Visual C++, sowie Kenntnisse über HTML/XML zur Erstellung der Onlinehilfe.
Officially this interface is going to be part of version 1.6 of the CANwizard<sup>®</sup>. It is, however, available for development purposes. Prerequisites for implementation is knowledge in programming Windows<sup>®</sup>-applications and components under Visual C++, as well as knowledge of HTML/XML to create the online help.


Den aktuellen Entwicklungsstand, neue Feature und Fehlerkorrekturen können unter folgendem externen Link eingesehen werden:
The current state of development, new features and corrections can be seen at the following external link:


[http://canwizard.de/de/dokumentation-allgemein CANwizard<sup>®</sup> Versionsübersicht]
[http://canwizard.de/de/dokumentation-allgemein CANwizard<sup>®</sup> Version Overview]


== Schnittstellendokumentation ==
== Interface Documentation ==
Die Dokumentation der ActiveX-Schnittstelle wird nun online auf der Webseite des Produktes gepflegt. Sie finden den aktuellen Stand unter dem folgenden Link: [http://canwizard.de/de/Dokumentation/CANwizard-ActiveX-Schnittstelle canwizard.de/de/Dokumentation/CANwizard-ActiveX-Schnittstelle]
The documentation of the ActiveX-interface will be kept online at the website of the product. You can find the current status at: [http://canwizard.de/en/ActiveX-interface_for_device_specific_dialog_views]


Für Rückfragen stehen Ihnen die Ansprechpartner von [[Böhnke & Partner GmbH |Böhnke + Partner GmbH]] gern zur Verfügung. Die Kontaktdaten finden Sie auf folgender Seite: [http://canwizard.de/de/Impressum CANwizard<sup>®</sup> Ansprechpartner]
For further questions the contact persons of [[Böhnke & Partner GmbH |Böhnke + Partner GmbH]] are available. Contact information can be found at: [http://canwizard.de/en/Impressum CANwizard<sup>®</sup> Contacts]


== Lizenzhinweise ==
== License Information ==
Die Schnittstellenbeschreibung, die Header-Datei und das Beispielprogramm stellt der Hersteller unter der freien Lizenz [http://creativecommons.org/licenses/by-sa/3.0/ CC-by SA 3.0] zur Verfügung.  
The interface description, the header file and the example program are available from the manufacturer under the free license [http://creativecommons.org/licenses/by-sa/3.0/ CC-by SA 3.0].  


= Weblinks =  
= Weblinks =  
Line 72: Line 73:
*[http://canwizard.de/de/Download/ActiveX-Dateien Download der die Schnittstellenbeschreibung, der Header-Datei und eines Beispiel-PlugIns]
*[http://canwizard.de/de/Download/ActiveX-Dateien Download der die Schnittstellenbeschreibung, der Header-Datei und eines Beispiel-PlugIns]
*Zum Konzept von ActiveX-Steuerelementen, finden Sie Informationen im: [http://msdn.microsoft.com/workshop/components/activex/activex_node_entry.asp MSDN Workshop ActiveX Node Entry]
*Zum Konzept von ActiveX-Steuerelementen, finden Sie Informationen im: [http://msdn.microsoft.com/workshop/components/activex/activex_node_entry.asp MSDN Workshop ActiveX Node Entry]
[Kategorie: Produkt]

Latest revision as of 12:23, 25 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

„Product code“ and „VendorId” are formatted hex decimally for 8 digits, for example, „000000F8\00000101“ for the CAP by BÖHNKE + PARTNER GmbH.

Bild:CANwizard-ActiveX-Registry-Tree.png

Information regarding development

Officially this interface is going to be part of version 1.6 of the CANwizard®. It is, however, available for development purposes. Prerequisites for implementation is knowledge in programming Windows®-applications and components under Visual C++, as well as knowledge of HTML/XML to create the online help.

The current state of development, new features and corrections can be seen at the following external link:

CANwizard® Version Overview

Interface Documentation

The documentation of the ActiveX-interface will be kept online at the website of the product. You can find the current status at: [1]

For further questions the contact persons of Böhnke + Partner GmbH are available. Contact information can be found at: CANwizard® Contacts

License Information

The interface description, the header file and the example program are available from the manufacturer under the free license CC-by SA 3.0.

Weblinks