flync_4_ecu

ECU Config

Expand for Schematic

        classDiagram

    class SOMEIPServiceDeployment {
        deployment_type: Literal['someip', 'someip_provider', 'someip_consumer']
        service: int
        major_version: int = 0
        instance_id: int
        someip_sd_timings_profile: str
    }

    class InternalTopology {
        connections: list[InternalConnectionUnion] = list
    }

    class UniqueName {
        name: str
    }

    class Controller {
        name: str
        controller_metadata: EmbeddedMetadata
        ethernet_interfaces: list[EthernetInterface] | None = list
        can_interfaces: list[CANInterfaceConfig] | None = list
        lin_interfaces: list[LINMasterInterfaceConfig | LINSlaveInterfaceConfig] | None = list
        virtual_switch: VirtualSwitch | None = None
    }

    class SwitchPort {
        name: str
        silicon_port_no: int
        default_vlan_id: int
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        ptp_config: PTPConfig | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = []
        macsec_config: MACsecConfig | None = None
    }

    class MulticastGroupMembership {
        group: IPvAnyAddress | MacAddress
        description: str | None = ''
        mode: Literal['tx'] | Literal['rx'] = 'tx'
        vlan: int | None = 0
        src_ip: IPvAnyAddress | None = None
        solicited_node_multicast: bool | None = False
    }

    class NamingStrategy {
        <<Enumeration>>
        AUTO: int = 0
        FIELD_NAME: int = 0
        FIXED_PATH: int = 1
    }

    class OutputStrategy {
        <<Enumeration>>
        AUTO: int = 1
        FOLDER: int = 1
        SINGLE_FILE: int = 2
        OMMIT_ROOT: int = 4
        FIXED_ROOT: int = 8
    }

    class Socket {
        name: str
        endpoint_address: IPvAnyAddress
        port_no: int
        deployments: list[DeploymentUnion] | None = list
        endpoint_type: Literal['multicast', 'unicast'] | None = <lambda>
        multicast_tx: list[IPvAnyAddress] | None = list
    }

    class ControllerInterface {
        name: str
        mac_address: MacAddress | None = None
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        compute_nodes: list[ComputeNodes] | None = list
        virtual_interfaces: list[VirtualControllerInterface] | None = list
        ptp_config: PTPConfig | None = None
        macsec_config: MACsecConfig | None = None
        firewall: Firewall | None = None
        htb: HTBInstance | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = list
        routing_table: list[RouteEntry] | None = []
    }

    class ECU {
        name: str
        ports: list[ECUPort] = list
        controllers: list[Controller]
        switches: list[Switch] | None = list
        topology: InternalTopology
        ecu_metadata: ECUMetadata
        mac_multicast_endpoints: MACMulticastEndpoints | None = None
        multicast_groups: list[MulticastGroupMembership] | None = list
    }

    class Switch {
        name: str
        tcam_rules: list[TCAMRule] | None = []
        ports: list[SwitchPort]
        vlans: list[VLANEntry]
        host_controller: ControllerInterface | None = None
        meta: EmbeddedMetadata
    }

    class ImpliedStrategy {
        <<Enumeration>>
        AUTO: int = 0
        FOLDER_NAME: int = 0
        FILE_NAME: int = 1
    }

    class ECUPort {
        name: str
        mdi_config: BASET1 | BASET1S | BASET = BASET1
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
    }

    class SOMEIPServiceProvider {
        deployment_type: Literal['someip_provider'] = 'someip_provider'
        service: int
        major_version: int
        instance_id: int
        someip_sd_timings_profile: str
        minor_version: int = 0
        provided_eventgroups: list[str] | None = None
    }

    class ECUMetadata {
        type: Literal['ecu'] = 'ecu'
        author: str
        compatible_flync_version: BaseVersion
        extensions: dict[str, str] | None = None
        hardware: HardwareBaseMetadata | None = None
        software: SoftwareBaseMetadata | None = None
    }

    class MACMulticastEndpoints {
        endpoints: list[MACEndpointUnion] = list
    }

    class SOMEIPServiceConsumer {
        deployment_type: Literal['someip_consumer'] = 'someip_consumer'
        service: int
        major_version: int = 0
        instance_id: int
        someip_sd_timings_profile: str
        consumed_eventgroups: list[str] | None = None
    }

    Controller ..> EmbeddedMetadata
    Controller ..> CANInterfaceConfig
    Controller ..> LINSlaveInterfaceConfig
    Controller ..> VirtualSwitch
    Controller ..> LINMasterInterfaceConfig
    Controller ..> EthernetInterface
    ControllerInterface ..> SGMII
    ControllerInterface ..> MacAddress
    ControllerInterface ..> PTPConfig
    ControllerInterface ..> HTBInstance
    ControllerInterface ..> TrafficClass
    ControllerInterface ..> VirtualControllerInterface
    ControllerInterface ..> ComputeNodes
    ControllerInterface ..> RGMII
    ControllerInterface ..> Firewall
    ControllerInterface ..> XFI
    ControllerInterface ..> MACsecConfig
    ControllerInterface ..> MII
    ControllerInterface ..> Stream
    ControllerInterface ..> RMII
    ControllerInterface ..> RouteEntry
    InternalTopology ..> InternalConnectionUnion
    MACMulticastEndpoints ..> MACEndpointUnion
    MulticastGroupMembership ..> IPvAnyAddress
    MulticastGroupMembership ..> MacAddress
    ECUPort ..> BASET1S
    ECUPort ..> SGMII
    ECUPort ..> BASET1
    ECUPort ..> BASET
    ECUPort ..> RGMII
    ECUPort ..> XFI
    ECUPort ..> MII
    ECUPort ..> RMII
    Socket ..> DeploymentUnion
    Socket ..> IPvAnyAddress
    Switch ..> VLANEntry
    Switch ..> EmbeddedMetadata
    Switch ..> TCAMRule
    Switch ..> ControllerInterface
    Switch ..> SwitchPort
    SwitchPort ..> SGMII
    SwitchPort ..> TrafficClass
    SwitchPort ..> RGMII
    SwitchPort ..> PTPConfig
    SwitchPort ..> MACsecConfig
    SwitchPort ..> XFI
    SwitchPort ..> MII
    SwitchPort ..> Stream
    SwitchPort ..> RMII
    ECUMetadata ..> BaseVersion
    ECUMetadata ..> SoftwareBaseMetadata
    ECUMetadata ..> HardwareBaseMetadata
    ECU ..> ECUPort
    ECU ..> InternalTopology
    ECU ..> Controller
    ECU ..> ECUMetadata
    ECU ..> MulticastGroupMembership
    ECU ..> MACMulticastEndpoints
    ECU ..> Switch


    

class ECU

Bases: UniqueName

Represents an Electronic Control Unit (ECU) in the network.

Parameters

namestr

Name of the ECU.

portslist of ECUPort

List of physical ECU ports. At least one port must be provided.

controllerslist of Controller

Controllers associated with this ECU.

switcheslist of Switch, optional

Switches integrated within the ECU. If not provided, the ECU contains no internal switches.

topologyInternalTopology

Internal topology defining the connectivity between ECU components.

multicast_groupslist of MulticastGroupMembership, optional

Multicast group memberships of the ECU. This field is populated automatically internally.

ecu_metadataECUMetadata

Metadata information describing the ECU.

ECU Ports Config

Expand for Schematic

        classDiagram

    class BASET1S {
        mode: Literal['base_t1s'] = 'base_t1s'
        speed: Literal[10] = 10
        duplex: Literal['half'] = 'half'
        role: Literal['master', 'slave']
        autonegotiation: bool = False
    }

    class SGMII {
        type: Literal['sgmii'] = 'sgmii'
        speed: Literal[10, 100, 1000, 2500] | None = 1000
        mode: Literal['mac', 'phy']
    }

    class BASET1 {
        mode: Literal['base_t1'] = 'base_t1'
        speed: Literal[100, 1000] = 100
        duplex: Literal['full'] = 'full'
        role: Literal['master', 'slave'] = 'slave'
        autonegotiation: bool = False
    }

    class BASET {
        mode: Literal['base_t'] = 'base_t'
        speed: Literal[100, 1000]
        duplex: Literal['full'] = 'full'
        role: Literal['master', 'slave'] = 'slave'
        autonegotiation: bool = False
    }

    class RGMII {
        type: Literal['rgmii'] = 'rgmii'
        speed: Literal[10, 100, 1000] | None = 1000
        mode: Literal['mac', 'phy']
    }

    class ECUPort {
        name: str
        mdi_config: BASET1 | BASET1S | BASET = BASET1
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
    }

    class XFI {
        type: Literal['xfi'] = 'xfi'
        speed: Literal[10000] = 10000
        mode: Literal['mac', 'phy']
    }

    class NamedDictInstances {
        name: str
    }

    class MII {
        type: Literal['mii'] = 'mii'
        speed: Literal[10, 100] | None = 100
        mode: Literal['mac', 'phy']
    }

    class RMII {
        type: Literal['rmii'] = 'rmii'
        speed: Literal[10, 100] | None = 100
        mode: Literal['mac', 'phy']
    }

    ECUPort ..> BASET1S
    ECUPort ..> SGMII
    ECUPort ..> BASET1
    ECUPort ..> BASET
    ECUPort ..> RGMII
    ECUPort ..> XFI
    ECUPort ..> MII
    ECUPort ..> RMII


    

Expand for a YAML example - 📄 ports.flync.yaml

Note

The external physical ports (and PHYs) of the ECUs of the system are configured in one dedicated file. For an ECU config, this file is mandatory since all ECUs need to define (at least) one port.

ports:
  - name: hpc1_p1
    mdi_config:
      mode: base_t1
      speed: 100
      duplex: full
      role: master
      autonegotiation: false
    mii_config:
      type: rmii
      speed: 100
      mode: phy

  - name: hpc1_p2
    mdi_config:
      mode: base_t1
      speed: 1000
      duplex: full
      role: master
      autonegotiation: false

  - name: hpc1_p3
    mdi_config:
      mode: base_t1
      speed: 1000
      duplex: full
      role: master
      autonegotiation: false

