# Snapshot Tool

In the context of CAN bus logging, a snapshot file refers to a JSON-formatted file containing a periodic sample or "snapshot" of decoded CAN bus data for select CAN signals of interest.

The steps below help you transmit a periodic sample of decoded CAN bus data for select CAN messages of interest in JSON format.

{% hint style="info" %}

#### Notes:

* Before you begin these steps, add and enable AWS configuration for the ReXgen logger.
  {% endhint %}

Drag the Snapshot tool in the Transmitting section in the configuration window.

* This opens the Snapshot window

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FspuvO9y5kWkffrnZsNg7%2Fimage.png?alt=media&#x26;token=3700e8c6-8c4b-491a-afb8-501760aa2f51" alt=""><figcaption></figcaption></figure>

**Add Snapshot File:** Users can add and name a new snapshot file.

**Remove Snapshot File:** This allows users to remove an existing snapshot file.

**Add Items:** This allows users to add items to a snapshot file.

**Remove Items:** This allows users to remove items from a snapshot file.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FWe4Vrrn0HuTktLoa0JaY%2Fimage.png?alt=media&#x26;token=b1381b59-9ed1-480c-8e6d-b1c5f53f7b89" alt=""><figcaption></figcaption></figure>

Click on the ‘Add Snapshot File’ tab –

* Enter the desired name, sampling rate (sec) and upload rate, and click OK.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FJJhZbpBYlKiOygAdYTo4%2Fimage.png?alt=media&#x26;token=5c3c217f-5806-46d3-81ff-993067f5beae" alt=""><figcaption></figcaption></figure>

Once the name of the Snapshot file is assigned, click the ‘Add Items’ tab to add the required items to the snapshot file.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2F4UKRZOt1sCanZPbNJEYw%2Fimage.png?alt=media&#x26;token=7b741238-c46b-4f72-89ea-a3601d6bfbc4" alt=""><figcaption></figcaption></figure>

#### **(a) Add Signals:**

* Add signals from the existing DBC file by clicking on the check box beside them.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FaXM4RirNTWSTEGLezNYe%2Fimage.png?alt=media&#x26;token=472249ae-3943-4c0d-8e6e-d85318d90202" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Note:

* One snapshot file supports only fourteen (14) items.
  {% endhint %}

OR

To add a new dbc file, click on the folder icon, select the desired dbc file containing the parameters, and click ‘Open’.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FvptRMvbI2zwZ30uYRYdI%2Fimage.png?alt=media&#x26;token=9b123bf9-7411-4a29-8c53-b09bd4e91d62" alt=""><figcaption></figcaption></figure>

Select up to fourteen items and click ‘OK’.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FHLk8yTRvylrqnfv8DFf7%2Fimage.png?alt=media&#x26;token=80aacb9d-83aa-422c-9fed-33eb7c74ff01" alt=""><figcaption></figcaption></figure>

Once the items are added to the snapshot file, specify the CAN source for each item separately.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FaTqebPOvaUq3qGOtR02w%2Fimage.png?alt=media&#x26;token=3205fe80-513a-40e7-b471-68f2264e6217" alt=""><figcaption></figcaption></figure>

#### (b) Add Internal Channels

Add internal channels by checking the checkboxes beside them, then click OK.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FVYgyNPQQoTm7UbKhbtLz%2Fimage.png?alt=media&#x26;token=e7416e4b-e5d4-41fc-a988-81653267c039" alt=""><figcaption></figcaption></figure>

Click “Run” to update the configuration. ![](https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2F99KtlGbS4S4BbfHg4emV%2Fimage.png?alt=media\&token=0a4b6e4c-b0d7-4257-84f9-a3b122b4965a)

* The configuration will be loaded into the data logger and will immediately start uploading to the S3 bucket.
* The snapshot file is stored in the ‘Root’ folder inside your S3 bucket.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FlcdYLnH9YYBvLdvUdG7K%2Fimage.png?alt=media&#x26;token=91d9b6b3-64cb-43a2-bd94-0fc02dcf36fb" alt=""><figcaption></figcaption></figure>

Open the root folder to view the snapshot file.

* The file is stored in ‘.json’ format.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FRpNrKagS2SmhlUFVb9A2%2Fimage.png?alt=media&#x26;token=9d2b2482-d83c-4d3f-9052-3a8215522708" alt=""><figcaption></figcaption></figure>

View the live value updates of the configured snapshot parameters in the snapshot .json file.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FXSuXlufVuPLI9H2RpTqc%2Fimage.png?alt=media&#x26;token=8af731a4-4df2-44b7-9d10-f3828497105a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Note:

* Snapshot is limited to 1 file with 13 items.
* Multiplexes signals are not supported.
  {% endhint %}