# Access Management

This guide provides a comprehensive overview of the Condense OEM Tool, designed to simplify managing your devices and vehicles.

## Log in to your OEM Account

Visit the OEM tool web page and provide your username and password to log in. If you don't have an account, contact Zeliot for creation.

## Manage Multiple Accounts

If you manage accounts for both standard fitment and aftermarket products, the OEM tool allows you to create and manage accounts for both.

## Device and SIM Management

#### 1. Adding and Viewing Devices

The OEM Tool offers three methods for adding new devices:  

* Manual: Add individual devices one at a time.  
* Bulk Upload: Upload a file containing details for multiple devices using a downloadable sample template.  
* API: API integration for automated device addition. 

<figure><img src="/files/noOC0GZ2i9uPDIOIFJxG" alt=""><figcaption></figcaption></figure>

#### 2. Adding and Viewing SIMs

Similar to devices, you can manage SIMs using three methods: &#x20;

* Manual: Add individual SIM cards one at a time. &#x20;
* Bulk Upload: Upload a file containing details for multiple SIMs using a downloadable sample template. &#x20;
* API: API Integration for automated SIM addition&#x20;

Once uploaded, the OEM Tool displays real-time SIM status information, including: &#x20;

* TSP1 (Telecom Service Provider 1) &#x20;
* TSP2 (Telecom Service Provider 2)&#x20;
* Activation Start Date &#x20;
* Activation End Date&#x20;

<figure><img src="/files/5WoQXBhGIcAub2MVUMQX" alt=""><figcaption></figcaption></figure>

## VIN Journey Tab

This section focuses on Vehicle Identification Number (VIN) and device (IMEI) mapping. There are three ways to complete VIN-IMEI mapping: &#x20;

* Individual Mapping: Manually map a VIN to an IMEI for a single vehicle. &#x20;
* Bulk Upload: Upload a file containing VIN-IMEI pairings for multiple vehicles using a downloadable sample template. &#x20;
* API Integration: API Integration for automated VIN-IMEI mapping.

<figure><img src="/files/4lW8velr6P4TJMtAwy19" alt=""><figcaption></figcaption></figure>

The VIN Journey tab also displays the following information: &#x20;

* Device Status (Real-Time) &#x20;
* End-of-Line Testing (EOLT) details for each VIN-IMEI mapping&#x20;

#### 1.  EOLT Confirmation

* After mapping is complete, the OEM Tool performs an EOLT to confirm device connectivity. &#x20;
* If the device communicates with the server after EOLT, the "Telematics Check" option becomes available. &#x20;

#### 2. Telematics Check

* This feature offers a real-time status report on the device, allowing you to verify its functionality. Clicking "Telematics Check" displays detailed information about the device &#x20;
* User can now access EOLT timestamp as well as latest packet status with Device and Server Timestamp &#x20;

<figure><img src="/files/uP7MWLOgZzuPG6u8v1NQ" alt=""><figcaption></figcaption></figure>

#### Edit VIN IMEI Mapping:

This feature enables OEM to make changes in the existing mapping of VIN-IMEI under scenarios when IMEI needs change. Users can manually edit VIN IMEI mapping in OEM tool through this functionality. &#x20;

<figure><img src="/files/CrlA53OFOI0hukmDa1bL" alt=""><figcaption></figcaption></figure>

## KYC Processing Tab

The KYC Journey tab within the Condense OEM Tool offers functionalities for managing KYC details and activation through integration with your SIM provider. This tab provides insights into the KYC processing lifecycle, including adding KYC information and managing approvals/rejections.

#### Adding KYC Details

The OEM Tool provides two methods for adding KYC information for each VIN: &#x20;

&#x20;1\.  Manual KYC: &#x20;

Users can enter mandatory KYC details for a specific VIN through a designated form within the Manual KYC option. Once the user fills in and submits the details, a new KYC record is created for that VIN. &#x20;

2. API Integration: &#x20;

The OEM Tool offers API integration capabilities to connect with client's system. &#x20;

