ovos-PHAL-plugin-mk1 0.1.5a1

A PHAL plugin for mycroft

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

utits to interact with the faceplate pixel by pixel can be found in ovos-mark1-utils

Serial Port Protocols

See the file 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 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!