summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRyan Harkin <ryan.harkin@linaro.org>2014-06-30 18:02:50 +0100
committerRyan Harkin <ryan.harkin@linaro.org>2014-06-30 18:02:50 +0100
commit373327f785b867580a5c320a415f9891bd728a5b (patch)
tree691f11afca26cabb7d652260b45463d80cf0c040
parent3e42964ee827488ddd9659ef2509cd723e12edd6 (diff)
14.06: apply getting start update from Andy
Signed-off-by: Ryan Harkin <ryan.harkin@linaro.org>
-rw-r--r--android/images/armv8-android-juno-lsk/HOWTO_gettingstarted.txt36
-rw-r--r--android/images/armv8-juice-juno-lsk/HOWTO_gettingstarted.txt38
-rw-r--r--openembedded/juno-lsk/GETTINGSTARTED.textile38
3 files changed, 59 insertions, 53 deletions
diff --git a/android/images/armv8-android-juno-lsk/HOWTO_gettingstarted.txt b/android/images/armv8-android-juno-lsk/HOWTO_gettingstarted.txt
index 2ba5909..665d3ae 100644
--- a/android/images/armv8-android-juno-lsk/HOWTO_gettingstarted.txt
+++ b/android/images/armv8-android-juno-lsk/HOWTO_gettingstarted.txt
@@ -18,15 +18,15 @@ h3(#uarts). UARTs
There are 4 UARTs on the Juno board:
-| *UART* | *Location* | *Used by* | *Baud* | *Data bits* |
-|SoC UART0 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |The motherboard, UEFI and the Linux kernel. |115200 |8 |
-|SoC UART1 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |SCP firmware |115200 |8 |
-|FPGA UART0 |Corresponds to the J55 header on the board. Please contact ARM for more information about this type of header. |AP Trusted Firmware |115200 |8 |
-|FPGA UART1 |Corresponds to the J56 header on the board. Please contact ARM for more information about this type of header |Unused at the moment |- |- |
+| *UART* | *Location* | *Used by* | *Baud* | *Data bits* | *Stop bits* | *Parity |
+|SoC UART0 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |The motherboard, UEFI and the Linux kernel. |115200 |8 |1 |None |
+|SoC UART1 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |SCP firmware |115200 |8 |1 |None |
+|FPGA UART0 |Corresponds to the J55 header on the board. Please contact ARM for more information about this type of header. |AP Trusted Firmware |115200 |8 |1 |None |
+|FPGA UART1 |Corresponds to the J56 header on the board. Please contact ARM for more information about this type of header |Unused at the moment |- |- |- |- |
h2. Quick Start
-If you have just unpacked a new Juno board and would like to get it booting straight away, you may wish to skip ahead to the “Set up and boot the Juno board”:#setup section.
+If you have just unpacked a new Juno board and would like to get it booting straight away, you may wish to skip ahead to the "Set up and boot the Juno board":#setup section.
 
@@ -91,7 +91,9 @@ If you have just received a new board and powered it on for the first time, you
h3. Setting the Real Time Clock (required for Android)
-The example below demonstrates how to set the clock on the board:
+New Juno boards do not have the correct time programmed into the real time clock. Some software (notably Android) will not operate correctly until a sensible time is programmed. To set the time, start a terminal session with "UART0":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png connector ("settings":#uarts). Ensure there is power to the board, but the SoC must be powered off (if it is not, then press the black "Hardware Reset" button).
+
+Execute the following:
bc. ARM V2M-Juno Boot loader v1.0.0
HBI0262 build 596
@@ -119,31 +121,31 @@ h3. Enabling Texture Compression Formats
The Mali GPU in Juno is able to use a variety of texture compression formats, many of which are subject to license from third parties. It is the responsibility of the end user to obtain a license for each texture that will be used on Juno. Once such licenses are obtained, the textures can be enabled by the following procedure:
-1.      Connect a serial terminal to the top 9-pin UART0 connector on the rear panel (115200 baud, 8, n, 1).
+1. Connect a serial terminal to the top 9-pin UART0 connector on the rear panel (115200 baud, 8, n, 1).
-2.      Connect a USB cable between the USB-B connector on the rear panel and a USB port of your host computer.
+2. Connect a USB cable between the USB-B connector on the rear panel and a USB port of your host computer.
-3.      Connect the 12 volt power supply to the board.
+3. Connect the 12 volt power supply to the board.
The serial terminal will show the command prompt Cmd>
-4.      At the Cmd> prompt on the serial terminal, issue the command usb_on
+4. At the Cmd> prompt on the serial terminal, issue the command usb_on
bc. Cmd> usb_on
The configuration flash memory should now be visible on the host computer as a mass storage device.
-5.      Open the file SITE1/HBI0262B/board.txt for editing.
+5. Open the file SITE1/HBI0262B/board.txt for editing.
-6.      Consult the “Mali-T600 Series GPU Configuration and Sign-off Guide” to determine the correct value that should be programmed into the GPU texture format register to enable only the registers that you have licensed for use with Juno. For example, to enable all texture compression formats, the value should be 0xFFFFFFFF.
+6. Consult the "Mali-T600 Series GPU Configuration and Sign-off Guide" to determine the correct value that should be programmed into the GPU texture format register to enable only the registers that you have licensed for use with Juno. For example, to enable all texture compression formats, the value should be 0xFFFFFFFF.
-7.      In the [SCC REGISTERS] section, below the “TOTALSCCS” line, insert the following line:
+7. In the [SCC REGISTERS] section, below the "TOTALSCCS" line, insert the following line:
-SCC: 0x05C <value from step 6 above>           ;Optional comment to explain which texture you have enabled
+SCC: 0x05C <value from step 6 above> ;Optional comment to explain which texture you have enabled
-8.      Update the TOTALSCCS count (increment it by one) so that it now reflects the total number of SCC registers that are programmed.
+8. Update the TOTALSCCS count (increment it by one) so that it now reflects the total number of SCC registers that are programmed.
-9.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
+9. Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
The board will load the default configuration and boot up.
diff --git a/android/images/armv8-juice-juno-lsk/HOWTO_gettingstarted.txt b/android/images/armv8-juice-juno-lsk/HOWTO_gettingstarted.txt
index df07d1b..cde6517 100644
--- a/android/images/armv8-juice-juno-lsk/HOWTO_gettingstarted.txt
+++ b/android/images/armv8-juice-juno-lsk/HOWTO_gettingstarted.txt
@@ -18,15 +18,15 @@ h3(#uarts). UARTs
There are 4 UARTs on the Juno board:
-| *UART* | *Location* | *Used by* | *Baud* | *Data bits* |
-|SoC UART0 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |The motherboard, UEFI and the Linux kernel. |115200 |8 |
-|SoC UART1 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |SCP firmware |115200 |8 |
-|FPGA UART0 |Corresponds to the J55 header on the board. Please contact ARM for more information about this type of header. |AP Trusted Firmware |115200 |8 |
-|FPGA UART1 |Corresponds to the J56 header on the board. Please contact ARM for more information about this type of header |Unused at the moment |- |- |
+| *UART* | *Location* | *Used by* | *Baud* | *Data bits* | *Stop bits* | *Parity |
+|SoC UART0 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |The motherboard, UEFI and the Linux kernel. |115200 |8 |1 |None |
+|SoC UART1 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |SCP firmware |115200 |8 |1 |None |
+|FPGA UART0 |Corresponds to the J55 header on the board. Please contact ARM for more information about this type of header. |AP Trusted Firmware |115200 |8 |1 |None |
+|FPGA UART1 |Corresponds to the J56 header on the board. Please contact ARM for more information about this type of header |Unused at the moment |- |- |- |- |
h2. Quick Start
-If you have just unpacked a new Juno board and would like to get it booting straight away, you may wish to skip ahead to the “Set up and boot the Juno board”:#setup section.
+If you have just unpacked a new Juno board and would like to get it booting straight away, you may wish to skip ahead to the "Set up and boot the Juno board":#setup section.
 
@@ -76,7 +76,7 @@ New Juno boards do not contain any Android software pre-installed.
 
-h3. Set up and boot the Juno board
+h3(#setup). Set up and boot the Juno board
You are strongly recommended to update to the latest firmware before doing anything productive with your Juno board.
@@ -91,7 +91,9 @@ If you have just received a new board and powered it on for the first time, you
h3. Setting the Real Time Clock (required for Android)
-The example below demonstrates how to set the clock on the board:
+New Juno boards do not have the correct time programmed into the real time clock. Some software (notably Android) will not operate correctly until a sensible time is programmed. To set the time, start a terminal session with "UART0":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png connector ("settings":#uarts). Ensure there is power to the board, but the SoC must be powered off (if it is not, then press the black "Hardware Reset" button).
+
+Execute the following:
bc. ARM V2M-Juno Boot loader v1.0.0
HBI0262 build 596
@@ -119,31 +121,31 @@ h3. Enabling Texture Compression Formats
The Mali GPU in Juno is able to use a variety of texture compression formats, many of which are subject to license from third parties. It is the responsibility of the end user to obtain a license for each texture that will be used on Juno. Once such licenses are obtained, the textures can be enabled by the following procedure:
-1.      Connect a serial terminal to the top 9-pin UART0 connector on the rear panel (115200 baud, 8, n, 1).
+1. Connect a serial terminal to the top 9-pin UART0 connector on the rear panel (115200 baud, 8, n, 1).
-2.      Connect a USB cable between the USB-B connector on the rear panel and a USB port of your host computer.
+2. Connect a USB cable between the USB-B connector on the rear panel and a USB port of your host computer.
-3.      Connect the 12 volt power supply to the board.
+3. Connect the 12 volt power supply to the board.
The serial terminal will show the command prompt Cmd>
-4.      At the Cmd> prompt on the serial terminal, issue the command usb_on
+4. At the Cmd> prompt on the serial terminal, issue the command usb_on
bc. Cmd> usb_on
The configuration flash memory should now be visible on the host computer as a mass storage device.
-5.      Open the file SITE1/HBI0262B/board.txt for editing.
+5. Open the file SITE1/HBI0262B/board.txt for editing.
-6.      Consult the “Mali-T600 Series GPU Configuration and Sign-off Guide” to determine the correct value that should be programmed into the GPU texture format register to enable only the registers that you have licensed for use with Juno. For example, to enable all texture compression formats, the value should be 0xFFFFFFFF.
+6. Consult the "Mali-T600 Series GPU Configuration and Sign-off Guide" to determine the correct value that should be programmed into the GPU texture format register to enable only the registers that you have licensed for use with Juno. For example, to enable all texture compression formats, the value should be 0xFFFFFFFF.
-7.      In the [SCC REGISTERS] section, below the “TOTALSCCS” line, insert the following line:
+7. In the [SCC REGISTERS] section, below the "TOTALSCCS" line, insert the following line:
-SCC: 0x05C <value from step 6 above>           ;Optional comment to explain which texture you have enabled
+SCC: 0x05C <value from step 6 above> ;Optional comment to explain which texture you have enabled
-8.      Update the TOTALSCCS count (increment it by one) so that it now reflects the total number of SCC registers that are programmed.
+8. Update the TOTALSCCS count (increment it by one) so that it now reflects the total number of SCC registers that are programmed.
-9.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
+9. Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
The board will load the default configuration and boot up.
diff --git a/openembedded/juno-lsk/GETTINGSTARTED.textile b/openembedded/juno-lsk/GETTINGSTARTED.textile
index c32c496..9674c0c 100644
--- a/openembedded/juno-lsk/GETTINGSTARTED.textile
+++ b/openembedded/juno-lsk/GETTINGSTARTED.textile
@@ -18,15 +18,15 @@ h3(#uarts). UARTs
There are 4 UARTs on the Juno board:
-| *UART* | *Location* | *Used by* | *Baud* | *Data bits* |
-|SoC UART0 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |The motherboard, UEFI and the Linux kernel. |115200 |8 |
-|SoC UART1 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |SCP firmware |115200 |8 |
-|FPGA UART0 |Corresponds to the J55 header on the board. Please contact ARM for more information about this type of header. |AP Trusted Firmware |115200 |8 |
-|FPGA UART1 |Corresponds to the J56 header on the board. Please contact ARM for more information about this type of header |Unused at the moment |- |- |
+| *UART* | *Location* | *Used by* | *Baud* | *Data bits* | *Stop bits* | *Parity |
+|SoC UART0 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |The motherboard, UEFI and the Linux kernel. |115200 |8 |1 |None |
+|SoC UART1 |"back panel":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png |SCP firmware |115200 |8 |1 |None |
+|FPGA UART0 |Corresponds to the J55 header on the board. Please contact ARM for more information about this type of header. |AP Trusted Firmware |115200 |8 |1 |None |
+|FPGA UART1 |Corresponds to the J56 header on the board. Please contact ARM for more information about this type of header |Unused at the moment |- |- |- |- |
h2. Quick Start
-If you have just unpacked a new Juno board and would like to get it booting straight away, you may wish to skip ahead to the “Set up and boot the Juno board”:#setup section.
+If you have just unpacked a new Juno board and would like to get it booting straight away, you may wish to skip ahead to the "Set up and boot the Juno board":#setup section.
 
@@ -76,7 +76,7 @@ New Juno boards do not contain any Android software pre-installed.
 
-h3. Set up and boot the Juno board
+h3(#setup). Set up and boot the Juno board
You are strongly recommended to update to the latest firmware before doing anything productive with your Juno board.
@@ -91,7 +91,9 @@ If you have just received a new board and powered it on for the first time, you
h3. Setting the Real Time Clock (required for Android)
-The example below demonstrates how to set the clock on the board:
+New Juno boards do not have the correct time programmed into the real time clock. Some software (notably Android) will not operate correctly until a sensible time is programmed. To set the time, start a terminal session with "UART0":https://releases.linaro.org/14.06/openembedded/juno-lsk/RearPanel.png connector ("settings":#uarts). Ensure there is power to the board, but the SoC must be powered off (if it is not, then press the black "Hardware Reset" button).
+
+Execute the following:
bc. ARM V2M-Juno Boot loader v1.0.0
HBI0262 build 596
@@ -119,31 +121,31 @@ h3. Enabling Texture Compression Formats
The Mali GPU in Juno is able to use a variety of texture compression formats, many of which are subject to license from third parties. It is the responsibility of the end user to obtain a license for each texture that will be used on Juno. Once such licenses are obtained, the textures can be enabled by the following procedure:
-1.      Connect a serial terminal to the top 9-pin UART0 connector on the rear panel (115200 baud, 8, n, 1).
+1. Connect a serial terminal to the top 9-pin UART0 connector on the rear panel (115200 baud, 8, n, 1).
-2.      Connect a USB cable between the USB-B connector on the rear panel and a USB port of your host computer.
+2. Connect a USB cable between the USB-B connector on the rear panel and a USB port of your host computer.
-3.      Connect the 12 volt power supply to the board.
+3. Connect the 12 volt power supply to the board.
The serial terminal will show the command prompt Cmd>
-4.      At the Cmd> prompt on the serial terminal, issue the command usb_on
+4. At the Cmd> prompt on the serial terminal, issue the command usb_on
bc. Cmd> usb_on
The configuration flash memory should now be visible on the host computer as a mass storage device.
-5.      Open the file SITE1/HBI0262B/board.txt for editing.
+5. Open the file SITE1/HBI0262B/board.txt for editing.
-6.      Consult the “Mali-T600 Series GPU Configuration and Sign-off Guide” to determine the correct value that should be programmed into the GPU texture format register to enable only the registers that you have licensed for use with Juno. For example, to enable all texture compression formats, the value should be 0xFFFFFFFF.
+6. Consult the "Mali-T600 Series GPU Configuration and Sign-off Guide" to determine the correct value that should be programmed into the GPU texture format register to enable only the registers that you have licensed for use with Juno. For example, to enable all texture compression formats, the value should be 0xFFFFFFFF.
-7.      In the [SCC REGISTERS] section, below the “TOTALSCCS” line, insert the following line:
+7. In the [SCC REGISTERS] section, below the "TOTALSCCS" line, insert the following line:
-SCC: 0x05C <value from step 6 above>           ;Optional comment to explain which texture you have enabled
+SCC: 0x05C <value from step 6 above> ;Optional comment to explain which texture you have enabled
-8.      Update the TOTALSCCS count (increment it by one) so that it now reflects the total number of SCC registers that are programmed.
+8. Update the TOTALSCCS count (increment it by one) so that it now reflects the total number of SCC registers that are programmed.
-9.      Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
+9. Press the red ON/OFF button on the rear panel of the board and wait for reprogramming to complete.
The board will load the default configuration and boot up.