Introduction

The QuarterMaster is a powerful platform that leverages the Black Pearl Interceptor System-on-Module. This system provides a huge variety of features and connectivity for tackling any challenge within the IOT spectrum. This User Guide details the high-level features and basic setup you need to get started with an Interceptor design.

Features

Interceptor

‍

QuaterMaster Interfaces

Getting Started

System Requirements

Unboxing

Development Kit Contents

• QuarterMaster Development Board with Interceptor
• MicroSD Card with Linux Kernel and Debian Filesystem
• USB drive with Linux Development Environment
• DC Power SupplyMicro-USB Debug Cable
• USB OTG Cable

TODO Picture of QuarterMaster with labels to various components

‍

Serial Connection

The default command line interface to the Interceptor is through the USB Debug Port exposed on the QuarterMaster board. To communicate with this interface, you can use a Serial Terminal emulator such as PuTTY or Minicom.

‍

PuTTY

In order to connect to the terminal on the Interceptor, follow the steps below:

1. Connect the Micro-USB cable to the host PC and to the USB Debug port of the QuarterMaster. TODO Picture
2. Open PuTTY to the newly allocated COM Port at 115200 baud. TODO Screenshot
3. Turn on the QuarterMaster Board via the power switch. TODO Picture
4. Wait for the board to boot. TODO Screenshot of boot screen
5. Default Password is “root”.

Minicom

In order to connect to the terminal on the Interceptor on a Linux/Unix machine, follow the steps below:

1. Install the program using the command

        sudo apt-get install minicom

2. Connect the Micro-USB cable to the host PC and to the USB Debug port of the QuarterMaster. Make sure the Linux has serial port detection enabled.
3. In order to find the name of your port, enter the command

        dmesg | grep tty

4. For the USB-to-Serial adaptor, one may see

         [        0.000000] console [tty0] enabled

         [        5.065029] usb 1-1:  pl2303 converter now attached to ttyUSB0

5. To configure the serial port, open a terminal and enter

        sudo minicom -s

Adjust the Serial Port Setup for the desired port number, save and exit the configuration.

6. To start minicom, use the command

        minicom

Alternate Boot Modes

Alternate boot modes can be selected by changing the DIP Switch setting on the QuaterMaster board.

-TODO DIP Switch picture

‍

Boot Priority Table

SD Card Boot

Set the DIP Switch[5:1] to 00001b

A bootable Micro SD Card must be inserted into the SD Card Slot. If no SD Card is detected, the QuarterMaster will attempt to boot from the on-board eMMC next.

Peripherals

Wi-Fi Connection

How to setup and configure Wi-Fi

1. Find available Wi-Fi adaptors using the following command:

         iw dev

2. Check the Wi-Fi device status using the following command:

        ip link show wlan0

Look for the word "UP" within the brackets in the first line of the output.

3. Bring up the Wi-Fi interface using the command:

        ip link set wlan0 up

-TODO picture

4. Check the connection status using the command:

       iw wlan0 link

-TODO Picture

5. Scan to find Wi-Fi network using the command:

        iw wlan0 scan

6. Generate a wpa/wpa2 configuration file that contains a pre-shared key "passphrase" for the Wi-Fi network using the command:

        wpa_passphrase NETWORK_SSID >> /etc/wpa_supplicant.conf
‍

        # NETWORK_PASSWORD (passphrase) 

-TODO Picture

wpa_passphrase will create necessary configuration entries based on the input. Each network will be added as a new configuration.

7. Connect to WPA/WPA2 network Wi-Fi network using the command: 

        wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf

        # -B to run wpa_supplicant in the background

        # -c to specify the path of configuration file

-TODO Picture

8. Verify the connection using the command:

        iw wlan0 link

-TODO Picture

9. Get an IP address for the Wi-Fi network using dhclient:

        dhclient wlan0

-TODO Picture

10. Verify the I{ address assigned by DHCP using the command:

       iconfig wlan0

-TODO Picture

11. Verify default routing rules:

       ip route show

-TODO Picture

‍

Bluetooth Connection

How to setup and configure Bluetooth

‍

TPM Connection

How to setup and configure the TPM module

1. Insert the TPM module files using the following commands:

-TODO auto-load the modules

         sudo insmod /lib/modules/4.12.79-ge669d52447/kernel/drivers/char/tpm/tpm.ko

         sudo insmod /lib/modules/4.12.79-ge669d52447/kernel/drivers/char/tpm/tpm_tis_core.ko

         sudo insmod /lib/modules/4.12.79-ge669d52447/kernel/drivers/char/tpm/tpm_tis_spi.ko

2. Verify TPM device setup:

        cd /dev

        ls

The following two devices must be present:

       tpm0       tpmrm0

-TODO Add basic commands and processes for TPM such as device provisioning and key management

‍

IO Interfaces

How to use IO Interfaces

‍

Related Links

• Creating a Bootable SD Card
• Wi-Fi and Bluetooth Configuration