Skip to content

OSS Creator

Create OSS application data structure on virgin Desfire transponders.

Overview

The OSS Creator feature allows the OSS Updater to be configured in "creator" mode, enabling the creation of the OSS application data structure on a virgin Desfire transponder. This eliminates the need for pre-provisioned transponders and enables on-site credential creation.

Available since: Version 23.10 (October 2023)

How to Use

Prerequisites

  • OSS Updater device configured and coupled to the DOMBridge
  • Virgin Desfire transponders
  • API v23 or later

Configuration Steps

  1. Enable Creator Mode

Set the OSS Updater to "creator" mode via the API:

POST /api/oss/updater/{updater_id}/mode
{
  "mode": "creator"
}
  1. Present Virgin Transponder

Place the virgin Desfire transponder near the OSS Updater device.

  1. Create OSS Structure

The OSS Updater will automatically: - Detect the virgin transponder - Create the OSS application data structure - Write the credential information

  1. Verify Creation

Check the transponder status via:

GET /api/oss/transponder/{transponder_id}/status

API Reference

Refer to section 4.8.4.2 Creator function in the Middleware API Specification v24.

Updates

26.01 — March 2026

Narrower Configuration

  • Creator mode configuration now lets you define the number of DTS, day IDs and time periods
  • The API returns an error when trying to push more permissions than the transponder can support

24.04 — April 2024

EID Support

  • OSS Creator now supports EID (Electronic ID) with Firmware 5.9
  • Extended compatibility with newer transponder types

24.01 — January 2024

Recovery Enhancement

  • If transponder was not correctly written the first time, it will now be recovered automatically
  • Improved reliability of the creation process

23.10 — October 2023

Initial Release

  • Introduced OSS Creator functionality
  • OSS Updater can now be set as "creator" mode
  • Enables creation of OSS application data structure on virgin Desfire transponders