Hint

In case of a port with an external PHY, we need to include mdi_config (see Media-Dependent Interfaces), and mii_config (see Media-Independent Interfaces).

class ECUPort

Bases: NamedDictInstances

Represents an ECU port and its configuration.

This class encapsulates both the media-dependent (MDI) and media-independent (MII) interface configurations for a port.

Parameters

namestr

Name of the ECU port.

mdi_configBASET1 or BASET1S or BASET

Media-dependent interface configuration, such as BASE-T1, BASE-T1S or BASE-T.

mii_configMII or RMII or SGMII or RGMII, optional

Media-independent interface configuration, such as MII or RMII.

Private Attributes

_ecu :

The ECU of which the ECU Port is a part of.

_connected_component:

The switch port, controller interface or ecu port connected to the controller interface. This attribute is managed internally and is not part of the public API.

_type:

The type of the object generated. Set to ecu_port.

Controller Config

Changed in version 0.11.0: The Structure of the Controller configuration was significantly updated with Version 0.11.0! Make sure to upgrade your config to the new structure as described in the reference: ECUs - Controllers

Expand for Schematic

        classDiagram

    class VLANEntry {
        name: str
        id: int
        default_priority: int
        ports: list[str]
        multicast: list[MulticastGroup] | None = []
    }

    class NamedListInstances {
        name: str
    }

    class SocketContainer {
        name: str
        vlan_id: int | None = 0
        sockets: list[SocketTCP | SocketUDP] | None = list
    }

    class HTBInstance {
        root_id: str
        default_class: int | None = None
        child_classes: list[ChildClass]
    }

    class Controller {
        name: str
        controller_metadata: EmbeddedMetadata
        ethernet_interfaces: list[EthernetInterface] | None = list
        can_interfaces: list[CANInterfaceConfig] | None = list
        lin_interfaces: list[LINMasterInterfaceConfig | LINSlaveInterfaceConfig] | None = list
        virtual_switch: VirtualSwitch | None = None
    }

    class TrafficClass {
        name: str
        priority: int
        frame_priority_values: list[int] | None = []
        internal_priority_values: list[int] | None = []
        selection_mechanisms: CBSShaper | ATSShaper | None = None
    }

    class IPv6AddressEndpoint {
        address: IPv6Address
        ipv6prefix: int
        sockets: list[SocketTCP | SocketUDP] | None = list
    }

    class EmbeddedMetadata {
        type: Literal['embedded'] = 'embedded'
        author: str
        compatible_flync_version: BaseVersion
        extensions: dict[str, str] | None = None
        hardware: HardwareBaseMetadata | None = None
        app: SoftwareBaseMetadata | None = None
        bootloader: SoftwareBaseMetadata | None = None
        target_system: str
    }

    class Firewall {
        default_action: Literal['reject', 'accept', 'drop'] | None = 'reject'
        input_rules: list[FirewallRule] | None = []
        output_rules: list[FirewallRule] | None = []
        forward_rules: list[FirewallRule] | None = []
    }

    class VirtualControllerInterface {
        name: str
        vlanid: int | None = None
        addresses: list[IPv6AddressEndpoint | IPv4AddressEndpoint]
        multicast: list[IPvAnyAddress | MacAddress] | None = []
    }

    class EthernetInterface {
        interface_config: ControllerInterface
        sockets: list[SocketContainer] | None = list
    }

    class MII {
        type: Literal['mii'] = 'mii'
        speed: Literal[10, 100] | None = 100
        mode: Literal['mac', 'phy']
    }

    class RMII {
        type: Literal['rmii'] = 'rmii'
        speed: Literal[10, 100] | None = 100
        mode: Literal['mac', 'phy']
    }

    class RouteEntry {
        destination: IPv4AddressEntry | IPv6AddressEntry
        default_gateway: IPvAnyAddress
        egress_interface: str
    }

    class SGMII {
        type: Literal['sgmii'] = 'sgmii'
        speed: Literal[10, 100, 1000, 2500] | None = 1000
        mode: Literal['mac', 'phy']
    }

    class NamingStrategy {
        <<Enumeration>>
        AUTO: int = 0
        FIELD_NAME: int = 0
        FIXED_PATH: int = 1
    }

    class OutputStrategy {
        <<Enumeration>>
        AUTO: int = 1
        FOLDER: int = 1
        SINGLE_FILE: int = 2
        OMMIT_ROOT: int = 4
        FIXED_ROOT: int = 8
    }

    class IPv4AddressEndpoint {
        address: IPv4Address
        ipv4netmask: IPv4Address
        sockets: list[SocketTCP | SocketUDP] | None = list
    }

    class PTPConfig {
        cmlds_linkport_enabled: bool = False
        ptp_ports: list[PTPPort] = []
    }

    class VirtualSwitchPort {
        name: str
        node_connected: str
    }

    class ControllerInterface {
        name: str
        mac_address: MacAddress | None = None
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        compute_nodes: list[ComputeNodes] | None = list
        virtual_interfaces: list[VirtualControllerInterface] | None = list
        ptp_config: PTPConfig | None = None
        macsec_config: MACsecConfig | None = None
        firewall: Firewall | None = None
        htb: HTBInstance | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = list
        routing_table: list[RouteEntry] | None = []
    }

    class CANInterfaceConfig {
        bus_ref: str
        sender_frames: list[CANFrameRef] = list
        receiver_frames: list[CANFrameRef] = list
    }

    class ComputeNodes {
        name: str
        mac_address: MacAddress | None = None
        virtual_interfaces: list[VirtualControllerInterface]
        ptp_config: PTPConfig | None = None
        macsec_config: MACsecConfig | None = None
        firewall: Firewall | None = None
        htb: HTBInstance | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = list
    }

    class RGMII {
        type: Literal['rgmii'] = 'rgmii'
        speed: Literal[10, 100, 1000] | None = 1000
        mode: Literal['mac', 'phy']
    }

    class ImpliedStrategy {
        <<Enumeration>>
        AUTO: int = 0
        FOLDER_NAME: int = 0
        FILE_NAME: int = 1
    }

    class FLYNCBaseModel {
    }

    class VirtualSwitch {
        name: str
        ports: list[VirtualSwitchPort]
        vlans: list[VLANEntry]
    }

    class XFI {
        type: Literal['xfi'] = 'xfi'
        speed: Literal[10000] = 10000
        mode: Literal['mac', 'phy']
    }

    class NamedDictInstances {
        name: str
    }

    class MACsecConfig {
        vlan_bypass: list[int]
        mka_enabled: bool | None = True
        hello_time: int
        bounded_hello_time: int
        life_time: int
        sak_retire_time: int
        hello_time_rampup: list[int] = []
        sak_rekey_time: int | None = 3
        macsec_mode: Literal['disabled', 'integrity', 'integrity_confidentiality']
        kay_on: bool
        key_role: Literal['key_server_always', 'key_server_never']
        delay_protect: bool
        participant_activation: Literal['disabled', 'onoperup', 'always']
        sci_included: bool | None = False
        cipher_preference: list[IntegrityWithoutConfidentiality | IntegrityWithConfidentiality] = <lambda>
    }

    class Stream {
        name: str
        stream_identification: list[FrameFilter] = []
        drop_at_ingress: bool | None = False
        max_sdu_size: int | None = 1522
        policer: SingleRateTwoColorMarker | SingleRateThreeColorMarker | DoubleRateThreeColorMarker | None = None
        ipv: int | None = None
        ats: ATSInstance | None = None
    }

    CANInterfaceConfig ..> CANFrameRef
    RouteEntry ..> IPv4AddressEntry
    RouteEntry ..> IPvAnyAddress
    RouteEntry ..> IPv6AddressEntry
    SocketContainer ..> SocketTCP
    SocketContainer ..> SocketUDP
    IPv4AddressEndpoint ..> SocketTCP
    IPv4AddressEndpoint ..> SocketUDP
    IPv4AddressEndpoint ..> IPv4Address
    IPv6AddressEndpoint ..> SocketTCP
    IPv6AddressEndpoint ..> SocketUDP
    IPv6AddressEndpoint ..> IPv6Address
    VLANEntry ..> MulticastGroup
    EmbeddedMetadata ..> BaseVersion
    EmbeddedMetadata ..> SoftwareBaseMetadata
    EmbeddedMetadata ..> HardwareBaseMetadata
    Firewall ..> FirewallRule
    MACsecConfig ..> IntegrityWithConfidentiality
    MACsecConfig ..> IntegrityWithoutConfidentiality
    HTBInstance ..> ChildClass
    PTPConfig ..> PTPPort
    Stream ..> SingleRateTwoColorMarker
    Stream ..> ATSInstance
    Stream ..> DoubleRateThreeColorMarker
    Stream ..> FrameFilter
    Stream ..> SingleRateThreeColorMarker
    TrafficClass ..> CBSShaper
    TrafficClass ..> ATSShaper
    VirtualControllerInterface ..> IPv6AddressEndpoint
    VirtualControllerInterface ..> IPv4AddressEndpoint
    VirtualControllerInterface ..> IPvAnyAddress
    VirtualControllerInterface ..> MacAddress
    ComputeNodes ..> TrafficClass
    ComputeNodes ..> PTPConfig
    ComputeNodes ..> HTBInstance
    ComputeNodes ..> Firewall
    ComputeNodes ..> VirtualControllerInterface
    ComputeNodes ..> MACsecConfig
    ComputeNodes ..> MacAddress
    ComputeNodes ..> Stream
    VirtualSwitch ..> VLANEntry
    VirtualSwitch ..> VirtualSwitchPort
    ControllerInterface ..> SGMII
    ControllerInterface ..> MacAddress
    ControllerInterface ..> PTPConfig
    ControllerInterface ..> HTBInstance
    ControllerInterface ..> TrafficClass
    ControllerInterface ..> VirtualControllerInterface
    ControllerInterface ..> ComputeNodes
    ControllerInterface ..> RGMII
    ControllerInterface ..> Firewall
    ControllerInterface ..> XFI
    ControllerInterface ..> MACsecConfig
    ControllerInterface ..> MII
    ControllerInterface ..> Stream
    ControllerInterface ..> RMII
    ControllerInterface ..> RouteEntry
    EthernetInterface ..> SocketContainer
    EthernetInterface ..> ControllerInterface
    Controller ..> EmbeddedMetadata
    Controller ..> CANInterfaceConfig
    Controller ..> LINSlaveInterfaceConfig
    Controller ..> VirtualSwitch
    Controller ..> LINMasterInterfaceConfig
    Controller ..> EthernetInterface


    

