# 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%2FxYDt147rvmXu2GLum2WM%2Fimage.png?alt=media&#x26;token=bac9a80f-b4c9-4beb-8a79-75f189a794a7" alt=""><figcaption></figcaption></figure>

* **Add Snapshot File:** this allows the user to add and name a new snapshot file.
* **Remove Snapshot File:** this allows the user to remove an existing snapshot file.
* **Add Items:** this allows the user 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%2FlF1E6f6Z1Vj0bYy2hQBI%2Fimage.png?alt=media&#x26;token=7eb6ae0e-733c-4fe5-9c6b-f47a6cda7fea" 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.

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

{% hint style="info" %}

#### Note:

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

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2F3xLLCHXDcEE6N7vrdkmF%2Fimage.png?alt=media&#x26;token=779c9934-92e0-4578-988b-bd955f9012c8" alt=""><figcaption></figcaption></figure>

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>

Click “Run” to update the configuration.

<figure><img src="https://109727927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUEja6FQFpk6wbBteOsbv%2Fuploads%2FXYK1Yc2Zzfoee4NOYltY%2Fimage.png?alt=media&#x26;token=b74621b2-d51b-4d83-b3fe-d18b35f787fa" alt=""><figcaption></figcaption></figure>

* The configuration will be loaded into the data logger and 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%2F0F5nWikeUjsFEXl1cE7H%2Fimage.png?alt=media&#x26;token=8ad7112e-16dc-4999-8a54-5c9dcd36e670" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Note:

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