Glossary
The vocabulary below is the one used throughout the platform, the API and this documentation.
Product and deployment
DK Studio β the web platform. It runs on a server, serves the UI and the REST API, and holds the database. Sometimes called the studio or the platform.
DK Studio Agent β the companion application that runs on the machine under test. It holds credentials, keeps a connection to the studio and executes commands. Sometimes called the agent.
Studio URL β the base URL an agent uses to reach the studio, for example
http://localhost:3000. It is the only address an agent ever needs.
Hosted studio β the studio operated by DK Studio. You install nothing on your side except the agents on your benches; the studio, the socket server and the database run on DK Studio's infrastructure. See Deployment modes.
In-house installation β the studio running on infrastructure you control, with your own database and your own agent pool. See Deployment modes.
Deployment mode β which of the two a studio runs in. The mode decides where the processes run and where the data lives; the REST API, the agent protocol, the case model and the reports are the same in both.
Licensing
Licence β a row in agent_licenses that authorises exactly one agent registration. A personal
licence is applied for in Personal Center; a lab licence is issued from Admin β Licences.
Licence code β the one-time ticket the agent presents to register. It is spent on that registration and never works again.
Licence type β personal or lab. It decides whether the machine that registers becomes the
owner's own machine or part of the shared lab.
Licence status β one of:
| Status | Meaning |
|---|---|
pending | Issued, not yet claimed by an agent. |
consumed | Claimed by a registered agent. |
revoked | Permanently invalidated. The agent can no longer register with it. |
expired | Past its expiry date. |
Edition β the tier a licence key grants: starter, professional, pro or enterprise. Each
edition carries a maximum agent count and a feature list. See
Setup Wizard.
Demo licence β the built-in key ENT0-DKST-UDIO-2026, which always verifies and grants the
enterprise edition.
Agents
Agent id β the identifier the studio assigns to an agent at registration. It is the value the agent sends on every command and heartbeat.
API key β a 32-character alphanumeric secret returned at registration. The agent presents it to authenticate over HTTP.
Agent secret β the credential the agent uses to authenticate over the socket. The studio generates it when registration succeeds and stores it on the agent row.
Registration β the one-time handshake where an agent claims a licence and receives its id, API key and secret. A licence is spent on that registration. Registering again with the agent's own credentials updates the agent in place and increments its registration count.
Connection status β online or offline. Derived from the live socket connection, not from a
stored flag, so it reflects reality within a heartbeat interval.
Command β a unit of work sent to an agent: shell, get_system_info, get_serial_ports,
open_serial, close_serial, serial_write.
Command status β pending, then in_progress once the agent claims it, then completed. The
result carries its own status: success, error or timeout.
Domain
Digital key β the credential that unlocks a vehicle, delivered over NFC or a companion app. DK Studio is built for teams that develop and verify them.
OEM β original equipment manufacturer. The car maker. In this domain an OEM defines a protocol family that its suppliers implement.
Protocol family β one of the protocols DK Studio covers: CCC, ICCE, ICCOA or COT. The first three are public industry standards; COT is DK Studio's own proprietary protocol. See Supported Protocols.
Protocol driver β the part of a family's driver layer that encodes its frames, reads its replies and maps its requirements to bench commands. One per family. The COT driver ships with the platform.
Vehicle model β a specific car model, usually with several hardware variants.
Bench β the test rig in the lab: a PC with a serial or USB connection to a key reader or an ECU.
ECU β electronic control unit. The microcontroller on the other end of the bench.
Serial port β the serial connection to a bench device, opened at a baud rate such as 115200.
Device under test β the reader, ECU, module, phone or rig the agent is attached to; the thing being verified.
Layer under test β one of the three layers of a digital key product that DK Studio covers: vehicle, cloud or mobile. See Overview.
Vehicle layer β the MCU, UWB, NFC and BLE modules, and the digital key controllers, readers and ECUs attached to them.
Cloud layer β the digital key backend: interface performance, key generation and distribution logic, and the certificate chain that binds vehicle, cloud and handset together.
Mobile layer β the system-level wallet car keys on branded phones and smart watches, across the main wallet ecosystems and the vehicle maker's own app.
Wallet β the application on a phone or watch that holds the system-level car key: a platform wallet on a branded handset, or the vehicle maker's own app.
Test case / test suite / test run / execution β the verification hierarchy: a test case is one checkable condition, a suite groups cases, a run executes a suite, and an execution records one case's outcome within a run.
Artifact β a file produced by a run, such as a log or a captured trace.
Environment β a named configuration a run executes against.