SpringCard K531 & K632 - Console operation

About this document

This document provides information regarding the SpringCard K531 & K632 OEM embedded software.

You will find a detailed description of the SpringCard K531 & K632 hardware in the product datasheet.

Audience

This document is meant to be used by anyone wishing to build embedded electronic systems implementing the use of a ISO 144443 contactless interface.

History

Date Description
05/02/2007 Initial release
28/02/2008 ISO 15693 & ICODE1 command (specific for SpringCard K632 OEM) added
25/05/2009 ISO 15693 & ICODE1 command (specific for SpringCard K632 OEM) updated

Disclaimer

The "console" included in K531 & K632 OEM embedded software is not a part of the specified product features. They only provide a tool for product evaluation and test.

Depending on firmware version, the list of available commands and the format of their parameters may dramatically change, due to new features being included and to heavy differences in memory footprint.

Therefore, the console commands shall not be used at a production stage, and only be understood as a mean for developer or integrators to validate their hardware before writing host-side software.

Overview

Default communication parameters are :

Baudrate can be changed either at runtime (see below) or at startup (see K531 & K632 settings).

Mode : for performance reason, once firmware has started working either in OSI or in Binary protocol, the console is disabled. You must reset the module to enable the console (and the ASCII protocol BTW) again.

Basics

Getting the command list

Remember the list may vary when firmware version is updated.

Getting product version

Remember the list may vary when firmware version is updated.

Non-volatile settings (EEPROM)

Enter const to read current value of non-volatile settings.

Enter const=xxxxxxxx to set a new value, where xxxxxxxx is a 32-bit number (hexadecimal format) built according to K531 & K632 Settings document.

Non-volatile settings (FEED)

Please refer to K531 & K632 Settings document for a list of valid data (address and length). Do not try to change undocumented data !

Looking for cards (polling)

ISO/IEC 15693 and ICODE1 cards are specific for SpringCard K632 OEM.

Card lookup is performed every 200ms, and RF field is switched OFF between each rounds. Add a "!" after the command to have a continuous polling, with RF field always ON.

Use the "Escape" key to exit from polling.

Advanced flags for polling

The polling command can be altered by those flags :

Working with Mifare cards

Select a type A card

Enter tag or taga to select a card. Note there's no difference between a Mifare card and another kind of card at this level.

Read a Mifare card

Enter read to read the card.

Load "out-of-factory" keys into RC' EEPROM

Enter keys_e2 to load the default keys.

This will overwrite any other key you may have entered before, either through the console or by software.

Load a secret keys into RC' EEPROM

To change Mifare 'A' keys :

To change Mifare 'B' keys :

xxxxxxxxxxxx is the 6-byte value of the key (hexadecimal format).

This will overwrite any other key you may have entered before, either through the console or by software.

Working with T=CL cards

Select a card

Enter tag, tagb or taga to select a card (14443-3 activation). Note there's no difference between a T=CL compliant card and another kind of card at this level.

Opening a T=CL session

Type A

Enter ats to enter T=CL layer of a type A card (14443-4 activation).

Type B

Enter attrib to enter T=CL layer of a type B card (14443-4 activation).

Exchanging T=CL frames

Enter apdu xx...xx to dialog with the T=CL card.

Closing T=CL session

Enter deselect to disconnect from the T=CL card.

Working with ISO/IEC 15693 cards

NOTE : specific for SpringCard K632 OEM

Select a card

Enter tag* or tagv to select a card.

Select a card with standard mode

Enter tagvs to select a card with standard mode.

Select a card with fast mode

Enter tagvf to select a card with fast mode.

Read a card

Enter vic_rd to read the card.

Write a 4-byte block on a card

Enter vic_rwxx=yyyyyyyy to set a new value, where xx is the number of the block to be written (decimal format) and yyyyyyyy is the block data buffer (32-bit number in hexadecimal format).

Lock a 4-byte block on a card

Enter vic_lbxx to lock block, where xx is the number of the block to be locked (decimal format).

Get system information

Enter vic_info to get system information of the card.

Working with ICODE1 cards

NOTE : specific for SpringCard K632 OEM

Select a card with standard mode

Enter tag* or tagi to select a card with standard mode.

Select a card with fast mode

Enter tagif to select a card with fast mode.

Miscellaneous

LEDs

Enter leds=xxx to configure the LEDs.

Allowed values for each parameter are :

Changing baudrate

New baudrate is applied immediatly. Change baudrate in your terminal to be able to communicate with the module again.

Changing RC settings

See K531 & K632 settings for details.

Driving RF field

Any card-related command (tag, poll for instance) will automatically switch ON this field if it was OFF.