Supported platforms and protocols
RemotiveTopology runs on Linux, on Windows with WSL2, and on macOS. Linux has full support. Some features need RemotiveBus, which is only available on Linux, including WSL2. For installation, see Install RemotiveTopology.
Operating systems
| Linux | Windows (WSL2) | macOS | |
|---|---|---|---|
| Container engine | Docker Engine or Podman | Docker Engine, installed in WSL2 | Docker or Podman |
| RemotiveBus | Yes | Yes, with a WSL2 kernel that has the vcan and vxcan modules, see WSL2 in Windows | No, run RemotiveTopology in a Linux virtual machine |
remotive topology commands | Yes | In WSL2, not in PowerShell | Yes |
| Behavioral models and tests in Python | Python 3.10 or later | Python 3.10 or later | Python 3.10 or later |
On macOS, the preferred way is to run RemotiveTopology in a Linux virtual machine, so you can use RemotiveBus. Without RemotiveBus, CAN and LIN channels fall back to UDP emulation, and the features in the following table that need RemotiveBus aren't available.
Channel drivers and features
| Feature | Needs | Linux | Windows (WSL2) | macOS |
|---|---|---|---|---|
| CAN with SocketCAN, the default | RemotiveBus | Yes | Yes | Linux VM |
| CAN emulation using UDP | Nothing | Yes | Yes | Yes |
| LIN, over the CAN drivers | RemotiveBus or UDP | Yes | Yes | UDP, or Linux VM |
| Ethernet with Docker bridge networks, the default | Nothing | Yes | Yes | Yes |
| Ethernet with VLAN | RemotiveBus | Yes | Yes | Linux VM |
| Test access points (TAP) | RemotiveBus with Docker | Yes | Yes | Linux VM |
SocketCAN tools such as candump | RemotiveBus | Yes | Yes | Linux VM |
| Virtual ECUs on CAN | RemotiveBus | Yes | Yes | Linux VM |
| Connecting hardware | RemotiveBus and a Linux driver for the adapter | Yes | USB adapters passed through to WSL2 | Linux VM |
RemotiveBus provides TAP only for Docker networks, not for Podman.
Protocols
| Protocol | Described by | Notes |
|---|---|---|
| CAN | DBC, ARXML | Bit rate set in the platform, see CAN channel |
| CAN FD | DBC, ARXML | Data phase bit rate and bit rate switching set in the platform with baudrate_fd and brs |
| LIN | LDF | Transported inside CAN frames, see LIN channels |
| Ethernet PDUs over UDP | ARXML, platform file | Point-to-point sockets, see Ethernet PDUs |
| SOME/IP over UDP | ARXML, Fibex | Services and instances, see SOME/IP |
File formats
| Format | Used for |
|---|---|
*.platform.yaml | Platforms, see Describing the platform |
*.instance.yaml | Instances, see Instantiating topology |
| DBC | CAN channels, their ECUs, frames, and signals |
| LDF | LIN channels, their ECUs, frames, signals, and schedule tables |
| ARXML | System descriptions and ECU extracts: channels, ECUs, sockets, and SOME/IP services |
| Fibex | SOME/IP services |
| FMU, FMI 2.0 and 3.0 with co-simulation | FMU models |
| CAN dump and CSV | Recordings |
The topology schema describes every field of the platform and instance files.