.bp Block Permalock transponder Command

This command is used to read or write the block permalock status on supported transponders. Block permalock is an optional command in the Class 1 Generation 2 Air Protocol so requires both the reader and the transponder to support the block permalock command for it to be used. With block permalock the user memory of a transponder is split into several manufacturer defined blocks. These blocks each have a write protect bit which can be set but NOT reset (hence permalock). The block permalock command can be used to read the status of these permalock flags or to write them. To read the permalock flags specify the start index offset (-do) and the number of blocks (-dl) to read the status of. The returned data is a bit pattern of lock status, 1 for locked 0 for not locked. To write the permalock flags specify the start index offset (-do), the number of blocks (-dl), the mask of the blocks to lock (-dm). Setting the bit index for the block permalock to 1 will permalock the block, setting to 0 will leave the block in its current state (permalocked or not).

Android	iOS	.NET
link coming soon	link coming soon	BlockPermalockTransponderCommand

Parameters

Identifier	Values	Description
-al	on/off	Perform an alert after a successful write using the current alert Parameters from the .al command
-ap	xxxxxxxx	Access password, where xxxxxxxx is an 8 character ASCII Hex value
-c	on/off	Include EPC checksum response
-dm	xxxx..zzzz	The mask data of blocks to lock in 4 character ASCII Hex words. Up to a maximum of 16 words
-dl	xx	Length in words of the data to read or write, where xx is a 2 character ASCII Hex value up to a maximum of 10hex
-do	xxxx	Mask data offset specifies the starting address for the mask, in units of 16 manufacturer defined blocks, where xxxx is a 4 character ASCII Hex value
-dt	on/off	Include date time response
-e	on/off	Include EPC PC information response
-io	on/off	Inventory only, if set to on then no select will be performed before the inventory round phase is started
-ix	on/off	Index number each transponder response
-m	rd/wr	Set the mode to either read (rd) the block permalock status or write (wr) the block permalock bits
-n		No action, just set the parameters
-o	nn	Output power in dBm, where nn is in the range 10 to 29
-p		List the parameter and their current values
-ql	all/nsl/sl	query Select
-qs	s0/s1/s2/s3	query Session
-qt	a/b	query Target
-qv	nn	Q value (0..15)
-r	on/off	Include transponder RSSI response
-sa	n	Select action
-sb	epc/tid/usr	Bank to use for the select mask
-sd	xx..zz	Select mask data in 2 character ASCII Hex bytes padded to ensure full bytes, up to a maximum of 32 bytes.
-sl	xx	Length in bits of the select mask, where xx is a 2 character ASCII Hex value
-so	xxxx	Number of bits from the start of the block to the start of the select mask, where xxxx is a 4 character ASCII Hex value
-st	s0/s1/s2/s3/sl	Select target
-x		Reset the parameters to defaults

Parameter detail

-al

Perform an alert after a successful write using the current alert Parameters from the .al command

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	2
Default Value	on

-ap

Access password, where xxxxxxxx is an 8 character ASCII Hex value

Type	HEX
Value	xxxxxxxx
Range	8 Hex digits
Order In Interpretation	24
Default Value	00000000

-c

Include EPC checksum response

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	3
Default Value	off

-dm

The mask data of blocks to lock in 4 character ASCII Hex words. Up to a maximum of 16 words

Type	HEX
Value	xxxx..zzzz
Range	integer numberof HEX words
Order In Interpretation	22
Default Value

-dl

Length in words of the data to read or write, where xx is a 2 character ASCII Hex value up to a maximum of 10hex

Type	HEX
Value	xx
Range	2 Hex digits
Order In Interpretation	21
Default Value	00

-do

Mask data offset specifies the starting address for the mask, in units of 16 manufacturer defined blocks, where xxxx is a 4 character ASCII Hex value

Type	HEX
Value	xxxx
Range	4 Hex digits
Order In Interpretation	23
Default Value	0000

-dt

Include date time response

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	7
Default Value	off

-e

Include EPC PC information response

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	4
Default Value	off

-io

Inventory only, if set to on then no select will be performed before the inventory round phase is started

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	14
Default Value	off

-ix

Index number each transponder response

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	8
Default Value	off

-m

Set the mode to either read (rd) the block permalock status or write (wr) the block permalock bits

