CNfcType3Connection Class Reference

#include <mw/nfctype3connection.h>

Link against: nfctagextension.lib

class CNfcType3Connection : public CActive, public MNfcConnection

Inherits from

CNfcType3Connection
- CActive
  - CBase
- MNfcConnection

Public Member Functions
	~CNfcType3Connection()
virtual IMPORT_C TInt	Activate(TInt)
virtual IMPORT_C void	CancelRawModeAccess()
IMPORT_C void	Check(TRequestStatus &, TDes8 &, TUint, const TNfcType3Address &)
IMPORT_C void	CheckCancel()
virtual IMPORT_C TNfcConnectionInfo::TNfcConnectionMode	ConnectionMode()
virtual IMPORT_C void	Deactivate()
IMPORT_C TInt	GetICCode(TInt &)
IMPORT_C TInt	GetIDm(TDes8 &)
virtual IMPORT_C TBool	IsActivated()
IMPORT_C CNfcType3Connection *	NewL(RNfcServer &)
IMPORT_C CNfcType3Connection *	NewLC(RNfcServer &)
virtual IMPORT_C void	RawModeAccess(TRequestStatus &, const TDesC8 &, TDes8 &, TTimeIntervalMicroSeconds32 &)
IMPORT_C void	Select(TRequestStatus &, TUint16)
IMPORT_C void	SelectCancel()
IMPORT_C void	Update(TRequestStatus &, const TDes8 &, const TNfcType3Address &)
IMPORT_C void	UpdateCancel()

Inherited Attributes
	CActive::iStatus

Inherited Enumerations
	CActive:TPriority

Inherited Functions
	CActive::CActive(TInt)
	CActive::Cancel()
	CActive::Deque()
	CActive::Extension_(TUint,TAny &,TAny )
	CActive::IsActive()const
	CActive::IsAdded()const
	CActive::Priority()const
	CActive::RunError(TInt)
	CActive::SetActive()
	CActive::SetPriority(TInt)
	CActive::~CActive()
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	MNfcConnection::~MNfcConnection()

Detailed Description

This interface provides access to a NFC Forum Type 3 tag.

Constructor & Destructor Documentation

~CNfcType3Connection ( )

IMPORT_C

~CNfcType3Connection

(

)

Destructor.

Member Function Documentation

Activate ( TInt )

IMPORT_C TInt

Activate

(

TInt

aHandle

)

[virtual]

Reimplemented from MNfcConnection::Activate(TInt)

See also: MNfcConnection

CancelRawModeAccess ( )

IMPORT_C void

CancelRawModeAccess

(

)

[virtual]

Reimplemented from MNfcConnection::CancelRawModeAccess()

See also: MNfcConnection

Check ( TRequestStatus &, TDes8 &, TUint, const TNfcType3Address & )

IMPORT_C void	Check	(	TRequestStatus &	aStatus,
			TDes8 &	aBuffer,
			TUint	aAmount,
			const TNfcType3Address &	aAddress
		)

Check memory blocks from the Type 3 tag.

Only one update/check command can be requested at a time.

Parameters
aStatus	The client's request status.
aBuffer	Descriptor for data.
aAmount	Length of data to be checked.
aAddress	Address where the check operation will start.

Return Value: Return values for aStatus:

Return Values

KErrArgument	aBuffer size was too small.
KErrDisconnected	No tag in field.
KErrInUse	The request is issued before the previous one is completed.
KErrNone	The operation is successfully completed.
KErrServerTerminated	Server connection is terminated.

CheckCancel ( )

IMPORT_C void

CheckCancel

(

)

Cancels check request.

ConnectionMode ( )

IMPORT_C TNfcConnectionInfo::TNfcConnectionMode

ConnectionMode

(

)

[virtual]

Reimplemented from MNfcConnection::ConnectionMode()

See also: MNfcConnection

Deactivate ( )

IMPORT_C void

Deactivate

(

)

[virtual]

Reimplemented from MNfcConnection::Deactivate()

See also: MNfcConnection

GetICCode ( TInt & )

IMPORT_C TInt

