CANoe VTP Protocol
Contents
1. General Offset 10 Size Type uint8 uint8 uint8 uint16 uint16 Field deviceStatus numberOflinterfa ces reserved identStringLengt h identificationStri ng 2 4 9 HardwareTypeRequest Command Manual CANoe VTP Protocol Description Delphi CRPU M3 7 Cohda MK3 8 Device status 0x01 device in use 0x02 device not configurable Number of WLAN interfaces Reserved byte Length of the identification string Identification string Hardware type The HardwareTypeRequest command is sent to the radio device by CANoe to request request the hardware type The radio device will answer with a HardwareTypeResponse command to provide information about the hardware type Offset 0 2 Size 2 2 Type uint16 uint16 Field commandSize commandCode 2 4 10 HardwareTypeResponse Command Description Size of command 4 Bytes kCommandCode_HardwareTypeReques t 0x000A Hardware type The HardwareTypeResponse command is sent to CANoe by the radio device This response command is the answer to a hardware type request by CANoe and provides information about the hardware type and number of WLAN channels Offset 0 2 16 Size 2 2 1 Type uint16 uint16 uint8 uint8 Field commandSize commandCode hardwareType numberOflinterfa ces Version 1 0 0 Description Size of command at least 12 Bytes kCommandCode_HardwareTypeRespon se 0x000B Hardware type unk2. frameControl Frame Control 2 2 uint16 commandCode Duration ID 4 6 uint48 addressOne Address 1 Destination 10 6 uint48 addressTwo Address 2 Source 16 6 uint48 addressThree Address 3 BSSID 22 2 uint16 sequenceControl Sequence Control 24 6 uint48 addressFour Address 4 Relay 30 2 uint16 qosControl Quality of Service Control 32 6 uint48 ethDestAddress Ethernet Destination Address MAC Header DA Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol Offset 38 44 46 2 3 Protocol Description Size 6 Type uint48 uint16 uint32 2 3 1 Structure of the Datagram General Field Description ethSrcAddress Ethernet Source Address MAC Header SA ethType Ethernet Type frameBody Frame Body 0 2314 frameChecksum FCS MAC Header frame checksum Communication via The communication between CANoe and the radio device is implemented through datagrams datagrams that are exchanged via UDP A datagram consists of the datagram header followed by one or more commands Offset 0 16 16 aa 16 aa bb Size 16 aa bb cc Field datagramHeader commandField1 commandField2 commandField3 Description Header First command Optional second command Optional third commands Optional further commands The datagram header and the individual commands are described in the following sections 2 3 2 Datagram Header Datagram header The datagram header consists of a signature a
3. Sweden Phone 46 31 764 7600 Fax 46 31 764 7619 mailto info se vector com http www vector com Version 1 0 0 Appendix A Address Table 27 Get more Information Visit our Website for gt News gt Products gt Demo Software gt Support gt Training Classes gt Addresses www vector com vector
4. commandSize Size of command 6 Bytes 2 2 uint16 commandCode kCommandCode AssignlFaceRequest 0x0016 4 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 selectionFlag Interface assignment 0x01 allocate device 0x00 deallocate device 2 4 22 AssigniFaceResponse Command Interface assignment The AssignlFaceResponse command is sent to CANoe by the radio device This response 20 command is the answer to an assign interface request by CANoe The radio device indicates the current assignment state of the chosen WLAN interface Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode AssignlFaceResponse Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol General Offset Size Type Field Description 0x0017 4 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 selectionFlag Interface assignment 0x01 device allocated 0x00 device deallocated 2 4 23 TransmitFrame Command Radio frame transmission The TransmitFrame command is sent to the radio device by CANoe This command triggers the transmission of the included IEEE 802 11p frame on the chosen interface Offset Size Type Field Description 0 2 uint16 commandSize Size of command 10 Bytes length of WLAN frame 2 2 uint16 commandCode kCommandCode_TransmitFrame 0
5. 1 0 0 Description Size of command 6 Bytes kCommandCode_ SelectRequest 0x0013 TCP IP port number 19 General Manual CANoe VTP Protocol 2 4 19 SelectResponse Command Device selection response The SelectResponse command is sent to CANoe by the radio device This command is the positive answer to a selection request by CANoe The radio device is now occupied by the requesting CANoe instance and its status is device in use for scan requests of other instances The occupation will be cancelled by a free selection command or the occurrence of a heartbeat event The sequence counter is reset Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_SelectResponse 0x0014 2 4 20 FreeSelection Command Free device selection The FreeSelection command is sent to the radio device by CANoe to cancel its allocation of the radio device The status device in use is cleared Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_FreeSelection 0x0015 2 4 21 AssigniFaceRequest Command Interface assignment The AssignlFaceRequest command is sent to the radio device by CANoe to allocate request or deallocate a WLAN interface of the radio device The radio device will answer with an AssignIFaceResponse command Offset Size Type Field Description 0 2 uint16
6. WLAN frame 2 4 25 Reboot Command Reboot device The Reboot command is sent to the radio device to bring the operating system to shut down the radio device and start again This command is not initiated by CANoe but may be used by automated scripts Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_ Reboot 0x003D 2 4 26 Halt Command Halt device The Halt command is sent to the radio device to bring the operating system to shut down the radio device to power off This command is not initiated by CANoe but may be used by automated scripts Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_Reboot 0x003E 2 4 27 Error Message Error status message The Error message is sent by the radio device or by CANoe depending on the origin of the failure If the error message is related to a command that cannot be processed the sequence number of the rejected datagram will be the error source If the error message is related to a WLAN interface the interface number will be the error source In any other case the error source is set to zero Offset 0 on B N 22 Size 2 IN IN IN Type uint16 uint16 uint16 uint16 uint64 Field commandSize commandCode errorCode errorSource errorDesc Version 1 0 0 Description Size of command 16 Bytes kCommandCode_ Er
7. WLAN interface Channel number Bandwidth MHz Bitrate Mbit s Transmission power dBm Reserved byte Channel parameter The ChannelParameterResponse command is sent to CANoe by the radio device response This command is the answer to a channel parameter request or channel parameter set command by CANoe and provides the current settings of the radio device on the chosen channel Offset Size Type Field Description 0 2 uint16 commandSize Size of command 10 Bytes 2 2 uint16 commandCode kCommandCode_ChannelParameterRe sponse 0x0012 4 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 channelNumber Channel number 6 1 uint8 bandWidth Bandwidth MHz 7 1 uint8 bitRate Bitrate Mbit s 8 1 uint8 transmissionPo Transmission power dBm wer 9 1 uint8 reserved Reserved byte 2 4 18 SelectRequest Command Device selection The SelectRequest command is sent to the radio device by CANoe to allocate the request radio device for exclusive communication with this CANoe instance A new TCP IP port is assigned for all further VTP communication recommended use of 0xC2C1 and the following according to the connection number of the radio device The radio device will answer with a SelectResponse command already on the new port to accept the connection with CANoe Offset Size Type 0 2 uint16 2 2 uint16 4 2 uint16 Vector Informatik GmbH Field commandSize commandCode portNumber Version
8. connection The protocol is derived from the CANoe FDX Fast Data eXchange protocol and enables CANoe to use common CCUs Car Communication Units to receive and transmit WLAN traffic The WLAN frames are standardized in the reference documents IEEE 802 11 2007 and ETSI ES 202 663 V1 1 0 2010 01 1 2 History VTP Protocol CANoe Description CANoe 7 6 First release of VTP feature CANoe 7 6 SP2 User description to identify radio device added 1 3 About this User Manual 1 3 1 Navigational Aids and Conventions To find information quickly Conventions This user manual provides you with the following navigational aids gt At the beginning of each chapter you will find a summary of the contents gt The header shows which chapter and paragraph you are located in gt The footer shows which version the user manual refers to The following two charts show the spelling and symbol conventions used in this manual Style Utilization bold Fields interface elements window and dialog names in the software Accentuation of warnings and notes OK Buttons are denoted by square brackets File Save Notation for menus and menu entries CANoe Legally protected proper names and side notes Source code _ File name and source code Hyperlink Hyperlinks and references lt Ctrl gt lt S gt Notation for keyboard shortcuts Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol Introduction Utilization Here
9. You can get through to our hotline by calling 49 711 80670 200 or you can send a problem report to the Vector Support 1 3 5 Registered Trademarks Registered All trademarks mentioned in this user manual including those registered to third trademarks parties are governed by the respective trademark laws and are the property of their respective owners All trademarks trade names or company names are or can be trademarks or registered trademarks of their particular owners All rights which are not expressly allowed are reserved Failure to explicitly note any given trademark within this user manual does not imply that a third party does not have rights to it gt Windows Windows XP Vista Windows 7 are trademarks of the Microsoft Corporation gt CANoe is a trademark of Vector Informatik GmbH 6 Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol 2 General This chapter contains the following information 2 1 Implementation Architecture Overview Radio Device Software Personal Computer Software 2 2 Protocol Properties UDP as Transport Foundation Data Types Radio Frame 2 3 Protocol Description Structure of the Datagram Datagram Header Command Field 2 4 Protocol Commands NOP Command Start Command Stop Command Heartbeat Command Statistic Command TimeAdjustment Command ScanRequest Command ScanResponse Command HardwareTypeRequest Command HardwareTypeResponse Command SoftwareVersionRequest Comma
10. Zi Plan Design a i Developmen 2 T aa DI 9 Pie _ N KD A Version 1 0 0 English vector Imprint Vector Informatik GmbH Ingersheimer Str 24 D 70499 Stuttgart The information and data given in this user manual can be changed without prior notice No part of this manual may be reproduced in any form or by any means without the written permission of the publisher regardless of which method or which instruments electronic or mechanical are used All technical information images drawings etc are protected by copyright law Copyright 2011 Vector Informatik GmbH Printed in Germany All rights reserved Manual CANoe VTP Protocol Table of Contents 1 Introduction 1 1 VTP ata Glance 1 2 History VTP Protocol 1 3 About this User Manual 1 3 1 Navigational Aids and Conventions 1 3 2 Certification 1 3 3 Warranty 1 3 4 Support 1 3 5 Registered Trademarks General 2 1 Implementation Architecture 2 1 1 Overview 2 1 2 Radio Device Software 2 1 3 Personal Computer Software 2 2 Protocol Properties 2 2 1 UDP as Transport Foundation 2 2 2 Data Types 2 2 3 Radio Frame 2 3 Protocol Description 2 3 1 Structure of the Datagram 2 3 2 Datagram Header 2 3 3 Command Field 2 4 Protocol Commands 2 4 1 NOP Command 2 4 2 Start Command 2 4 3 Stop Command 2 4 4 Heartbeat Command 2 4 5 Statistic Command 2 4 6 TimeAdjustment Command 2 4 7 ScanRequest Command 2 4 8 ScanRe
11. cription 0 2 uint16 commandSize Size of command 12 Bytes 2 2 uint16 commandCode kCommandCode_SetTime 0x0005 4 4 uint32 timeSeconds Seconds 8 4 uint32 timeMicroSecon Microseconds ds 2 4 7 ScanRequest Command Device scan request The ScanRequest command is broadcasted on port 0xC2C0 to the cable connected network by CANoe to gather information about all available radio devices All attached radio devices will answer with a ScanResponse command to show their status Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_ScanRequest 2 4 8 ScanResponse Command Device scan response 0x0008 The ScanResponse command is sent to CANoe by the radio device This command is the answer to a device scan requested by CANoe and provides information about the hardware type and number of WLAN channels The radio device indicates if it is already assigned by another CANoe and not available for the requesting one Offset Size 0 2 2 2 4 1 Vector Informatik GmbH Type uint16 uint16 uint8 Field commandSize commandCode hardwareType Version 1 0 0 Description Size of command 10 Bytes length of identification string kCommandCode_ScanResponse 0x0009 Hardware type unknown 0 NEC LinkBird MX 2 1 Denso WSU 01 2 NEC LinkBird MX 3 3 Delphi CRPU M2 4 Cohda MK2 5 Denso WSU 02 6 15
12. d is ignored Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode Start 0x0001 2 4 3 Stop Command Stop a measurement The Stop command is sent to the radio device by CANoe in order to stop a measurement The radio device ends to transmit all received IEEE 802 11p frames to CANoe If the measurement is not running the Stop command is ignored Vector Informatik GmbH Version 1 0 0 13 General Manual CANoe VTP Protocol Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_ Stop 0x0002 2 4 4 Heartbeat Command Heartbeat The Heartbeat command is sent to the radio device by CANoe cyclical It has to reach the radio device before expiration of the heartbeat time of about two seconds otherwise the radio device will switch to measurement stop by itself With every received heartbeat command the radio device starts a new countdown and transmits its statistic information to CANoe Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode Heartbeat 0x0003 2 4 5 Statistic Command Bus statistic 14 The Statistic command is sent to CANoe by the radio device to respond to the heartbeat command The timestamp is given in UNIX time format time zone set to UTC The channel values are accumulated in each h
13. d the size of the command By specifying the size of the command it is possible to insert additional fields later without this resulting in incompatibility with the protocol The CommandCode determines what type of command is being used measurement start frame transmission etc Command Size The command size refers to the size of the whole command field including the size field itself Therefore the size can never be less than four A value of zero or an odd value will lead to refuse the remaining commands of this datagram Offset Size Type Field Description 0 2 unit16 commandSize Size of this command in bytes 2 2 unit16 commandCode Command code 4 ne ne ve Optional further fields The individual commands are described in the following section 2 4 Protocol Commands 2 4 1 NOP Command No operation The NOP No operation command does nothing No action will be performed The reason for the existents of this command is just to get the protocol more robust against a zero copying failure into the datagram Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_Nop 0x0000 2 4 2 Start Command Start a measurement The Start command is sent to the radio device by CANoe in order to start a measurement The radio device begins to transmit all received IEEE 802 11p frames to CANoe according to its configuration If the measurement is already running the Start comman
14. eartbeat interval and reset to zero after transmission of the statistic command Offset Size Type Field Description 0 2 uint16 commandSize Size of command at least 14 Bytes 2 2 uint16 commandCode kCommandCode Statistic 0x0004 4 4 uint32 timeSeconds Seconds 8 4 uint32 timeMicroSecon Microseconds ds 12 1 uint8 numberOfiInterfa Number of WLAN interfaces ces 13 1 uint8 reserved Reserved byte 14 2 uint16 numberOfFrame Channel 1 Received frames sRxCh1 16 4 uint32 numberOfBytes Channel 1 Received bytes RxCh1 20 2 uint16 numberOfFrame Channel 1 Transmitted frames sTxCh1 22 4 uint32 numberOfBytes Channel 1 Transmitted bytes TxCh1 26 2 uint16 numberOfCollisi Channel 1 Collisions onsCh1 28 2 uint16 numberOfErrors Channel 1 Errors Ch1 30 ne dare DA Further channels Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol General 2 4 6 TimeAdjustment Command Time adjustment The TimeAdjustment command is sent to the radio device by CANoe in order to provide the PC time to the radio device for time adjustment This command is sent by CANoe before start of measurement The radio device evaluates the time difference between its internal clock and the PC time This difference time is added to the internal timestamp of each IEEE 802 11p frame to build the correct CANoe time The timestamp is given in UNIX time format time zone set to UTC Offset Size Type Field Des
15. eter request The ChannelParameterRequest command is sent to the radio device by CANoe to request the channel parameters of the radio device on the chosen channel The radio device will answer with a ChannelParameterResponse command to provide the channel information Offset Size Type Field Description 0 2 uint16 commandSize Size of command 6 Bytes 2 2 uint16 commandCode kCommandCode_ ChannelParameterRe quest 0x0010 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 reserved Reserved byte 2 4 16 ChannelParameterSet Command Channel parameter set 18 The ChannelParameterSet command is sent to the radio device by CANoe to set the channel parameters of the radio device on the chosen channel The radio device will answer with a ChannelParameterResponse command to provide the current settings If some of the requested parameters are not changeable the old values will remain The measurement units are declared in IEEE 802 11a Offset Size Type Field Description 0 2 uint16 commandSize Size of command 10 Bytes 2 2 uint16 commandCode kCommandCode_ChannelParameterSet Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol Offset Size Type 4 1 uint8 5 1 uint8 6 1 uint8 7 1 uint8 8 1 uint8 9 1 uint8 Field interfaceNumber channelNumber bandWidth bitRate transmissionPo wer reserved 2 4 17 ChannelParameterResponse Command General Description 0x0011 Number of
16. he protocol remains compatible until the major version number changes The sequence number enables you to recognize the loss of individual datagrams The datagrams are numbered sequentially from 0x0001 to Ox7FFF by the sender The special value 0x0000 is used to start a new counting sequence To end a counting sequence the current sequence number is ORed with the value 0x8000 The overwrap of sequence numbers goes from Ox7FFF auf 0x0001 Sequence number Description 0x0000 Special number 0x0000 indicates start of sequence counting 0x0001 0x0002 0x0003 Ox7FFF Overwrap of sequence number happens from value 0x0001 Ox7FFF to value 0x0001 0x0002 0x1233 0x1234 0x9235 Sequence number 0x1235 is combined with 0x8000 to indicate the end of sequence counting Sequence counting is an optional feature Use of the special value 0x8000 as sequence number indicates that no sequence counting is being used Both transmission directions CANoe to radio device radio device to CANoe have their dedicated sequence counter When a datagram is received that indicates the same sequence number in the range from 0x0001 to Ox7FFF as its predecessor it will be ignored If CANoe determines any sequence numbering errors in the incoming datagrams a warning is written to the CANoe Write window Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol General 2 3 3 Command Field Command Field Every command begins with the CommandCode an
17. lished via UDP sockets Unassigned radio devices do listen by default on port number 49856 OxC2C0 until they are selected by CANoe to get an additional port number e g 49857 0xC2C1 for the exchange of WLAN frames RMTPCD opens a raw socket in promiscuous mode to the IEEE 802 11p interface of the radio device to receive and transmit WLAN frames Hint The monitoring mode of the IEEE 802 11p interface offers a much more detailed analysis of the WLAN traffic but does not allow transmitting frames only receiving them Therefore this mode is not used by RMTPCD 2 1 3 Personal Computer Software CANoe DLL The implementation of the communication software on the PC is developed as DLL and part of CANoe The connection to the radio device is established via UDP sockets and starts with using port number 49856 OxC2C0 After selection of a radio device CANoe does assign an additional port number e g 49857 0xC2C1 and following numbers according to the number of radio devices already collected Every VTP communication is initiated by CANoe only Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol General PC Radio Device CANoe Car2x RMTPCD C2X Stack NI Linux Operating System gt Driver Ethernet CAN RS232 802 11p Figure 1 System Design 2 2 Protocol Properties 2 2 1 UDP as Transport Foundation UDP protocol The protocol is based on the UDP protocol IPv4 UDP is a
18. nd SoftwareVersionResponse Command RadioMAC ID Request Command RadioMAC ID Response Command ChannelParameterRequest Command ChannelParameterSet Command ChannelParameterResponse Command SelectRequest Command SelectResponse Command FreeSelection Command AssignlFaceRequest Command AssignlFaceResponse Command TransmitFrame Command ReceiveFrame Command Reboot Command Halt Command Error Message Vector Informatik GmbH Version 1 0 0 General page 8 page 9 page 11 page 13 General Manual CANoe VTP Protocol 2 1 Implementation Architecture 2 1 1 Overview System Design To get CANoe talking IEEE 802 11p it needs to have access to a radio device for transmission and reception of WLAN frames This radio device is connected to the PC running CANoe via Ethernet IEEE 802 3 The communication protocol is based on TCP IP using the user datagram protocol UDP to exchange commands with VTP The VTP protocol is handled by different software implementations on the PC and the radio device for a schematic see Figure 1 2 1 2 Radio Device Software RMTPCD The remote service software of the radio device is implemented as a background process daemon running on a Linux operating system The name is built by the acronym RMTPCD which stands for Remote Packet Capture Daemon To get a good communication responsiveness of the remote service software the process is divided into several threads POSIX The connection to CANoe is estab
19. nown 0 NEC LinkBird MX 2 1 Denso WSU 01 2 NEC LinkBird MX 3 3 Delphi CRPU M2 4 Cohda Mk2 5 Denso WSU 02 6 Delphi CRPU M3 7 Cohda MK3 8 Number of WLAN interfaces Vector Informatik GmbH Manual CANoe VTP Protocol Offset 6 Size 2 4 n Type Field uint16 capabilityBits uint32 vendorldWlan 2 4 11 SoftwareVersionRequest Command General Description Radio device feature list 0x01 genuine MAC header 0x02 RX TX counter 0x04 error counter 0x08 checksum FCS 0x10 accurate time e g GPS DCF77 Radio Chip Manufacturer Software version The SoftwareVersionRequest command is sent to the radio device by CANoe to request request the software version The radio device will answer with a SoftwareVersionResponse command to provide information about the software version Offset Size Type Field Description 0 2 uint16 commandSize Size of command 4 Bytes 2 2 uint16 commandCode kCommandCode_SoftwareVersionRequ 2 4 12 SoftwareVersionResponse Command est 0x000C Software version The SoftwareVersionResponse command is sent to CANoe by the radio device response This command is the answer to a software version request by CANoe and provides information about the software version Offset 0 2 Size 2 2 Type uint16 uint16 uint8 uint8 uint8 uint8 Field commandSize commandCode softwareMainVe rsion softwareSubVer sion sof
20. nteger gt int16 2 Byte signed integer gt uint16 2 Byte unsigned integer gt int32 4 Byte signed integer gt uint32 4 Byte unsigned integer gt int48 6 Byte signed integer gt uint48 6 Byte unsigned integer gt int64 8 Byte signed integer gt uint64 8 Byte unsigned integer gt float 4 Byte floating point gt double 8 Byte floating point gt string null terminated ASCII character string gt bytearray sequence of individual data bytes The data types are encoded for the network architecture integer values use Big Endian as the byte sequence signed integer types use the 2 s complement and floating point values use IEEE format Strings are made up of single byte ASCII characters and are always null byte terminated This corresponds to the string format from the C programming language Bytearrays go along with a length value indicating the number of data bytes used in the array For the definition of data sets each set is assigned a fixed offset value in bytes You have to ensure that data sets do not overlap in the memory layout 2 2 3 Radio Frame IEEE 802 11p frame The IEEE 802 11p radio frame consists of the MAC header the payload frame body 10 and the checksum FCS If the radio device cannot provide some values they are set to zero VTP inserts an Ethernet header IEEE 802 3 between the MAC header and the frame body Offset Size Type Field Description 0 2 uint16
21. or com Version 1 0 0 Appendix A Address Table 25 Appendix A Address Table Vector France SAS Vector GB Ltd Vector Informatik India Private Limited 26 Vector France SAS 168 Boulevard Cam linat 92240 Malakoff France Phone 33 1 4231 4000 Fax 33 1 4231 4009 mailto information fr vector com http www vector com Vector GB Ltd Rhodium Central Boulevard Blythe Valley Park Solihull Birmingham West Midlands B90 8AS United Kingdom Phone 44 121 50 681 50 Fax 44 121 50 681 69 mailto info uk vector com http www vector com Vector Informatik India Private Limited 4 1 1 1 3 floor Sutar Icon Sus Road Pashan Pune 411021 India Phone 91 20 2587 2023 Fax 91 20 2587 2025 mailto info in vector com http www vector com Version 1 0 0 Manual CANoe VTP Protocol Vector Informatik GmbH Manual CANoe VTP Protocol Vector Japan Co Ltd Vector Korea IT Inc VecScan AB Vector Informatik GmbH Vector Japan Co Ltd Seafort Square Center Bld 18F 2 3 12 Higashi shinagawa Shinagawa ku Tokyo 140 0002 Japan Phone 81 3 5769 7800 Fax 81 3 5769 6975 mailto info jp vector com http Awww vector com Vector Korea IT Inc 1406 Mario Tower Guro dong Guro gu 222 12 Seoul 152 848 Republic of Korea Phone 82 2 8070 600 Fax 82 2 8070 601 mailto info kr vector com http www vector com VecScan AB Theres Svenssons Gata 9 417 55 G teborg
22. ror 0x003F Error code Error source Description Vector Informatik GmbH Manual CANoe VTP Protocol General Error codes The error codes with description Error Code Description 1001 kErrorCode_QueueFull Too many commands to process 1002 kErrorCode_MissingFrame Sequence numbering violation 1003 kErrorCode_InterfaceOffline WLAN interface not available 1004 kErrorCode_WrongParameter General parameter mismatch 1005 kErrorCode_DeviceUnavailable Negative response to selection command 1006 kErrorCode_WrongChannel Transmit frame channel number different to device settings Vector Informatik GmbH Version 1 0 0 23 Manual CANoe VTP Protocol 3 Appendix A Address Table Vector Informatik GmbH Vector Informatik GmbH Shanghai Representative Office Vector CANtech Inc Vector Informatik GmbH Vector Informatik GmbH Ingersheimer Str 24 70499 Stuttgart Germany Phone 49 711 80670 0 Fax 49 711 80670 111 mailto info de vector com http www vector com Vector Informatik GmbH Shanghai Representative Office Unit 1701 Sunyoung Center No 398 Jiangsu Road Changning District Shanghai 200050 P R China Phone 86 21 6432 53530 Fax 86 21 6432 5308 mailto info cn vector com http Awww vector com Vector CANtech Inc Suite 550 39500 Orchard Hill Place Novi Mi 48375 USA Phone 1 248 449 9290 Fax 1 248 449 9704 mailto info us vector com http www vect
23. sponse Command 2 4 9 HardwareTypeRequest Command 2 4 10 HardwareTypeResponse Command 2 4 11 SoftwareVersionRequest Command 2 4 12 SoftwareVersionResponse Command 2 4 13 RadioMAC ID Request Command 2 4 14 RadioMAC ID Response Command 2 4 15 ChannelParameterRequest Command 2 4 16 ChannelParameterSet Command 2 4 17 ChannelParameterResponse Command 2 4 18 SelectRequest Command 2 4 19 SelectResponse Command 2 4 20 FreeSelection Command 2 4 21 AssigniFaceRequest Command 2 4 22 AssignIFaceResponse Command 2 4 23 TransmitFrame Command 2 4 24 ReceiveFrame Command Vector Informatik GmbH Version 1 0 0 Table of Contents OM OM OOA A A Q Table of Contents Manual CANoe VTP Protocol 2 4 25 Reboot Command 22 2 4 26 Halt Command 22 2 4 27 Error Message 22 3 Appendix A Address Table 25 Il Version 1 0 0 Vector Informatik GmbH Manual CANoe VTP Protocol Introduction 1 Introduction This chapter contains the following information 1 1 VTP at a Glance page 4 1 2 History VTP Protocol page 4 1 3 About this User Manual page 4 Navigational Aids and Conventions Certification Warranty Support Registered Trademarks Vector Informatik GmbH Version 1 0 0 3 Introduction Manual CANoe VTP Protocol 1 1 VTP ata Glance IEEE 802 11p radio device access CANoe VTP Vector Transport Protocol is a protocol for simple fast real time exchange of IEEE 802 11p WLAN frames between CANoe and different radio devices via an Ethernet
24. twareReleas eVersion reserved 2 4 13 RadioMAC ID Request Command Description Size of command 8 Bytes kCommandCode_SoftwareVersionResp onse 0x000D Software main version Software sub version Software release version Reserved byte Radio MAC ID The RadioMAC ID Request command is sent to the radio device by CANoe to request request the hardware MAC ID of the radio device on the chosen channel The radio device will answer with a RadioMAC ID Response command to provide the MAC ID Vector Informatik GmbH Version 1 0 0 17 General Manual CANoe VTP Protocol Offset Size Type Field Description 0 2 uint16 commandSize Size of command 6 Bytes 2 2 uint16 commandCode kCommandCode_RadioMAC ID Request 0x000E 4 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 reserved Reserved byte 2 4 14 RadioMAC ID Response Command Radio MAC ID response The RadioMAC ID Response command is sent to CANoe by the radio device This command is the answer to a radio MAC ID request by CANoe and provides the hardware MAC ID of the radio device on the chosen channel Offset Size Type Field Description 0 2 uint16 commandSize Size of command 12 Bytes 2 2 uint16 commandCode kCommandCode_RadioMAC ID Response 0x000F 4 1 uint8 interfaceNumber Number of WLAN interface 1 uint8 reserved Reserved byte 6 6 uint48 radioMacld Radio MAC ID 2 4 15 ChannelParameterRequest Command Channel param
25. two digit version number major and minor version for the protocol the number of subsequent commands and a sequence number For future development of VTP protocol extensions and for better alignment two more bytes are reserved Offset 0 10 12 14 Vector Informatik GmbH Size 8 Type uint64 uint8 uint8 uint16 uint16 uint16 Field vtpSignature vtpMajorVersion vtpMinorVersion numberOfCommands sequenceNumber reserved Version 1 0 0 Description Signature of the VTP protocol this is always the value 0x505456656F4E4143 Protocol version major part kVtpMajorVersion 1 Protocol version minor part kVtpMinorVersion 0 Number of commands in the datagram Datagram sequence number This field should be initialized with 0 11 General Signature Version number Sequence number Example Sequence counting 12 Manual CANoe VTP Protocol The signature serves as a magic cookie to check whether the datagram was actually intended as VTP communication or whether a program sent the datagram to CANoe or a radio device by mistake CANoe and the radio device ignore all datagrams that have a wrong signature The two digit version number is used to check compatibility A new protocol version with the same major version number may contain additional information but the datagram can still be processed except for the new information by older programs with the same major version number T
26. widespread standard protocol which means there will most likely be an implementation available on the radio device The exchange of data between CANoe and the radio device is achieved through reciprocal transmission of UDP datagrams As a matter of principle CANoe always sends a datagram to the radio device first and therefore has to know the IP address used by the radio device for the VTP protocol CANoe may scan every attached network to determine the available radio devices and their IP addresses UDP port By default CANoe uses port 0xC2CO for the VTP protocol The port number is adjustable on the radio device and in the CANoe WLAN settings The exact structure of the UDP datagrams is shown in section 2 3 Protocol Description The datagram structures have been kept purposely simple so that an experienced developer can implement the VTP protocol within a short time on the radio device provided there is already an IP stack available 2 2 2 Data Types Data types To reduce the bandwidth required for data transfer over the network the VTP protocol is binary coded To facilitate the data access on the radio device side the data types are limited to these ones that are directly available in most C C compilers and most other programming languages Vector Informatik GmbH Version 1 0 0 9 General Encoding Offset Manual CANoe VTP Protocol These data types are gt ints 1 Byte signed integer gt uint 1 Byte unsigned i
27. x001E 4 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 channelNumber Number of WLAN channel 6 2 uint16 transactionld Transaction identifier 8 2 uint16 frameLength Frame length 10 n wlanFrame IEEE 802 11p WLAN frame 2 4 24 ReceiveFrame Command Radio frame reception The ReceiveFrame command is sent to CANoe by the radio device This command includes an IEEE 802 11p frame received on the indicated interface Every frame transmitted on the indicated interface is signalled to CANoe with direction set to TX The timestamp is given in UNIX time format time zone set to UTC Offset Size Type Field Description 0 2 uint16 commandSize Size of command 24 Bytes length of WLAN frame 2 2 uint16 commandCode kCommandCode_ReceiveFrame 0x001F 4 1 uint8 interfaceNumber Number of WLAN interface 5 1 uint8 channelNumber Number of WLAN channel 6 1 uint8 direction Transmission direction 0x01 TX 0x00 RX 7 1 uint8 reserved Reserved byte 8 4 uint32 timeSeconds Seconds 12 4 uint32 timeMicroSecon Microseconds ds 16 2 uint16 signalStrength Signal strength Vector Informatik GmbH Version 1 0 0 21 General Manual CANoe VTP Protocol Offset Size Type Field Description 18 2 uint16 signalQuality Signal quality 20 2 uint16 transactionld Transaction identifier 22 2 uint16 frameLength Frame length 24 n wlanFrame IEEE 802 11p
28. you can obtain supplemental information This symbol calls your attention to warnings Here you can find additional information Here is an example that has been prepared for you JAM PA Step by step instructions provide assistance at these points ni a Instructions on editing files are found at these points This symbol warns you not to edit the specified file This symbol indicates multimedia files like e g video clips This symbol indicates an introduction into a specific topic This symbol indicates text areas containing basic knowledge This symbol indicates text areas containing expert knowledge This symbol indicates that something has changed D M9 1 3 2 Certification Certified Quality Vector Informatik GmbH has ISO 9001 2008 certification Management System The ISO standard is a globally recognized quality standard 1 3 3 Warranty Limitation of warranty We reserve the right to change the contents of the documentation and the software without notice Vector Informatik GmbH assumes no liability for correct contents or damages which are resulted from the usage of the user manual We are always grateful for references to mistakes or for suggestions for improvement so as to be able to offer you even better performing products in the future Vector Informatik GmbH Version 1 0 0 5 Introduction Manual CANoe VTP Protocol 1 3 4 Support Need support
Download Pdf Manuals
Related Search