Skip to content

Add project settings to your configuration

In the project settings, you define which data is read from the project card and how it is converted. You can create project settings once you've collected the project information.

Supported card types

You can create project settings for the card types listed here. For all other card types, please order a configuration.

In most cases, you'll have 1 configuration file and add 1 project settings component to it as described below. In more complex scenarios, however, you may need multiple project settings, e.g. when dealing with various card types or exchanging an encryption key (learn more here).

Add a project settings component

  1. Open BALTECH ConfigEditor.

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

  2. In the popup window, click Open and select the BALCFG file of your existing configuration.
    Screenshot: Open an existing configuration (BALCFG format) in BALTECH ConfigEditor

    If you don't have a configuration file yet, create a new one.

  3. Click Extend Configuration.

  4. Navigate to the card type you want to add.
    Screenshot: Example menu path to add autoread project settings for a 13.56 MHz card in BALTECH ConfigEditor
  5. Select the appropriate Autoread form and fill it out as described in the next chapter.

Select and fill out project settings form

Depending on your card type, one or several forms are available. Below, you get an overview of when to use which form and how to fill it out.

125 kHz cards

Autoread UID

Details

Default form to read the card's UID.

  • If the UID returned by the card matches the expected number, you don't have to fill out anything. Just save the empty form as part of your configuration.
  • If the numbers don't match, enter the UID returned by the card in the Sample UID field and use the UID Transformation Rules to convert it into the expected number.

Autoread UID in Wiegand Format

Details

Use this form if the data on the card is encoded in Wiegand format. You'll get Wiegand-specific UID transformation rules to obtain the expected number.

13.56 MHz cards

Autoread UID

Details

Read the card's UID.

  • If the UID matches the expected number, you don't have to fill out anything. Just save the empty form as part of your configuration.
  • If the numbers don't match, use the UID Conversion Rules to convert the UID into the expected number.

Autoread UID with Authentication

Details

Read the UID of a card that returns a random ID by default.

  • In the Card Parameters section, specify any encryption key for reading the card's UID.
  • If the card's real UID doesn't match the expected number, use the UID Conversion Rules to convert the UID.

Autoread PCN

iClass

Read a PCN on an iClass card that needs to be accessed with an HID iClass SE Processor (also known as "iClass SAM").

There's a standard and an advanced form. Please always start with the standard form. Only use the advanced form if the standard form doesn't produce the expected result.

Standard

  • This form covers standard HID bit lengths. If you can rule out certain bit lengths for your project card, select Restrict card formats to disable them.
  • Convert the PCN into the expected number. To do so, use the options in the Cut PCN section (learn more about these options here).
  • If the form doesn't return the expected number when you test it in ID-engine Explorer, your card uses an uncommon bit format. In this case, use the advanced form.

Advanced

  • Open the advanced form. Without making any changes, test it in ID-engine Explorer.
  • Take the number returned by ID-engine Explorer and enter it in the Data in hex field of the form. The first byte is the bit length, the following bytes are the card number.
  • Convert this number into the expected number. To do so, use the options in the Facility Code and ID Code sections (learn more about these options here). By default, the options in the IC Code section are applied to the entire data stream. To convert the facility code individually, select Activate Facility Code.
  • If you want to use HID configuration cards to deploy HID Elite Keys to the reader, select Enable HID ConfigCards.
All other card types

Read a PCN stored in the card's memory.

  • In the Card Parameters section, specify the memory location of the data to read and, if applicable, the encryption key.
  • In the How PCN is stored section, specify the byte length and encoding of the data.

Autoread ID of NFC ID App

Details

Use this form if you use an NFC ID app instead of a card.

  • Specify the number to read and its byte length.

When you're done, you can test your project settings.