Through this integration, KYC details can be automatically added to the KYC processing tab upon creation. &#x20;

#### KYC Approval/Rejection Workflow

* Regardless of the method used to add KYC details (manual or API), all KYC records appear in the KYC Details tab. This tab allows the client's service team to manually review and approve or reject each KYC record. &#x20;
* Approvals and rejections are timestamped for reference and record-keeping purposes. &#x20;

\- Real-Time Status Updates: &#x20;

The KYC Processing tab within the OEM Tool displays the current status of each KYC record in real-time. This status reflects the approval/rejection decision made by the service team in the KYC Details tab. &#x20;

&#x20;\- Integration with Client System (API): &#x20;

* When using API integration for KYC processing, the OEM Tool communicates with your client's system in both directions: KYC record updates from your client's system are reflected in the KYC processing tab within the OEM Tool. &#x20;
* Approval/rejection decisions made by the service team in the KYC Details tab are communicated back to your client's system via the API, updating the KYC status within their system.&#x20;

<figure><img src="/files/BBUhuYhaiqqu2dcexIrm" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/l1EvKUscS8nH4oNznP9a" alt=""><figcaption></figcaption></figure>

## Logs

### KYC Log Management

The OEM Tool provides a dedicated KYC Logs page to track all KYC-related activity. KYC Logs page provides an audit trail of all KYC activity, including re-attempts, updates, and the previous state of KYC details for each VIN.

<figure><img src="/files/3RIqNW5RMAjCnAIS2SjR" alt=""><figcaption></figcaption></figure>

#### Triggering KYC Logs &#x20;

&#x20; KYC logs are created in two scenarios: &#x20;

* Re-attempts After Submission/Rejection: Whenever a user attempts to modify KYC details for a VIN after an initial submission (successful or rejected), a new KYC log is generated. This allows for tracking changes made to KYC information. &#x20;
* KYC Details Update: A KYC log is created whenever the KYC Details associated with a specific VIN are updated. This includes both:&#x20;
* Updating existing details for a previously submitted KYC record. &#x20;
* Adding new KYC details for a VIN that didn't have any KYC information before

#### Log Content and Display

Each KYC log captures the following information: &#x20;

* Previous KYC Details: The details associated with the VIN before the update. &#x20;
* Updated KYC Details: The new details entered after the update. &#x20;
* Timestamp: The date and time the update occurred. &#x20;

The KYC Logs page displays these logs, allowing you to review the history of changes made to KYC information for each VIN.  &#x20;

#### Integration with VIN Journey Page

The latest KYC details for a VIN are also reflected on the VIN Journey page within the OEM Tool. This ensures you have easy access to the most current KYC information associated with each vehicle.

### VIN Log Management

The VIN Logs feature within OEM Tool provides a centralized location to view the history of VIN-IMEI mappings. location data, connectivity details, and EOLT status. &#x20;

<figure><img src="/files/w0BPjNWno4DPp3j2xhI4" alt=""><figcaption></figcaption></figure>

#### Accessing VIN Logs

* The VIN Logs feature displays a table containing a comprehensive record of all VIN-IMEI mappings. &#x20;
* Clicking on a specific VIN number in the table opens a pop-up window showing detailed logs for that VIN. This pop-up window includes the following information: &#x20;
* Serial Number: Unique identifier for the specific log entry. &#x20;
* Sequence: Order in which the mapping details were created. &#x20;
* VIN: Vehicle Identification Number. &#x20;
* IMEI: International Mobile Equipment Identity of the connected device. &#x20;
* Vehicle Type: Type of vehicle associated with the VIN (obtained from mapping details). &#x20;
* Vehicle Model: Model of the vehicle associated with the VIN (obtained from mapping details). &#x20;
* Fuel Type: Type of fuel used by the vehicle (obtained from mapping details).
* Status: Current status of the VI N-IMEI mapping (e.g., "VIN-IMEI Mapped"). &#x20;
* Created On: Date and time the log entry was created. &#x20;

#### Location and Connectivity Details

