pcsc

Documentation

Overview

* package to handle the communication of smartcard devices under the PCSC implementation

projects on which it is based:

https://github.com/LudovicRousseau/PCSC
https://github.com/ebfe/scard

/*

Index

• func ListReaders(ctx *Context) ([]string, error)
• type Card
• type Context
  • func NewContext() (*Context, error)
  • func (c *Context) Release() error
• type Reader
  • func NewReader(ctx *Context, readerName string) Reader
• type Scard
  • func (c *Scard) ATR() ([]byte, error)
  • func (c *Scard) ATS() ([]byte, error)
  • func (c *Scard) Apdu(apdu []byte) ([]byte, error)
  • func (c *Scard) ControlApdu(ioctl uint32, apdu []byte) ([]byte, error)
  • func (c *Scard) ControlApduA(ioctl uint32, apdu []byte) ([]byte, error)
  • func (c *Scard) DisconnectCard() error
  • func (c *Scard) DisconnectEjectCard() error
  • func (c *Scard) DisconnectResetCard() error
  • func (c *Scard) DisconnectUnpowerCard() error
  • func (c *Scard) EndTransaction() error
  • func (c *Scard) EndTransactionResetCard() error
  • func (c *Scard) GetData(ins byte) ([]byte, error)
  • func (c *Scard) SAK() byte
  • func (c *Scard) Switch1444_3() ([]byte, error)
  • func (c *Scard) Switch1444_4() ([]byte, error)
  • func (c *Scard) TransparentSessionEnd() ([]byte, error)
  • func (c *Scard) TransparentSessionResetRF() ([]byte, error)
  • func (c *Scard) TransparentSessionStart() ([]byte, error)
  • func (c *Scard) TransparentSessionStartOnly() ([]byte, error)
  • func (c *Scard) UID() ([]byte, error)
• type State

Functions

func ListReaders

func ListReaders(ctx *Context) ([]string, error)

List Readers in a Context

Types

type Card

type Card interface {
	smartcard.ICard
	ControlApdu(ioctl uint32, apdu []byte) ([]byte, error)
	ControlApduA(ioctl uint32, apdu []byte) ([]byte, error)
	EndTransaction() error
	EndTransactionResetCard() error
	// DisconnectResetCard() error
	// DisconnectUnpowerCard() error
	// DisconnectEjectCard() error
	TransparentSessionStart() ([]byte, error)
	TransparentSessionStartOnly() ([]byte, error)
	TransparentSessionResetRF() ([]byte, error)
	TransparentSessionEnd() ([]byte, error)
	Switch1444_4() ([]byte, error)
	Switch1444_3() ([]byte, error)
}

Card Interface

type Context

type Context struct {
	*scard.Context
}

func NewContext

func NewContext() (*Context, error)

Establish Context to Reader in pcscd

func (*Context) Release

func (c *Context) Release() error

Release Context in pcscd

type Reader

type Reader interface {
	smartcard.IReader
	Name() string
	ConnectDirect() (Card, error)
	ConnectCardPCSC() (Card, error)
	ConnectCardPCSC_T0() (Card, error)
	ConnectCardPCSC_Tany() (Card, error)
}

Interface to Reader device

func NewReader

func NewReader(ctx *Context, readerName string) Reader

Create New Reader interface

type Scard

type Scard struct {
	State State
	*scard.Card
	// contains filtered or unexported fields
}

func (*Scard) ATR

func (c *Scard) ATR() ([]byte, error)

ATR Get ATR from Card

func (*Scard) ATS

func (c *Scard) ATS() ([]byte, error)

ATS GetData with INS = 0x01

func (*Scard) Apdu

func (c *Scard) Apdu(apdu []byte) ([]byte, error)

Apdu Primitive function (SCardTransmit) to send command to card

func (*Scard) ControlApdu

func (c *Scard) ControlApdu(ioctl uint32, apdu []byte) ([]byte, error)

ControlApdu Primitive function (SCardControl) to send command to card

func (*Scard) ControlApduA

func (c *Scard) ControlApduA(ioctl uint32, apdu []byte) ([]byte, error)

ControlApdu Primitive function (SCardControl) to send command to card

func (*Scard) DisconnectCard

func (c *Scard) DisconnectCard() error

DisconnectCard Disconnect card from context with card with disposition type LeaveCard

func (*Scard) DisconnectEjectCard

func (c *Scard) DisconnectEjectCard() error

DisconnectEjectCard Disconnect card from context with card with disposition type EjectCard

func (*Scard) DisconnectResetCard

func (c *Scard) DisconnectResetCard() error

DiconnectResetCard Disconnect card from context with card with disposition type ResetCard

func (*Scard) DisconnectUnpowerCard

func (c *Scard) DisconnectUnpowerCard() error

DisconnectUnpowerCard Disconnect card from context with card with disposition type UnpowerCard

func (*Scard) EndTransaction

func (c *Scard) EndTransaction() error

EndTransactionn End transaccion with card with disposition type LeaveCard

func (*Scard) EndTransactionResetCard

func (c *Scard) EndTransactionResetCard() error

EndTransactionResetCard End transaccion with card with disposition type ResetCard

func (*Scard) GetData

func (c *Scard) GetData(ins byte) ([]byte, error)

GetData GetData with param INS

func (*Scard) SAK

func (c *Scard) SAK() byte

func (*Scard) Switch1444_3

func (c *Scard) Switch1444_3() ([]byte, error)

Switch1444_4 switch channel reader to send ISO 1444-3 APDU

func (*Scard) Switch1444_4

func (c *Scard) Switch1444_4() ([]byte, error)

Switch1444_4 switch channel reader to send ISO 1444-4 APDU

func (*Scard) TransparentSessionEnd

func (c *Scard) TransparentSessionEnd() ([]byte, error)

TransparentSessionEnd finish transparent session

func (*Scard) TransparentSessionResetRF

func (c *Scard) TransparentSessionResetRF() ([]byte, error)

TransparentSessionResetRF start transparent session to send APDU

func (*Scard) TransparentSessionStart

func (c *Scard) TransparentSessionStart() ([]byte, error)

Transparent Session (PCSC)

func (*Scard) TransparentSessionStartOnly

func (c *Scard) TransparentSessionStartOnly() ([]byte, error)

TransparentSessionStartOnly start transparent session to send APDU

func (*Scard) UID

func (c *Scard) UID() ([]byte, error)

UID GetData with INS = 0x00

type State

type State int

Connect state

const (
	CONNECTED State = iota
	CONNECTEDDirect
	DISCONNECTED
)