Skip to content

Latest commit

 

History

History
132 lines (111 loc) · 3.84 KB

image_recipe.md

File metadata and controls

132 lines (111 loc) · 3.84 KB
Raw

Recipe for creating the Picroft IMG

These are the steps followed to create the base image for Picroft on Raspbian Buster. This was performed on a Raspberry Pi 3B+ or Pi 4

NOTE: At startup Picroft will automatically update itself to the latest version of released software, scripts and Skills.

Start with the official Raspbian Image

  • Download and burn Raspbian Buster Lite.
    Last used 2019-09-26 version
  • Install into Raspberry Pi and boot
    • login: pi
    • password: raspberry

General configuration

  • sudo raspi-config
  • 1 Change User Password
    • Enter and verify mycroft
  • 2 Network Options
    • N1 Hostname
      • Enter picroft
    • N3 Network interface names
      • pick Yes
  • 3 Boot Options
    • B1 Desktop / CLI
      • B2 Console Autologin
    • B2 Wait for network
      • pick No
  • 4 Localization Options
    • I3 Change Keyboard Layout
      • Pick Generic 104-key PC
      • Pick Other
      • Pick English (US)
      • Pick English (US)
      • Pick The default for the keyboard layout
      • Pick No compose key
    • I4 Change Wi-fi Country
      • Pick United States
  • 5 Interfacing Options
    • P2 SSH
      • Pick Yes
  • Finish and reboot

Set the device to not use locale settings provided by ssh

  • sudo nano /etc/ssh/sshd_config and comment out the line (prefix with '#') 
    AcceptEnv LANG LC_*

Connect to the network

  • Either plug in Ethernet or

    or

  • Guided wifi setup

    • sudo raspi-config
      • 2 Network Options
        • N2 Wi-fi

    or

  • Manually setup wifi

    • sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
    • Enter network creds: 
      network={
        ssid="NETWORK"
        psk="WIFI_PASSWORD"  # for network with password
        key_mgmt=NONE        # for open network
}

Install Picroft scripts

The update.sh script will perform all of the following steps in this section... When asked by dev_setup, answer as follows:

  • Y) run on the stable 'master' branch
  • Y) automatically check for updates
  • Y) build Mimic locally
  • Y) add Mycroft helper commands to path
  • Y) check code style
Enable Autologin as the 'pi' user

  • sudo nano /etc/systemd/system/getty@tty1.service.d/autologin.conf and enter:

    [Service]
ExecStart=
ExecStart=-/sbin/agetty --autologin pi --noclear %I     38400 linux

  • sudo systemctl enable getty@tty1.service

Create RAM disk and point to it
  • sudo nano /etc/fstab and add the line: 
    tmpfs /ramdisk tmpfs rw,nodev,nosuid,size=20M 0 0
Environment setup (part of update.sh)
  • sudo mkdir /etc/mycroft
  • sudo nano /etc/mycroft/mycroft.conf
  • mkdir ~/bin
Customize .bashrc for startup
  • nano ~/.bashrc uncomment #alias ll='ls -l' near the bottom of the file at the bottom add: 
    #####################################
# This initializes Mycroft
#####################################
source ~/auto_run.sh
Install git and mycroft-core
  • sudo apt-get install git
  • git clone https://github.com/MycroftAI/mycroft-core.git
  • cd mycroft-core
  • git checkout master
  • bash dev_setup.sh

(Wait an hour on a RPi 3B+/4)

Final steps

  • Run . ~/bin/mycroft-wipe --keep-skills
  • Remove the SD card
  • Create an IMG file named "Picroft_v${CORE_VERSION}_${YYYYMMDD}.img" (optionally include a release candidate suffix "_rc-${num}.img")
  • Compress the IMG using pishrink.sh
  • Upload to downloads.mycroft.ai and adjust redirect link from https://mycroft.ai/to/picroft-image or https://mycroft.ai/to/picroft-unstable