Entry

Summary

Represents a SOME/IP Entry object.

See also

Option

Methods
Properties

Structure

class Entry
add_ipv4_option(port: uint16, address: str, is_udp: bool, is_multicast: bool) Option

Creates an IPv4 endpoint option over UDP or TCP from the parameters given and attaches it to the entry, updating the corresponding fields (index and number of options) to reflect the addition.

Parameters
  • port (uint16) – UDP or TCP port number.

  • address (str) – IPv4 address.

  • is_udp (bool) – True if it’s over UDP . False otherwise.

  • is_multicast (bool) – True if the option is used in a SusbcribeEventgroupAck entry to indicate that the events/methods of the subscribed service will be sent multicast.:code:False otherwise.

Returns

IPv4 endpoint option over UDP or TCP.

Return type

Option

contains_op(option: Option) bool

Verifies if the put option put it in parameter exists in option list

Parameters

option (Option) – Option to set.

Returns

The index of option in option list. -1 if it does not exist.

Return type

bool

set_option_tcp(port: uint16, address: str, isMulticast: bool)

Creates an IPv4 endpoint option over TCP from the parameters given and attaches it to the entry, updating the corresponding fields(index and number of options) to reflect the addition.

Parameters
  • port (uint16) – TCP port number.

  • address (str) – IPv4 address.

  • isMulticast (bool) – True if the option is used in a SusbcribeEventgroupAck entry to indicate that the events/methods of the subscribed

set_option_tcp_by_instance_id() bool

Creates an IPv4 endpoint option over TCP from the info found in the Fibex database for the service id and instance id of the entry and attaches it to the entry. To get that, it performs the following actions, It searches the Fibex database for the service instance associated to the instance id and service id of the entry, then checks if this service instance has TCP among the defined transport protocols, If so, it gets the IP address and TCP port from this service instance, With the gathered info, it creates the TCP IPv4 endpoint option and adds it to the entry.

Returns

True if the option could be successfully added. False otherwise.

Return type

bool

set_option_udp(port: uint16, address: str, isMulticast: bool)

Creates an IPv4 endpoint option over UDP from the parameters given and attaches it to the entry, updating the corresponding fields(index and number of options) to reflect the addition.

Parameters
  • port (uint16) – UDP port number.

  • address (str) – IPv4 address.

  • isMulticast (bool) – True if the option is used in a SusbcribeEventgroupAck entry to indicate that the events/methods of the subscribed.

set_option_udp_by_instance_id() bool

Creates an IPv4 endpoint option over UDP from the info found in the Fibex database for the service id and instance id of the entry and attaches it to the entry. To get that, it performs the following actions, It searches the Fibex database for the service instance associated to the instance id and service id of the entry, then checks if this service instance has UDP among the defined transport protocols, If so, it gets the IP address and UDP port from this service instance, With the gathered info, it creates the UDP IPv4 endpoint option and adds it to the entry.

Returns

True if the option could be successfully added. False otherwise.

Return type

bool

counter

Counter : Is used to differentiate identical Subscribe Eventgroups of the same subscriber. Set to 0x0 if not used.

Type

uint8

entry_type

the type of the entry.

Type

uint8

event_group_id

Event group id. Only used in entries of type Eventgroup, i.e. for subscriptions.

Type

uint16

flag_op_1

Number of options used in the first option run.

Type

uint8

flag_op_2

Number of options used in the second option run.

Type

uint8

index_op_1

Index of the first option run in the options array of the SOME/IP-SD message the entry belongs to.

Type

uint8

index_op_2

Index of the second option run in the options array of the SOME/IP-SD message the entry belongs to.

Type

uint8

initial_data_req

Initial Data Requested Flag : Shall be set to 1, if initial data shall be sent by Server

Type

uint8

instance_id

Instance id of the service referenced by the entry. Set to 0xFFFF if all instances of a service are meant.

Type

uint16

major_version

Major version of the service referenced by the entry.

Type

uint8

minor_version

Minor version of the service referenced by the entry.

Type

uint32

options

List of Option associated to the entry.

Type

List[Option]

reserved

Reserved field in an entry of type Eventgroup. It shall be set to 0x0000.

Type

uint16

reserved2

Reserved2 : Shall be set to 0x0, if not specified

Type

uint8

service_id

Id of the service referenced by the entry.

Type

uint16

string_entry_type

True if the parameter is of type array. False otherwise.

Type

str

ttl

entry's time to live.

Type

int32

type

Entry type. It includes both Service and Eventgroup entries. See Entry type enum for valid values.

Type

EntryType