commit
5f30b13087
GPG Key ID:
2C5FD5035250423D
@ -0,0 +1,3 @@ |
|||||||
|
*.map |
||||||
|
.sass-cache |
||||||
|
.idea/ |
||||||
@ -0,0 +1,6 @@ |
|||||||
|
<footer> |
||||||
|
<div> |
||||||
|
GEX is a project by Ondřej Hruška (MightyPork) |
||||||
|
</div> |
||||||
|
</footer> |
||||||
|
</body></html> |
||||||
@ -0,0 +1,39 @@ |
|||||||
|
<?php |
||||||
|
$cli = defined('STDIN'); |
||||||
|
$suf = $cli ? '.html' : '.php'; |
||||||
|
list($curpage, ) = explode('.', basename($curpage)); |
||||||
|
$pages = [ |
||||||
|
"index" => 'What is GEX', |
||||||
|
"features" => 'Features', |
||||||
|
"platforms" => 'Platforms', |
||||||
|
"downloads" => 'Downloads', |
||||||
|
"contact" => 'Get Involved', |
||||||
|
]; |
||||||
|
?><!DOCTYPE html> |
||||||
|
<html> |
||||||
|
<head lang="en"> |
||||||
|
<meta charset="UTF-8"> |
||||||
|
<title>GEX - <?= $pages[$curpage] ?></title>
|
||||||
|
<link rel="stylesheet" href="css/application.css"> |
||||||
|
</head> |
||||||
|
<body> |
||||||
|
|
||||||
|
<header id="PageHeader"> |
||||||
|
<div> |
||||||
|
<span id="top"></span> |
||||||
|
<span class="Title">GEX</span><br> |
||||||
|
<span class="Subtitle">...the GPIO header for your PC</span> |
||||||
|
</div> |
||||||
|
</header> |
||||||
|
|
||||||
|
<section> |
||||||
|
<nav> |
||||||
|
<?php |
||||||
|
foreach ($pages as $page => $label) { |
||||||
|
echo "<a href=\"$page$suf\""; |
||||||
|
if ($curpage == $page) echo ' class="active"'; |
||||||
|
echo ">$label</a>"; |
||||||
|
} |
||||||
|
?> |
||||||
|
</nav> |
||||||
|
</section> |
||||||
@ -0,0 +1,24 @@ |
|||||||
|
<?php $curpage = basename(__FILE__); require '_header.php'; ?> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>How to Contribute</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
GEX is open-source, and I want it to grow beyond the current one-man-show. |
||||||
|
A <a href="https://github.com/gexpander/">GitHub mirror</a> of most of the GEX |
||||||
|
repositories is available and regularly updated to match the upstream. |
||||||
|
Feel free to send pull requests or issues to these repos. |
||||||
|
</p> |
||||||
|
|
||||||
|
<h1>Contact</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
You can reach me by e-mail at <a href="mailto:ondra@ondrovo.com">ondra@ondrovo.com</a>, |
||||||
|
or send me a message on Mastodon (GNU Social compatible): <a>@MightyPork@dev.glitch.social</a> |
||||||
|
</p> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<?php require '_footer.php'; ?> |
||||||
|
|
||||||
@ -0,0 +1,13 @@ |
|||||||
|
#!/bin/bash |
||||||
|
|
||||||
|
php contact.php > public/contact.html |
||||||
|
php downloads.php > public/downloads.html |
||||||
|
php features.php > public/features.html |
||||||
|
php index.php > public/index.html |
||||||
|
php platforms.php > public/platforms.html |
||||||
|
|
||||||
|
cp -r img public/ |
||||||
|
cp -r css public/ |
||||||
|
cp -r js public/ |
||||||
|
|
||||||
|
echo "Done." |
||||||
@ -0,0 +1,93 @@ |
|||||||
|
html, body { |
||||||
|
width: 100%; |
||||||
|
height: 100%; |
||||||
|
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; |
||||||
|
color: #333; |
||||||
|
font-size: 16pt; |
||||||
|
margin: 0; |
||||||
|
padding: 0; } |
||||||
|
|
||||||
|
body { |
||||||
|
overflow-y: scroll; } |
||||||
|
|
||||||
|
*, *::before, *::after { |
||||||
|
box-sizing: border-box; } |
||||||
|
|
||||||
|
a { |
||||||
|
color: #005e5e; |
||||||
|
text-decoration: none; } |
||||||
|
a:hover { |
||||||
|
color: #001d5e; |
||||||
|
text-decoration: none; } |
||||||
|
|
||||||
|
section, header, footer { |
||||||
|
width: 100%; } |
||||||
|
section > *, header > *, footer > * { |
||||||
|
max-width: 850px; |
||||||
|
margin: 0 auto; |
||||||
|
padding: 10pt 0; } |
||||||
|
|
||||||
|
section, header { |
||||||
|
border-bottom: 4px solid darkcyan; } |
||||||
|
section h1:first-child, header h1:first-child { |
||||||
|
margin-top: .4em; } |
||||||
|
|
||||||
|
section + section { |
||||||
|
border-bottom: none; } |
||||||
|
section + section > * { |
||||||
|
border-bottom: 2px dashed rgba(0, 139, 139, 0.5); } |
||||||
|
|
||||||
|
section:last-of-type { |
||||||
|
border-bottom: 4px solid darkcyan; } |
||||||
|
section:last-of-type > * { |
||||||
|
border-bottom: 0 none; } |
||||||
|
|
||||||
|
header .Title { |
||||||
|
font-size: 40pt; |
||||||
|
font-weight: bold; |
||||||
|
letter-spacing: 2pt; } |
||||||
|
header .Subtitle { |
||||||
|
font-size: 24pt; } |
||||||
|
|
||||||
|
nav a { |
||||||
|
padding-right: 10pt; |
||||||
|
padding-left: 10pt; |
||||||
|
border-right: 2px solid darkcyan; } |
||||||
|
nav a:first-child { |
||||||
|
padding-left: 0; } |
||||||
|
nav a:last-child { |
||||||
|
border-right: 0 none; } |
||||||
|
nav a.active { |
||||||
|
font-weight: bold; } |
||||||
|
|
||||||
|
h1 a { |
||||||
|
opacity: .3; |
||||||
|
margin-left: 6pt; } |
||||||
|
h1 a:hover { |
||||||
|
opacity: .6; } |
||||||
|
|
||||||
|
p { |
||||||
|
text-align: justify; } |
||||||
|
|
||||||
|
h2 { |
||||||
|
font-size: 110%; } |
||||||
|
|
||||||
|
footer { |
||||||
|
text-align: left; |
||||||
|
font-size: 12pt; |
||||||
|
color: #066; |
||||||
|
opacity: .5; |
||||||
|
font-style: italic; } |
||||||
|
|
||||||
|
section img { |
||||||
|
max-width: 100%; } |
||||||
|
|
||||||
|
div.center { |
||||||
|
text-align: center; } |
||||||
|
|
||||||
|
div.aside { |
||||||
|
float: right; |
||||||
|
margin-left: 16pt; |
||||||
|
margin-bottom: 16pt; } |
||||||
|
|
||||||
|
/*# sourceMappingURL=application.css.map */ |
||||||
@ -0,0 +1,132 @@ |
|||||||
|
$fg: #333; |
||||||
|
$bg: #fff; |
||||||
|
|
||||||
|
html, body { |
||||||
|
width: 100%; |
||||||
|
height: 100%; |
||||||
|
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; |
||||||
|
color: $fg; |
||||||
|
font-size: 16pt; |
||||||
|
margin: 0; padding: 0; |
||||||
|
} |
||||||
|
|
||||||
|
body { |
||||||
|
overflow-y: scroll; |
||||||
|
} |
||||||
|
|
||||||
|
*, *::before, *::after { |
||||||
|
box-sizing: border-box; |
||||||
|
} |
||||||
|
|
||||||
|
a { |
||||||
|
color: #005e5e; |
||||||
|
text-decoration: none; |
||||||
|
|
||||||
|
&:hover { |
||||||
|
color: #001d5e; |
||||||
|
text-decoration: none; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
section, header, footer { |
||||||
|
width: 100%; |
||||||
|
> * { |
||||||
|
max-width: 850px; |
||||||
|
margin: 0 auto; |
||||||
|
padding: 10pt 0; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
section, header { |
||||||
|
border-bottom: 4px solid darkcyan; |
||||||
|
|
||||||
|
h1:first-child { |
||||||
|
margin-top: .4em; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
section + section { |
||||||
|
border-bottom: none; |
||||||
|
|
||||||
|
> * { |
||||||
|
border-bottom: 2px dashed rgba(darkcyan, .5) |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
section:last-of-type { |
||||||
|
border-bottom: 4px solid darkcyan; |
||||||
|
|
||||||
|
> * { |
||||||
|
border-bottom: 0 none; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
header { |
||||||
|
.Title { |
||||||
|
font-size: 40pt; |
||||||
|
font-weight: bold; |
||||||
|
letter-spacing: 2pt; |
||||||
|
} |
||||||
|
|
||||||
|
.Subtitle { |
||||||
|
font-size: 24pt; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
nav a { |
||||||
|
padding-right: 10pt; |
||||||
|
padding-left: 10pt; |
||||||
|
|
||||||
|
border-right: 2px solid darkcyan; |
||||||
|
|
||||||
|
&:first-child { |
||||||
|
padding-left: 0; |
||||||
|
} |
||||||
|
|
||||||
|
&:last-child { |
||||||
|
border-right: 0 none; |
||||||
|
} |
||||||
|
|
||||||
|
&.active { |
||||||
|
font-weight: bold; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
h1 a { |
||||||
|
opacity: .3; |
||||||
|
margin-left: 6pt; |
||||||
|
|
||||||
|
&:hover { |
||||||
|
opacity: .6; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
p { |
||||||
|
text-align: justify; |
||||||
|
} |
||||||
|
|
||||||
|
h2 { |
||||||
|
font-size: 110%; |
||||||
|
} |
||||||
|
|
||||||
|
footer { |
||||||
|
text-align: left; |
||||||
|
font-size: 12pt; |
||||||
|
color: #066; |
||||||
|
opacity: .5; |
||||||
|
font-style: italic; |
||||||
|
} |
||||||
|
|
||||||
|
section img { |
||||||
|
max-width: 100%; |
||||||
|
} |
||||||
|
|
||||||
|
div.center { |
||||||
|
text-align: center; |
||||||
|
} |
||||||
|
|
||||||
|
div.aside { |
||||||
|
float: right; |
||||||
|
margin-left: 16pt; |
||||||
|
margin-bottom: 16pt; |
||||||
|
} |
||||||
@ -0,0 +1,69 @@ |
|||||||
|
<?php $curpage = basename(__FILE__); require '_header.php'; ?> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>Thesis</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
I've developed the hardware prototypes and the original firmware (1.0) for my Master's Thesis. |
||||||
|
The thesis text may be used as a manual for this firmware version. |
||||||
|
</p> |
||||||
|
|
||||||
|
<p> |
||||||
|
<a href="https://www.ondrovo.com/cvut/dp">Thesis PDF + attachments</a> |
||||||
|
</p> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>Firmware</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
Pre-compiled firmware images are stored in the |
||||||
|
<a href="https://git.ondrovo.com/gex/gex-binaries">GEX binaries repository</a>. |
||||||
|
</p> |
||||||
|
|
||||||
|
<h2>Source Code</h2> |
||||||
|
|
||||||
|
<p> |
||||||
|
GEX is open-source, all its repositories can be found at <a href="https://git.ondrovo.com/gex">git.ondrovo.com/gex</a>. |
||||||
|
Important firmware repositories: |
||||||
|
</p> |
||||||
|
|
||||||
|
<ul> |
||||||
|
<li><a href="https://git.ondrovo.com/gex/gex-f072">STM32F072</a> |
||||||
|
<li><a href="https://git.ondrovo.com/gex/gex-core">GEX Core</a> (included in ports as a submodule) |
||||||
|
</ul> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>PC Libraries</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
The protocol is described in the GEX Thesis, which should be enough to port it to any language. |
||||||
|
Two libraries were developed as a proof of concept: |
||||||
|
</p> |
||||||
|
|
||||||
|
<ul> |
||||||
|
<li><a href="https://git.ondrovo.com/gex/gex-client-py">Python Library</a> (recommended) |
||||||
|
<li><a href="https://git.ondrovo.com/gex/gex-client-c">C Library</a> |
||||||
|
</ul> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>Custom Hardware</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
The <a href="https://git.ondrovo.com/gex/gex-hardware">GEX hardware</a> is open source, too. |
||||||
|
The PCBs are drawn in Altium, but the respository includes gerber files and PDFs to make it more accessible. |
||||||
|
</p> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<?php require '_footer.php'; ?> |
||||||
|
|
||||||
@ -0,0 +1,58 @@ |
|||||||
|
<?php $curpage = basename(__FILE__); require '_header.php'; ?> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>Features</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
The project started as a STM32 alternative to BusPirate, offering access to the many |
||||||
|
hardware peripherals of STM32 microcontrollers. The firmware is modular, composed of |
||||||
|
functional blocks (“units”) that may be activated and configured by the user through |
||||||
|
INI configuration files. Those files are stored inside the module and edited |
||||||
|
programmatically, or with a text editor on a virtual FAT16 USB disk. |
||||||
|
</p> |
||||||
|
|
||||||
|
<p> |
||||||
|
GEX is used as a GPIO header for the PC, except besides GPIO it also supports a range |
||||||
|
of hardware buses, and several analog features. The device is configured for a particular |
||||||
|
hardware setup, but the control script runs on the host PC. This lets you build graphical |
||||||
|
applications above the low level control code with PyQt or other toolkits, process |
||||||
|
data with NumPy or SciPy, and more. When needed, the Python library may be called from |
||||||
|
within MATLAB, too. |
||||||
|
</p> |
||||||
|
|
||||||
|
<h2>Connection</h2> |
||||||
|
|
||||||
|
<p> |
||||||
|
GEX can be connected through USB (CDC/ACM - virtual COM port), by a hardware UART, or |
||||||
|
wirelessly, using a nRF24L01+ transceiver module. |
||||||
|
</p> |
||||||
|
|
||||||
|
<h2>Hardware Functions</h2> |
||||||
|
|
||||||
|
<p> |
||||||
|
The firmware version 1.0 for STM32F072 contains the following key features: |
||||||
|
</p> |
||||||
|
|
||||||
|
<ul> |
||||||
|
<li>Direct GPIO pin access |
||||||
|
<li>SPI master |
||||||
|
<li>I²C master |
||||||
|
<li>UART/USART |
||||||
|
<li>1-Wire master (including the search algorithm) |
||||||
|
<li>PWM output |
||||||
|
<li>Frequency and duty cycle measurement |
||||||
|
<li>ADC with oscilloscope-like features |
||||||
|
<li>DAC (analog output) with waveform generation based on DDS |
||||||
|
</ul> |
||||||
|
|
||||||
|
<p> |
||||||
|
Some features (specifically the analog ones) are experimental and exhibit various |
||||||
|
limitations. These will be addressed in a later firmware version, possibly as a full |
||||||
|
rewrite. |
||||||
|
</p> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<?php require '_footer.php'; ?> |
||||||
|
|
||||||
|
After Width: | Height: | Size: 25 KiB |
|
After Width: | Height: | Size: 162 KiB |
|
After Width: | Height: | Size: 157 KiB |
@ -0,0 +1,33 @@ |
|||||||
|
<?php $curpage = basename(__FILE__); require '_header.php'; ?> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>What is GEX</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
GEX is a general purpose input/output device that attaches to a PC or laptop. |
||||||
|
The module, controlled by a Python or C program running on the host PC, provides easy |
||||||
|
access to on-chip peripherals and low level functions implemented by the firmware. |
||||||
|
</p> |
||||||
|
|
||||||
|
<p> |
||||||
|
The platform is designed for quick hardware prototyping, tinkering, automation, and measurements. |
||||||
|
In addition to custom hardware, the firmware can run on STM32 development boards, |
||||||
|
which makes it accessible to everyone. Even better, a version for the eBay-popular |
||||||
|
STM32F103 Bluepill board is planned. |
||||||
|
</p> |
||||||
|
|
||||||
|
<div class="center"> |
||||||
|
<img src="img/zero.jpg" alt="GEX Zero v1"> |
||||||
|
</div> |
||||||
|
|
||||||
|
<p> |
||||||
|
You can try GEX right now, perhaps with one of the pre-built firmware images, but keep in mind |
||||||
|
that it is still under development and despite having version 1.0.0, it is closer to |
||||||
|
beta than a stable release. In particular, the API may change in backward-incompatible ways |
||||||
|
(obviously accompanied by a minor version bump). |
||||||
|
</p> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<?php require '_footer.php'; ?> |
||||||
@ -0,0 +1,29 @@ |
|||||||
|
function headingAnchors(self_link_text) { |
||||||
|
self_link_text = self_link_text || '#'; |
||||||
|
var headings = document.querySelectorAll('h1'); |
||||||
|
|
||||||
|
for (var i = 0; i < headings.length; i++) { |
||||||
|
var e = headings[i]; |
||||||
|
if (!e.id) { |
||||||
|
var tc = e.textContent; |
||||||
|
tc = tc.replace(/[^a-z0-9-]/gi, '-') |
||||||
|
.replace(/-{2,}/gi, '-') |
||||||
|
.replace(/-+$/gi, '') |
||||||
|
.toLowerCase(); |
||||||
|
|
||||||
|
e.id = tc; |
||||||
|
} |
||||||
|
|
||||||
|
var a = document.createElement('a'); |
||||||
|
a.href = '#' + e.id; |
||||||
|
a.target = "_self"; |
||||||
|
a.textContent = self_link_text; |
||||||
|
|
||||||
|
e.appendChild(a); |
||||||
|
} |
||||||
|
|
||||||
|
// Scroll to the given hash
|
||||||
|
var h = location.hash; |
||||||
|
location.hash = ''; |
||||||
|
location.hash = h; |
||||||
|
} |
||||||
@ -0,0 +1,26 @@ |
|||||||
|
<?php $curpage = basename(__FILE__); require '_header.php'; ?> |
||||||
|
|
||||||
|
<section> |
||||||
|
<div> |
||||||
|
<h1>Supported Platforms</h1> |
||||||
|
|
||||||
|
<p> |
||||||
|
The original GEX firmware targets the STM32F072 microcontroller, which is used in the |
||||||
|
two custom hardware modules; you can see some of these in the photo below. In the future |
||||||
|
I hope to port it to STM32F103, and later to STM32F303 or others. A reimplementation |
||||||
|
for the ESP32 is also an exciting possibility, though it would be even more challenging. |
||||||
|
</p> |
||||||
|
|
||||||
|
<p> |
||||||
|
The PC libraries were written and tested on Linux. The Python library should be portable |
||||||
|
to other systems, as it uses PySerial and PyUSB, but I didn't try it. |
||||||
|
</p> |
||||||
|
|
||||||
|
<div class="center"> |
||||||
|
<img src="img/gexen.jpg" alt="Photo fo several GEX prototypes"> |
||||||
|
</div> |
||||||
|
</div> |
||||||
|
</section> |
||||||
|
|
||||||
|
<?php require '_footer.php'; ?> |
||||||
|
|
||||||
@ -0,0 +1,2 @@ |
|||||||
|
* |
||||||
|
!.gitignore |
||||||
Loading…
Reference in new issue