aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorbnewbold <bnewbold@robocracy.org>2015-01-07 03:04:47 +0000
committerbnewbold <bnewbold@robocracy.org>2015-01-07 03:04:47 +0000
commit7ac9348f50ac344293292f722b9c39d15535f644 (patch)
treee6e4f3f5e3c9d8a582ad0e2ced266dfc4e96cc14
parent64121173ebbe6c941d7aadb052c46f7240dd25ae (diff)
downloadnovena-guide-7ac9348f50ac344293292f722b9c39d15535f644.tar.gz
novena-guide-7ac9348f50ac344293292f722b9c39d15535f644.zip
quickstart-board: readability improvements
-rw-r--r--quickstart-board.rst35
1 files 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
<http://kosagi.com/w/index.php?title=Using_Novena_PVT1>`_, 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