Note

All controllers of an ECU are configured in the respective directory inside 📁 controllers/. This is a mandatory dir for the ECU configuration, since all ECUs need to define (at least) one controller.

class Controller

Bases: NamedListInstances

Represents a controller device that contains multiple interfaces.

Parameters

namestr

Name of the controller.

controller_metadataEmbeddedMetadata

Metadata describing the embedded controller.

ethernet_interfaceslist of EthernetInterface

Ethernet interfaces of the controller.

virtual_switch: VirtualSwitch

Represents a software switch inside a controller in case there are more than one interface or virtual machines/ compute nodes.

Private Attributes

_type:

The type of the object generated. Defaults to “Controller”.

Ethernet Interfaces

Expand for a YAML example - 📄 interface_config.flync.yaml

Note

The configuration of a controller interface is defined in one file per Controller.

name: hpc_c1_iface1
mac_address: 00:11:02:01:01:01
mii_config:
  type: rmii
  speed: 100
  mode: phy
virtual_interfaces:
  - name: hpc_c1_i1_viface1
    vlanid: 10
    addresses:
      - address: 10.0.10.5
        ipv4netmask: 255.255.255.0
    multicast:
    - 91:E0:F0:00:00:AA
    - 91:E0:F0:00:00:BB
  - name: hpc_c1_i1_viface2
    vlanid: 20
    addresses:
      - address: 10.0.20.5
        ipv4netmask: 255.255.255.0
    multicast:
      - 224.244.224.245
      - 224.0.0.15
  - name: hpc_c1_i1_viface3
    vlanid: 50
    addresses:
      - address: 10.0.50.5
        ipv4netmask: 255.255.255.0
  - name: hpc_c1_i1_viface4
    vlanid: 40
    addresses:
      - address: 10.0.40.5
        ipv4netmask: 255.255.255.0
    multicast:
    - 224.0.0.1
ptp_config:
  cmlds_linkport_enabled: false
  ptp_ports:
    - domain_id: 0
      src_port_identity: 1
      sync_config:
        type: time_receiver
        sync_timeout: 3
        sync_followup_timeout: 10
      pdelay_config:
        log_tx_period: 1
macsec_config:
  vlan_bypass: []
  mka_enabled: true
  hello_time: 1000
  bounded_hello_time: 2000
  life_time: 100000
  sak_retire_time: 20000
  macsec_mode: integrity
  kay_on: true
  key_role: key_server_always
  delay_protect: false
  participant_activation: always

Hint

For controller interfaces that have an external PHY, the mii_config (see Media-Independent Interfaces) for that interface must be provided. For controller interfaces with integrated PHY, no mii_config is needed.

Warning

In any case, the MDI configuration is never configured on the controller interface, but on the ECU Ports. See ECU Ports Config for more details.

class EthernetInterface

Bases: FLYNCBaseModel

An Ethernet Interface of a Controller.

Parameters

interface_config: ControllerInterface

Configuration of the Controller Interface.

sockets: optional list of SocketContainer

class ControllerInterface

Bases: NamedDictInstances

A physical Ethernet interface on a controller.

A controller interface is the hardware-level network endpoint of the controller. It can be used in two ways:

• Direct mode — virtual interfaces (VLANs) are stacked directly on the physical interface. No compute nodes or Virtual Switch are needed.

• Bridge mode — one or more ComputeNodes (VMs) are attached to the interface. In this case the VirtualSwitch defined on the parent Controller acts as a software MAC bridge: it connects the physical interface and each compute node together, and can also bridge multiple physical interfaces at Layer 2.

Network features (PTP, MACsec, ingress stream policing, traffic shaping) can be configured at the interface level or offloaded to individual compute nodes, but not on both simultaneously.

Parameters

namestr

Interface name.

mac_addressMacAddress, optional

MAC address of the physical interface in standard notation.

mii_configMII or RMII or SGMII or RGMII, optional

Media-independent interface configuration.

compute_nodeslist of ComputeNodes, optional

VMs attached to this interface. When present, an VirtualSwitch must be defined on the parent Controller to connect them.

virtual_interfaceslist of VirtualControllerInterface, optional

VLAN-tagged virtual interfaces stacked directly on this physical interface (used in direct mode, without compute nodes).

ptp_configPTPConfig, optional

Precision Time Protocol configuration.

macsec_configMACsecConfig, optional

MACsec configuration.

firewallFirewall, optional

Firewall configuration for the interface.

htbHTBInstance, optional

Hierarchical Token Bucket (HTB) egress shaping configuration.

ingress_streamslist of Stream, optional

IEEE 802.1Qci ingress stream policing configuration.

traffic_classeslist of TrafficClass, optional

Traffic class definitions and egress queue shaping configuration.

routing_tablelist of RouteEntry, optional

Static routing table for forwarding between subnets. When provided, this interface acts as an IP router. Each entry maps a destination network to a default_gateway IP and an egress_interface (VCI name).

Private Attributes

_connected_component :

The switch port, controller interface, or ECU port connected to this interface. Managed internally; not part of the public API.

_type :

Fixed to "controller_interface".

class VirtualControllerInterface

Bases: FLYNCBaseModel

A VLAN-tagged virtual interface stacked on top of a physical controller interface or a compute node.

Each virtual interface represents one logical network endpoint, identified by a VLAN ID and assigned one or more IP addresses. Multiple virtual interfaces can be defined on the same physical interface or compute node to separate traffic across different VLANs.

Parameters

namestr

Name of the virtual interface.

vlanidint, optional

VLAN identifier. Values 0-4094 are accepted; 4095 is reserved by IEEE 802.1Q and emits a warning when used. None denotes an untagged virtual interface.

addresseslist of IPv4AddressEndpoint or IPv6AddressEndpoint

Assigned IPv4 and IPv6 address endpoints.

multicastlist of IPv4Address or IPv6Address or str, optional

Allowed multicast addresses.

class ComputeNodes

Bases: FLYNCBaseModel

WARNING: ComputeNode is currently experimental! Subject to change, please use with care.

A virtual machine (VM) attached to a controller interface.

Compute nodes are VMs that run on the same SoC as the controller. Each compute node has its own MAC address and one or more virtual interfaces (VLANs). Traffic between a compute node and the physical network is forwarded through the VirtualSwitch defined on the parent Controller — the Virtual Switch acts as a software MAC bridge that connects compute nodes to the controller interface and to each other.

Network features such as PTP, MACsec, ingress stream policing, and traffic shaping can be configured either on the parent ControllerInterface or offloaded to individual compute nodes, but not on both simultaneously.

Parameters

namestr

Name of the compute node / VM.

mac_addressMacAddress, optional

MAC address of the compute node in standard notation.

virtual_interfaceslist of VirtualControllerInterface

One or more VLAN-tagged virtual interfaces exposed by this compute node.

ptp_configPTPConfig, optional

Precision Time Protocol configuration (offloaded from the interface).

macsec_configMACsecConfig, optional

MACsec configuration (offloaded from the interface).

firewallFirewall, optional

Firewall configuration for this compute node.

htbHTBInstance, optional

Hierarchical Token Bucket (HTB) egress shaping configuration.

ingress_streamslist of Stream, optional

IEEE 802.1Qci ingress stream policing configuration.

traffic_classeslist of TrafficClass, optional

Traffic class definitions and egress queue shaping configuration.

Virtual Switch

Expand for a YAML example - 📄 virtual_switch.flync.yaml

Note

A Virtual Switch is defined in a separate file per Controller.

name: br0
ports:
  - name: br0_p1
    node_connected: eth_ecu_vm1
  - name: br0_p2
    node_connected: eth_ecu_vm2
  - name: br0_p3
    node_connected: eth_ecu_c1_iface1
vlans:
  - name: VLAN40
    id: 40
    default_priority: 0
    ports:
      - br0_p1
      - br0_p3
  - name: VLAN50
    id: 50
    default_priority: 0
    ports:
      - br0_p2
      - br0_p3

class VirtualSwitch

Bases: FLYNCBaseModel

WARNING: VirtualSwitch is currently experimental! Subject to change, please use with care.

A software MAC bridge inside a controller.

The Virtual Switch is the connectivity fabric that ties together the controller’s physical interfaces and their compute nodes. It must be defined on the Controller whenever compute nodes are present or when multiple interfaces need to exchange traffic at Layer 2.

Each VirtualSwitchPort references either a ControllerInterface or a ComputeNodes by name. VLANs defined on the bridge control which ports share broadcast domains, mirroring the role of VLANs on a hardware switch.

Parameters

namestr

Name of the Virtual Switch instance.

portslist of VirtualSwitchPort

Ports of the virtual switch, each referencing a controller interface or compute node.

vlanslist of VLANEntry

VLAN membership table: defines which ports belong to each VLAN and therefore which nodes can communicate at Layer 2.

class VirtualSwitchPort

Bases: FLYNCBaseModel

A port on the VirtualSwitch, referencing a connected node by name.

Each port is bound to either a ControllerInterface or a ComputeNodes instance. The node_connected name must match the name field of one of those objects within the same controller.

Parameters

namestr

Name of the port.

node_connectedstr

Name of the connected ControllerInterface or ComputeNodes.

Socket Config

Expand for Schematic

        classDiagram

    class SocketUDP {
        name: str
        endpoint_address: IPvAnyAddress
        port_no: int
        deployments: list[DeploymentUnion] | None = list
        endpoint_type: Literal['multicast', 'unicast'] | None = <lambda>
        multicast_tx: list[IPvAnyAddress] | None = list
        protocol: Literal['udp'] = 'udp'
        udp_options: UDPOption | None = udp_cork=False
    }

    class SOMEIPSDDeployment {
        deployment_type: Literal['someip_sd'] = 'someip_sd'
        multicast: MulticastSDEndpoint | None = None
    }

    class IPv6AddressEndpoint {
        address: IPv6Address
        ipv6prefix: int
        sockets: list[SocketTCP | SocketUDP] | None = list
    }

    class DictInstances {
    }

    class IPv6AddressEntry {
        address: IPv6Address
        ipv6prefix: int
    }

    class PDUReceiver {
        deployment_type: Literal['pdu_receiver'] = 'pdu_receiver'
        pdu_ref: str
    }

    class SocketTCP {
        name: str
        endpoint_address: IPvAnyAddress
        port_no: int
        deployments: list[DeploymentUnion] | None = list
        endpoint_type: Literal['multicast', 'unicast'] | None = <lambda>
        multicast_tx: list[IPvAnyAddress] | None = list
        protocol: Literal['tcp'] = 'tcp'
        tcp_profile: int
    }

    class Socket {
        name: str
        endpoint_address: IPvAnyAddress
        port_no: int
        deployments: list[DeploymentUnion] | None = list
        endpoint_type: Literal['multicast', 'unicast'] | None = <lambda>
        multicast_tx: list[IPvAnyAddress] | None = list
    }

    class IPv4AddressEndpoint {
        address: IPv4Address
        ipv4netmask: IPv4Address
        sockets: list[SocketTCP | SocketUDP] | None = list
    }

    class RootModel {
        root: RootModelRootType
    }

    class UDPOption {
        udp_cork: bool | None = False
    }

    class PDUSender {
        deployment_type: Literal['pdu_sender'] = 'pdu_sender'
        pdu_ref: str
    }

    class DeploymentUnion {
        root: SOMEIPServiceConsumer | SOMEIPServiceProvider | SOMEIPSDDeployment | PDUSender | PDUReceiver
    }

    class FLYNCBaseModel {
    }

    class SOMEIPServiceProvider {
        deployment_type: Literal['someip_provider'] = 'someip_provider'
        service: int
        major_version: int
        instance_id: int
        someip_sd_timings_profile: str
        minor_version: int = 0
        provided_eventgroups: list[str] | None = None
    }

    class IPv4AddressEntry {
        address: IPv4Address
        ipv4netmask: IPv4Address
    }

    class TCPOption {
        tcp_profile_id: int
        nagle: bool | None = False
        keepalive_enabled: bool | None = True
        keepidle: int | None = 10
        keepcount: int | None = 10
        keepintvl: int | None = 2
        user_timeout: int | None = 28
        congestion_avoidance: Literal['reno', 'cubic', 'bbr'] | None = 'reno'
        tcp_maxseg: int | None = 1460
        tcp_quickack: bool | None = False
        tcp_syncnt: int | None = 6
    }

    class SOMEIPServiceConsumer {
        deployment_type: Literal['someip_consumer'] = 'someip_consumer'
        service: int
        major_version: int = 0
        instance_id: int
        someip_sd_timings_profile: str
        consumed_eventgroups: list[str] | None = None
    }

    RootModel ..> RootModelRootType
    IPv4AddressEntry ..> IPv4Address
    IPv6AddressEntry ..> IPv6Address
    SOMEIPSDDeployment ..> MulticastSDEndpoint
    DeploymentUnion ..> SOMEIPServiceProvider
    DeploymentUnion ..> SOMEIPSDDeployment
    DeploymentUnion ..> PDUSender
    DeploymentUnion ..> PDUReceiver
    DeploymentUnion ..> SOMEIPServiceConsumer
    Socket ..> DeploymentUnion
    Socket ..> IPvAnyAddress
    SocketTCP ..> DeploymentUnion
    SocketTCP ..> IPvAnyAddress
    SocketUDP ..> UDPOption
    SocketUDP ..> DeploymentUnion
    SocketUDP ..> IPvAnyAddress
    IPv4AddressEndpoint ..> SocketTCP
    IPv4AddressEndpoint ..> SocketUDP
    IPv4AddressEndpoint ..> IPv4Address
    IPv6AddressEndpoint ..> SocketTCP
    IPv6AddressEndpoint ..> SocketUDP
    IPv6AddressEndpoint ..> IPv6Address


    

Expand for a YAML example - 📁 sockets/

Note

This directory contains files that define a group of sockets per VLAN for a specific ethernet interface. Each file defines the sockets (VLAN ID, address endpoint and port number) and lists the deployments that use each socket.

It is advisable to keep sockets that provide similar functionality together (e.g. all SOME/IP sockets in the same file).

vlan_id: 20
sockets:
- name: sd_multicast_socket
  endpoint_address: 10.0.20.5
  endpoint_type: multicast
  port_no: 30490
  protocol: udp
  multicast_tx:
  - 224.244.224.245
  deployments:
  - deployment_type: someip_sd
    multicast:
      ip_address: 224.244.224.245
      port: 30490
      ip_ttl: 1
- name: someip_client_socket_udp1
  endpoint_address: 10.0.20.5
  endpoint_type: unicast
  port_no: 30491
  protocol: udp
  deployments:
  - deployment_type: someip_consumer
    service: 0x0101
    instance_id: 0xf4
    major_version: 1
    consumed_eventgroups:
    - eg2_all
    - eg5_events_and_fields_unreliable
    someip_sd_timings_profile: client_default
- name: someip_client_socket_tcp1
  endpoint_address: 10.0.20.5
  endpoint_type: unicast
  port_no: 30491
  protocol: tcp
  tcp_profile: 1
  deployments:
  - deployment_type: someip_consumer
    service: 0x0101
    instance_id: 0xf4
    major_version: 1
    consumed_eventgroups:
    - eg2_all
    someip_sd_timings_profile: client_default
- name: someip_server_socket_udp1
  endpoint_address: 10.0.20.5
  endpoint_type: unicast
  port_no: 30501
  protocol: udp
  multicast_tx:
  - 224.0.0.15
  deployments:
  - deployment_type: someip_provider
    service: 0x0101
    instance_id: 1
    major_version: 1
    minor_version: 0
    someip_sd_timings_profile: server_default
- name: someip_server_socket_tcp1
  endpoint_address: 10.0.20.5
  endpoint_type: unicast
  port_no: 30501
  protocol: tcp
  tcp_profile: 1
  multicast_tx:
  - 224.0.0.15
  deployments:
  - deployment_type: someip_provider
    service: 0x0101
    instance_id: 1
    major_version: 1
    minor_version: 0
    someip_sd_timings_profile: server_default

class SocketContainer

Bases: FLYNCBaseModel

Represents a socket container for the ecu.

Parameters

namestr

Name of the socket container, implied from the filename on disk.

vlan_idint, optional

ID of the virtual interface. Use None for an untagged container.

socketslist of SocketTCP or SocketUDP

Assigned TCP and UDP socket endpoints.

class Socket

Bases: FLYNCBaseModel

Defines a virtual-interface socket that is bound to a specific IP address.

Parameters

namestr

A readable identifier for the socket.

endpoint_addressIPv4Address or IPv6Address

The IP address assigned to the socket.

port_noint

The port number the socket uses for communication.

deploymentslist of DeploymentUnion, optional

Deployments of the socket.

endpoint_typeLiteral[“multicast”, “unicast”], optional

The type of the socket endpoint, which can be either “multicast” or “unicast”. This field is per default automatically determined based on the value of endpoint_address, but can be overridden by explicitly providing a value.

multicast_txlist of IPv4Multicast or IPv6Multicast, optional

Multicast addresses that the socket is allowed to transmit to (only applicable for sockets with a multicast endpoint_type).

class SocketUDP

Bases: Socket

Represents a UDP socket.

Parameters

protocolLiteral[“udp”]

Transport protocol for the socket. Defaults to "udp".

udp_optionsUDPOption, optional

The UDP options that can be configured for this socket.

class SocketTCP

Bases: Socket

Represents a TCP socket.

Parameters

protocolLiteral[“tcp”]

Transport protocol for the socket. Defaults to "tcp".

tcp_profileint

The unique identifier of the TCP profile whose options are applied to the socket.

Endpoints

class IPv4AddressEndpoint

Bases: IPv4AddressEntry

Represents an IPv4 address endpoint for a network interface.

Parameters

socketslist of SocketTCP or SocketUDP

Assigned TCP and UDP socket endpoints.

class IPv6AddressEndpoint

Bases: IPv6AddressEntry

Represents an IPv6 address endpoint for a network interface.

Parameters

socketslist of SocketTCP or SocketUDP

Assigned TCP and UDP socket endpoints.

Deployments

class DeploymentUnion

Bases: RootModel

Union type representing a deployment configuration for a socket. This model wraps a union of different deployment models and uses the deployment_type field as a discriminator to determine which specific deployment model is present.

Possible types

SOMEIPServiceConsumer or SOMEIPServiceProvider or SOMEIPSDDeployment or PDUSender or PDUReceiver

Switch Config

Expand for Schematic

        classDiagram

    class VLANEntry {
        name: str
        id: int
        default_priority: int
        ports: list[str]
        multicast: list[MulticastGroup] | None = []
    }

    class Mirror {
        type: Literal['mirror'] = 'mirror'
        ports: list[str]
    }

    class NamedListInstances {
        name: str
    }

    class FrameFilter {
        src_mac: str | MACAddressEntry | list[str | MACAddressEntry] | None = None
        dst_mac: str | MACAddressEntry | list[str | MACAddressEntry] | None = None
        vlan_tagged: bool | None = None
        vlanid: int | ValueRange | list[int | ValueRange] | None = None
        pcp: int | list[int] | None = None
        src_ipv4: IPv4AddressEntry | IPv4Address | list[IPv4AddressEntry | IPv4Address] | None = None
        dst_ipv4: IPv4AddressEntry | IPv4Address | list[IPv4AddressEntry | IPv4Address] | None = None
        src_ipv6: IPv6AddressEntry | IPv6Address | list[IPv6AddressEntry | IPv6Address] | None = None
        dst_ipv6: IPv6AddressEntry | IPv6Address | list[IPv6AddressEntry | IPv6Address] | None = None
        protocol: Literal['tcp'] | Literal['udp'] | None = None
        src_port: int | ValueRange | list[int | ValueRange] | None = None
        dst_port: int | ValueRange | list[int | ValueRange] | None = None
    }

    class TrafficClass {
        name: str
        priority: int
        frame_priority_values: list[int] | None = []
        internal_priority_values: list[int] | None = []
        selection_mechanisms: CBSShaper | ATSShaper | None = None
    }

    class SwitchPort {
        name: str
        silicon_port_no: int
        default_vlan_id: int
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        ptp_config: PTPConfig | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = []
        macsec_config: MACsecConfig | None = None
    }

    class ForceEgress {
        type: Literal['force_egress'] = 'force_egress'
        ports: list[str]
    }

    class EmbeddedMetadata {
        type: Literal['embedded'] = 'embedded'
        author: str
        compatible_flync_version: BaseVersion
        extensions: dict[str, str] | None = None
        hardware: HardwareBaseMetadata | None = None
        app: SoftwareBaseMetadata | None = None
        bootloader: SoftwareBaseMetadata | None = None
        target_system: str
    }

    class MII {
        type: Literal['mii'] = 'mii'
        speed: Literal[10, 100] | None = 100
        mode: Literal['mac', 'phy']
    }

    class VLANOverwrite {
        type: Literal['vlan_overwrite'] = 'vlan_overwrite'
        overwrite_vlan_id: int | None = None
        overwrite_vlan_pcp: int | None = None
        ports: list[str]
    }

    class RMII {
        type: Literal['rmii'] = 'rmii'
        speed: Literal[10, 100] | None = 100
        mode: Literal['mac', 'phy']
    }

    class BASET1S {
        mode: Literal['base_t1s'] = 'base_t1s'
        speed: Literal[10] = 10
        duplex: Literal['half'] = 'half'
        role: Literal['master', 'slave']
        autonegotiation: bool = False
    }

    class SGMII {
        type: Literal['sgmii'] = 'sgmii'
        speed: Literal[10, 100, 1000, 2500] | None = 1000
        mode: Literal['mac', 'phy']
    }

    class RemoveVLAN {
        type: Literal['remove_vlan'] = 'remove_vlan'
        ports: list[str]
    }

    class BASET1 {
        mode: Literal['base_t1'] = 'base_t1'
        speed: Literal[100, 1000] = 100
        duplex: Literal['full'] = 'full'
        role: Literal['master', 'slave'] = 'slave'
        autonegotiation: bool = False
    }

    class PTPConfig {
        cmlds_linkport_enabled: bool = False
        ptp_ports: list[PTPPort] = []
    }

    class ControllerInterface {
        name: str
        mac_address: MacAddress | None = None
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        compute_nodes: list[ComputeNodes] | None = list
        virtual_interfaces: list[VirtualControllerInterface] | None = list
        ptp_config: PTPConfig | None = None
        macsec_config: MACsecConfig | None = None
        firewall: Firewall | None = None
        htb: HTBInstance | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = list
        routing_table: list[RouteEntry] | None = []
    }

    class BASET {
        mode: Literal['base_t'] = 'base_t'
        speed: Literal[100, 1000]
        duplex: Literal['full'] = 'full'
        role: Literal['master', 'slave'] = 'slave'
        autonegotiation: bool = False
    }

    class TCAMRule {
        name: str
        id: int
        match_filter: FrameFilter
        match_ports: list[str]
        action: list[Drop | Mirror | VLANOverwrite | ForceEgress | RemoveVLAN]
    }

    class Switch {
        name: str
        tcam_rules: list[TCAMRule] | None = []
        ports: list[SwitchPort]
        vlans: list[VLANEntry]
        host_controller: ControllerInterface | None = None
        meta: EmbeddedMetadata
    }

    class RGMII {
        type: Literal['rgmii'] = 'rgmii'
        speed: Literal[10, 100, 1000] | None = 1000
        mode: Literal['mac', 'phy']
    }

    class FLYNCBaseModel {
    }

    class XFI {
        type: Literal['xfi'] = 'xfi'
        speed: Literal[10000] = 10000
        mode: Literal['mac', 'phy']
    }

    class Drop {
        type: Literal['drop'] = 'drop'
        ports: list[str]
    }

    class NamedDictInstances {
        name: str
    }

    class MACsecConfig {
        vlan_bypass: list[int]
        mka_enabled: bool | None = True
        hello_time: int
        bounded_hello_time: int
        life_time: int
        sak_retire_time: int
        hello_time_rampup: list[int] = []
        sak_rekey_time: int | None = 3
        macsec_mode: Literal['disabled', 'integrity', 'integrity_confidentiality']
        kay_on: bool
        key_role: Literal['key_server_always', 'key_server_never']
        delay_protect: bool
        participant_activation: Literal['disabled', 'onoperup', 'always']
        sci_included: bool | None = False
        cipher_preference: list[IntegrityWithoutConfidentiality | IntegrityWithConfidentiality] = <lambda>
    }

    class Stream {
        name: str
        stream_identification: list[FrameFilter] = []
        drop_at_ingress: bool | None = False
        max_sdu_size: int | None = 1522
        policer: SingleRateTwoColorMarker | SingleRateThreeColorMarker | DoubleRateThreeColorMarker | None = None
        ipv: int | None = None
        ats: ATSInstance | None = None
    }

    ControllerInterface ..> SGMII
    ControllerInterface ..> MacAddress
    ControllerInterface ..> PTPConfig
    ControllerInterface ..> HTBInstance
    ControllerInterface ..> TrafficClass
    ControllerInterface ..> VirtualControllerInterface
    ControllerInterface ..> ComputeNodes
    ControllerInterface ..> RGMII
    ControllerInterface ..> Firewall
    ControllerInterface ..> XFI
    ControllerInterface ..> MACsecConfig
    ControllerInterface ..> MII
    ControllerInterface ..> Stream
    ControllerInterface ..> RMII
    ControllerInterface ..> RouteEntry
    VLANEntry ..> MulticastGroup
    EmbeddedMetadata ..> BaseVersion
    EmbeddedMetadata ..> SoftwareBaseMetadata
    EmbeddedMetadata ..> HardwareBaseMetadata
    MACsecConfig ..> IntegrityWithConfidentiality
    MACsecConfig ..> IntegrityWithoutConfidentiality
    FrameFilter ..> IPv6Address
    FrameFilter ..> IPv6AddressEntry
    FrameFilter ..> IPv4Address
    FrameFilter ..> IPv4AddressEntry
    FrameFilter ..> ValueRange
    FrameFilter ..> MACAddressEntry
    PTPConfig ..> PTPPort
    Stream ..> SingleRateTwoColorMarker
    Stream ..> ATSInstance
    Stream ..> DoubleRateThreeColorMarker
    Stream ..> FrameFilter
    Stream ..> SingleRateThreeColorMarker
    TrafficClass ..> CBSShaper
    TrafficClass ..> ATSShaper
    SwitchPort ..> SGMII
    SwitchPort ..> TrafficClass
    SwitchPort ..> RGMII
    SwitchPort ..> PTPConfig
    SwitchPort ..> MACsecConfig
    SwitchPort ..> XFI
    SwitchPort ..> MII
    SwitchPort ..> Stream
    SwitchPort ..> RMII
    TCAMRule ..> Mirror
    TCAMRule ..> RemoveVLAN
    TCAMRule ..> FrameFilter
    TCAMRule ..> Drop
    TCAMRule ..> VLANOverwrite
    TCAMRule ..> ForceEgress
    Switch ..> VLANEntry
    Switch ..> EmbeddedMetadata
    Switch ..> TCAMRule
    Switch ..> ControllerInterface
    Switch ..> SwitchPort


    

Expand for a YAML example - 📁 switches/

Note

The switches directory contains the individual configuration files for every ethernet switch that is present in that ECU. This is a non-mandatory directory for the ECU configuration, since not all ECUs have switches.

meta:
  author: Dev
  compatible_flync_version:
    version_schema: semver
    version: 0.11.0
  target_system: flync_os
name: hpc_switch1
ports:
- name: hpc_s1_p0
  silicon_port_no: 0
  default_vlan_id: 1
  mii_config:
    type: rmii
    speed: 100
    mode: mac
  ptp_config:
      cmlds_linkport_enabled: false
      ptp_ports:
        - domain_id: 0
          src_port_identity: 2
          sync_config:
            type: time_receiver
            sync_timeout: 3
            sync_followup_timeout: 10
          pdelay_config:
            log_tx_period: 1
  ingress_streams:
    - name: stream_0
      stream_identification:
        - vlanid: [10, 20, 30, 40]
          dst_ipv4:
            address: 10.0.0.0
            ipv4netmask: 255.255.0.0
          protocol: udp
          dst_port:
            from_value: 32000
            to_value: 33000
      drop_at_ingress: false
      max_sdu_size: 1522
      policer:
        type: single_rate_two_color
        cir: 10000
        cbs: 10000
        eir: 0
        ebs: 5000
        coupling: false
    - name: stream_1
      stream_identification:
        - vlanid: 10
          dst_ipv4:
            address: 224.0.0.0
            ipv4netmask: 255.0.0.0
          protocol: tcp
      drop_at_ingress: false
      max_sdu_size: 1522
      policer:
        type: double_rate_three_color
        cir: 10000
        cbs: 10000
        eir: 20000
        ebs: 2000
        coupling: true
  traffic_classes:
    - name: high_prio
      priority: 7
      frame_priority_values: [7, 6, 5, 4]
      selection_mechanisms:
        type: cbs
        idleslope: 50000
    - name: best_effort
      priority: 1
      frame_priority_values: [3, 2, 1, 0]
      selection_mechanisms:
        type: cbs
        idleslope: 10000
  macsec_config:
    vlan_bypass: []
    mka_enabled: true
    hello_time: 1000
    bounded_hello_time: 2000
    life_time: 100000
    sak_retire_time: 20000
    macsec_mode: integrity
    kay_on: true
    key_role: key_server_never
    delay_protect: false
    participant_activation: always

