asterics / fabi

The repository for FABI (Flexible Assistive Button Interface)

Welcome to AsTeRICS

---

AsTeRICS is a free and Open-Source graphical construction set for assistive technologies (AT). It allows the creation of flexible solutions for people with disabilities using a large set of sensors and actuators.

Possible applications are

• Computer input (mouse, keyboard, joystick)
• Environmental Control (KNX, FS20, IR, EnOcean, openHAB)
• Toys and Games (Playstation 3, computer games, RC-toys ...)
• Brain/Neural computer interfaces (Enobio, OpenVIBE, OpenEEG)
• Android Phone support (SMS, calls)
• and many more!

For more information see our website http://www.asterics.eu.

Demos (Solutions)

Check out some solutions here

Quick Build Instructions

To clone and compile the AsTeRICS framework, please execute the following steps:

1. Clone Repository (submodules will be cloned during build)

git clone https://github.com/asterics/AsTeRICS.git

2. Install the Java Development Kit (JDK, 32bit preferred) >= 8

• Ensure to set JAVA_HOME to the folder where you installed the Java JDK and add the JDK bin path to the Environment Variable Path

3. apache ant build framework (version >= 1.9.1)

• Ensure to set ANT_HOME to the folder where you installed ant and add the ant bin path to the Environment Variable Path
• The git command line tool must be available from within ant, ensure to set the Environment Variable Path to the respective bin folder.

4. Open a terminal and start the AsTeRICS Runtime Environment (ARE) by calling:

ant run

If you don't need commandline support, you can use an IDE for Java Developers, e.g. Eclipse, which already contains ant. There you can directly execute ant targets by selecting the build file build.xml and select the target of choice, e.g. run.

Documentation

• AsTeRICS Tutorial with screencasts
• Getting Started
• Tutorials
• Developer Manual
• Plugin Hellp

You can find more documentation and build plans for some hardware devices in ModelGuides and DIYGuides.

Contact

If you want to contribute to the AsTeRICS project, have questions or just need help using it don't bother to create an issue, pull request or via the contact page.

If you want to support the development of AsTeRICS you're very welcome to donate to the AsTeRICS Foundation:

   

License

This project has been partly funded by the European Commission, Grant Agreement Number 247730 in the years 2010-2012. Since 2013, further development of AsTeRICS software and hardware components is hosted at: https://github.com/asterics/AsTeRICS

ACS and NativeASAPI libraries

Licensed under LGPL

ARE-middleware, ARE-plugins, services and BNCI Suite

Licensed under a dual license MIT or GPL with CLASSPATH exception

How to apply the dual licensing

You may use these components under the terms of the MIT License, if no source code (plugins, services, libraries, ...) which is contained in your desired collection of ARE plugins and services is licensed under the GNU General Public License (GPL). In order for that, you can remove unneeded plugins or services.

Please note: There are also some plugins (e.g. MathEvaluator, VLC) which are GPL without CLASSPATH exception, so in this case your license would have to be GPL as well.

Please have a look at the individual licenses of the AsTeRICS plugins and services. You find the license files in the subfolder LICENSE of every plugin.

Disclaimer

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. See DISCLAIMER

Releases

• See CHANGELOG or old Release Notes and the published releases

fabi's Issues

Documentation: hint on isolated wires

The docs should mention the necessary removal of any isolation on thin wires.

Aktion: "Linke Maustaste halten (für Dauer der Eingabe Aktion)" funktioniert nicht

Die Aktion: "Linke Maustaste halten (für Dauer der Eingabe Aktion)" funktioniert nicht. Nothing is happening

.

Macros: AT MA KW \;;CR; not clicking with right mouse button

I'm testing macro function via serial console AT MA KW \;;CR;:

1. Writes ; as expected
2. Doesn't do a right-click with the mouse as expected.

New Button Action: Action according to analogue input value

It would be great if you could map the sensor value (e.g. of a pressure sensor) to an analogue action.
e.g.
move the mouse cursor in x-direction by the amount of the pressure change.

This could be useful for all commands requiring a decimal number as parameter. In this case you could provide the name of the input pin, e.g.:

AT MX +A0

or even with a simple signal processing

AT MX +2*A0

Add AT command for renaming slots

In order to be able to easily change a slot name from WebGUI a specific AT command would be great!
Suggestion: AT SN <name> for renaming the current slot.

related: asterics/FLipMouse#51

ProMicro RX/TX LEDs

When using the Bluetooth Addon, its LED is not clearly visible compared to the Arduino Pro Micro's RX/TX LEDs.

Should we switch off these LEDs?

pinMode(LED_BUILTIN_RX,INPUT);
pinMode(LED_BUILTIN_TX,INPUT);

Free memory - detection for 100% usage failing

If the EEPROM is filled up to 100%, the FABI hits an overflow -> e.g. returns "6400% free" on "AT FR".

Most likely to be a bug in saveToEEPROM.

Problem when changing slots with long-press and double-press combined

I have configured 3 Slots:
In the first two slots i change to the next slot by double pressing a button.
In the last slot i change to the next slot by a long-press of a button.

First Problem:

As soon as i want to change from the last slot to the first by a long-press, the firmware seems to get two "slot change" - AT commands and skips the first slot.

Second Problem:

When i change the slot by a double-press, the action of the next slot on the corresponding button gets activated.
For example: I have configured slot 3 for left and right mouse clicks with two buttons. I am currenctly at slot 2 and want to change to slot 3 by a double press. As soon as i do that, the mouse click of the third slot gets activated too.

To reproduce this issue i attached a file with the settings i tested with:
FABI-config-2021-12-15.zip

No possibility for writing a "\"

It is not possible for writing a backslash (e.g. inside of the commandline) because the KW command does not print it and with KP there is no possible KEY for the "ß" button on a german Keyboard. Without this it is only possible to navigate your disc within the commandline via copy pasting the path that you want to use.

Keyboardlayout - problems with special characters

Special characters (like {[]};...) are not printed correct, if the write text function is active.

This applies only on other layouts than US

Update: typo...

Case improvements for ordering pre-cut cases

In order to use pre-cut cases, ordered in China, the case design files should be updated.

The future case will be a AK-S-01 (805019mm) by Szomk.

Mouse movement: AT MX assigned to a button has different behaviour than FLipMouse

Reproduce:

1. Assign mouse movement with step size 1 to a button on both FLipMouse and FABI
2. Press the button

Result:
On FLipMouse mouse begins to move immediately, on FABI I have to wait and press the button for about 1 second until mouse begins to move. If the value for mouse movement is higher (e.g. 5 or 10), the time to wait is shorter.

CManual changes

Clarify resistor colors in manual or change constructions kits.

Button Action: Deleting Action can't be saved

Deleting a keyboard action can't be saved.

Generally a global "Delete action" button could make sense here:

Integrate BLE module HM-10

FABI should be able to use a BLE connection in addition to USB HID

Provide current version of FabiGUI.exe and firmware files as release

When going to https://github.com/asterics/FABI/releases only an old version can be downloaded.

Button Action: Changing between Tabs deletes previous value

When opening the action of a button to (re)configure it, the currently set value is deleted as soon as you change the tab (e.g. from Mouse to Keyboard) and back again:

This is annoying as sometimes you only want to check other options.