Expand description
Numeric constants of the ATECC608B protocol.
Every byte value, command opcode, max execution time, polling parameter, and packet size lives here. The rest of the driver imports symbols by name and never uses magic numbers.
Source of truth: Microchip CryptoAuthLib (lib/calib/calib_command.h and
lib/calib/calib_execution.c). Cross-references to the public summary
datasheet (DS40002239A) are included in comments where they exist.
Constants§
- COMMAND_
FRAME_ 🔒OVERHEAD - Number of bytes a command frame contains besides its data payload.
- EXEC_
TIME_ 🔒CHECKMAC_ MS - Nominal execution time of
CheckMac, in milliseconds. - EXEC_
TIME_ 🔒COUNTER_ MS - Nominal execution time of
Counter, in milliseconds. - EXEC_
TIME_ 🔒GENDIG_ MS - Nominal execution time of
GenDig, in milliseconds. - EXEC_
TIME_ 🔒GENKEY_ MS - Nominal execution time of
GenKey, in milliseconds. - EXEC_
TIME_ 🔒INFO_ MS - Nominal execution time of
Info, in milliseconds. - EXEC_
TIME_ 🔒LOCK_ MS - Nominal execution time of
Lock, in milliseconds. - EXEC_
TIME_ 🔒NONCE_ MS - Nominal execution time of
Nonce, in milliseconds. - EXEC_
TIME_ 🔒PRIVWRITE_ MS - Nominal execution time of
PrivWrite, in milliseconds. - EXEC_
TIME_ 🔒RANDOM_ MS - Nominal execution time of
Random, in milliseconds. - EXEC_
TIME_ 🔒READ_ MS - Nominal execution time of
Read, in milliseconds. - EXEC_
TIME_ 🔒SIGN_ MS - Nominal execution time of
Sign, in milliseconds. - EXEC_
TIME_ 🔒VERIFY_ MS - Nominal execution time of
Verify, in milliseconds. - EXEC_
TIME_ 🔒WRITE_ MS - Nominal execution time of
Write, in milliseconds. - I2C_
ADDRESS 🔒 - Factory default 7-bit I2C address of an ATECC608B-SSHDA. Programmable via
the
ChipMode.I2C_Addressbyte of the config zone, but never changed in this project. - MAX_
COMMAND_ 🔒DATA_ LEN - Maximum size of the data field of a command, equal to
MAX_PACKET_SIZE - 1 (word addr) - COMMAND_FRAME_OVERHEAD = 155. - MAX_
PACKET_ 🔒SIZE - Maximum size of a command packet sent to the chip, including the word address byte prepended at the I2C level.
- MAX_
RESPONSE_ 🔒SIZE - Maximum size of a response read from the chip.
- OP_
CHECKMAC 🔒 CheckMac- verify a precomputed MAC against a stored secret.- OP_
COUNTER 🔒 Counter- read or increment the monotonic counters.- OP_
GENDIG 🔒 GenDig- derive a digest intoTempKeyfor use withWriteencrypted.- OP_
GENKEY 🔒 GenKey- generate a P-256 key pair in a slot, or compute a public key.- OP_INFO 🔒
Info- retrieve revision / status /KeyValid.- OP_LOCK 🔒
Lock- irreversibly lock a zone or a slot.- OP_
NONCE 🔒 Nonce- loadTempKeyorMsgDigBuffor subsequent commands.- OP_
PRIVWRITE 🔒 PrivWrite- encrypted write of a P-256 private key into a slot.- OP_
RANDOM 🔒 Random- produce 32 cryptographically random bytes.- OP_READ 🔒
Read- read 4 or 32 bytes from config / data / OTP.- OP_SIGN 🔒
Sign- produce an ECDSA P-256 signature.- OP_
VERIFY 🔒 Verify- verify an ECDSA P-256 signature.- OP_
WRITE 🔒 Write- write 4 or 32 bytes to config / data / OTP.- POLLING_
MAX_ 🔒MS - Upper bound on the total polling window before
crate::AteccError::Timeout. - POLLING_
PERIOD_ 🔒MS - Time the driver waits between two consecutive response reads.
- WAKE_
DELAY_ US - Time to wait after the wake pulse before the first I2C transaction.
- WAKE_
LOW_ DURATION_ US - Minimum duration SDA must be held low to wake the chip (datasheet
tWLO). - WAKE_
RESPONSE_ 🔒OK - Bytes returned by the chip after a successful wake.
- WAKE_
RESPONSE_ 🔒SELFTEST_ FAIL - Bytes returned if the chip’s self-test failed at wake.
- WORD_
ADDRESS_ 🔒COMMAND - Word address sent before every command packet.
- WORD_
ADDRESS_ 🔒IDLE - Word address that puts the chip in idle (keeps
TempKey, drops the watchdog). - WORD_
ADDRESS_ 🔒SLEEP - Word address that puts the chip into deep sleep (clears volatile state).