Class TagAccess

Namespace

TechnologySolutions.Rfid

Assembly

TechnologySolutions.Rfid.Operations.dll

Provides a specification to perform a tag access operation on a EPC Global C1G2 transponder including

• BlockPermalockLock(TagMemory, int, int, int)
• BlockPermalockRead(int, int, int)
• Kill(int, int)
• Lock(int, int)
• Read(MemoryBank, int, int, int)
• Write(MemoryBank, int, TagMemory, int)

This can be combined with a TagFilter (which specifies which tag(s) to access) into a TagAccessFilterFields for use with an IReaderOperationTranspondersAccess

e.g. Read(MemoryBank, int, int, int) to Read the user memory bank starting at word offset 0 for 4 words. Use Access password 0x11223344

TagAccess.Read(MemoryBank.User, /* offset */ 0, /* count */4, /*access password*/ 0x11223344);

public class TagAccess

Inheritance

object

TagAccess

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Fields

NoPassword

The value to use when no access password is set

public const int NoPassword = 0

Field Value

int

Properties

AccessPassword

Gets the access password

public int AccessPassword { get; }

Property Value

int

Data

Gets the data to write

public TagMemory Data { get; }

Property Value

TagMemory

KillPassword

Gets the kill password (kill only)

public int KillPassword { get; }

Property Value

int

LockPayload

Gets the lock payload (lock only)

public int LockPayload { get; }

Property Value

int

See Also

LockPayload

Memory

Gets the memory bank to access

public MemoryBank Memory { get; }

Property Value

MemoryBank

Operation

Gets the tag access operation to perform

public TagAccessOperation Operation { get; }

Property Value

TagAccessOperation

WordCount

Gets the number of words to access

public int WordCount { get; }

Property Value

int

WordOffset

Gets the offset in words into the specified Memory to access

public int WordOffset { get; }

Property Value

int

Methods

BlockPermalockLock(TagMemory, int, int, int)

Returns a TagAccess to lock blocks. Perform a BlockPermalock Lock.

public static TagAccess BlockPermalockLock(TagMemory mask, int blockPtr, int blockRange, int accessPassword = 0)

Parameters

mask TagMemory

The mask must be a least 16 x blockRange bits long. The mask bits are ordered from lower block to higher. A bit 0 means retain the current block permalock status, A bit 1 is block permalock the corresponding memory block.

blockPtr int

Specifies the stating address for Mask, in units of 16 blocks. For example 0 for block 0, 1 for block 16, 2 for block 32

blockRange int

Specifies the range of mask, staring at blockPtr and ending (16 x blockRange) - 1 blocks later.

accessPassword int

The access password for the transponder

Returns

TagAccess

A TagAccess to BlockPermalock Lock the specified blocks

Remarks

For each transponder accessed a TransponderData is returned. If the command was successful for the transponder the IsLockSuccess is true. If the command was not successful for the transponder the TransponderAccessErrorCode or TransponderBackscatterErrorCode is set.

BlockPermalockRead(int, int, int)

Returns a TagAccess to read the block permalock status. Perform a BlockPermalock Read.

public static TagAccess BlockPermalockRead(int blockPtr, int blockRange, int accessPassword = 0)

Parameters

blockPtr int

Specifies the stating address for Mask, in units of 16 blocks. For example 0 for block 0, 1 for block 16, 2 for block 32.

blockRange int

Specifies the range of mask, staring at blockPtr and ending (16 x blockRange) - 1 blocks later.

accessPassword int

The access password for the transponder

Returns

TagAccess

A TagAccess to read the BlockPermalock status

Remarks

For each transponder accessed a TransponderData is returned. The BlockPermalock status is reported as a bit mask in the ReadData field. If the command was not successful for the transponder the TransponderAccessErrorCode or TransponderBackscatterErrorCode is set.

Kill(int, int)

Returns a TagAccess to kill a transponder

public static TagAccess Kill(int killPassword, int accessPassword)

Parameters

killPassword int

The transponder kill password

accessPassword int

The transponder access password

Returns

TagAccess

A TagAccess to Kill a transponder

Remarks

For each transponder accessed a TransponderData is returned. If the command was successfll for the transponder the IsKillSuccess is true. If the command was not successful for the transponder the TransponderAccessErrorCode or TransponderBackscatterErrorCode is set.

Lock(int, int)

Returns a TagAccess to lock a transponder

public static TagAccess Lock(int lockPayload, int accessPassword)

Parameters

lockPayload int

The payload that specifies how and what memory to lock

accessPassword int

The access password for the transponder

Returns

TagAccess

A TagAccess to Lock a transponder

Remarks

For each transponder accessed a TransponderData is returned. If the command was successful for the transponder the IsLockSuccess is true. If the command was not successful for the transponder the TransponderAccessErrorCode or TransponderBackscatterErrorCode is set.

See Also

LockPayload

Read(MemoryBank, int, int, int)

Returns a TagAccess to read the memory of a transponder

public static TagAccess Read(MemoryBank memory, int wordOffset, int wordCount, int accessPassword = 0)

Parameters

memory MemoryBank

The memory bank to read

wordOffset int

The offset in words into the memory to read from

wordCount int

The number of words to read

accessPassword int

The access password for the transponder

Returns

TagAccess

A TagAccess to read a transponder

Remarks

For each transponder accessed a TransponderData is returned. The read data is reported in the ReadData field. If the command was not successful for the transponder the TransponderAccessErrorCode or TransponderBackscatterErrorCode is set.

Write(MemoryBank, int, TagMemory, int)

Returns a TagAccess to write the memory of a transponder

public static TagAccess Write(MemoryBank memory, int wordOffset, TagMemory data, int accessPassword = 0)

Parameters

memory MemoryBank

The memory bank to write

wordOffset int

The offset in words into the memory to start writing at

data TagMemory

The data to write to the memory

accessPassword int

The access password for the transponder

Returns

TagAccess

A TagAccess to write to a transponder

Remarks

For each transponder accessed a TransponderData is returned. If the command was successful for the transponder the WordsWritten is returned with the number of words written. This may be less than the expected count so should be checked. If the command was not successful for the transponder the TransponderAccessErrorCode or TransponderBackscatterErrorCode is set.