EcuNodeEthernet

Summary

Represents an RBS Ethernet ECU node.

Methods
Properties
Events

Structure

class EcuNodeEthernet
call(selector: str, input_parameters: IDictionary, transport_protocol: str = None, timeout: float = 1) IDictionary

Calls a consumed method to send SOME/IP message and return the output parameters. Follows an example RBS Scripting in documentation for more info.

Parameters
  • selector (str) – selector can be service_id_or_name.method_id_or_name

  • input_parameters (IDictionary) – dictionary contains the input parameters of a method and its default values

  • transport_protocol (str) – the protocol of the service. It can be UDP or TCP

  • timeout (float) – timout of response message in seconds

Returns

A dictionary contains the output parameters of a method and its values

Return type

IDictionary

disable(selector: str)

Disables a service, a method, an event or a field of the ecu.

Parameters

selector (str) – selector can be service_id_or_name and it can be service_id_or_name.member_id_or_name

enable(selector: str)

Enables a service, a method, an event or a field of the ecu.

Parameters

selector (str) – selector can be service_id_or_name and it can be service_id_or_name.member_id_or_name

get_config(config_path: str, config_property: str) decimal

Gets the value of a specified config.

Parameters
Returns

The value of a specified config.

Return type

decimal

get_mac(ip: str) str

Finds the specific device with the specific IP address provided from the map and returns its MAC address.

Parameters

ip (str) – Desired IP address.

Returns

MAC address found.

Return type

str

get_value(path: str, member: str = None) object

Gets the value of a specific child of the ecu.

Parameters
  • path (str) – The path to the child. follows a specific path format see RBS Notations in documentation for more info

  • member (str) – [optional] The name of the member in the child, empty or None means the entire child value will be returned.

Returns

The value of the child (member if member is not None)

Return type

object

reset() bool

Resets the ECU.

Returns

True if the operation was successful, False otherwise.

Return type

bool

reset(service_id: uint16, instance_id: uint16) bool

Attempts to reset the ECU node.

Parameters
  • service_id (uint16) – Service identifier.

  • instance_id (uint16) – Instance identifier.

Returns

True if reset was successful, False if not.

Return type

bool

reset_value(path: str = None, member: str = None)

Resets the value of a specific child of the ecu to the default value.

Parameters
  • path (str) – The path to the child. follows a specific path format see RBS Notations in documentation for more info.empty or None means the entire elements of the node will be reset.

  • member (str) – [optional] The name of the member in the child, empty or None means the entire child value will be reset.

set_config(config_path: str, config_property: str, value: decimal)

Sets the value of a specified config.

Parameters
set_mac(mac: str, p: str)

Sets the mac address (if empty) of the desired device by IP from the MAC/IP map.

Parameters
  • mac (str) – Desired MAC address.

  • p (str) – Desired IP addresses

set_value(path: str, value: object)

Sets the value of a specific child of the ecu to a specific value.

Parameters
  • path (str) – The path to the child. follows a specific path format see RBS Notations in documentation for more info.

  • value (object) – The value of the child/member to be set, None means default value.

set_value(path: str, member: str, value: object)

Sets the value of a specific child of the ecu to a specific value.

Parameters
  • path (str) – The path to the child. follows a specific path format see RBS Notations in documentation for more info.

  • member (str) – The name of the member in the child, None means the entire child value will be set (use set_values(path, value) instead).

  • value (object) – The value of the child/member to be set, None means default value.

start()

Starts the ECU

stop()

Stops the ECU.

trigger(selector: str, transport_protocol: str = None)

Triggers an enabled provided field or event of the ecu to send SOME/IP message. Follows an example RBS Scripting in documentation for more info.

Parameters
  • selector (str) – selector is service_id_or_name.instance_id.member_id_or_name

  • transport_protocol (str) – the protocol of the service. It can be UDP or TCP

@on_method_called(sender: object, e: MethodCalledArgs)

Gets the service id, service name , member_id, member_name and instance_id, request and response message when we send a SOME/IP message.

Parameters
  • sender (object) – The source of the event.

  • e (MethodCalledArgs) – An object that contains the event data.

@on_receiving(sender: object, e: ReceivingEventArgs)

Event is triggered when we receive a message.See Using node events for more information.

Parameters
@on_reset_ecu

Event is triggered when the capture of Ethernet ECU RBS is reset.

@on_sending_sd(sender: object, e: SendingSomeIPSDEventArgs)

Event is triggered when a someip-sd has been sent. See Using node events for more information.

Parameters
@on_sending_someip(sender: object, e: SendingSomeIPEventArgs)

Event is triggered when a someip has been sent. See Using node events for more information.

Parameters
@on_start

Event is triggered when the capture of Ethernet ECU RBS is started.

@on_stop

Event is triggered when the capture of Ethernet ECU RBS is stopped.

@on_value_changed(sender: object, e: ValueChangedArgs)

Gets the new value , old value, service id, service name , member_id, member_name and instance_id when we set value of field or event and trigger it.

Parameters
  • sender (object) – The source of the event.

  • e (ValueChangedArgs) – An object that contains the event data.

auto_fire

True if node auto fires, False if not.

Type

bool

auto_fire_delay

The auto toggle's fire delay.

Type

int32

auto_toggle_bit_length

The bit length of the auto toggle.

Type

int32

auto_toggle_bit_position

The auto toggle's bit location.

Type

int32

auto_toggle_payload

True if node has auto toggle property, False if not.

Type

bool

data_base

Takes the database object.

Type

Database

enable_arp_manager

The state of the ARP messages manager. True if manager is Activated False if manager is deactivated.

Type

bool

enable_icmp_manager

The state of the ICMP messages manager. True if manager is Activated False if manager is deactivated.

Type

bool

enable_nm_manager

The state of the NM messages manager.

Type

ManagerState

enable_sd_manager

The state of the SD messages manager.

Type

ManagerState

ip_address_source

IP address that is used when sending SOME/IP-SD message.

Type

str

ip_multicast_address

Mapping of IPs and Macs for the current ECU.

Type

str

is_started

Checks whether the Ethernet ECU RBS is running.

Type

bool

message_manager

The component that handles sending and receiving messages.

Type

IMessageManager

nm_manager

The component that handles sending and receiving SOMEIP/NM messages.

Type

INMMessageManager

override_auto_fire_delays

True if node overrides auto fire delay, False if not.

Type

bool

override_auto_toggle_bit

True if node overrides auto toggle property, False if not.

Type

bool

port_connection

The port connection of the node.

Type

Port

sd_manager

The component that handles sending and receiving SOMEIP/SD messages.

Type

ISDMessageManager

someip_manager

The component that handles sending and receiving SOMEIP messages.

Type

ISomeIPMessageManager