Devices

device → device_platform ↓	Raspberry Pi	Orange Pi / A20 or H3 boards	Desktops	NOTES
raspberrypi	OK	~	~	can be run any device with fakeRPiGPIO for development only
orangepi	X	OK under root	X
desktop	~	~	~	only interactively
dummy	OK	OK	OK

~ means you should check the NOTES column for explanation / details

Raspberry Pi

Works fine by default!

Orange Pi & other A20 / H3 based boards

Note: Please don't use system images from the vendor. Just DON'T. They are complete and utter crap and they might even cause overheating / damage to your boards. Use Armbian instead. It's awesome, it's as secure as possible, it's up-to-date and it's loaded with features!

You have these options:

1. Use the orangepi platform.

This will allow you to use a push button and LEDs! Right now, you have to install the library for this manually:

pip install git+https://github.com/duxingkei33/orangepi_PC_gpio_pyH3.git

Unfortunately, you have to run AlexaPi under root for this. To do this, after the installation is complete, put ```

Use this only if you need access to GPIO on a platform that doesn't support root-less GPIO!

[Service] User=root Group=root ProtectHome=false

  in `/etc/systemd/system/AlexaPi.service.d/usergroup-root.conf`. Then run `systemctl daemon-reload` for the changes to take effect and then you can (re)start your AlexaPi!


2. Use the general _sysfs gpio_ platform.

   Not yet available.

3. Use the _dummy_ platforms.

   If you don't care about button triggering or LEDs, you can use this. You can then run AlexaPi securely under the _alexapi_ user.

## Desktop / development machine

The best option is probably the `desktop` platform as it will allow you to trigger Alexa with your keyboard.

If you don't care about that, you can use the `dummy` platform.

Another option, possibly only for developers is to install [fakeRPiGPIO](https://github.com/ArmlessJohn404/fakeRPiGPIO) and use the `raspberrypi` platform. You won't be able to trigger Alexa other than by the trigger word, but you'll see output (function calls) from the _fake_ library. This will allow you to partially test the logic in the _raspberrypi_ platform without actually running this on a Pi.

## Other boards / computers

If none of the above platforms is suitable for you, you can use the _dummy_ platform. You will then have voice activation only with no indicators (other than process output). This is a good idea for getting AlexaPi to work on new unsupported systems - you make sure the AlexaPi itself works under the OS and then you bother yourself with the device platform itself.