* Latitude & Longitude: Geographic coordinates of the device (if available). &#x20;
* Plus Code: Location reference code for the device (if available). &#x20;
* Device Timestamp: Date and time of the packet received from the device. &#x20;
* Server Timestamp: Date and time of the packet received by the server. &#x20;
* Packet Type: Type of data packet received from the device (e.g., tracking data). &#x20;

#### Integration with VIN Journey Page

The latest VIN-IMEI mapping details for a specific VIN are also reflected on the VIN Journey page within the OEM Tool. This ensures you have easy access to the most current information about each connected vehicle.

#### IMEI Updates and Logging: &#x20;

* Whenever the IMEI associated with a VIN is updated, a new log entry is created in the VIN-IMEI logs page. &#x20;
* This log entry captures

## Over The Air (OTA)

This guide provides an overview of Zeliot's E-FOTA system, which enables remote firmware updates for ECUs in vehicles. &#x20;

### Major Components

Zeliot FOTA system consists of majorly 4 components: &#x20;

1. Campaign Manager: A FOTA Campaign Manager is an application responsible for communication with a backend server and updating campaign management for all the other ECUs in the vehicle. Typically runs on FOTA gateway. &#x20;
2. FOTA server: responsible for the management of vehicle software release, and optionally to customise updates for every vehicle client based on OEM policies.&#x20;
3. Condense: responsible for all device related communication like push command for flash initiation, package download, etc. It will act as an interface between device and OTA.&#x20;
4. TCU Flash Manager: application that performs final updating of firmware for ECUs during run-time. &#x20;

<figure><img src="/files/EAYty9C9qJE4eaxuepZ7" alt=""><figcaption></figcaption></figure>

| Field         | Value                                                                                                                              | Description                                                                                                                                                                      |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type          | ECU Flashing, Read Error codes, Erase Error Codes, Read Error codes with Snapshots, Read Data Identifiers, Update Data Identifiers | ECU Flash refers to Program Flash and data flash sometimes, Reading ECU common error codes, erasing these error codes, read and update data identifiers includes sensor readings |
| File Name     |                                                                                                                                    |                                                                                                                                                                                  |
| Name          | Delphi, Bosch, Bosch\_IFX, Cummins, Albonair                                                                                       |                                                                                                                                                                                  |
| Group         | Engine, ACU                                                                                                                        | Engine Control Unit, etc                                                                                                                                                         |
| File Type     | Base, Calibration, Base + Calibration                                                                                              |                                                                                                                                                                                  |
| Uploaded By   | Zeliot Admin, Client                                                                                                               |                                                                                                                                                                                  |
| Uploaded Date | DD-MM-YYYY HHMMSS                                                                                                                  |                                                                                                                                                                                  |
| Actions       | DD-MM-YYYY HHMMSS                                                                                                                  |                                                                                                                                                                                  |

### Process Flow

To create a campaign, please find the process flow below: &#x20;

#### &#x20;Step 1

<figure><img src="/files/5yXslZIOfa3ZQfDAYTQr" alt=""><figcaption></figcaption></figure>

User can create package (inclusive of file name, ECU name, ECU Group, Schedule Type and Group) for target ECU using the tab “Upload New File” as shown in below fig &#x20;

#### Step 2

Upload New file will open a dialog box as depicted in below fig. Here user will have provision to enter below fields:

<table><thead><tr><th>Field Name</th><th>Value</th><th data-hidden>Description</th></tr></thead><tbody><tr><td>Schedule Type </td><td>ECU Flashing, Read Error codes, Erase Error Codes, Read Error codes with Snapshots, Read Data Identifiers, Update Data Identifiers </td><td> </td></tr><tr><td>ECU Group </td><td>Engine, ACU </td><td> </td></tr><tr><td>ECU Name </td><td>Delphi, Bosch, Bosch_IFX, Cummins, Albonair </td><td> </td></tr><tr><td>File Type </td><td>Base, Calibration, Base + Calibration </td><td> </td></tr><tr><td>Upload File </td><td>Bin File </td><td> </td></tr><tr><td>Cancel/Upload File </td><td> </td><td> </td></tr></tbody></table>

