3 interface functions, 1 generic, Interface functions – BECKHOFF ET9300 User Manual

Page 29: Generic

Advertising
background image

Application Note ET9300

27

Prototype:

void ECAT_StateChange(UINT8 alStatus, UINT16 alStatusCode)

Parameter

alStatus

Requested Al Status

alStatusCode AL Status Code. (if != 0 the error flag indication will be set)

Return

Void

Description

This function shall be called by the application to trigger state transition in case
of an application error or to complete a pending transition.
If the function was called due to an error it shall be again if the error is gone.
NOTE: state requests to a higher state than the current state are not allowed.

6.3

Interface Functions

6.3.1

Generic

Prototype:

void APPL_Application(void)

Parameter

Void

Return

void

Description

This function is called by the synchronization ISR or from the mainloop if not
synchronization is activated.

Prototype:

UINT16 APPL_GetDeviceID (void)

Parameter

Void

Return

Explicit Device ID which is written to the AL Status Code register.

Description

This function is called if the master requests the Explicit Device ID.
Only required if the slave supports Explicit Device ID handling
(EXPLICIT_DEVICE_ID).

Prototype:

UINT16 (* pAPPL_EEPROM_Read)(UINT32 wordaddr)

Parameter

Wordaddr

start word address within the EEPROM memory

Return

0 if the operation was successful.
greater 0 an error has occurred

Description

This is an optional function and only required if EEPROM_EMULATION is
enabled and no EEPROM content is created (CREATE_EEPROM_CONTENT
== 0)
This function shall copy EEPROM data to the ESC EEPROM data register
(0x508:0x50F/0x50B).
The EEPROM data starting at the specified word address and the length
specified with "EEPROM_READ_SIZE".
The data shall be copied to the ESC EEPROM buffer (ESC offset 0x508)

Advertising