scapy.contrib.ethercat

EtherCat automation protocol

author:

Thomas Tannhaeuser, hecke@naberius.de

description:

This module provides Scapy layers for the EtherCat protocol.

normative references:

  • IEC 61158-3-12 - data link service and topology description

  • IEC 61158-4-12 - protocol specification

Currently only read/write services as defined in IEC 61158-4-12, sec. 5.4 are supported.

TODO:

  • Mailbox service (sec. 5.5)

  • Network variable service (sec. 5.6)

NOTES:

  • EtherCat frame type defaults to TYPE-12-PDU (0x01) using xxx bytes of padding

  • padding for minimum frame size is added automatically

class scapy.contrib.ethercat.EtherCat(_pkt, /, *, length=0, _reserved=0, type=0)[source]

Bases: Packet

Common EtherCat header layer

ETHERCAT_HEADER_LEN = 2
ETHERCAT_TYPE12_DLPDU_TYPES = {1: <class 'scapy.contrib.ethercat.EtherCatAPRD'>, 2: <class 'scapy.contrib.ethercat.EtherCatAPWR'>, 3: <class 'scapy.contrib.ethercat.EtherCatAPRW'>, 4: <class 'scapy.contrib.ethercat.EtherCatFPRD'>, 5: <class 'scapy.contrib.ethercat.EtherCatFPWR'>, 6: <class 'scapy.contrib.ethercat.EtherCatFPRW'>, 7: <class 'scapy.contrib.ethercat.EtherCatBRD'>, 8: <class 'scapy.contrib.ethercat.EtherCatBWR'>, 9: <class 'scapy.contrib.ethercat.EtherCatBRW'>, 10: <class 'scapy.contrib.ethercat.EtherCatLRD'>, 11: <class 'scapy.contrib.ethercat.EtherCatLWR'>, 12: <class 'scapy.contrib.ethercat.EtherCatLRW'>, 13: <class 'scapy.contrib.ethercat.EtherCatARMW'>, 14: <class 'scapy.contrib.ethercat.EtherCatFRMW'>}
ETHER_FRAME_MIN_LEN = 64
ETHER_FSC_LEN = 4
ETHER_HEADER_LEN = 14
FRAME_TYPES = {1: 'TYPE-12-PDU', 4: 'NETWORK-VARIABLES', 5: 'MAILBOX'}
aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|        LENGTH       | |  TYPE |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                          Fig. EtherCat
EtherCat fields

length

LEBitField (11 bits)

0

_reserved

LEBitField (1 bit)

0

type

LEBitField (4 bits)

0
guess_payload_class(payload)[source]
payload_guess

Possible sublayers: EtherCatAPRD, EtherCatAPRW, EtherCatAPWR, EtherCatARMW, EtherCatBRD, EtherCatBRW, EtherCatBWR, EtherCatFPRD, EtherCatFPRW, EtherCatFPWR, EtherCatFRMW, EtherCatLRD, EtherCatLRW, EtherCatLWR

post_build(pkt, pay)[source]

need to set the length of the whole PDU manually to avoid any bit fiddling use a dummy class to build the layer content

also add padding if frame is < 64 bytes

Note: padding only handles Ether/n*Dot1Q/EtherCat

(no special mumbo jumbo)

Parameters:

  • pkt – raw string containing the current layer

  • pay – raw string containing the payload

Returns:

<new current layer> + payload

class scapy.contrib.ethercat.EtherCatAPRD(_pkt, /, *, _cmd=1, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

APRD - Auto Increment Physical Read (IEC 61158-5-12, sec. 5.4.1.2 tab. 14 / p. 32)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatAPRD
EtherCatAPRD fields

_cmd

ByteField

1

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatAPRW(_pkt, /, *, _cmd=3, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

APRW - Auto Increment Physical Read Write (IEC 61158-5-12, sec. 5.4.3.1 tab. 22 / p. 41)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatAPRW
EtherCatAPRW fields

_cmd

ByteField

3

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatAPWR(_pkt, /, *, _cmd=2, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

APWR - Auto Increment Physical Write (IEC 61158-5-12, sec. 5.4.2.2 tab. 18 / p. 37)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatAPWR
EtherCatAPWR fields

_cmd

ByteField

2

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatARMW(_pkt, /, *, _cmd=13, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

ARMW - Auto increment physical read multiple write (IEC 61158-5-12, sec. 5.4.3.5 tab. 26 / p. 46)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatARMW
EtherCatARMW fields

_cmd

ByteField

13

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatBRD(_pkt, /, *, _cmd=7, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

BRD - Broadcast read (IEC 61158-5-12, sec. 5.4.1.4 tab. 16 / p. 34)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                         Fig. EtherCatBRD
EtherCatBRD fields

_cmd

ByteField

7

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatBRW(_pkt, /, *, _cmd=9, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

BRW - Broadcast read write (IEC 61158-5-12, sec. 5.4.3.3 tab. 24 / p. 39)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                         Fig. EtherCatBRW
EtherCatBRW fields

_cmd

ByteField

9

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatBWR(_pkt, /, *, _cmd=8, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

BWR - Broadcast read (IEC 61158-5-12, sec. 5.4.2.4 tab. 20 / p. 39)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                         Fig. EtherCatBWR
EtherCatBWR fields

_cmd

ByteField

8

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatFPRD(_pkt, /, *, _cmd=4, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

FPRD - Configured address physical read (IEC 61158-5-12, sec. 5.4.1.3 tab. 15 / p. 33)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatFPRD
EtherCatFPRD fields

_cmd

ByteField

4

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatFPRW(_pkt, /, *, _cmd=6, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

FPRW - Configured address physical read write (IEC 61158-5-12, sec. 5.4.3.2 tab. 23 / p. 43)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatFPRW
EtherCatFPRW fields

_cmd

ByteField

6

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatFPWR(_pkt, /, *, _cmd=5, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

FPWR - Configured address physical write (IEC 61158-5-12, sec. 5.4.2.3 tab. 19 / p. 38)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatFPWR
EtherCatFPWR fields

_cmd

ByteField

5

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatFRMW(_pkt, /, *, _cmd=14, idx=0, adp=0, ado=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

FRMW - Configured address physical read multiple write (IEC 61158-5-12, sec. 5.4.3.6 tab. 27 / p. 47)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADP              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|              ADO              |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                        Fig. EtherCatFRMW
EtherCatFRMW fields

_cmd

ByteField

14

idx

ByteField

0

adp

LEShortField

0

ado

LEShortField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatLRD(_pkt, /, *, _cmd=10, idx=0, adr=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

LRD - Logical read (IEC 61158-5-12, sec. 5.4.1.5 tab. 17 / p. 36)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADR              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                         Fig. EtherCatLRD
EtherCatLRD fields

_cmd

ByteField

10

idx

ByteField

0

adr

LEIntField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatLRW(_pkt, /, *, _cmd=12, idx=0, adr=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

LRW - Logical read write (IEC 61158-5-12, sec. 5.4.3.4 tab. 25 / p. 45)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADR              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                         Fig. EtherCatLRW
EtherCatLRW fields

_cmd

ByteField

12

idx

ByteField

0

adr

LEIntField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatLWR(_pkt, /, *, _cmd=11, idx=0, adr=0, len=None, _reserved=0, c=0, next=None, irq=0, data=[], wkc=0)[source]

Bases: EtherCatType12DLPDU

LWR - Logical write (IEC 61158-5-12, sec. 5.4.2.5 tab. 21 / p. 40)

aliastypes
fields_desc
Display RFC-like schema
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|       CMD     |      IDX      |              ADR              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                               |         LEN         | RESE| C |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              NEXT             |IRQ|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |              DATA             |WKC|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                         Fig. EtherCatLWR
EtherCatLWR fields

_cmd

ByteField

11

idx

ByteField

0

adr

LEIntField

0

len

LEBitFieldLenField (11 bits)

None

_reserved

LEBitField (3 bits)

0

c

LEBitEnumField (1 bit)

0

next

LEBitEnumField (1 bit)

None

irq

LEShortField

0

data

FieldListField

[]

wkc

LEShortField

0
class scapy.contrib.ethercat.EtherCatType12DLPDU(_pkt, /)[source]

Bases: Packet

Type12 message base class

BROADCAST_ADDRESSING_DESC = [<ByteField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).idx>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).adp>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).ado>, <LEBitFieldLenField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).len>, <LEBitField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW)._reserved>, <LEBitEnumField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).c>, <LEBitEnumField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).next>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).irq>, <FieldListField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).data>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).wkc>]
LOGICAL_ADDRESSING_DESC = [<ByteField (EtherCatLRD,EtherCatLWR,EtherCatLRW).idx>, <LEIntField (EtherCatLRD,EtherCatLWR,EtherCatLRW).adr>, <LEBitFieldLenField (EtherCatLRD,EtherCatLWR,EtherCatLRW).len>, <LEBitField (EtherCatLRD,EtherCatLWR,EtherCatLRW)._reserved>, <LEBitEnumField (EtherCatLRD,EtherCatLWR,EtherCatLRW).c>, <LEBitEnumField (EtherCatLRD,EtherCatLWR,EtherCatLRW).next>, <LEShortField (EtherCatLRD,EtherCatLWR,EtherCatLRW).irq>, <FieldListField (EtherCatLRD,EtherCatLWR,EtherCatLRW).data>, <LEShortField (EtherCatLRD,EtherCatLWR,EtherCatLRW).wkc>]
PHYSICAL_ADDRESSING_DESC = [<ByteField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).idx>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).adp>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).ado>, <LEBitFieldLenField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).len>, <LEBitField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW)._reserved>, <LEBitEnumField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).c>, <LEBitEnumField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).next>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).irq>, <FieldListField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).data>, <LEShortField (EtherCatAPRD,EtherCatFPRD,EtherCatBRD,EtherCatAPWR,EtherCatFPWR,EtherCatBWR,EtherCatAPRW,EtherCatFPRW,EtherCatBRW,EtherCatARMW,EtherCatFRMW).wkc>]
aliastypes
guess_payload_class(payload)[source]
post_build(pkt, pay)[source]

