Signed-off-by: jh8801.jung <jh8801.jung@samsung.com>
Change-Id: I471d85aed87122117415a287b6cd7aac4b7d9de8
/// <summary>
/// A class for Smartcard channel informations. It allows applications to handle channel informations.
/// </summary>
/// <summary>
/// A class for Smartcard channel informations. It allows applications to handle channel informations.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
public class SmartcardChannel : IDisposable
{
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
public class SmartcardChannel : IDisposable
{
/// <summary>
/// Whether the kind of channel is basic.
/// </summary>
/// <summary>
/// Whether the kind of channel is basic.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public bool IsBasicChannel
{
get
public bool IsBasicChannel
{
get
/// <summary>
/// Whether the kind of channel is logical.
/// </summary>
/// <summary>
/// Whether the kind of channel is logical.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public bool IsLogicalChannel
{
get
public bool IsLogicalChannel
{
get
/// <summary>
/// Whether the channel is closed.
/// </summary>
/// <summary>
/// Whether the channel is closed.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public bool IsClosed
{
get
public bool IsClosed
{
get
/// <summary>
/// The session that has opened the given channel.
/// </summary>
/// <summary>
/// The session that has opened the given channel.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public SmartcardSession Session
{
get
public SmartcardSession Session
{
get
/// <summary>
/// Closes the given channel to the Secure Element.
/// </summary>
/// <summary>
/// Closes the given channel to the Secure Element.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public void Close()
{
int ret = Interop.Smartcard.Channel.ChannelClose(_channelHandle);
public void Close()
{
int ret = Interop.Smartcard.Channel.ChannelClose(_channelHandle);
/// <summary>
/// Gets the response to the select command.
/// </summary>
/// <summary>
/// Gets the response to the select command.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Byte array to retrieve the SELECT response.</returns>
public byte[] GetSelectedResponse()
{
/// <returns>Byte array to retrieve the SELECT response.</returns>
public byte[] GetSelectedResponse()
{
/// <summary>
/// Transmits an APDU command (as per ISO/IEC 7816-4) to the Secure Element.
/// </summary>
/// <summary>
/// Transmits an APDU command (as per ISO/IEC 7816-4) to the Secure Element.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Byte array for the response APDU plus status words.</returns>
/// <param name="cmd">Command APDU to be send to the secure element.</param>
public byte[] Transmit(byte[] cmd)
/// <returns>Byte array for the response APDU plus status words.</returns>
/// <param name="cmd">Command APDU to be send to the secure element.</param>
public byte[] Transmit(byte[] cmd)
/// <summary>
/// Helper function to retrieves the response APDU of the previous transmit() call.
/// </summary>
/// <summary>
/// Helper function to retrieves the response APDU of the previous transmit() call.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Byte array for the response APDU plus status words.</returns>
public byte[] GetTransmittedResponse()
{
/// <returns>Byte array for the response APDU plus status words.</returns>
public byte[] GetTransmittedResponse()
{
/// <summary>
/// Performs a selection of the next Applet on the given channel that matches to the partial Application ID(AID).
/// </summary>
/// <summary>
/// Performs a selection of the next Applet on the given channel that matches to the partial Application ID(AID).
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>True or false depending whether another applet with the partial Application ID(AID).</returns>
public bool SelectNext()
{
/// <returns>True or false depending whether another applet with the partial Application ID(AID).</returns>
public bool SelectNext()
{
/// <summary>
/// A class for Smartcard management. It allows applications to use Smartcard service.
/// </summary>
/// <summary>
/// A class for Smartcard management. It allows applications to use Smartcard service.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
static public class SmartcardManager
{
/// <summary>
/// Gets the list of available Secure Element readers.
/// </summary>
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
static public class SmartcardManager
{
/// <summary>
/// Gets the list of available Secure Element readers.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>List of SmartcardReader objects.</returns>
static public IEnumerable<SmartcardReader> GetReaders()
{
/// <returns>List of SmartcardReader objects.</returns>
static public IEnumerable<SmartcardReader> GetReaders()
{
/// <summary>
/// A class for Smartcard reader informations. It allows applications to handle reader informations.
/// </summary>
/// <summary>
/// A class for Smartcard reader informations. It allows applications to handle reader informations.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
public class SmartcardReader : IDisposable
{
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
public class SmartcardReader : IDisposable
{
/// <summary>
/// The name of reader.
/// </summary>
/// <summary>
/// The name of reader.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <summary>
/// The existence of secure element.
/// </summary>
/// <summary>
/// The existence of secure element.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public bool IsSecureElementPresent
{
get
public bool IsSecureElementPresent
{
get
/// <summary>
/// Connects to a Secure Element in the given reader.
/// </summary>
/// <summary>
/// Connects to a Secure Element in the given reader.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>The SmartcardSession object.</returns>
public SmartcardSession OpenSession()
{
/// <returns>The SmartcardSession object.</returns>
public SmartcardSession OpenSession()
{
/// <summary>
/// Closes all the sessions opened on the given reader.
/// </summary>
/// <summary>
/// Closes all the sessions opened on the given reader.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public void CloseSessions()
{
int ret = Interop.Smartcard.Reader.ReaderCloseSessions(_readerHandle);
public void CloseSessions()
{
int ret = Interop.Smartcard.Reader.ReaderCloseSessions(_readerHandle);
/// <summary>
/// A class for Smartcard session informations. It allows applications to handle session informations.
/// </summary>
/// <summary>
/// A class for Smartcard session informations. It allows applications to handle session informations.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
public class SmartcardSession : IDisposable
{
/// <privilege>http://tizen.org/privilege/secureelement</privilege>
public class SmartcardSession : IDisposable
{
/// <summary>
/// The reader object that provides the given session.
/// </summary>
/// <summary>
/// The reader object that provides the given session.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public SmartcardReader Reader
{
get
public SmartcardReader Reader
{
get
/// <summary>
/// The Answer to Reset(ATR) of this Secure Element.
/// </summary>
/// <summary>
/// The Answer to Reset(ATR) of this Secure Element.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <summary>
/// Whether the session is closed.
/// </summary>
/// <summary>
/// Whether the session is closed.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public bool IsClosed
{
get
public bool IsClosed
{
get
/// <summary>
/// Closes the connection with the Secure Element.
/// </summary>
/// <summary>
/// Closes the connection with the Secure Element.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public void Close()
{
int ret = Interop.Smartcard.Session.SessionClose(_sessionHandle);
public void Close()
{
int ret = Interop.Smartcard.Session.SessionClose(_sessionHandle);
/// <summary>
/// Closes any channel opened on the given session.
/// </summary>
/// <summary>
/// Closes any channel opened on the given session.
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
public void CloseChannels()
{
int ret = Interop.Smartcard.Session.SessionCloseChannels(_sessionHandle);
public void CloseChannels()
{
int ret = Interop.Smartcard.Session.SessionCloseChannels(_sessionHandle);
/// <summary>
/// Gets an access to the basic channel, as defined in the ISO/IEC 7816-4 specification (the one that has number 0).
/// </summary>
/// <summary>
/// Gets an access to the basic channel, as defined in the ISO/IEC 7816-4 specification (the one that has number 0).
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>The SmartcardChannel object for basic channel.</returns>
/// <param name="aid">Byte array containing the Application ID(AID) to be selected on the given channel.</param>
/// <param name="p2">P2 byte of the SELECT command if executed.</param>
/// <returns>The SmartcardChannel object for basic channel.</returns>
/// <param name="aid">Byte array containing the Application ID(AID) to be selected on the given channel.</param>
/// <param name="p2">P2 byte of the SELECT command if executed.</param>
/// <summary>
/// Open a logical channel with the Secure Element, selecting the Applet represented by the given Application ID(AID).
/// </summary>
/// <summary>
/// Open a logical channel with the Secure Element, selecting the Applet represented by the given Application ID(AID).
/// </summary>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>The SmartcardChannel object for logical channel.</returns>
/// <param name="aid">Byte array containing the Application ID(AID) to be selected on the given channel.</param>
/// <param name="p2">P2 byte of the SELECT command if executed.</param>
/// <returns>The SmartcardChannel object for logical channel.</returns>
/// <param name="aid">Byte array containing the Application ID(AID) to be selected on the given channel.</param>
/// <param name="p2">P2 byte of the SELECT command if executed.</param>