Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/OpenVoiceOS/ovos-PHAL-plugin-mk1

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/OpenVoiceOS/ovos-PHAL-plugin-mk1
Owner: OpenVoiceOS
License: apache-2.0
Created: 2021-11-06T18:03:37.000Z (almost 3 years ago)
Default Branch: dev
Last Pushed: 2024-05-16T20:27:51.000Z (4 months ago)
Last Synced: 2024-05-16T21:37:13.863Z (4 months ago)
Language: Python
Size: 43.9 KB
Stars: 0
Watchers: 8
Forks: 3
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ovos-plugins - ovos-PHAL-plugin-mk1

README

        # ovos-PHAL-plugin - Mark1

handles integration with the Mycroft Mark1 hardware

the firmware for mark1 arduino that controls the eyes and faceplate can be found [here](https://github.com/OpenVoiceOS/mycroft-mark1-firmware)

utits to interact with the faceplate pixel by pixel can be found in [ovos-mark1-utils](https://github.com/OpenVoiceOS/ovos-mark1-utils) 

# Serial Port Protocols

See the file [protocols.txt](./protocols.txt) for a description of commands that can be sent to the faceplate.

Commands can be sent from the command line on a Raspberry Pi, such as this:

```

$ echo "eyes.blink" > /dev/ttyAMA0

$ echo "eyes.color=16711680" > /dev/ttyAMA0

$ echo "mouth.text=I am angry!" > /dev/ttyAMA0

```

Which will blink the eyes, turn them red, then display the phrase on the faceplate.

# Graphics

The `mouth.icon=` command takes a custom format for it's black and white images.  You can use the [HTML editor](http://htmlpreview.github.io/?https://raw.githubusercontent.com/MycroftAI/enclosure-mark1/master/editor.html) to create the image strings that can be sent. 

# IO pins

When looking at the device from the back, pins are laid out as:

```

             -----------------------------------------------------------------------------------------------

RCA Port    | 2 | 4 | 6 | 8 | 10 | 12 | 14 | 16 | 18 | 20 | 22 | 24 | 26 | 28 | 30 | 32 | 34 | 36 | 38 | 40 |

            | 1 | 3 | 5 | 7 |  9 | 11 | 13 | 15 | 17 | 19 | 21 | 23 | 25 | 27 | 29 | 31 | 33 | 35 | 37 | 39 |

             -----------------------------------------------------------------------------------------------

 HDMI                         Ethernet                        USB     USB

```

Where:

| Pin| Description          |

|:--:|:---------------------|

| 1  | GND                  |

| 2  | +12V                 |

| 3  | GND                  |

| 4  | +5V                  |

| 5  | GND                  |

| 6  | +3.3V                |

| 7  | Arduino Reset        |

| 8  | Arduino D5           |

| 9  | Arduino D6           |

| 10 | Arduino D10          |

| 11 | Arduino A2           |

| 12 | Arduino A3           |

| 13 | +3.3V                |

| 14 | +3.3V                |

| 15 | +3.3V                |

| 16 | GND                  |

| 17 | GND                  |

| 18 | GND                  |

| 19 | +5V                  |

| 20 | +5V                  |

| 21 | +5V                  |

| 22 | +5V                  |

| 23 | GND                  |

| 24 | GND                  |

| 25 | Raspberry Pi ID_SC   |

| 26 | Raspberry Pi ID_SD   |

| 27 | Raspberry Pi GPIO 4  |

| 28 | Raspberry Pi GPIO 5  |

| 29 | Raspberry Pi GPIO 6  |

| 30 | Raspberry Pi GPIO 7  |

| 31 | Raspberry Pi GPIO 8  |

| 32 | Raspberry Pi GPIO 9  |

| 33 | Raspberry Pi GPIO 10 |

| 34 | Raspberry Pi GPIO 11 |

| 35 | Raspberry Pi GPIO 12 |

| 36 | Raspberry Pi GPIO 16 |

| 37 | Raspberry Pi GPIO 25 |

| 38 | Raspberry Pi GPIO 26 |

| 39 | GND                  |

| 40 | GND                  |

**WARNING: This is not the same as the standard Raspberry Pi GPIO headers!**