/enclosure-picroft

Mycroft interface for Raspberry Pi environment

Primary LanguageShellGNU Lesser General Public License v3.0LGPL-3.0

Picroft 0.8

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:

Download img Picroft 0.8 image

SHA256 checksum for the PiCroft_v0.8b_Raspian_JessieLite_2017-01-26.zip image: ce316e13f53c261ab22a6856c397170d9dc3dd3bf4c3a5b49e10dcf668ed2c11

Download img "unstable" Picroft 0.8 image

SHA256 checksum for the PiCroft_v0.8d_Raspian_JessieLite_2017-07-13.zip image: 7323b0da8b8e6395e4fa8794fe45ede0d0bfa081fa5d8d00ad6df60a4bfde20e

Requirements

  • Raspberry Pi 3
  • MicroSD Card (4 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

Usage

Upon boot, Picroft will search for open wifi networks or an Ethernet connection. If neither 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?"

Apt errors (June 2017)

If you receive an error on your picroft such as:

  • W: GPG error: http://repo.mycroft.ai debian InRelease: The following signatures were invalid: KEYEXPIRED 1498079146 KEYEXPIRED 1498079146 KEYEXPIRED 1498079146 KEYEXPIRED 1498079146
  • Ign http://repo.mycroft.ai debian Release.gpg
  • E: Some index files failed to download. They have been ignored, or old ones used instead.

You need to run: sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys F3B1AA8B

This will update the mycroft package signing key in the apt package manger "keyring."

Sorry for this inconvience, as the time on GPG keys is in UNIX time since EPOCH it can be hard to keep track, and we apologize.

Versions

  • 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 Slack Channel which are welcome to join!