alexxnica / enclosure-picroft

Mycroft interface for Raspberry Pi environment

Welcome

Picroft 0.9.1

The Picroft project is an enclosure for a stock Raspberry Pi connected to a speaker and basic USB microphone. This is built around a Raspbian Jessie Lite installation. The entire project is available as a pre-built micro-SD image ready to be burned and placed into a Raspberry Pi. You can download the pre-built image here:

Picroft 0.9 image

SHA256 checksum for the raspbian_Picroft_2018-01-19_v0.9.1.zip image: d3041e41e7b6f1ca4f4b9ad3b4a665702b9dc32b285884d9bfdad8aefb9b788d

Requirements

• Raspberry Pi 3 (Older versions do not have sufficient processing power, and if they work they will be very slow)
• MicroSD Card (8 GB or larger)
• Any analog speaker
• USB Microphone. Tested with CM108-based microphones.

Installation

Official Raspberry Pi Image Installation Instuctions

Etcher Cross-Platform GUI SD card creator for RPi

Advanced Installation

• Windows
• OSX/MacOS
• Linux

Usage

Upon boot, Picroft will search for an Ethernet connection. If none is found, the Wifi Setup process will begin to get the device connected to any available network.

Once connected, you must pair the device at https://home.mycroft.ai using the code spoken by the device. You can also read the code on the screen.

After that, you can simply speak to Picroft as you would to any Mycroft implementation. For example:

"Hey Mycroft, what time is it?" "Mycroft, how tall was Abraham Lincoln?"

Versions

• 0.9.1 - Preloaded with mycroft-core 0.9.14, better pairing, CLI after boot
• 0.9 - Preloaded with 17.08a, auto-upgrading from this repo
• 0.8 - Connecting to Home backend
• 0.5.1 - Fixed several audio issues with 0.5 image
• 0.5 - Original image, connecting to Cerberus backend

Help and more info

Check out the project wiki here.
There's also the general Documentation.

There are two scripts run on startup

• audio_setup.sh configures your specific audio setup.
• custom_setup.sh is a stub meant to initialize any other IoT devices or services you might need like a DLNA server or syslog for example.

Using USB Audio as Output

Typically the USB audio should be connected to hwplug:1,0 but to verify run the following:

aplay -L

Find the hwplug output for the device you want to use, take this and update the /etc/mycroft/mycroft.conf file accordingly:

"play_wav_cmdline": "aplay -Dhw:0,0 %1" this line now becomes "play_wav_cmdline": "aplay -Dplughw:1,0 %1"

You can now run ./auto_run.sh to start the program back up and test and ensure the output comes through the USB speakers.

---

There is an active Picroft community within the Mycroft's Mattermost which are welcome to join!