Difference between revisions of "I/O configurations"

From WICE Wiki v2.91
Jump to navigation Jump to search
 
(40 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<div class="keywords"> io, io configurations, io config, io configs </div>
<div class="keywords"> io, io configurations, io config, io configs </div>
<includeonly>= I/O configurations =</includeonly>
<includeonly>= I/O configurations =</includeonly>
<noinclude>The following applies to version >= 2.41 of the portal:</noinclude>For WCUs with software version >= 2.41 the "Edit Configuration" window has a new tab named "IO". In this tab, it is possible to edit the settings of the CAN and Ethernet channels of a WCU. It is also possible to apply a pre defined template which is created and managed by an admin.
<noinclude>The following applies to version >= 2.41 of the portal:</noinclude>For WCUs with software version >= 2.41 the "Edit Configuration" window has a new tab named "IO". In this tab, it is possible to edit the settings of the CAN and Ethernet channels of a WCU. It is also possible to apply a pre defined template which is created and managed by an admin. The "Edit Configuration" window is reached by going to the Vehicles tab, select a WCU and press the button "Edit Configuration".
[[File:Edit configuration IO.png|thumb|Edit Configuration: IO.]]


==Edit CAN channels==
==Edit CAN channels==
Line 12: Line 13:
===Speed (kB)===
===Speed (kB)===
The speed column shows the baud rate of each CAN channel. This value was previously added to the WCU configuration when the WCU was connected to a CAR but from now it has to be set manually in this tab.
The speed column shows the baud rate of each CAN channel. This value was previously added to the WCU configuration when the WCU was connected to a CAR but from now it has to be set manually in this tab.
=== FD Speed (kB) ===
[[File:Wcu-configuration-can-fd.png|alt=CAN FD setting for the HMX platform|thumb|CAN FD setting for the HMX platform]]
If the platform is HMX and the WCU version is 2.91.0 or later, a column will appear for the CAN channel.


===Name===
===Name===
Line 18: Line 23:
===Comment===
===Comment===
The last column is used to add some comments to each channel. This is typically some describing text, e.g. the reason why a channel is disabled.
The last column is used to add some comments to each channel. This is typically some describing text, e.g. the reason why a channel is disabled.
===Add WMU(s)===
If your Portal has [[WMU | WMU's]] enabled the "Add WMU" button will show in the CAN section. You can then add/remove WMU's and configure their CAN channels in the same way as the WCU's CAN channels are configured. For each WMU that is added, a corresponding tab is added under the [[The_Portal_Administrator_View#WMU's_Power_Management | Power Management tab]] for configuring the WMU's power behaviour.
=== Add CAN channels ===
If your Portal has Vehicle Communication Forwarder enabled, the "Add CAN channels" button will show in the CAN section. If both WMUs and Vehicle Communication Forwarder are enabled in your Portal, only "Add CAN channels" will show up. After having added a Vehicle Communication Forwarder with at least one CAN channel, pressing the button again will add more CAN channels to the Vehicle Communication Forwarder. When removing CAN channels, it is possible to either remove the entire Vehicle Communication Forwarder, or individual CAN channels from it.


==Edit Ethernet Channels==
==Edit Ethernet Channels==
[[File:WCU conf io eth channels.png|thumb|Edit Ethernet Channels]]
[[File:NewEthernetChannel.png|thumb|Edit Ethernet Channels]]
Like for CAN channels, the number of available Ethernet channels depends on the platform type of the WCU which is configured. The group of Ethernet channels contains five columns and the individual meaning is as follows.
Like for CAN channels, the number of available Ethernet channels depends on the platform type of the WCU which is configured. The group of Ethernet channels contains eight columns and the individual meaning is as follows.


===Channel===
===Channel===
This column is a checkbox were you can enabled and disable ethX. Currently this setting has no meaning on the WCU.
This column indicates which interface or interfaces that exists.


===DHCP type===
===Addressing mode===
In this column the DHCP type of the WCU is configured. The choices are "Client", "Server" and "None". Choosing "Client" means that the WCU will act as a DHCP client. "Server" means that it will act as a DHCP server. Choosing "None" means that it will use a static IP address which is set in the next column.
In this column the Addressing mode is configured. The choices are "DHCP client", "AutoIP" and "Static".


===IP address===
===IP address===
Here you set the static IP address if you have selected "None" as the DHCP type. The IP address here will also act as a fallback if the DHCP failed.
Here you set the static IP address if you have selected "Static" as the Addressing mode.
 
===Netmask===
Here you set the netmask if you have selected "Static" as the Addressing mode.
 
===Default route===
Here you set the default route if you have selected "Static" as the Addressing mode. This field only shows if the WCU software version is 2.85.0 or later. The default route is the route that takes effect when no other route is available for an IP destination address.
 
===Name Server (DNS)===
Here you set the Name Server if you have selected "Static" as the Addressing mode. This field only shows if the WCU software version is 2.85.0 or later. Here you set the name of the DNS protocol.


===Name===
===Name===
Line 39: Line 59:


==The Miscellaneous Section==
==The Miscellaneous Section==
[[File:WCU conf io misc.png|thumb|Miscellaneous]]
[[File:Screenshot from 2024-09-16 09-49-47.png|thumb|Miscellaneous]]
This section is available for WCUs with version 2.49 or later.
This section is available for WCUs with version 2.49 or later.
===Set digital out 3 on boot===  
===Set digital out 3 on boot===  
Digital out 3 is one of the output pins in the dsub contact on WCUs of model MX4. This setting activates that pin on start-up of the WCU. The purpose of this is to trigger an external measurement equipment (e.g. [[Creating_a_Task#M-Log|M-Log]] or [[Creating_a_Task#Arcos|Arcos]]).
===Diagnostic tester priority===
===Diagnostic tester priority===
For WCUs of version later than or equal to 2.60 it is possible to choose to configure the diagnostic tester priority. If enabled, a value between 1-12 can be selected. The described options are depicted in Figure "Miscellaneous".
For WCUs of version later than or equal to 2.60 it is possible to choose to configure the diagnostic tester priority. If enabled, a value between 1-12 can be selected. The described options are depicted in Figure "Miscellaneous".
=== Allow ethernet activation on WCU ===
For WCUs of version 2.90.4 or later it is possible to choose whether or not to allow the WCU to use ethernet activation. Not allowing this might disturb some of the WCUs features.
===Set 5V out on boot===
===Set 5V out on boot===
Option on the WCU to enable a buzzing sound when a trigger-button (or other digital input) is activated. The option is visible for WCUs with version 2.76.0 or later.
Option to set one of the output pins on the WCU to supply electricity at 5V to external equipment when the WCU is starting up. The option is visible for WCUs of model MX4 (except submodel V61) and with version 2.76.0 or later.
 
===Activate buzzer on detected digital input change===
===Activate buzzer on detected digital input change===
Option on the WCU to set one of the output pins to supply electricity at 5V to external equipment. It is possible on all MX4 models except V61. The option is visible for WCUs with version 2.76.0 or later.
Option to enable that the WCU makes a buzzing sound when a trigger-button (or other digital input) is activated on the WCU. It is possible on all MX4 models. The option is visible for WCUs with version 2.76.0 or later.
 
==Manage templates==
[[File:Io config2.png|thumb|frame|Selecting Template]]
Admins can save configs as templates (see [[#Manage templates (for admins) | Manage templates (for admins)]]) and normal users can use these templates to fill all columns with the data stored in the template.
Clicking "Apply" will apply the selected template. You can always change settings or add more info, the template could be anything you need or just act as a starting point.


==Preselect template==
If WMUs are enabled in the portal, a template will save the CANs from each WMU and when a template is selected the WMU CANs are applied 1:1 to each existing WMU in the configuration.  
[[File:Io config2.png|thumb|frame|Preselect Template]]
If there are no WMUs in the configuration the template's WMU CANs will not be applied, only the WCU's CANs.
Admins can save configs as templates (see [[#Manage templates (for admins)]]) and normal users can use these templates to fill all columns with the data stored in the template.
To select and apply a template, click "Preselect template" and the small window shown in Figure "Preselect Template" will pop up. From the drop down menu, select the template you want to apply and click "OK". You can always change settings or add more info, the template could be anything you need or just act as a starting point.


==Manage templates (for admins)==
==Manage templates (for admins)==
[[File:Io config3.png|thumb|frame|Manage Templates]]
[[File:Io config3.png|thumb|frame|Manage Templates (admin view)]]
If you are a admin you have a extra button, "Manage templates" to the left of the "Preselect template" button. If you click "Manage templates" a new window will open up which can be seen in Figure "Manage Templates".
[[File:Io config4.png|thumb|frame|Manage Templates (with WMUs enabled)]]
Previously saved templates are listed in the "Templates" table. To remove a template, click the red "Remove record" icon to the right of the template name. A confirmation dialog will popup prevent deletion by mistake.
If you are an admin you have an extra button "Save current config as template" in the Manage configuration templates window. Clicking it to save the current configuration as a template will prompt you for a name. If the name already exists (case insensitive) a confirmation dialog will popup before overwriting.


To save the current config as a template, click the "Save current config as a template" button. You will be asked to set a name for the new template and when you press OK, the new template will be saved and listed in the "Templates" table above.
Additionally, as admin you will be able to remove existing templates, which is done by clicking the red "Remove record" icon to the right of the template name. A confirmation dialog will popup to prevent deletion by mistake.


==Show Vehicle Profile==
==Show Vehicle Profile==
[[File:WCU conf io car interf.png|thumb|Vehicle Profile]]
[[File:WCU conf io car interf.png|thumb|Vehicle Profile]]
The button "Show vehicle profile" can be used to show, and hide, a panel showing the CAN and ethernet information for the connected car, see Figure "Vehicle Profile". This option is disabled if no car is connected.
The button "Show vehicle profile" can be used to show, and hide, a panel showing the CAN and ethernet information for the connected car, see Figure "Vehicle Profile". This option is disabled if no car is connected.

Latest revision as of 10:39, 14 October 2024

io, io configurations, io config, io configs

The following applies to version >= 2.41 of the portal:For WCUs with software version >= 2.41 the "Edit Configuration" window has a new tab named "IO". In this tab, it is possible to edit the settings of the CAN and Ethernet channels of a WCU. It is also possible to apply a pre defined template which is created and managed by an admin. The "Edit Configuration" window is reached by going to the Vehicles tab, select a WCU and press the button "Edit Configuration".

Edit Configuration: IO.

Edit CAN channels

Edit CAN Channels

The number of available CAN channels depends on the platform type of the WCU which is configured. The group of CAN channels consists of four columns named Channel, Speed, Name and Comment. Each column is described separately below.

Channel

This column is a checkbox and if you enable CAN X, this means that X is available for mappings when creating a new task and uploading this task to his WCU. Read more about Mappings. In the same way, disabling CAN X means that X is not available for mappings. If a CAN channel for some reason is not connected to the WCU, then it could be good choice to disabling it here.

Speed (kB)

The speed column shows the baud rate of each CAN channel. This value was previously added to the WCU configuration when the WCU was connected to a CAR but from now it has to be set manually in this tab.

FD Speed (kB)

CAN FD setting for the HMX platform
CAN FD setting for the HMX platform

If the platform is HMX and the WCU version is 2.91.0 or later, a column will appear for the CAN channel.

Name

In this column it is possible to set a nickname for the channel. This name is used when a Signalreader task or assignment is automapped (see Mappings) so choose your names carefully. The default value is CAN 1,2..6.

Comment

The last column is used to add some comments to each channel. This is typically some describing text, e.g. the reason why a channel is disabled.

Add WMU(s)

If your Portal has WMU's enabled the "Add WMU" button will show in the CAN section. You can then add/remove WMU's and configure their CAN channels in the same way as the WCU's CAN channels are configured. For each WMU that is added, a corresponding tab is added under the Power Management tab for configuring the WMU's power behaviour.

Add CAN channels

If your Portal has Vehicle Communication Forwarder enabled, the "Add CAN channels" button will show in the CAN section. If both WMUs and Vehicle Communication Forwarder are enabled in your Portal, only "Add CAN channels" will show up. After having added a Vehicle Communication Forwarder with at least one CAN channel, pressing the button again will add more CAN channels to the Vehicle Communication Forwarder. When removing CAN channels, it is possible to either remove the entire Vehicle Communication Forwarder, or individual CAN channels from it.

Edit Ethernet Channels

Edit Ethernet Channels

Like for CAN channels, the number of available Ethernet channels depends on the platform type of the WCU which is configured. The group of Ethernet channels contains eight columns and the individual meaning is as follows.

Channel

This column indicates which interface or interfaces that exists.

Addressing mode

In this column the Addressing mode is configured. The choices are "DHCP client", "AutoIP" and "Static".

IP address

Here you set the static IP address if you have selected "Static" as the Addressing mode.

Netmask

Here you set the netmask if you have selected "Static" as the Addressing mode.

Default route

Here you set the default route if you have selected "Static" as the Addressing mode. This field only shows if the WCU software version is 2.85.0 or later. The default route is the route that takes effect when no other route is available for an IP destination address.

Name Server (DNS)

Here you set the Name Server if you have selected "Static" as the Addressing mode. This field only shows if the WCU software version is 2.85.0 or later. Here you set the name of the DNS protocol.

Name

In this column you can set a nickname for this channel. This setting has no effect on the WCU side.

Comment

In the last column you can set a comment for this channel. Like for the name, this setting has no effect on the WCU side.

The Miscellaneous Section

Miscellaneous

This section is available for WCUs with version 2.49 or later.

Set digital out 3 on boot

Digital out 3 is one of the output pins in the dsub contact on WCUs of model MX4. This setting activates that pin on start-up of the WCU. The purpose of this is to trigger an external measurement equipment (e.g. M-Log or Arcos).

Diagnostic tester priority

For WCUs of version later than or equal to 2.60 it is possible to choose to configure the diagnostic tester priority. If enabled, a value between 1-12 can be selected. The described options are depicted in Figure "Miscellaneous".

Allow ethernet activation on WCU

For WCUs of version 2.90.4 or later it is possible to choose whether or not to allow the WCU to use ethernet activation. Not allowing this might disturb some of the WCUs features.

Set 5V out on boot

Option to set one of the output pins on the WCU to supply electricity at 5V to external equipment when the WCU is starting up. The option is visible for WCUs of model MX4 (except submodel V61) and with version 2.76.0 or later.

Activate buzzer on detected digital input change

Option to enable that the WCU makes a buzzing sound when a trigger-button (or other digital input) is activated on the WCU. It is possible on all MX4 models. The option is visible for WCUs with version 2.76.0 or later.

Manage templates

Selecting Template

Admins can save configs as templates (see Manage templates (for admins)) and normal users can use these templates to fill all columns with the data stored in the template. Clicking "Apply" will apply the selected template. You can always change settings or add more info, the template could be anything you need or just act as a starting point.

If WMUs are enabled in the portal, a template will save the CANs from each WMU and when a template is selected the WMU CANs are applied 1:1 to each existing WMU in the configuration. If there are no WMUs in the configuration the template's WMU CANs will not be applied, only the WCU's CANs.

Manage templates (for admins)

Manage Templates (admin view)
Manage Templates (with WMUs enabled)

If you are an admin you have an extra button "Save current config as template" in the Manage configuration templates window. Clicking it to save the current configuration as a template will prompt you for a name. If the name already exists (case insensitive) a confirmation dialog will popup before overwriting.

Additionally, as admin you will be able to remove existing templates, which is done by clicking the red "Remove record" icon to the right of the template name. A confirmation dialog will popup to prevent deletion by mistake.

Show Vehicle Profile

Vehicle Profile

The button "Show vehicle profile" can be used to show, and hide, a panel showing the CAN and ethernet information for the connected car, see Figure "Vehicle Profile". This option is disabled if no car is connected.