bcload

Name

bcload -- ZeitControl Firmware downloader for enhanced BasicCard Smart Cards

Synopsis

bcload [-?hlptv?] [-d debug_level] [-f fname] [-r reader]

DESCRIPTION

The bcload command is a firmware downloader for ZeitControl BasicCard Smart Cards. Bcload is based off the bcload example included in the development environment. Bcload has only been tested with ZC3.9 Smart Card hardware. Small changes would be required to support the Professional line of cards.

OPTIONS

-d, --debug= debug_level

Set debug level.

-f, --image= fname

Name of BasicCard Image file. Defaults to HOTPC.IMG

-h, --help

Help.

-l, --list-readers

List SC Readers

-p, --no-paranoid

Disable paranoid check for ZC3.9 hardware. Enhanced Smart Cards will probably work, support for the professional cards require changes to bcload.c.

-r, --reader= reader

Set Smart Card reader. Use -l to list available readers. A reader is defined as class:reader:[option]. PCSC and embedded are the two available classes. The embedded class contains the acr30s driver which is specified as embedded:acr30s:[serial_port]. If pcscd is running the first PC/SC reader will be the default followed by the embedded acr30s driver. Use PCSC: for the first available PC/SC reader. Use embedded:acr30s:/dev/cuaU0 for the embedded acr30s driver with serial port /dev/cuaU0.

-t, --force-test

Force card mode to TEST after programming. Defaults to the mode specified in the image file.

-v, --verbose

Display verbose status messages while programming the card.

--version

Display software version.

EXAMPLES

Download the HOTPC.IMG file to the default Smart Card reader. Display verbose results.

bcload -v -f HOTPC.IMG

Card/State: ZC3.9 test
EEChunkSize=2000
BCSetState: load
SC: Reset
EEStart=8020,EELen=1fa0
imgAddr=8020,imgLen=1fa0
Clear: addr=8020,len=1fa0
BCClearEEProm: success
SC: Reset
EEWRITE: nWrites=118,addr=8020,len=1e
EEWRITE: nWrites=117,addr=8038,len=10
EEWRITE: nWrites=116,addr=8170,len=38
...
EEWRITE: nWrites=1,addr=9f40,len=48
EEWRITE: nWrites=0,addr=9f80,len=48
EECRC: nWrites=1,addr=8020,len=1fa0,imgCRC=b17a
EECRC: SCCRC=b17a
EECRC: nWrites=0,addr=8020,len=00,imgCRC=00
EECRC: SCCRC=0
BCSetState: test
BCSetState: test

AUTHOR

Mark Fullmer

SEE ALSO

otp-control(1) otp-sca(1) otp-sct(1) pam_otp(1) htsoft-downloader(1) otp-ov-plugin(1) urd(1) spyrus-par2(7)