General FAQ & Troubleshooting


Release Notes - Latest Release 1/13/2023 (RC-23.01)

We updated the common Zymbit software release common to all products: ZYMKEY4, HSM4, HSM6, and the new SCM-based product line. Existing customers can do an update/upgrade to get the latest code.

sudo apt-get update
sudo apt-get upgrade -y
sudo pip3 install zku --upgrade

Zymbit Host Side Code Versions (view with dpkg -l | grep -i zym):

  • libzk 1.1-22
  • libzymkeyssl 1.0-10
  • zkapputilslib 1.1-25
  • zkbootrtc 1.1-15
  • zkifc 1.2-36
  • zkpkcs11 1.0-3
  • zksaapps 1.0-16
  • zku 1.0.33

Changes

  • Added support for Raspberry OS Bullseye 64-bit and Ubuntu 22.04 Jammy 32-bit and 64-bit
  • Common code base supports across all products including SCM. See SCM release notes for details on SCM features.
  • Fixed: #120 get_public_key() with a very large number crashes zkifc
  • Fixed: #123 zk_pkcs11: Doesn’t work with 64-bit OS
  • Fixed: #113 LED resets to default pattern after 5-10 minutes
  • Fixed: #110 Fixed memory leak in zkifc which eventually could lead to zkifc crashing
  • API functions that include Bip or Slip have been renamed to BIP and SLIP. See API docs for new syntax

Issues and Solutions

Expired GPG Key Preventing Access to Repository

The Zymbit GPG key expired and was renewed on September 30, 2022. New installations should not have any problems. apt-get update may complain that the GPG key has expired. To update your local key, do the following:

sudo su
curl -L https://zk-sw-repo.s3.amazonaws.com/apt-zymkey-pubkey.gpg | apt-key add -

CPU Scaling Governor

We have seen some issues with the scaling cpu governor on the raspberry pi interfere with the i2c bus. This sometimes causes the zymkey to be put into a odd state or return failures from operations that get optimized out by the governor. The raspberry pi sets the scaling governor to be “ondemand” by default. We recommend switching this mode to “performance” to get the best out of the zymkey. Details:

Unattended-upgrades

When encrypting your rootfs, we highly recommend turning off unattended-upgrades prior to the encryption process. In some cases primarily with Ubuntu 20.04, during an update/upgrade after encryption, the update-initramfs process may fail and leave the system unable to boot.

To mitigate this issue, remove the service unattended-upgrades:

systemctl stop unattended-upgrades

systemctl disable unattended-upgrades

Products

Q: Where can I learn about and/or pre-order future products?
Expand for Answer

A: Sign up for our new product email updates at the bottom of Zymbit’s homepage.


Q: What are the differences between Zymbit’s Products?
Expand for Answer

A: See the Product Comparison Matrix for the differences between Zymkey, HSM4, and HSM6. Please reach out with any further questions.


Q: How much power do Zymbit products consume?
Expand for Answer
  • Zymkey-RPi (3.3V): idle approx. 1mA; max active < 25mA with LED off, < 35mA with LED on.
  • Zymkey-USB (5V): idle approx. 1.5mA; max active < 40mA with LEDs off, < 60mA with LEDs on.

See Power Quality for more information.


Compatibility

Q: Which operating systems does Zymbit support?
Expand for Answer

supported OSs


Q: Which SBCs are compatible with Zymbit Products?
Expand for Answer
  • Electrically, the Zymkey-I2C will interface to any single board computer using I2C. Check compatibility with your particular Linux distribution.
  • Raspberry Pi 3, 3B+, 4, Zero
  • RPi Compute Module 3, 4
  • NVIDIA Jetson Nano, Xavier NX

Q: Do Zymbit Products work with Arduino?
Expand for Answer

A: We have no plans to release an Arduino shield version. While we love Arduinos and use them all the time, they generally don’t have enough resources to handle cryptographic operations at this level.


Q: Do Zymbit Products work with BeagleBone?
Expand for Answer

A: Zymbit does not officially support the BeagleBoard platform at this time.