Package net.rim.device.api.smartcard

Provides a library of components for interacting with Smart Cards and Smart Card Readers.

See:
Description

Interface Summary

ReaderStatus	This class defines the status of a smart card reader.
ReaderStatusListener	An interface which allows an application to listen to the status of readers.

Class Summary

AnswerToReset	Represents an Answer to Reset object(ATR).
CommandAPDU	Represents a command Application Protocol Data Unit (APDU).
ResponseAPDU	Represents a response Application Protocol Data Unit.
SmartCard	Represents a kind (or model or family) of a physical smart card, as opposed to one unique smart card.
SmartCardCapabilities	Represents the capabilites of a physical smartcard, in terms of the protocols the card supports, the baud rate and clock adjustment factors.
SmartCardFactory	Provides factory functions for dealing with SmartCard objects.
SmartCardID	A class to represent a specific smart card within a family of smart cards.
SmartCardReader	Represents a physical smart card reader.
SmartCardReaderFactory	Provides factory functions to return SmartCardReader and SmartCardReaderSession objects.
SmartCardReaderSession	Represents a communications session with a physical smartcard reader.
SmartCardSession	A SmartCardSession represents a communications session with a physical smartcard.

Exception Summary

SmartCardAccessDeniedException	Thrown when the user is unable to gain access to a smart card resource.
SmartCardBlockTimeoutException	Thrown when a block timeout occurs communicating with the card.
SmartCardCancelException	Thrown when a smart card operation is canceled, typically by the user.
SmartCardCharacterTimeoutException	Thrown when a character timeout occurs communicating with the card.
SmartCardException	Thrown when a smart card error occurs.
SmartCardIOException	Thrown when there is IO problem communicating with a reader or card.
SmartCardLockedException	Thrown when the user is unable to attempt anymore logins on a smart card.
SmartCardNoCardPresentException	Thrown when there is no card present in the smart card reader.
SmartCardNoReaderPresentException	Thrown when there is no reader attached to the device.
SmartCardProtocolErrorException	Thrown when there is an error in either the T=1 or T=0 protocol.
SmartCardRemovedException	Thrown when the card is removed when communicating with the card.
SmartCardSessionAlreadyOpenException	Thrown when a smart card session is already open.
SmartCardSessionClosedException	Thrown when a method is called on a closed SmartCardSession or SmartCardReaderSession.
SmartCardTimeoutException	Thrown when a smart card operation is taking too long.
SmartCardUnsupportedException	Thrown when a smart card is not supported by the reader.
SmartCardUnsupportedOperationException	Thrown when a smart card operation is not supported.

Package net.rim.device.api.smartcard Description

Provides a library of components for interacting with Smart Cards and Smart Card Readers.

Smart Cards are credit card sized devices that store programmable data on an integrated circuit within the body of the card. They are used to securely store, and more importantly transfer, sensitive data from one party to another. In the RIM Crypto API, smart cards are used to store and transfer sensitive crypto token data.

This package contains the framework and functionality required to allow developers to implement their own custom smartcard and smartcard reader solution.

For information on implementing smart cards, see Adding smartcard drivers to the SmartCard API. This tutorial describes the process of adding support for new smart cards and smart card drivers to the API.

For information on implementing smart card readers, see Adding smartcard reader drivers to the SmartCard API This tutorial describes the process of adding support for new smart card reader and smart card reader drivers to the API. A smart card reader consists of the physical device and the software driver used to read the data from a smart card.