set next attr automatically if not set explicitly by user

Parameters:

  • pkt – raw string containing the current layer

  • pay – raw string containing the payload

Returns:

<new current layer> + payload

class scapy.contrib.ethercat.LEBitEnumField(name, default, size, enum)[source]

Bases: LEBitField, _EnumField

i2s: Dict[I, str] | None
i2s_cb: Callable[[I], str] | None
s2i: Dict[str, I] | None
s2i_cb: Callable[[str], I] | None
class scapy.contrib.ethercat.LEBitField(name: str, default: I | None, size: int, tot_size: int = 0, end_tot_size: int = 0)[source]

Bases: BitField

a little endian version of the BitField

addfield(pkt, s, val)[source]
Parameters:

  • pkt – packet instance the raw string s and field belongs to

  • s – raw string representing the frame

  • val – value

Returns:

final raw string, tuple (s, bitsdone, data) if in between bit field # noqa: E501

as we don’t know the final size of the full bitfield we need to accumulate the data. # noqa: E501 if we reach a field that ends at a octet boundary, we build the whole string # noqa: E501

getfield(pkt, s)[source]

extract data from raw str

collect all instances belonging to the bit field set. if we reach a field that ends at a octet boundary, dissect the whole bit field at once # noqa: E501

Parameters:

  • pkt – packet instance the field belongs to

  • s – raw string representing the frame -or- tuple containing raw str, number of bits and array of fields # noqa: E501

Returns:

tuple containing raw str, number of bits and array of fields -or- remaining raw str and value of this # noqa: E501

class scapy.contrib.ethercat.LEBitFieldLenField(name, default, size, length_of=None, count_of=None, adjust=<function LEBitFieldLenField.<lambda>>)[source]

Bases: LEBitField

adjust
count_of
i2m(pkt, x)[source]
length_of
exception scapy.contrib.ethercat.LEBitFieldSequenceException[source]

Bases: Scapy_Exception

thrown by EtherCat structure tests