CANServer v2 Analysis

Firmware v2 Manual

Manual Root

Analysis Screen

The Analysis screen lets you configure the CANServer's onboard CAN frame decoding features.

Any values that are decoded can be used via the scripting system, and through the scripting system can be sent to microDisplays.

Screen Overview

Each Analysis item is made up of the following parameters:
(Most of these parameters can be sourced from a DBC file that matches the CAN network you have connected the CANServer to)

• Name

  A unique name that identifies the Analysis Item (and can be used to fetch the value when needed)

• Bus ID

  The Bus Id that this CAN frame is expected to be seen on. The Bus gets assigned when an CAN frame is received on a hardware CAN interface. You can configure the Bus Id associated with the hardware interfaces on the settings screen

• Frame ID

  This is the CAN frame's Id.
  When associated with a multiplexed signal the 2nd text box in the Frame ID is used for the multiplexor match value.

• Start Bit

  The start bit for the data you want to decode from the CAN frame's payload

• Bit Length

  The bit length for the data you want to decode from the CAN frame's payload

• Factor

  The factor to apply to the decoded data from the CAN frame's payload

• Offset

  The offset to apply to the decoded data from the CAN frame's payload

• Signed

  Set this if the decoded data represents a signed value

• Little Endian

  Set this if the data is to be decoded as a little endian value. For big endian leave it unchecked

There are also 2 options that can be applied to each Analysis Item

• Log

  By setting this option on an Analysis Item it will be logged to a log file when Filtered logging is enabled on the logging screen

• Force

  The force option allows a temporary override of the decoded value. Once this option is enabled (and the row is saved) it will allow setting of the value through the web interface. The Value column will change to an input box and entering a value and hitting enter will apply the forced value. Forced values will only be active until the CANServer restarts.

• Value

  The Value column shows the last value that was decoded. The display will update every 2 seconds and show a new value. Depending on the rate that a signal is being sent on the CAN busses this value may not reflect the present value as it is updated in the browser infrequently. The text colour will reflect the age of the value as the time of update. An age of <= 1 second will be displayed in Green, > 1 second and <= 5 seconds will display in Yellow, and > 5 seconds will display in Red

Multiplexed Analysis Items

As of firmware version 2.1 you can add multiplexed signals.
The Analysis Item row is split into two sub rows. The first sub row has the signal definition for the multiplexor signal. This is the signal that tells you what multiplexed data the CAN frame has.
The second sub row has the match value and the signal definition for the multiplexed signal.

When the multiplexor signal is decoded and its value matches the match value then the multiplexed signal is decoded and assigned to the Analysis Item.

Editing Analysis Items

Existing rows can be edited, and when any of the parameters for an Analysis Item have been changed the row will be highlighted in a shade of yellow. Changes need to be saved for each row modified by clicking on the save icon.

If you leave the Analysis page with unsaved changes you will be prompted if you wish to abandon the changes.

Deleting Analysis Items

To delete an Analysis Item you can click the delete icon for its row. After you confirm the entry will be removed.

New Analysis Items

To Add new items you can click the New Item button. This will add a new row to the table that will be highlighted in a shade of green. You can then fill in the parameters and save it using the save icon.

Multiplexed signals can be created by clicking on the New Multiplexed Item button. This will add a new item that can have both the multiplexor and multiplexed signal details to.

Importing/Exporting Analysis Items

• Export

  You can click on the copy icon on a given row to export the Analysis Item's parameters to your clipboard. You can then paste that representation into a text file or email or any other application. The data is formatted as a json string and contains all the information for that Analysis Item.

• Import

  The Analysis page allows you to paste a json representation into the page. You don't have to select any special part of the page, and can then hit paste.

  The format is the same as when generated when you hit copy for any row.

  If the pasted Analysis Item already exists it will be modified with the newly pasted data. If it is a new item a new row will be created.

  Once the data been pasted (either a modification of an existing item or a new item) it can be saved in the same manner as editing or creating a row.