# On CAN Packet Received

## Overview

![The On CAN Packet Received Node.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-5b9963aacf1b5a3c32076e3b2a5c6a6f4b6ba59b%2Foncanpacketreceivednode20241.png?alt=media)

**On CAN Packet Received** is an **Event Listener Node** allowing the user to perform an action once a **CAN** `Message` is selected from the **Drop-down Menu**.

[**Scope**](https://github.com/cgi-studio-gmbh/incari-doc/blob/2025.1/toolbox/communication/overview.md#scopes): **Project**, **Scene**.

## Attributes

![The On CAN Packet Received Node Attributes.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-655e2f379c31890d968b487284f1a9bbc294b5c1%2Foncanpacketreceived-attriupdate.png?alt=media)

| Attribute       | Type          | Description                                                                                                                                                                        |
| --------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `On Change`     | **Bool**      | Specifies whether the **Node** executes when a **Packet**'s `Message` changes or simply when a **Packet**'s `Message` is received.                                                 |
| `Configuration` | **Drop-down** | The identifying connection name that will be used, which is one that was set up in the [**Project Settings**](https://docs.incari.com/incari-studio/modules/project-settings/can). |
| `Message Name`  | **Drop-down** | A `Message` that is chosen from the uploaded *DBC* file. This is done in **Project Settings**.                                                                                     |

## Outputs

| Output             | Type      | Description                                                                                                                            |
| ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse** | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Signal [n]`       | **Float** | The *Signal* or *Signals* of a *Message* from the specified *DBC* file.                                                                |

## Example

To visualize how the **Node** works a bit better, refer to the images below. The first is an example *DBC* file, which would have been added in the **CAN Project Settings**. There are two *Messages* and two *Signals*, each of which correspond to one of the *Messages*.

![DBC File Example.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-354878f48362599e26946a6363565b0654183604%2Fdbcfilereal.png?alt=media)

When the connection has been added in **Project Settings** and those changes are saved, the user can select the desired `Message Name` -- here Message1 -- which will make an output appear called `Signal1`. If a *Message* has multiple *Signals* -- for example if Message1 had two *Signals* called Signal1a and Signal1b -- all appear as outputs of the **Node**.

![On CAN Packet Received Node with Connection.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-e78b4408e83bd2a140acb71bd977dbc27b4b8e16%2Fcanpacketreceivedmessagesignal.png?alt=media)

## See Also

* [**On CAN Start**](https://docs.incari.com/incari-studio/toolbox/communication/can/events/oncanstart)
* [**On CAN Stop**](https://docs.incari.com/incari-studio/toolbox/communication/can/events/oncanstop)

## External Links

* The example [*DBC* file.](https://www.csselectronics.com/pages/can-dbc-file-database-intro)