<figure><img src="/files/sEievYVu4g92TMJagbkW" alt=""><figcaption></figcaption></figure>

#### Step 3

User can either cancel or upload the file. If the file is uploaded successfully, a record is created in the Files Tab.&#x20;

#### Step 4

Then the user needs to go to “Campaign” tab to create the campaign wrt package created.

#### Step 5

<figure><img src="/files/nEkjqB06yD6H6lyKf9FW" alt=""><figcaption></figcaption></figure>

A campaign allows you to deploy software updates to groups of devices. When you create a campaign, you need to specify the criteria of campaign type, ECU group, ECU name, file type and expiry days. &#x20;

#### &#x20;Step 6

To create a campaign, user needs to click on “New Campaign” tab in Campaigns page. A dialog box will open up where the user needs to input the details as shown in below fig

<figure><img src="/files/z7xNSmiOES0HBRR5VoPT" alt=""><figcaption></figcaption></figure>

| Field Name           | Value                                        | Desciption                                                          |
| -------------------- | -------------------------------------------- | ------------------------------------------------------------------- |
| Select Campaign Type | Dropdown option of VIN and IMEI              | User can either select it individually or in bulk                   |
| Select ECU Group     | BCU, ACU, Cluster, Engine, Powertrain        | User can select the ECU group from the drop-down menu               |
| Select ECU Name      | Delphi, Bosch, Bosch\_IFX, Cummins, Albonair | User can enter the ECU Name                                         |
| Select File Type     | Base, Calibration, Base+Calibration          | User to select type of file is whether Base or calibration or both. |
| Select File          | Bin File                                     | User to upload the file and select bin.                             |
| Type Expiry Number   | Expiry in days                               | User to provide the expiry date or validity of the campaign         |

<figure><img src="/files/EZIsBGLzgWz5kkdURjxO" alt=""><figcaption></figcaption></figure>

#### Step 7

Once user provides the details to create campaign, an OTP will be sent to email (as shown in below fig). The user needs to provide the OTP as confirmation for the package created/campaign created to be downloaded.

<figure><img src="/files/UxRxuCDG9xoQrdEcHopB" alt=""><figcaption></figcaption></figure>

#### Step 8

For OTP, there are multiple statuses associated with package. These statuses will reflect in “Campaigns” tab as shown in fig – New Campaign.

<table><thead><tr><th width="189">Case</th><th width="152">OTP Validation</th><th>Approved/Cancel</th><th>Status</th></tr></thead><tbody><tr><td>No OTP </td><td>Not Validated </td><td>NA </td><td>Pending for Approval </td></tr><tr><td>Incorrect OTP </td><td>Validated </td><td>Approved </td><td>Pending for Approval </td></tr><tr><td>Correct OTP </td><td>Validated </td><td>Approved </td><td>In Progress </td></tr><tr><td>Correct OTP and File Download and ECU flashing for all VINs </td><td>Validated </td><td>Approved </td><td>Completed </td></tr><tr><td>Manually Rejected </td><td>Validated </td><td>Approved </td><td>Rejected </td></tr></tbody></table>

Once the OTP is validated in OTA, it will act as a trigger for Condense to request for package download to TCU Flash Manager. TCU Flash manager acknowledges the command received by Condense and requests FOTA server to download the package (this package is stored in S3 bucket). TCU Flash Manager downloads the package and saves it. Simultaneously, the status is updated as Completed.

#### Step 9

As a subset of Creating Campaign Successfully, File Download and ECU flashing are 2 integral points. For File Download, below are the possible cases and flow:&#x20;

&#x20;

