Running CrackNuts
This section uses the Cracker-S1 device as an example. In the CrackNuts side-channel acquisition and analysis integrated solution, the host software is provided to users in the form of a Python SDK. Users can use Jupyter as a programming IDE to control the device, acquire data, and perform subsequent data analysis.
The Cracker-S1 supports both DC 12V and POE power supply. The two power supply methods and their corresponding network connections are shown in the figure below:
This section demonstrates using the DC 12V method for power supply, and the host computer is directly connected to the Cracker for network connection.
For information on connecting the Cracker to an existing network, please refer to the host software section.
The functional layout of the Cracker-S1 device is as follows:
Device Connection​
After connecting the device to the DC 12V power supply and the network cable, switch the power selector to the DC 12V position to power on the device. After the device starts, its LED screen will display the current IP address.
By default, the Cracker-S1 is configured with an IP address of 192.168.0.10/24. When connecting directly to the device, you need to change the IP address of the host computer's Ethernet network card to another IP address within the 192.168.0.0/24 subnet. For example, the configuration in Windows:
In Windows, you can access the IP address modification window via Control Panel: Control Panel\Network and Internet\Network Connections, then select your wired network adapter.
After configuring the IP address on your host computer, you can use the PING command to verify if network communication is normal. For example, the following display in Windows indicates normal network communication:
ping 192.168.0.10
Pinging 192.168.0.10 with 32 bytes of data:
Reply from 192.168.0.10: bytes=32 time=1ms TTL=64
Reply from 192.168.0.10: bytes=32 time=1ms TTL=64
Reply from 192.168.0.10: bytes=32 time=1ms TTL=64
Reply from 192.168.0.10: bytes=32 time=1ms TTL=64
After verifying the communication is successful, you can start connecting with the host software.
If you need to connect the device to an existing Ethernet network, please refer to the user manual section for modifying the device's IP address.
Running the Host Software​
This section demonstrates how to run the host software using the Jupyter environment. If you installed CrackNuts using the quick installation method, you can find the CrackNuts launch icon in the Start menu or on the desktop (Linux users can find it in the launcher). Double-clicking CrackNuts will launch the CrackNuts environment. If you installed via pip, you can locate the environment where CrackNuts was installed.
In the CrackNuts environment, execute cracknuts lab to start Jupyter lab:
After completing the above steps, you have successfully launched the CrackNuts runtime environment.