Skip to content

Create a configuration for a custom application

To prepare readers for access from your application, you may need a configuration. Whether or not you need one depends on your operation mode.

  • If your operation mode is Autoread, we recommend you create the configuration with Autoread Wizard.
  • For all other operation modes, create your configuration as described below.

Set up configuration

  1. Open BALTECH ConfigEditor.
    If you haven't installed it yet, you can download it here as part of BALTECH ToolSuite.

  2. Click Create from Scratch.

    Screenshot: Create a new configuration from scratch in BALTECH ConfigEditor to configure BALTECH RFID readers

  3. A new configuration opens.

Complete configuration

BALTECH configurations consist of several components. When you create a configuration from scratch, it only contains the component Administrative Information with details for managing the configuration.

To complete the configuration:

  1. Click the Plus icon and add a host interface component.

    Screenshot: Add a host interface component in BALTECH ConfigEditor

  2. Select your operation mode if this option is available.

    My operation mode isn't listed.

    If you use VHL without config, select APDU (via VHL) or Low Level.

    Screenshot: Operation Mode option in an host interface component in BALTECH ConfigEditor

  3. The left column of Your Workflow now guides you through configuration completion.

    a) If needed for your operation mode, add an Autoread component and/or a VHL file.

    b) Complete the components by filling in the indicated details. If you're unsure what to enter, please refer to your card issuer. You can also analyze the card structure of certain card types.

    Tip: Clicking an entry will highlight the respective setting.

    Screenshot: Example list of missing components and empty, mandatory configuration fields in a configuration created from scratch in BALTECH ConfigEditor

  4. Review and adjust the default settings in all components.
    Settings in Administrative Information are described here.

  5. If needed, add additional components via the Plus icon at the top. E.g. if you want to set up AES Authentication and Encryption you can import the respective component.

Set password (optional)

As an option, you can set a password to encrypt the BALCFG file. We highly recommend this in the following cases:

  • You want to send the BALCFG file to someone else for further editing.
  • You store the BALCFG file on a server where unauthorized users may access it.

To set a password, click File > Set Password. Please transmit the password via a different channel than the configuration, e.g. via SMS or on the phone.

For productive deployment, please only hand out the deployable file that is exported when you release a configuration version. This file is end-to-end-encrypted and thus doesn't need to be protected with a password.

Test it

You can test Autoread components right in ConfigEditor. To test VHL, you can use ID-engine Explorer.

Back to top