BitScope Pi Core is a (slightly) modified version of Raspbian Lite. It is the core from which BitScope Pi and BitScope Blade SD cards for Raspberry Pi are built. It adds system scripts and other things needed to use Raspbian for BitScope purposes, e.g. rebuilding, cloning and maintaining BitScope Blade systems.
Download the latest Raspbian Jessie Lite SD image and install it,
On your Internet connected Windows, Mac or Linux PC (or even an already running Raspberry Pi) you will need to unzip and copy the downloaded SD image to a micro SD card. Your PC must have an SD Card reader or you can use a cheap USB Micro-SD Adapter (Full Instructions).
Connect your Raspberry Pi to the Internet and boot,
Plug in the micro SD card and connect the Raspberry Pi to your network using an ethernet cable. Optionally (see below) connect a USB keyboard and HDMI monitor. Power on the Raspberry Pi.
Log in (username: pi, password: raspberry) and download the BitScope Pi Core archive,
$ wget http://bitscope.com/pi/core.tgz
Unpack the archive (as root, -v option to see what's unpacking), and
$ sudo tar xvf core.tgz
Install the package (as root).
$ sudo core/install.sh
Installation takes 5 to 10 minutes (depending on your Internet connection speed, the repositories you use and the Raspberry Pi version). When complete your Raspberry Pi will reboot and you should be set to go.
If installation takes significantly longer than 10 minutes it may be because the (default) repositories are not readily accessible from where you happen to be on the planet. Check your Internet connection and review the list or mirrors for one closer to you. To use a different one, see this page for advice. If the repositores are unavailable when you run this script you may encounter errors. If this occurs you may need to redo steps 3, 4 and 5 when they are up again. If installation takes longer than 30 minutes, the screen may go blank. Hit any key to unblank it and see where the installation is up to.
We've chosen the US locale & keyboard layouts as these are more widely used outside Raspberry Pi's default (GB) but he timezone remains UTC. We also expand the file system (when you reboot for the first time). You can run raspi-config to change these and any other options (e.g. overscan etc) if required.
You may also like to change the default password by typing:
$ passwd
and following the prompts to enter a new one.
If your Raspberry Pi is "headless" (i.e. you don't have a keyboard and monitor attached) you can still use this image. In this case you will need to log into your Pi via SSH (which is enabled by default).
To to this you will need to know the IP address of your Raspberry Pi before logging in.
If using Pi 3 (or an earlier model with a WiFi dongle) you can enable WiFi by editing the file:
/etc/wpa_supplicant/wpa_supplicant.conf
and replacing SSID and SECRET with the values appropriate for your WiFi network:
country=AU
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
ssid="SSID"
psk="SECRET"
}
Run the following commands to activate it:
$ sudo ifconfig wlan0 down
$ sudo ifup wlan0 up
and/or simply reboot the Raspberry Pi.
This image includes the bare minimum required to run Raspbian on Raspberry Pi with BitScope system management scripts and some software pre-installed. Everything else can be installed using system:
Usage: system [OPTIONS] [ACTION]
Install, update, save or restore system packages.
OPTIONS:
-s, --simulate don't actually change anything
-q, --quiet don't say much, just do it
-y, --sayes always say yes when updating
-? --help display this help and exit
--version show version and exit
ACTION:
install install specified packages
remove remove specified packages
update update to newest packages
snapshot snapshot system package/config snapshot
restore restore snapshot to the system
forget forget all scheduled packages
or you can use the package management commands apt-get or aptitude. Using system helps when using revision control (as we normally do). You can add repositories (see add-apt-repository) to install packages not included as standard with raspbian and bitscope if necessary.
There is also support for installing and uninstalling tarballs with tpkg:
Usage: tpkg [OPTIONS] [TARBALL]
Un/Install a tarball in the current working directory.
OPTIONS:
-r, --root=ROOT un/pack to ROOT instead
-i, --install unpack and install files
-u, --uninstall remove matching files
-x, --strip strip leading directory name
-s, --simulate do actually change anything
-? --help display this help and exit
--version show version and exit
The TARBALL argument must refer to an existing tarball file unless
uninstalling in which case it must a tarball name that matchs those
listed in the .tpkg directory (in the installation directory).
Use the strip option to remove the prefix directory name (for use
with tarballs that include a(n unwanted) root directory name.
which can be handy to manage software that is not packaged. A special directory called /backup has been added (which is used by various scripts to perform backups and clone files). The two partitions are labelled (BOOT and ROOT) and there are scripts clone and build new SD card images directly from Raspberry Pi (requires a USB/SD card reader to be attached). These and other things are (or will be) documented elsewhere (eventually).
GC23A 08