i2cdriver/README.md

63 lines
1.9 KiB
Markdown

![logo](/images/logo.png)
[![Build Status](https://travis-ci.org/jamesbowman/i2cdriver.svg?branch=master)](https://travis-ci.org/jamesbowman/i2cdriver)
[![Documentation Status](https://readthedocs.org/projects/i2cdriver/badge/?version=latest)](https://i2cdriver.readthedocs.io/en/latest/?badge=latest)
I2CDriver is a tool for controlling any I2C device from your PC's USB port,
and can also monitor and capture I2C traffic.
It connects as a standard USB serial device, so there are no drivers to install.
On the main site
[i2cdriver.com](https://i2cdriver.com),
there are drivers for
* Windows/Mac/Linux GUI
* Windows/Mac/Linux command-line
* Python 2 and 3
* Windows/Mac/Linux C/C++
![front](/images/hero.jpg)
Full documentation is at
[i2cdriver.com](http://i2cdriver.com).
For developers: How to make a release
-------------------------------------
To release Python:
rm -rf dist/*
python setup.py sdist
twine upload dist/*
To build the Windows installer, you first need to build the two executables
``i2ccl.exe`` and ``i2cgui.exe`` then use an NSIS script to create the installer.
On Linux cross-compile ``i2ccl``:
cd c
make -f win32/Makefile
On Windows first make sure that you can run the GUI on the command-line, e.g.
python python\samples\i2cgui.py
(You may need to install i2cdriver, wxPython and pySerial).
Then build the GUI executable using ``pyinstaller``:
cd python\samples
pyinstaller --onefile --windowed --icon=../../images/i2cdriver.ico i2cgui.py
This builds the executable in ``python\samples\dist\i2cgui.exe``.
The Windows installer is built with NSIS (Nullsoft Scriptable Install System). Download and install it.
Copy the two executables ``i2ccl.exe`` and ``i2cgui.exe`` into ``nsis/``.
Then build the installer with NSIS:
cd nsis
"C:\Program Files\NSIS\makensis.exe" i2cdriver.nsi
The script ``go.bat`` in ``nsis`` has an example complete flow.