GetICCode

(

TInt &

aIcCode

)

Returns the IC code of the current Type 3 tag.

Parameters
aIcCode	The ICCode of the Type 3 tag.

Return Values

KErrDisconnected	No tag in field. Or block is locked and cannot be written.
KErrNone	The operation is successfully completed.
KErrServerTerminated	Server connection is terminated.

GetIDm ( TDes8 & )

IMPORT_C TInt

GetIDm

(

TDes8 &

aIdm

)

Returns the IDm (manufacturer ID) of the Type 3 tag. The lenght of the IDm is 8 bytes.

Parameters
aIdm	The IDm of the Type 3 tag.

Return Values

KErrArgument	If aIdm length is smaller than 8.
KErrDisconnected	No tag in field. Or block is locked and cannot be written.
KErrNone	The operation is successfully completed.
KErrServerTerminated	Server connection is terminated.

IsActivated ( )

IMPORT_C TBool

IsActivated

(

)

[virtual]

Reimplemented from MNfcConnection::IsActivated()

See also: MNfcConnection

NewL ( RNfcServer & )

IMPORT_C CNfcType3Connection *

NewL

(

RNfcServer &

aNfcServer

)

[static]

Creates a new instance of this class.

May leave with one of the system wide error codes.

Return Value: Pointer to the newly created instance.

NewLC ( RNfcServer & )

IMPORT_C CNfcType3Connection *

NewLC

(

RNfcServer &

aNfcServer

)

[static]

Creates a new instance of this class.

May leave with one of the system wide error codes.

Return Value: Pointer to the newly created instance.

RawModeAccess ( TRequestStatus &, const TDesC8 &, TDes8 &, TTimeIntervalMicroSeconds32 & )

IMPORT_C void	RawModeAccess	(	TRequestStatus &	aStatus,
			const TDesC8 &	aCommand,
			TDes8 &	aResponse,
			TTimeIntervalMicroSeconds32 &	aTimeout
		)	[virtual]

Reimplemented from MNfcConnection::RawModeAccess(TRequestStatus &,const TDesC8 &,TDes8 &,TTimeIntervalMicroSeconds32 &)

See also: MNfcConnection

Select ( TRequestStatus &, TUint16 )

IMPORT_C void	Select	(	TRequestStatus &	aStatus,
			TUint16	aSystemCode
		)

Asynchronous request to select a partition matching the specified system code.

A Type 3 tag may have different partitions each having a distinct system code. The partition selected by default is the first partition of the Type 3 tag (the primary partition). This method can be used to select another partition.

Return Value: aStatus returns the request completion value

Return Values

KErrCancel	The request was cancelled.
KErrInUse	Another request is pending.
KErrNone	when select is completed and partition matching to aSystemCode has been found.
KErrNotFound	Matching partition has not been found.
KErrNotSupported	Several matching partitions have been found. For example several tags with matching partition in the field. Or other systemwide error codes.

SelectCancel ( )

IMPORT_C void

SelectCancel

(

)

Cancels asynchronous Select request.

Update ( TRequestStatus &, const TDes8 &, const TNfcType3Address & )

IMPORT_C void	Update	(	TRequestStatus &	aStatus,
			const TDes8 &	aBuffer,
			const TNfcType3Address &	aAddress
		)

Updates data to the Type 3 tag. The data is updated to adjacent memory addresses belonging to a single service.

Only one update/check command can be requested at a time.

Parameters
aStatus	The client's request status.
aBuffer	Descriptor which contains data to be written. Length of the descriptor must be multiple of Type 3 block size in bytes
aAddress	The address where the update operation will start. See NFC Forum Type 3 specification for restrictions.

Return Value: Return values for aStatus:

Return Values

KErrArgument	Writing failed due to tag type specific restrictions
KErrDisconnected	No tag in field.
KErrInUse	The request is issued before the previous one is completed.
KErrNone	The operation is successfully completed.
KErrServerTerminated	Server connection is terminated.

UpdateCancel ( )

IMPORT_C void

UpdateCancel

(

)

Cancels update request.