Metadata-Version: 2.1
Name: i2cx
Version: 0.9.1
Summary: Graphical interface for I2Cx Scanner Lite (FT2232H)
Home-page: https://github.com/I2Cx-Cyber-Range/i2cx-gui
Author: LOOTUS
Author-email: julien.moinard@lootus.net
License: UNKNOWN
Project-URL: Homepage, https://www.i2cx.io
Keywords: ftdi i2cx pyside cyberrange IoT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyside6
Requires-Dist: pyftdi

### I²Cx Scanner Lite
Port A => can drive 4 mA (needed for SWD)

Port B => can drive 16 mA (useful to force logic level on bus like I2C and SPI and avoid reset master)

### Install from PyPi
pip3 install i2cx --no-cache-dir

### Upgrade from PyPi
pip3 install upgrade i2cx --no-cache-dir

### To start Graphical Interface of I²Cx Cyber Range
i2cx

### To use I²Cx Scanner Lite with openOCD you need to add a config file (available in tools folder)
/usr/local/share/openocd/scripts/interface/i2cx-scanner-lite.cfg

openocd -f interface/i2cx-scanner-lite.cfg -f target/stm32f7x.cfg  -c "adapter speed 4000"

telnet 127.0.0.1 4444

flash read_bank 0 firmware.bin

### Allow I2Cx Scanner Lite to non root user and Load FTDI driver to I2CX Scanner Lite
edit /etc/udev/rules.d/35-i2cx-cyber-range.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6E50", GROUP="plugdev"
ACTION=="add", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6e50", RUN+="/sbin/modprobe ftdi_sio" RUN+="/bin/sh -c 'echo 0403 6e50 > /sys/bus/usb-serial/drivers/ftdi_sio/new_id'"

### In case or OpenGl issue
ImportError: libOpenGL.so.0: cannot open shared object file: No such file or directory
sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
sudo apt-get install -y libopengl0

or

sudo apt-get install --reinstall libxcb-xinerama0

or

sudo apt-get install freeglut3 freeglut3-dev

## I2CX on windows
The probably easiest way to deal with libusb on Windows is to use Zadig

Start up the Zadig utility

Select Options/List All Devices, then select the FTDI devices you want to communicate with. Its names depends on your hardware, i.e. the name stored in the FTDI EEPROM.

With FTDI devices with multiple channels, such as FT2232 (2 channels) and FT4232 (4 channels), you must install the driver for the composite parent, not for the individual interfaces. If you install the driver for each interface, each interface will be presented as a unique FTDI device and you may have difficulties to select a specific FTDI device port once the installation is completed. To make the composite parents to appear in the device list, uncheck the Options/Ignore Hubs or Composite Parents menu item.

Be sure to select the parent device, i.e. the device name should not end with (Interface N), where N is the channel number.

for example Dual RS232-HS represents the composite parent, while Dual RS232-HS (Interface 0) represents a single channel of the FTDI device. Always select the former.

Select libusb-win32 (not WinUSB) in the driver list.

Click on Replace Driver