- name: hpc_s1_p1
  silicon_port_no: 1
  default_vlan_id: 1
  mii_config:
    type: rmii
    speed: 100
    mode: mac
  ptp_config:
      cmlds_linkport_enabled: false
      ptp_ports:
        - domain_id: 0
          src_port_identity: 3
          sync_config:
            type: time_transmitter
            log_tx_period: -3
            two_step: true
            tlv: []
  macsec_config:
      vlan_bypass: []
      mka_enabled: true
      hello_time: 1000
      bounded_hello_time: 2000
      life_time: 100000
      sak_retire_time: 20000
      macsec_mode: integrity
      kay_on: true
      key_role: key_server_never
      delay_protect: false
      participant_activation: always



- name: hpc_s1_p2
  silicon_port_no: 2
  default_vlan_id: 1
  mii_config:
    type: rmii
    speed: 100
    mode: mac
  macsec_config:
      vlan_bypass: []
      mka_enabled: true
      hello_time: 1000
      bounded_hello_time: 2000
      life_time: 100000
      sak_retire_time: 20000
      macsec_mode: integrity
      kay_on: true
      key_role: key_server_never
      delay_protect: false
      participant_activation: always

- name: hpc_s1_p3
  silicon_port_no: 3
  default_vlan_id: 1
  ptp_config:
      cmlds_linkport_enabled: false
      ptp_ports:
        - domain_id: 0
          src_port_identity: 4
          sync_config:
            type: time_transmitter
            log_tx_period: -3
            two_step: true
            tlv: []
  ingress_streams:
    - name: stream_0
      stream_identification:
        - vlanid: [10, 20, 30, 40]
          dst_ipv4:
            address: 10.0.0.0
            ipv4netmask: 255.255.0.0
          protocol: udp
          dst_port:
            from_value: 32000
            to_value: 33000
      drop_at_ingress: false
      max_sdu_size: 1522
      policer:
        type: single_rate_two_color
        cir: 10000
        cbs: 10000
        eir: 0
        ebs: 5000
        coupling: false
    - name: stream_1
      stream_identification:
        - vlanid: 10
          dst_ipv4:
            address: 224.0.0.0
            ipv4netmask: 255.0.0.0
          protocol: tcp
      drop_at_ingress: false
      max_sdu_size: 1522
      policer:
        type: double_rate_three_color
        cir: 10000
        cbs: 10000
        eir: 20000
        ebs: 2000
        coupling: true
  traffic_classes:
    - name: high_prio
      priority: 7
      frame_priority_values: [7, 6, 5, 4]
      selection_mechanisms:
        type: cbs
        idleslope: 50000
    - name: best_effort
      priority: 1
      frame_priority_values: [3, 2, 1, 0]
      selection_mechanisms:
        type: cbs
        idleslope: 10000
  macsec_config:
      vlan_bypass: []
      mka_enabled: true
      hello_time: 1000
      bounded_hello_time: 2000
      life_time: 100000
      sak_retire_time: 20000
      macsec_mode: integrity
      kay_on: true
      key_role: key_server_never
      delay_protect: false
      participant_activation: always

- name: hpc_s1_p4
  silicon_port_no: 4
  default_vlan_id: 1
  ptp_config:
      cmlds_linkport_enabled: false
      ptp_ports:
        - domain_id: 0
          src_port_identity: 5
          sync_config:
            type: time_transmitter
            log_tx_period: -3
            two_step: true
            tlv: []
  ingress_streams:
    - name: stream_0
      stream_identification:
        - vlanid: [10, 20, 30, 40]
          dst_ipv4:
            address: 10.0.0.0
            ipv4netmask: 255.255.0.0
          protocol: udp
          dst_port:
            from_value: 32000
            to_value: 33000
      drop_at_ingress: false
      max_sdu_size: 1522
      policer:
        type: single_rate_two_color
        cir: 10000
        cbs: 10000
        eir: 0
        ebs: 5000
        coupling: false
    - name: stream_1
      stream_identification:
        - vlanid: 10
          dst_ipv4:
            address: 224.0.0.0
            ipv4netmask: 255.0.0.0
          protocol: tcp
      drop_at_ingress: false
      max_sdu_size: 1522
      policer:
        type: double_rate_three_color
        cir: 10000
        cbs: 10000
        eir: 20000
        ebs: 2000
        coupling: true
  traffic_classes:
    - name: high_prio
      priority: 7
      frame_priority_values: [7, 6, 5, 4]
      selection_mechanisms:
        type: cbs
        idleslope: 50000
    - name: best_effort
      priority: 1
      frame_priority_values: [3, 2, 1, 0]
      selection_mechanisms:
        type: cbs
        idleslope: 10000
  macsec_config:
      vlan_bypass: []
      mka_enabled: true
      hello_time: 1000
      bounded_hello_time: 2000
      life_time: 100000
      sak_retire_time: 20000
      macsec_mode: integrity
      kay_on: true
      key_role: key_server_never
      delay_protect: false
      participant_activation: always


vlans:
- name: VLAN10
  id: 10
  default_priority: 0
  ports:
    - hpc_s1_p0
    - hpc_s1_p1

- name: VLAN20
  id: 20
  default_priority: 0
  ports:
    - hpc_s1_p0
    - hpc_s1_p1
    - hpc_s1_p4

- name: VLAN30
  id: 30
  default_priority: 0
  ports:
    - hpc_s1_p0
    - hpc_s1_p2

- name: VLAN40
  id: 40
  default_priority: 0
  ports:
    - hpc_s1_p2
    - hpc_s1_p3
    - hpc_s1_p4
    - hpc_s1_p1
    - hpc_s1_p0

- name: VLAN50
  id: 50
  default_priority: 0
  ports:
    - hpc_s1_p1


host_controller:
  name: hpc_sw_host_iface
  mac_address: 00:11:02:03:01:01
  virtual_interfaces:
    - name: hpc_sw_host_viface1
      vlanid: 30
      addresses:
        - address: 10.0.30.101
          ipv4netmask: 255.255.255.0
    - name: hpc_sw_host_viface2
      vlanid: 40
      addresses:
        - address: 10.0.40.101
          ipv4netmask: 255.255.255.0
    - name: hpc_sw_host_viface3
      vlanid: 50
      addresses:
        - address: 10.0.50.101
          ipv4netmask: 255.255.255.0
  routing_table:
    - destination:
        address: 10.0.30.0
        ipv4netmask: 255.255.255.0
      default_gateway: 10.0.30.6
      egress_interface: hpc_sw_host_viface1

Hint

A switch configuration contains key details regarding the following parameters:

• switch (logical) ports

• VLAN configuration

• multicast configuration

• TimeSync configuration

• QoS configuration

Hint

Similar to controller config, each port of switch with an external PHY has an mii_config (see Media-Independent Interfaces), describing the various properties of the MII connected to that port. For switch ports using an integrated PHY, no mii_config is needed.

class Switch

Bases: NamedListInstances

Represents an automotive Ethernet network switch configuration.

Parameters

metaEmbeddedMetadata

Metadata associated with the switch, such as vendor-specific or implementation-specific attributes.

namestr

Name of the switch.

portslist of SwitchPort

List of external (connected to ECU ports) or internal (connected to internal ECU interfaces) switch ports.

vlanslist of VLANEntry

List of VLAN entries configured on the switch.

host_controllerControllerInterface, optional

Internal controller interface that manages the switch.

tcam_ruleslist of TCAMRule, optional

List of TCAM rules configured on the switch. These rules define packet-matching conditions and associated actions applied to ingress or egress traffic.

class SwitchPort

Bases: NamedDictInstances

Represents a Switch Port and its configuration.

Parameters

namestr

Name of the Switch Port.

silicon_port_noint

Silicon hardware port number (vendor-specific).

default_vlan_idint

VLAN ID to be added to an untagged frame ingressing on the port. Use None for an untagged port (no default VLAN).

mii_configMII or RMII or SGMII or RGMII, optional

Media-independent interface configuration (e.g., MII or RMII).

ptp_configPTPConfig, optional

Precision Time Protocol configuration.

ingress_streamslist of Stream, optional

Stream-based IEEE 802.1Qci configuration.

traffic_classeslist of TrafficClass, optional

Traffic class definitions and traffic shaping configuration applied to egress port queues.

macsec_configMACsecConfig, optional

MACsec configuration for the port.

Private Attributes

_type :

The type of the object generated. Set to controller_interface.

_mdi_config : BaseT1 or BaseT1S or BaseT

_connected_component:

The switch port, controller interface or ecu port connected to the switch port. This attribute is managed internally and is not part of the public API.

class VLANEntry

Bases: FLYNCBaseModel

Represents a VLAN entry for a switch.

Parameters

namestr

Human-readable name for the VLAN.

idint

VLAN ID. Values 0-4094 are accepted; 4095 is reserved by IEEE 802.1Q and emits a warning when used.

default_priorityint

Default frame priority for the VLAN (0-7).

portslist of str

List of switch port names members of this VLAN.

multicastlist of MulticastGroup, optional

List of multicast group configurations associated with this VLAN.

TCAM

class TCAMRule

Bases: FLYNCBaseModel

Definition of a TCAM (ternary content-addressable memory) rule for a switch.

Parameters

namestr

Name for the description of the TCAM rule.

idStrictInt

Unique TCAM rule ID.

match_filterFrameFilter

Packet-matching filter used to decide whether the rule applies.

match_portslist of str

Ports to which the rule is bound.

actionlist of Drop or Mirror or ForceEgress or VLANOverwrite or RemoveVLAN

One or more actions performed when the rule matches. The type field of each action class acts as the discriminating key for Pydantic.

class Drop

Bases: FLYNCBaseModel

Action that discards traffic on the selected egress ports.

Parameters

