[v3,6/6] boards: tbs2910: add README
diff mbox series

Message ID 20200208053839.7101-6-GNUtoo@cyberdimension.org
State Changes Requested
Delegated to: Bin Meng
Headers show
Series
  • [v3,1/6] board: tbs2910: disable loadb and loads commands
Related show

Commit Message

Denis 'GNUtoo' Carikli Feb. 8, 2020, 5:38 a.m. UTC
The installation documentation make use of the
"BOOT/UPDATE" mechanism that is documented in the TBS2910
OS installation manual[1].

This is to make sure that they work on the different PCB
revisions of this board.

There is also a boot configuration switch (SW6) but the
one described in the v2.1 schematics has 8 switches whereas
the one present on the v2.3 board has only 4.

Only the v2.1 board schematics are available.

[1]https://www.tbsdtv.com/download/document/tbs2910/How-to-burn-a-new-OS-into-eMMC-on-Matrix-V2.0.pdf

Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
---
 board/tbs/tbs2910/README | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 board/tbs/tbs2910/README

Comments

Soeren Moch Feb. 8, 2020, 3:47 p.m. UTC | #1
On 08.02.20 06:38, Denis 'GNUtoo' Carikli wrote:
> The installation documentation make use of the
> "BOOT/UPDATE" mechanism that is documented in the TBS2910
> OS installation manual[1].
>
> This is to make sure that they work on the different PCB
> revisions of this board.
>
> There is also a boot configuration switch (SW6) but the
> one described in the v2.1 schematics has 8 switches whereas
> the one present on the v2.3 board has only 4.
>
> Only the v2.1 board schematics are available.
>
> [1]https://www.tbsdtv.com/download/document/tbs2910/How-to-burn-a-new-OS-into-eMMC-on-Matrix-V2.0.pdf
>
> Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
Thanks for adding this README.
You mentioned the boot configuration switch (SW6) in the commit message,
but not in the README itself. Does this mean you planned to include a
description of the boot switch settings (what I think would be a good
idea)?For board version V2.3 the switch settings are:
switch 1 2 3 4
eMMC   1 1 1 1
SD2    1 0 0 0
SD3    0 1 0 0

Loading u-boot from SATA unfortunately is not possible on V2.3 .
> [...]
> \ No newline at end of file
Please add the newline when resending this patch.

Soeren
Bin Meng Feb. 8, 2020, 3:49 p.m. UTC | #2
Hi,

On Sat, Feb 8, 2020 at 1:39 PM Denis 'GNUtoo' Carikli
<GNUtoo@cyberdimension.org> wrote:
>
> The installation documentation make use of the
> "BOOT/UPDATE" mechanism that is documented in the TBS2910
> OS installation manual[1].
>
> This is to make sure that they work on the different PCB
> revisions of this board.
>
> There is also a boot configuration switch (SW6) but the
> one described in the v2.1 schematics has 8 switches whereas
> the one present on the v2.3 board has only 4.
>
> Only the v2.1 board schematics are available.
>
> [1]https://www.tbsdtv.com/download/document/tbs2910/How-to-burn-a-new-OS-into-eMMC-on-Matrix-V2.0.pdf
>
> Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
> ---
>  board/tbs/tbs2910/README | 37 +++++++++++++++++++++++++++++++++++++

Could you please convert the board readme to reST format, and put it
under doc/board/tbs/tbs2910.rst?

>  1 file changed, 37 insertions(+)
>  create mode 100644 board/tbs/tbs2910/README
>

Regards,
Bin

Patch
diff mbox series

diff --git a/board/tbs/tbs2910/README b/board/tbs/tbs2910/README
new file mode 100644
index 0000000000..6562897e21
--- /dev/null
+++ b/board/tbs/tbs2910/README
@@ -0,0 +1,37 @@ 
+How to use U-Boot on the TBS2910
+--------------------------------
+
+Configure and build U-boot for the TBS2910:
+    $ make mrproper
+    $ make tbs2910_defconfig
+    $ make
+
+This will generate the u-boot.imx image.
+
+UART:
+- The UART voltage is at 3.3V and its settings are 115200bps 8N1
+
+Boot from eMMC:
+- Once the board is booted, flash u-boot.imx to mmcblk0boot0:
+    $ sudo echo 0 >/sys/block/mmcblk0boot0/force_ro
+    $ sudo dd if=u-boot.imx of=/dev/mmcblk0boot0 bs=1k seek=1; sync
+  Note that the eMMC card node may vary, so adjust this as needed.
+- Power off the board
+- Make sure that the boot switch is set to "BOOT"
+- Connect the UART cable to the host PC
+- Power up the board and U-Boot messages will appear in the serial console.
+
+Boot from USB:
+- Build imx_usb_loader
+    $ git clone git://github.com/boundarydevices/imx_usb_loader.git
+    $ cd imx_usb_loader
+    $ make
+- Copy u-boot.imx in the imx_usb_loader directory
+- Power off the board
+- Make sure that the boot switch is set to "UPDATE"
+- Connect an USB cable to the host PC
+- Connect the UART cable to the host PC
+- Power on the board
+- Load u-boot.img through USB with imx_usb:
+  $ sudo ./imx_usb -v u-boot.imx
+- U-Boot messages will appear in the serial console
\ No newline at end of file