README.md

candy-pi-lite-os-image

Raspbian OS image builder for CANDY Pi Lite Board

Supported Raspberry Pi

ARMv6/ARMv7 boards are available for this image.

• Raspberry Pi Zero (Pin Header is required)
• Raspberry Pi Zero W (Pin Header is required)
• Raspberry Pi Zero WH
• Raspberry Pi 1 Model A+
• Raspberry Pi 1 Model B+
• Raspberry Pi 2 Model B
• Raspberry Pi 3 Model A+
• Raspberry Pi 3 Model B
• Raspberry Pi 3 Model B+
• Raspberry Pi 4 Model B

Raspbian OS Version

• Raspbian Buster Version September 2019 (Release date: 2019-09-26, Kernel: v4.19) with some library updates at the time of the image creation

Features

• Raspbian OS Lite (Raspbian Buster Lite) based image with software updates
• CANDY Pi Lite Board Service is installed
• CANDY RED, a Node-RED based software dedicated to CANDY Pi Lite Board and CANDY EGG Cloud Service, is installed
• ufw is enabled (denying from all traffic on ppp0 and wwan0)
• Hardware watchdog is enabled
• Node.js v12 (armv6l) is installed (in Active LTS)
• ssh is DISABLED by default. Place an empty file as /boot/ssh to enable it
• Extra Debian Packages
  • git
  • screen
  • fswebcam
  • sense-hat
• Extra Python Packages
  • pillow
  • pyserial

Distributions

• *-en_US suffix image contains US Keyboard Layout with UTC timezone and en_US.UTF-8 locale
• *-ja_JP suffix image contains Japanese Keyboard Layout with JST timezone and ja_JP.UTF-8 locale and CJK fonts

How to flash the image

Use balenaEtcher for burning the image, which is a cross-platform app.

How to build images

# create a tag for the version then push it to remote

# using IIJ Mobile
FIRST_USER_NAME="pi" \
  FIRST_USER_PASS="raspberry" \
  ENABLE_SSH="0" \
  BOOT_APN="iijmobile.biz-ipv4v6" \
  ./scripts/before_script.sh

# using soracom.io
FIRST_USER_NAME="pi" \
  FIRST_USER_PASS="raspberry" \
  ENABLE_SSH="0" \
  BOOT_APN="soracom.io" \
  ./scripts/before_script.sh

# Let's build an image
time ./scripts/build_img.sh

# Upload image files
RELEASE_VERSION=16.0.0

GITHUB_OAUTH_TOKEN=YOUR_GITHUB_OAUTH_TOKEN \
  TAG_NAME=${RELEASE_VERSION} \
  ./scripts/deploy_zip.sh

Trouble Shooting

Previous stage rootfs not found
******** Failed to build image files... ********

Remove empty directories under pi-gen directory.

How to release

1. Edit IMG_VERSION, CANDY_PI_LITE_VERSION, CANDY_RED_HASH, RPI_FIRMWARE_VERSION and NODEJS_VERSION in before_script.sh
2. Create image files
3. Test if they're working
4. Upload image files and package info
5. Tag the version