From 7ac9348f50ac344293292f722b9c39d15535f644 Mon Sep 17 00:00:00 2001 From: bnewbold Date: Wed, 7 Jan 2015 03:04:47 +0000 Subject: quickstart-board: readability improvements --- quickstart-board.rst | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) diff --git a/quickstart-board.rst b/quickstart-board.rst index 900ba83..b180e81 100644 --- a/quickstart-board.rst +++ b/quickstart-board.rst @@ -1,13 +1,17 @@ Quickstart: Just the Board ============================= +This page runs through the steps of configuring a "bare" Novena mainboard for +use as a display-less system using the factory-installed microSD card as the +rootfs media. + .. figure:: /img/novena-unbox-board-pvt2a.jpg :align: center :alt: Novena PVT2 just-the-board unboxing, Dec 2014 :width: 100% :target: _images/novena-unbox-board-pvt2a.jpg - *Novena PVT2 Just-The-Board unboxing, December 2014* + *Novena PVT2 "Just-The-Board" contents (December 2014)* .. topic:: Before you begin... @@ -15,9 +19,9 @@ Quickstart: Just the Board terminal). You will also need an Ethernet cable if you want wired networking. -First attach the FTDI cable with the USB side connected to your host machine -and the UART end connected to the Novena. The correct UART connection is -described on the `"Using Novena PVT1" wiki page +First, before applying power, attach the FTDI cable with the USB side connected +to your host machine and the UART end connected to the Novena. The correct UART +connection is described on the `"Using Novena PVT1" wiki page `_, and is shown below. .. TODO:: better image of attached cable @@ -31,16 +35,18 @@ described on the `"Using Novena PVT1" wiki page *Novena PVT2 board with FTDI UART cable attached to console port (note wire colors and orientation)* -Before powering on the Novena, open a terminal program on the work machine and -open the FTDI device using 115200 baud as the speed and "normal" settings for -everything else (eg, ``8n1``). Eg, on a UNIX machine you could use the -``screen`` command line program:: +Open a terminal program on the work machine and open the FTDI device using +115200 baud as the speed and "normal" settings for everything else (eg, +``8n1``). For example, on a UNIX machine you could use the ``screen`` command +line program:: screen /dev/ttyUSB0 115200 # Should be a blank screen until the Novena boots. # Type "Ctrl-A" then "k" to quit when you are done. -Finally connect power to the Novena board's DC barrel jack. You should see +Or you could use minicom or GtkTerm or whatever your favorite is.. + +Finally, connect power to the Novena board's DC barrel jack. You should see u-boot and then kernel boot messages stream out the console. Eventually you will enter the `"first run" menu system @@ -59,14 +65,14 @@ for a headless (aka, no display) system might be: - Disable graphical logins Following all the prompts, the system should get configured and you will be -able to login as the user you created. Horray! +able to login as the user you created. Blessed be! The next step will be to get networking up and running so you can upgrade and/or install new software. .. note:: - You need a wired connection to install required tools before you can use the - wireless interfaces. + You need a wired connection to install required utilities before you can + configure the wireless interfaces. **Configure Ethernet Networking** @@ -84,7 +90,7 @@ automatically. Test the connection with:: .. TODO:: closed wifi hotspot, passwords -Install packages:: +Install packages (over the wired connection):: sudo apt-get install wireless-tools iw @@ -124,7 +130,8 @@ install -f`` to fix configuration, then ``sudo apt-get upgrade`` to finish the upgrade. You will almost certainly find youself needing i2c control utilities if you -will be hacking on the Novena, so now would be a good time to do:: +will be hacking on the Novena, eg to compile the FPGA userland tools, so now +would be a good time to do:: sudo apt-get install i2c-tools libi2c-dev -- cgit v1.2.3