====== GreatFET One ======
A Python-programmable USB peripheral tool. 

===== Pins =====
The major attraction of the GreatFET is its array of I/O pins. The main headers (J1, J2, J7) contain 100 pins total, a few of which are set aside for special protocols. 

<WRAP center round important 60%>
I/O pins on the GreatFET are **not** 5V-tolerant!
</WRAP>

Right now, the best sources of pinout information are [[https://gf-pinout.greatscottgadgets.com/]] and [[https://github.com/greatfet-hardware/azalea]]. 

===== CLI =====
The ''greatfet'' Python package includes a series of CLI scripts for working with the various interfaces.

Zadig is needed to get the correct drivers on Windows. If two interfaces show up instead of one, unselect the "Ignore hubs or composite parents" option and choose the "GreatFET (Composite parent)" device. Then install the libusbK driver over the existing driver, and it should all work fine from there((https://github.com/greatscottgadgets/greatfet/issues/327#issuecomment-1080016036)). 

===== IPython shell =====
There is a bug in the ''gf shell'' command that prevents it from running under recent IPython versions. A small substitution in ''commands/greatfet_shell.py'' is all that is needed to fix it ((See [[https://github.com/SeismicSource/sourcespec/commit/8bde65ca752c24e5a421387ae4b6bc5c59e76c97|this GitHub commit]] from a different project.)). 
===== Links =====
  * https://hackaday.com/2019/07/02/hands-on-greatfet-is-an-embedded-tool-that-does-it-all/
  * https://greatscottgadgets.github.io/greatfet-tutorials/
  * https://greatfet.readthedocs.io/en/latest/index.html