Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add configuration parameters to Bus Terminal definition (low-cut) #221

Open
wants to merge 22 commits into
base: main
Choose a base branch
from

Conversation

bmenne-dspace
Copy link
Contributor

No description provided.

@bmenne-dspace bmenne-dspace linked an issue Dec 6, 2024 that may be closed by this pull request
@bmenne-dspace bmenne-dspace self-assigned this Dec 6, 2024
@bmenne-dspace bmenne-dspace added common Issue within the common part of the specification that is not directly related to a specific bus can Issue related to CAN, CAN FD or CAN XL bus flexray Issue related to FlexRay bus low-cut Describes an issue that concerns the low-cut labels Dec 6, 2024
@bmenne-dspace bmenne-dspace added this to the 1.0.0-final milestone Dec 6, 2024
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
docs/4_4_1_can.adoc Outdated Show resolved Hide resolved
@bmenne-dspace bmenne-dspace marked this pull request as ready for review December 11, 2024 07:23
@bmenne-dspace bmenne-dspace linked an issue Dec 12, 2024 that may be closed by this pull request
@chrbertsch
Copy link
Collaborator

FMI-Design Meeting:
Klaus: I will after the meeting review this in more detail, then we can merge it.

@klausschuch klausschuch force-pushed the 217-network-parameters-should-be-moved-to-the-bus-terminal branch from ac0210d to 94c0665 Compare December 19, 2024 14:25
----

This structural parameter is mandatory for Network FMUs only.
A Bus Simulation (FMU) does not require this structural parameter.
A Bus Simulation FMU might indicate via a variable with memberName=<<low-cut-can-bus-notification-parameter, `BusNotifications`>> in the CAN Bus Terminals whether it sends bus notifications or not.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@bmenne-dspace should we make this mandatory, by changing the might to shall?
I think it wouldn't be a big burden for Bus Simulation FMU exporters to always expose such a variable.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think optional is fine, because if its missing then its automatically "false". BTW: I think we should add the "to participate in an importer parameter propagation feature." sentence again

@@ -612,21 +611,19 @@ If a Network FMU does not support wake up, this operation can be ignored on the
|====

===== Network Parameters [[low-cut-can-network-parameters]]
By using configuration parameters on Bus Terminal level, Network FMUs can be parameterized by the user or the Bus Simulation (by using e.g. the parameter propagation mechanism).
This chapter specifies the configuration parameters that each CAN-specific Network FMU shall provide.
This chapter defines parameters that Network FMU might provide to configure CAN-specific behavior.
Copy link
Contributor Author

@bmenne-dspace bmenne-dspace Dec 19, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here we should mention that its is the config terminal within a bus terminal context

If the Network FMU shall be configured to handle responses in the form of <<low-cut-can-confirm-operation, `Confirm-`>>, <<low-cut-can-bus-error-operation, `Bus Error-`>> and <<low-cut-can-arbitration-lost-operation, `Arbitration Lost`>> operations, the <<low-cut-can-bus-notification-parameter, `BusNotifications`>> configuration parameter shall be set to `true`.
A Network FMU must always be able to handle the case that the Bus Simulation does not provide <<low-cut-can-confirm-operation, `Confirm-`>>, <<low-cut-can-bus-error-operation, `Bus Error-`>> or <<low-cut-can-arbitration-lost-operation, `Arbitration Lost`>> operations.
Since a Bus Simulation is allowed to provide bus notification regardless of the <<low-cut-can-bus-notification-parameter, `BusNotifications`>> configuration parameter, Network FMUs must silently ignore such notifications if the value of <<low-cut-can-bus-notification-parameter, `BusNotifications`>> is set to `false` or the parameter is omitted. +
Therefore, a parameter with memberName=<<low-cut-can-bus-notification-parameter, `BusNotifications`>> can be added to a CAN Bus Terminal. +
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To the "sub" config terminal .... thats why I called it "configuration parameter"

If a Network FMU supports bus notifications, the <<low-cut-can-bus-notification-parameter, `BusNotifications`>> parameter shall be exposed.
The default value of this parameter shall be `false`. +
_[The default value `false` allows a simple integration of Network FMUs to simulation scenarios where <<low-cut-can-confirm-operation, `Confirm-`>>, <<low-cut-can-bus-error-operation, `Bus Error-`>> or <<low-cut-can-arbitration-lost-operation, `Arbitration Lost`>> operations are not used.]_

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"A Network FMU must always be able to handle the case that the Bus Simulation does not provide <<low-cut-can-confirm-operation, Confirm->>, <<low-cut-can-bus-error-operation, Bus Error->> or <<low-cut-can-arbitration-lost-operation, Arbitration Lost>> operations." missing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
can Issue related to CAN, CAN FD or CAN XL bus common Issue within the common part of the specification that is not directly related to a specific bus flexray Issue related to FlexRay bus low-cut Describes an issue that concerns the low-cut
Projects
None yet
4 participants