X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=include%2Ffx2lafw.h;h=4a2cb8ae186358f620e8aaf40947998162caa98f;hb=8e269f7bfe3c6934a12f7a33274a6bf249a02610;hp=5819b6c6190a0429579a65cad8c25e8489e13ea1;hpb=a75a9ccb67defc791ccf9fdf73d4e149436dae3f;p=sigrok-firmware-fx2lafw.git

diff --git a/include/fx2lafw.h b/include/fx2lafw.h
index 5819b6c6..4a2cb8ae 100644
--- a/include/fx2lafw.h
+++ b/include/fx2lafw.h
@@ -1,5 +1,5 @@
 /*
- * This file is part of the fx2lafw project.
+ * This file is part of the sigrok-firmware-fx2lafw project.
  *
  * Copyright (C) 2012 Joel Holdsworth <joel@airwebreathe.org.uk>
  *
@@ -14,19 +14,36 @@
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
+ * along with this program; if not, see <http://www.gnu.org/licenses/>.
  */
 
+#ifndef FX2LAFW_INCLUDE_FX2LAFW_H
+#define FX2LAFW_INCLUDE_FX2LAFW_H
+
 #include <autovector.h>
 
-/**
- * Performs setup common to all fx2lafw devices.
- */
-void fx2lafw_init(void);
+#define SYNCDELAY() SYNCDELAY4
 
-/**
- * Performs a single iteration of the main loop code which is common
- * to all fx2lafw devices.
+/*
+ * Major and minor fx2lafw firmware version numbers.
+ * These can be queried by the host via CMD_GET_FW_VERSION.
+ *
+ * The minor version number must be increased every time there are
+ * backwards-compatible changes (which do not change the API).
+ *
+ * The major version number must be increased every time there are API
+ * changes or functional changes which require adaptations in the host
+ * (libsigrok) drivers, i.e. changes where old libsigrok versions would no
+ * longer (properly) work with the new fx2lafw firmware.
  */
-void fx2lafw_run(void);
+#define FX2LAFW_VERSION_MAJOR	1
+#define FX2LAFW_VERSION_MINOR	3
+
+#define LED_POLARITY		1 /* 1: active-high, 0: active-low */
+
+#define LED_INIT()		do { PORTACFG = 0; OEA = (1 << 1); } while (0)
+#define LED_ON()		do { PA1 = LED_POLARITY; } while (0)
+#define LED_OFF()		do { PA1 = !LED_POLARITY; } while (0)
+#define LED_TOGGLE()		do { PA1 = !PA1; } while (0)
+
+#endif