C API for BALTECH SDK

§ brp_Sys_SelectProtocol()

brp_errcode brp_Sys_SelectProtocol ( brp_protocol  protocol,
brp_ProtocolID  Protocol 
)

This command starts a host protocol.

Depending on the reader's hardware and firmware, multiple protocols may be supported. For most reader-to-host interfaces (e.g. USB, Ethernet), an unlimited number of protocols can be used on the physical channel, but in some cases only a single protocol per physical channel can be used at a time. This is for example the case when using a serial (RS-232/UART) interface, offering two physical channels, in which case each physical channel must be shared by several protocols.

After power-up, the reader activates all protocols specified in the__ Device / Run / EnabledProtocols__ configuration value. To change the activated protocols at runtime, this command has to be used.

In case only a single protocol is allowed to run per physical channel, calling this command when a channel is already in use by another protocol will stop the currently running protocol.

Example: the protocol is currently running on a serial interface (physical channel CH0) when Sys.SelectProtocol is called with ProtocolID = 0x09 (Debug Interface). Since the Debug Interface protocol uses the same physical channel (CH0), it will be disabled.

Parameters
[in]protocolused to execute the command
[in]ProtocolA list of all protocols. Not all protocols are available on all Firmware variants.