typeLiteral[“drop”]

Discriminator used by Pydantic.

portslist of str

Egress ports where the drop action should be applied.

class Mirror

Bases: FLYNCBaseModel

Action that mirrors incoming traffic to additional egress ports.

Parameters

typeLiteral[“mirror”]

Discriminator used by Pydantic.

portslist of str

Egress ports that will receive the mirrored traffic.

class ForceEgress

Bases: FLYNCBaseModel

Action that forces a packet to leave through a given set of ports, bypassing the normal forwarding decision.

Parameters

typeLiteral[“force_egress”]

Discriminator used by Pydantic.

portslist of str

Egress ports to which the messages are force-forwarded.

class VLANOverwrite

Bases: FLYNCBaseModel

Action that overwrites VLAN ID and/or PCP values on selected ports.

Parameters

typeLiteral[“vlan_overwrite”]

Discriminator used by Pydantic.

overwrite_vlan_idint, optional

New VLAN identifier (0-4095). If None, the VLAN ID is left unchanged.

overwrite_vlan_pcpint, optional

New PCP value (0-7). If None, the PCP value is left unchanged.

portslist of str

Egress ports at which the overwriting should take place.

class RemoveVLAN

Bases: FLYNCBaseModel

Action that removes the VLAN tag from packets on the given ports.

Parameters

typeLiteral[“remove_vlan”]

Discriminator used by Pydantic.

portslist of str

Egress ports where the VLAN tag will be removed.

Router Config

class RouteEntry

Bases: FLYNCBaseModel

Represents a static routing table entry.

Parameters

destinationIPv4AddressEntry or IPv6AddressEntry

The destination network expressed as address and mask (e.g. address="10.0.0.0", ipv4netmask="255.255.255.0").

default_gatewayIPvAnyAddress

Gateway IP for this route. If the next hop is a router, this is that router’s VCI address on the shared subnet. If the next hop is a controller interface (directly connected), this is the controller interface’s IP address.

egress_interfacestr

Name of the VirtualControllerInterface on this interface through which this route is forwarded.

PHY Config

Media-Dependent Interfaces

class BASET

Bases: FLYNCBaseModel

Represents a BASE-T Ethernet interface configuration.

Parameters

modeLiteral[“base_t”]

Interface mode. Defaults to "base_t".

speedint

Supported link speed in megabits per second. Valid values are 100 or 1000.

duplexLiteral[“full”]

Duplex mode. Defaults to "full".

roleLiteral[“master”, “slave”]

Role of the PHY, either master or slave. Defaults to "slave".

autonegotiationbool

Indicates whether autonegotiation is enabled.

class BASET1

Bases: FLYNCBaseModel

Represents a BASE-T1 Ethernet interface configuration.

Parameters

modeLiteral[“base_t1”]

Interface mode. Defaults to "base_t1".

speedint

Supported link speed in megabits per second. Valid values are 100 or 1000.

duplexLiteral[“full”]

Duplex mode. Defaults to "full".

roleLiteral[“master”, “slave”]

Role of the PHY, either master or slave.

autonegotiationbool

Indicates whether autonegotiation is enabled.

class BASET1S

Bases: FLYNCBaseModel

Represents a BASE-T1S Ethernet interface configuration.

Parameters

modeLiteral[“base_t1s”]

Interface mode. Defaults to "base_t1s".

speedint

Supported link speed in megabits per second. Defaults to 10.

duplexLiteral[“half”]

Duplex mode. Defaults to "half".

roleLiteral[“master”, “slave”]

Role of the PHY, either master or slave.

autonegotiationbool

Indicates whether autonegotiation is enabled.

Media-Independent Interfaces

class MII

Bases: FLYNCBaseModel

Represents a Media Independent Interface (MII) configuration.

Parameters

typeLiteral[“mii”]

Interface type. Defaults to "mii".

speedint

Supported link speed in megabits per second. Valid values are 10 or 100.

modeLiteral[“mac”, “phy”]

Operating mode, either MAC or PHY.

class RMII

Bases: FLYNCBaseModel

Represents a Reduced Media Independent Interface (RMII) configuration.

Parameters

typeLiteral[“rmii”]

Interface type. Defaults to "rmii".

speedint

Supported link speed in megabits per second. Valid values are 10 or 100.

modeLiteral[“mac”, “phy”]

Operating mode, either MAC or PHY.

class SGMII

Bases: FLYNCBaseModel

Represents a Serial Gigabit Media Independent Interface (SGMII or SGMII+) configuration.

Parameters

typeLiteral[“sgmii”]

Interface type. Defaults to "sgmii".

speedint

Supported link speed in megabits per second. Valid values are 10, 100, 1000, or 2500. Defaults to 1000 Mbps.

modeLiteral[“mac”, “phy”]

Operating mode, either MAC or PHY.

class RGMII

Bases: FLYNCBaseModel

Represents a Reduced Gigabit Media Independent Interface (RGMII) configuration.

Parameters

typeLiteral[“rgmii”]

Interface type. Defaults to "rgmii".

speedint

Supported link speed in megabits per second. Valid values are 10, 100, or 1000. Defaults to 1000 Mbps.

modeLiteral[“mac”, “phy”]

Operating mode, either MAC or PHY.

class XFI

Bases: FLYNCBaseModel

Represents a 10-Gigabit Ethernet (10GbE) serial electrical interface (XFI) configuration.

Parameters

typeLiteral[“xfi”]

Interface type. Defaults to “xfi”.

speedLiteral[10000]

Supported speed in Mbps. Defaults to 10000.

modeLiteral[“mac”, “phy”]

Operating mode of the interface, either MAC or PHY.

ECU Internal Topology

Expand for Schematic

        classDiagram

    class ControllerInterfaceToControllerInterface {
        type: Literal['controller_interface_to_controller_interface'] = 'controller_interface_to_controller_interface'
        id: str
        iface_name: str
        iface2_name: str
    }

    class InternalTopology {
        connections: list[InternalConnectionUnion] = list
    }

    class RootModel {
        root: RootModelRootType
    }

    class ControllerInterface {
        name: str
        mac_address: MacAddress | None = None
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        compute_nodes: list[ComputeNodes] | None = list
        virtual_interfaces: list[VirtualControllerInterface] | None = list
        ptp_config: PTPConfig | None = None
        macsec_config: MACsecConfig | None = None
        firewall: Firewall | None = None
        htb: HTBInstance | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = list
        routing_table: list[RouteEntry] | None = []
    }

    class SwitchPort {
        name: str
        silicon_port_no: int
        default_vlan_id: int
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
        ptp_config: PTPConfig | None = None
        ingress_streams: list[Stream] | None = []
        traffic_classes: list[TrafficClass] | None = []
        macsec_config: MACsecConfig | None = None
    }

    class InternalConnection {
        type: str
        id: str
    }

    class SwitchPortToXConnection {
        type: str
        id: str
        switch_port_name: str
    }

    class ECUPort {
        name: str
        mdi_config: BASET1 | BASET1S | BASET = BASET1
        mii_config: MII | RMII | SGMII | RGMII | XFI | None = None
    }

    class ECUPortToSwitchPort {
        type: Literal['ecu_port_to_switch_port'] = 'ecu_port_to_switch_port'
        id: str
        ecu_port_name: str
        switch_port_name: str
    }

    class SwitchPortToSwitchPort {
        type: Literal['switch_to_switch_same_ecu'] = 'switch_to_switch_same_ecu'
        id: str
        switch_port_name: str
        switch2_port_name: str
    }

    class FLYNCBaseModel {
    }

    class ECUPortToXConnection {
        type: str
        id: str
        ecu_port_name: str
    }

    class ECUPortToControllerInterface {
        type: Literal['ecu_port_to_controller_interface'] = 'ecu_port_to_controller_interface'
        id: str
        ecu_port_name: str
        iface_name: str
    }

    class InternalConnectionUnion {
        root: ECUPortToSwitchPort | ECUPortToControllerInterface | SwitchPortToControllerInterface | SwitchPortToSwitchPort | ControllerInterfaceToControllerInterface
    }

    class SwitchPortToControllerInterface {
        type: Literal['switch_port_to_controller_interface'] = 'switch_port_to_controller_interface'
        id: str
        switch_port_name: str
        iface_name: str
    }

    RootModel ..> RootModelRootType
    ControllerInterface ..> SGMII
    ControllerInterface ..> MacAddress
    ControllerInterface ..> PTPConfig
    ControllerInterface ..> HTBInstance
    ControllerInterface ..> TrafficClass
    ControllerInterface ..> VirtualControllerInterface
    ControllerInterface ..> ComputeNodes
    ControllerInterface ..> RGMII
    ControllerInterface ..> Firewall
    ControllerInterface ..> XFI
    ControllerInterface ..> MACsecConfig
    ControllerInterface ..> MII
    ControllerInterface ..> Stream
    ControllerInterface ..> RMII
    ControllerInterface ..> RouteEntry
    ECUPort ..> BASET1S
    ECUPort ..> SGMII
    ECUPort ..> BASET1
    ECUPort ..> BASET
    ECUPort ..> RGMII
    ECUPort ..> XFI
    ECUPort ..> MII
    ECUPort ..> RMII
    SwitchPort ..> SGMII
    SwitchPort ..> TrafficClass
    SwitchPort ..> RGMII
    SwitchPort ..> PTPConfig
    SwitchPort ..> MACsecConfig
    SwitchPort ..> XFI
    SwitchPort ..> MII
    SwitchPort ..> Stream
    SwitchPort ..> RMII
    InternalConnectionUnion ..> ECUPortToSwitchPort
    InternalConnectionUnion ..> ControllerInterfaceToControllerInterface
    InternalConnectionUnion ..> ECUPortToControllerInterface
    InternalConnectionUnion ..> SwitchPortToSwitchPort
    InternalConnectionUnion ..> SwitchPortToControllerInterface
    InternalTopology ..> InternalConnectionUnion


    

Expand for a YAML example - 📄 topology.flync.yaml

Note

