Commit 99a73b16 authored by Heather Ellsworth's avatar Heather Ellsworth

Adding steps to make bootable drive, use serial cable, and mention ssh

parent 881eb775
......@@ -3,8 +3,71 @@
First Steps
===========
The development board (whether a physical one or emulated one) will give you a place to see the effects of the active Librem 5 development. The software running on this board will become the software running on the Librem 5 phone but you don't have to wait for your Librem 5 phone to interact with it!
Regardless of which development board you are using, here are some first steps you will take when booting the system.
.. _make-bootable-drive:
Creating bootable drive for HW board
************************************
This section will show you how to put a bootable image on the microSD card for a physical development board. This step is not needed for the emulated board (VM) because the VM image already includes the software.
To complete this section, you will need:
* a physical development board
* a microSD card
* a method of accessig the microSD card with your computer (like a microSD <-> USB card reader)
Using your microSD <-> USB reader, mount the microSD card and take note of the device (with ``lsblk`` or ``df``). Then unmount it. For this walkthrough, the device is /dev/sdd::
$ lsblk
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
...
sdd 8:48 1 3.7G 0 disk
├─sdd1 8:49 1 181M 0 part /media/user/f36d95a4-dbd2-4ddc-a4fd-ae6fa119bf6e
└─sdd2 8:50 1 2.6G 0 part /media/user/94942ee2-a338-48b3-a27a-9c295405ce4e
$ sudo umount /dev/sdd1
$ sudo umount /dev/sdd2
In some temp directory, download the latest image from here: https://storage.puri.sm/librem5/binaries/unstable/latest/
In this example, we will download an image for the i.MX6 board.
Unpack the image and dd the image to the device::
$ wget https://storage.puri.sm/librem5/binaries/unstable/latest/imx6.img.xz
$ xzcat imx6.img.xz | pv | sudo dd of=/dev/sdd bs=4M
Depending on your system, the dd can take a while so grab a cup of coffee and be patient.
Once the dd has competed, put the microSD card in the appropriate slot on the development board and give the board power. The system should boot and you should see the boot logs on an attached screen.
.. _serial-monitoring:
Serial Connection Monitoring
****************************
If you do not have a screen attached to your physical development board or if you are not seeing the boot progress on your attached screen, you can use the `DB9 serial port <https://en.wikipedia.org/wiki/Serial_port>`_ on the board to monitor the boot progress.
To complete this section you will need:
* a physical development board
* a bootable microSD card (made from the previous section)
* a serial <-> USB cable (something like `this <https://webobjects2.cdw.com/is/image/CDW/3203815?$product-main$>`_)
With your bootable microSD card plugged into your board, connect your serial cable from the board to your computer. In the terminal, start the session on your computer with::
$ screen /dev/ttyUSB0 115200
Your terminal screen will turn blank with a waiting cursor in the top left of the screen.
Now give your development board power and watch your terminal. Boot logs should appear here, with an eventual log in prompt.
Quit the screen session at any time with `Ctrl+a` and then `:quit`.
Log in
******
......
......@@ -42,27 +42,8 @@ Most important interfaces:
* 2 USB host ports
* Ethernet port
Create bootable microSD card
----------------------------
Create a bootable microSD card with an i.MX6 image as described here: :ref:`make-bootable-drive`.
Using your microSD <-> USB reader, mount the microSD card and take note of the device (with ``lsblk`` or ``df``). Then unmount it. For this walkthrough, the device is /dev/sdd::
$ lsblk
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
...
sdd 8:48 1 3.7G 0 disk
├─sdd1 8:49 1 181M 0 part /media/user/f36d95a4-dbd2-4ddc-a4fd-ae6fa119bf6e
└─sdd2 8:50 1 2.6G 0 part /media/user/94942ee2-a338-48b3-a27a-9c295405ce4e
$ sudo umount /dev/sdd1
$ sudo umount /dev/sdd2
In some temp directory, download the latest image: https://storage.puri.sm/librem5/binaries/unstable/latest/imx6.img.xz
Unpack the image and dd the image to the device::
$ wget https://storage.puri.sm/librem5/binaries/unstable/latest/imx6.img.xz
$ xzcat imx6.img.xz | pv | sudo dd of=/dev/sdd bs=4M
Depending on your system, the dd can take a while so grab a cup of coffee and be patient.
Working with the i.MX6 Nitrogen board
-------------------------------------
......@@ -76,6 +57,7 @@ If however you have already performed the u-boot upgrade in the past, then skip
Now that we have the bootable drive on the microSD card, remove it from your microSD<->USB reader and insert it into the development board.
Also connect:
* an ethernet cable
* the HDMI cable to your monitor
* your keyboard and mouse
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment