AGHAF  4.5.6
Annecy electronique Generic Hardware Access Framework
AGHAF Documentation

AGHAF is a library for accessing Annecy Electronique's MUX devices.

This documentation is about the C API provided by this library.

The main functionnalities provided are:

  • Enumerate and identify connected devices
  • Configure devices for network communication (CAN, Ethernet, LIN, etc.)
  • Receive data from configured networks, e.g. for analysis purposes.
  • Send and receive data on configured networks, e.g. to diagnose or simulate ECU.

Environment

Compatibility

The C API and the AGHAF library should be compatible with any C or C++ compiler.

Supported platforms

Supported platforms are:

  • Microsoft Windows 32 and 64 bits (10 and above)
  • Linux 32 and 64 bits

Introduction to the API

The C API has been designed in object oriented mode. To achieve this, most of the APIs use pointers.

Thus the API will contain a very limited number of structures and most of the objects are accessible through handles (void *). Main drawback is that users do not have direct access objects internals. However, this provides many advantages:

  • Users do not have to deal with object initialization.
  • Permitted actions are clearly defined by the set of functions related to the object.

Below, the description of VCI Muxdiag 3 pinout :

Signal Pin comment AMUX-AEE2010 AMUX-AEE2020
Ethernet Tx(+) 1 12
BroadReach N 2
BroadReach P 3
Chassis Power Ground 4 4 4
Signal Communication Groud 5 5 5
CAN LS 1 L 6 10 10
CAN LS 1 H 7 9 9
CAN HS 1 L 8 8
CAN HS 1 H 9 3
Ethernet Rx(+) 10 3
Ethernet Tx(-) 11 13
ISO K line 1 12 7 7
n.c. 13 13
n.c. 14
n.c. 15
VBAT 16 16 16
CAN HS 2 H 17 6 6
CAN HS 2 L 18 14 14
Ethernet Rx(-) 19 11
ISO L Line 1 20 15 15
internal use 21 do not connect
internal use 22 do not connect
DoIP activation signal 23 8
APC 24 1 1
LIN 2 25 12
LIN 1 26 11

diagram

Major version evolution

Below, the compatibility of VCI Muxdiag 3 firmware and service.

Firmware Version SDK 3.x.x SDK 4.x.x
1.x compatible not compatible
2.x not compatible compatible

LIN is available since v2.09 from VCI MuxDiag3 firmware. KLine and ADC are available since v2.14 from VCI MuxDiag3 firmware.