This file contains all the different internal connections between entities of an ECU (ports, switch ports, controller interfaces, …) to resolve the internal topology of the component and run validation checks on the model. This is a mandatory file for the ECU configuration, since all ECUs present (at least) one ECU port and one Controller Interface.

connections:
  - type: ecu_port_to_switch_port
    id: conn1
    ecu_port: hpc1_p1
    switch_port: hpc_s1_p0
  - type: ecu_port_to_switch_port
    id: conn2
    ecu_port: hpc1_p2
    switch_port: hpc_s1_p4
  - type: ecu_port_to_switch_port
    id: conn3
    ecu_port: hpc1_p3
    switch_port: hpc_s1_p3
  - type: switch_port_to_controller_interface
    id: conn4
    switch_port: hpc_s1_p1
    controller_interface: hpc_c1_iface1
  - type: switch_port_to_controller_interface
    id: conn5
    switch_port: hpc_s1_p2
    controller_interface: hpc_c2_iface1

Internal Connection

Note

The fields of a connection will be different, depending on the kind of connection.

Types of Internal Connections

Types of Internal Connections

type	1st Attribute	2nd Attribute
ecu_port_to_switch_port	ecu_port	switch_port
ecu_port_to_controller_interface	ecu_port	controller_interface
switch_port_to_controller_interface	switch_port	controller_interface
switch_port_to_switch_port	switch_port_1	switch_port_2
controller_interface_to_controller_interface	controller_interface_1	controller_interface_2

class InternalTopology

Bases: FLYNCBaseModel

Parameters

connectionslist of InternalConnectionUnion

List of internal connections between ECU components. Defaults to an empty list.

class InternalConnectionUnion

Bases: RootModel

Union type representing a connection between two internal ECU components.

This model wraps a union of different internal connection types and uses the type field as a discriminator to determine which specific connection type is present.

Possible types

ECUPortToSwitchPort

Connection from an ECU port to a switch port.

ECUPortToControllerInterface

Connection from an ECU port to a controller interface.

SwitchPortToControllerInterface

Connection from a switch port to a controller interface.

SwitchPortToSwitchPort

Connection between two switch ports on the same ECU.

ControllerInterfaceToControllerInterface

Connection between two controller interfaces.

class InternalConnection

Bases: FLYNCBaseModel

Represents a base internal connection between two ECU components.

Parameters

typestr

The type of the connection.

idstr

Unique identifier for the connection.

component1_namestr, optional

Name of the first component in the connection.

component2_namestr, optional

Name of the second component in the connection.

Private Attributes

_ecuECU

The ECU object to which this connection belongs. Managed internally.

class ECUPortToXConnection

Bases: InternalConnection

Base class for connections from an ECU port to another ECU component.

Parameters

ecu_port_namestr

Name of the ECU port (alias: ecu_port).

Private Attributes

_ecu_portECUPort

Internal reference to the actual ECU port object. Managed privately.

class SwitchPortToXConnection

Bases: InternalConnection

Base class for connections from an ECU switch port to another component.

Parameters

switch_port_namestr

Name of the ECU switch port (alias: switch_port).

Private Attributes

_switch_portSwitchPort

Internal reference to the actual switch port object. Managed privately.

class ECUPortToSwitchPort

Bases: ECUPortToXConnection

Represents a connection from an ECU port to a switch port.

Parameters

typeLiteral[“ecu_port_to_switch_port”]

Type of the connection. Defaults to "ecu_port_to_switch_port".

switch_port_namestr

Name of the switch port (alias: switch_port).

Private Attributes

_switch_portSwitchPort

Internal reference to the actual SwitchPort object. Managed privately.

class ECUPortToControllerInterface

Bases: ECUPortToXConnection

Represents a connection from an ECU port to a controller interface.

Parameters

typeLiteral[“ecu_port_to_controller_interface”]

Type of the connection. Defaults to "ecu_port_to_controller_interface".

iface_namestr

Name of the controller interface (alias: controller_interface).

Private Attributes

_ifaceControllerInterface

Internal reference to the actual ControllerInterface object. Managed privately.

class SwitchPortToControllerInterface

Bases: SwitchPortToXConnection

Represents a connection from a switch port to a controller interface.

Parameters

typeLiteral[“switch_port_to_controller_interface”]

Type of the connection. Defaults to "switch_port_to_controller_interface".

iface_namestr

Name of the controller interface (alias: controller_interface).

Private Attributes

_ifaceControllerInterface

Internal reference to the actual ControllerInterface object. Managed privately.

class SwitchPortToSwitchPort

Bases: SwitchPortToXConnection

Represents a connection between two switch ports on the same ECU.

Parameters

typeLiteral[“switch_to_switch_same_ecu”]

Type of the connection. Defaults to "switch_to_switch_same_ecu".

switch2_port_namestr

Name of the second switch port (alias: switch2_port).

Private Attributes

_switch2_portSwitchPort

Internal reference to the second switch port object. Managed privately.

class ControllerInterfaceToControllerInterface

Bases: InternalConnection

Represents a direct connection between two controller interfaces in an ECU.

Parameters

typeLiteral[“controller_interface_to_controller_interface”]

Type of the connection. Defaults to "controller_interface_to_controller_interface".

iface_namestr

Name of the first controller interface (alias: controller_interface1).

iface2_namestr

Name of the second controller interface (alias: controller_interface2).

Private Attributes

_ifaceControllerInterface

Internal reference to the first controller interface. Managed privately.

_iface2ControllerInterface

Internal reference to the second controller interface. Managed privately.

MAC Multicast Endpoints

Expand for Schematic

        classDiagram

    class MACMulticastEndpoint {
        name: str
        mac_address: MacAddress
        protocol: str
        ethertype: int | None = None
        vlan_id: int | None = None
        multicast_tx: list[MacAddress] | None = []
    }

    class FLYNCBaseModel {
    }

    class RootModel {
        root: RootModelRootType
    }

    class AVTPMulticastEndpoint {
        name: str
        mac_address: MacAddress
        protocol: Literal['avtp'] | Literal['AVTP']
        ethertype: Literal[8944] = 8944
        vlan_id: int | None = None
        multicast_tx: list[MacAddress] | None = []
    }

    class MACEndpointUnion {
        root: AVTPMulticastEndpoint
    }

    class MACMulticastEndpoints {
        endpoints: list[MACEndpointUnion] = list
    }

    RootModel ..> RootModelRootType
    MACMulticastEndpoint ..> MacAddress
    AVTPMulticastEndpoint ..> MacAddress
    MACEndpointUnion ..> AVTPMulticastEndpoint
    MACMulticastEndpoints ..> MACEndpointUnion


    

Expand for a YAML example - 📄 mac_multicast_endpoints.flync.yaml

Note

This file contains defines Endpoints of the ECU for transmitted MAC multicast addresses.

endpoints:
- name: avb_endpoint
  protocol: AVTP
  mac_address: 00:11:03:01:01:01
  vlan_id: 10
  multicast_tx:
  - 91:E0:F0:00:00:AA
  - 91:E0:F0:00:00:BB

class MACMulticastEndpoints

Bases: FLYNCBaseModel

Represents a collection of multicast endpoints for an ECU.

Parameters

endpointsList[MACEndpointUnion]

List of multicast endpoints associated with the ECU.

class MACEndpointUnion

Bases: RootModel

Union type for MAC multicast endpoints, discriminated by the ‘ethertype’ field.

Possible types

• AVTPMulticastEndpoint: If ethertype is 0x22F0, the endpoint is treated as an AVTP multicast endpoint.

class MACMulticastEndpoint

Bases: FLYNCBaseModel

Represents a multicast endpoint that is bound to a specific controller.

Parameters

namestr

Name of the multicast endpoint.

mac_addressMacAddress

MAC address of the controller that this endpoint is bound to.

protocolstr

Protocol that is expected on this endpoint.

ethertypeOptional[int]

EtherType that is expected on this endpoint. Must be between 0x0000 and 0xFFFF if provided.

vlan_idOptional[int]

VLAN ID that is expected on this endpoint. Must be between 0 and 4095 if provided.

multicast_txOptional[List[MacAddress]]

List of multicast addresses that this endpoint should transmit to. Each address must be a valid multicast MAC address.

class AVTPMulticastEndpoint

Bases: MACMulticastEndpoint

Represents an AVTP multicast endpoint that is bound to a specific controller. This is a specialized version of MACMulticastEndpoint with fixed EtherType and protocol values, and additional validation to ensure that multicast addresses are within the AVTP range.

Parameters

ethertypeLiteral[0x22F0]

EtherType for AVTP, fixed to 0x22F0.

protocolLiteral[“avtp”] | Literal[“AVTP”]

Protocol for AVTP, fixed to “avtp” (case-insensitive).

Multicast Group Memberships

Hint

Multicast group memberships of an ECU are computed from several locations of a FLYNC Config. They are stored as a list in the field multicast_groups of an ECU. Mind that these multicast groups are not part of any YAML config, but are accessible fields in a FLYNC workspace.

Receiving Nodes

Receiving nodes are listed in the multicast group membership with the mode “rx”.

These entries are computed from:

• MAC, IPv4 or IPv6 addresses in the field multicast of a VirtualControllerInterface,

• IPv6 addresses of a VirtualControllerInterface as solicited-node multicast addresses.

Sending Nodes

Sender nodes are listed in the multicast group membership with the mode “tx”.

These entries are computed from:

• IPv4 or IPv6 addresses in the field multicast_tx of a Socket,

• MAC addresses in the field multicast_tx of a MACMulticastEndpoint,

• IPv6 solicited-node multicast addresses per VLAN.

class MulticastGroupMembership

Bases: FLYNCBaseModel

Represents a multicast group membership for virtual controller interfaces.

Parameters

groupIPv4Multicast or IPv6Multicast or MACAddressMulticast

Multicast group address.

descriptionstr, optional

Description of the multicast group membership.

mode“tx” or “rx”, optional

Mode of multicast group membership.

vlanint, optional

VLAN ID associated with the multicast group membership. Use None for untagged.

src_ipstr, optional

Source IP address. Only applicable for “tx” mode.