<table data-full-width="true"><thead><tr><th width="134">Case</th><th>Download File</th><th>Condense</th><th>TCU Flash Manager</th><th>VIN Status</th><th>Status</th></tr></thead><tbody><tr><td>Campaign - Rejected </td><td>NA </td><td>NA </td><td>NA </td><td>Inactive </td><td>Inactive </td></tr><tr><td>Campaign - Pending for Approval </td><td>NA </td><td>NA </td><td>NA </td><td>Active </td><td>PENDING </td></tr><tr><td>Campaign - In Progress </td><td>File Download option in Green - Not Triggered </td><td>Trigger yet to be received for package download command </td><td>Trigger yet to be received to download package </td><td>Active </td><td>PENDING </td></tr><tr><td>Campaign - In Progress </td><td>File Download option in Green - Triggered </td><td>Trigger received for package download command </td><td>Trigger received to download package </td><td>Active </td><td>FILE_DWNLD_REQ UESTED </td></tr><tr><td>Campaign - In Progress </td><td>File Download option in Green - Triggered </td><td>OTP validation success, Trigger received for package download command </td><td>Trigger received to download package, downloading in progress </td><td>Active </td><td>DEVICE_FILE_DO WNLOAD </td></tr><tr><td>Campaign - Completed </td><td>File Download option greyed out </td><td>OTP validation success, Trigger received for package download command </td><td>Package downloaded successfully </td><td>Active </td><td>FILE_DWLD_COM PLETED </td></tr><tr><td>Campaign - Completed </td><td>File Download option greyed out </td><td>OTP validation success, Trigger received for package download command </td><td>Package unavailable, deleted, corrupt, directory does not exist, pre-requisites not fulfilled, etc </td><td>Active </td><td>FILE_DWLD_FAILE D </td></tr></tbody></table>

For ECU Flashing, below are the possible cases and flow:

<table data-full-width="true"><thead><tr><th width="119">Case</th><th width="89">Flash ECU</th><th width="116">VIN Status</th><th width="136">Condense</th><th width="119">TCU Flash Manager</th><th>Status</th></tr></thead><tbody><tr><td>Inactive </td><td>NA </td><td>Inactive/Active </td><td>NA </td><td>NA </td><td>Inactive </td></tr><tr><td>PENDING </td><td>NA </td><td>Active </td><td>NA </td><td>NA </td><td>PENDING </td></tr><tr><td>FILE_DWNLD_REQ UESTED </td><td>NA </td><td>Active </td><td>Trigger received for package download command </td><td>Trigger received to download package </td><td>FILE_DWNLD_REQ UESTED </td></tr><tr><td>DEVICE_FILE_DO WNLOAD </td><td>NA </td><td>Active </td><td>Trigger received for package download command </td><td>Trigger received to download package, downloading in progress </td><td>DEVICE_FILE_DO WNLOAD </td></tr><tr><td>FILE_DWLD_COM PLETED </td><td>Enabled, not triggered </td><td>Active </td><td>Trigger received for package download command </td><td>Package downloaded successfully </td><td>FILE_DWLD_COM PLETED </td></tr><tr><td>FILE_DWLD_COM PLETED </td><td>Enabled, Triggered </td><td>Active </td><td>Latest Vehicle status check with pre- requisites satisfied </td><td>Package downloaded successfully </td><td>FLASH_REQUEST ED </td></tr><tr><td>FLASH_REQUEST ED </td><td>Disabled </td><td>Active </td><td>Latest Vehicle status check with pre- requisites satisfied </td><td>NA </td><td>FLASH_COMPLET ED </td></tr><tr><td>FLASH_REQUEST ED </td><td>Disabled </td><td>Active </td><td>Latest Vehicle status check with pre- requisites satisfied </td><td>NA </td><td><p>FLASH_FAILED </p><p>(security key check failed, etc) </p></td></tr></tbody></table>

#### Step 10

Once the Campaign Status is “Completed”, File Download Status is “FILE\_DWLD\_COMPLETED” and ECU Flash (for all VINs) is FLASH Completed with date and timestamp and progress as 100%, it reflects that Campaign is successful.

<figure><img src="/files/CwKJpnGMabknmRiJbmEb" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zeliot.in/condense-edge/oem-tool/access-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.