Type	Enum
Value	rd/wr
Range	rd/wr
Order In Interpretation	5
Default Value	rd

-n

No action, just set the parameters

Type	Switch
Value
Range
Order In Interpretation	26

-o

Output power in dBm, where nn is in the range 10 to 29

Type	Output power
Value	nn
Range
Order In Interpretation	13
Default Value	29

-p

List the parameter and their current values

Type	Switch
Value
Range
Order In Interpretation	25

-ql

query Select

Type	Enum
Value	all/nsl/sl
Range	all/nsl/sl
Order In Interpretation	17
Default Value	all

-qs

query Session

Type	Enum
Value	s0/s1/s2/s3
Range	s0/s1/s2/s3
Order In Interpretation	18
Default Value	s2

-qt

query Target

Type	Enum
Value	a/b
Range	a/b
Order In Interpretation	19
Default Value	b

-qv

Q value (0..15)

Type	Output power
Value	nn
Range
Order In Interpretation	20
Default Value	4

-r

Include transponder RSSI response

Type	Enum
Value	on/off
Range	on/off
Order In Interpretation	6
Default Value	off

-sa

Select action

Parameter n=	Matching Action		Non Matching Action
	SL Flag	Session Flag	SL Flag	Session Flag
0	assert	Set A	deassert	Set B
1	assert	Set A	nothing	nothing
2	nothing	nothing	deassert	Set B
3	toggle	toggle	nothing	nothing
4	deassert	Set B	assert	Set A
5	deassert	Set B	nothing	nothing
6	nothing	nothing	assert	Set A
7	nothing	nothing	toggle	toggle

Type	Numeric
Value	n
Range
Order In Interpretation	15
Default Value	4

-sb

Bank to use for the select mask

Type	Enum
Value	epc/tid/usr
Range	epc/tid/usr
Order In Interpretation	9
Default Value	epc

-sd

Select mask data in 2 character ASCII Hex bytes padded to ensure full bytes, up to a maximum of 32 bytes.

Type	HEX
Value	xx..zz
Range	Integer number of HEX bytes
Order In Interpretation	12
Default Value

-sl

Length in bits of the select mask, where xx is a 2 character ASCII Hex value

Type	HEX
Value	xx
Range	2 Hex digits
Order In Interpretation	11
Default Value	00

-so

Number of bits from the start of the block to the start of the select mask, where xxxx is a 4 character ASCII Hex value

Type	HEX
Value	xxxx
Range	4 Hex digits
Order In Interpretation	10
Default Value	0000

-st

Select target

Type	Enum
Value	s0/s1/s2/s3/sl
Range	s0/s1/s2/s3/sl
Order In Interpretation	16
Default Value	s2

-x

Reset the parameters to defaults

Type	Switch
Value
Range
Order In Interpretation	1

Parameter Interpretation Order

-x, -al, -c, -e, -m, -r, -dt, -ix, -sb,-so, -sl, -sd, -o, -io, -sa, -st, -ql, -qs, -qt, -qv, -dl, -dm, -do, -ap, -p, -n

Parameter Defaults

-al on, -ap 00000000, -c off, -dm, -dl 00, -do 0000, -dt off, -e off, -io off, -ix off, -m rd, -o 29, -ql all, -qs s2, -qt b, -qv 4, -r off, -sa 4, -sb epc, -sd, -sl 00, -so 0000, -st s2

Response Headers

CR CS DT EA EB EP ER IX ME OK PC PR RI LS

Examples

Command	Response	Action
.bp -x -sd1166FFFFAAAAFFFF -sl40 -so0020 -m wr -dl01 -do0000 -dm1000	CS: .bp -x -sd1166FFFFAAAAFFFF -sl40 -so0020 -m wr -dl01 -do0000 -dm1000 EP: 1166FFFFAAAAFFFF LS: Lock Success OK:	Block permalock block 3 of transponder with EPC 1166FFFFAAAAFFFF
.bp -x -sd1166FFFFAAAAFFFF -sl40 -so0020 -m rd -dl01 -do0000	CS: .bp -x -sd1166FFFFAAAAFFFF -sl40 -so0020 -dl01 -do0000 -m rd EP: 1166FFFFAAAAFFFF RD: 0000 OK:	Read the block permalock status of transponder with EPC 1166FFFFAAAAFFFF (no blocks locked)