Re: [PATCH] Nokia RX-51: Convert documentation to rst format
On Monday 02 August 2021 11:43:59 Lokesh Vutla wrote:
> Hi Pali,
>
> On 01/08/21 4:18 pm, Pali Rohár wrote:
> > On Monday 26 July 2021 12:38:05 Lokesh Vutla wrote:
> >> On 22/07/21 2:55 am, Pali Rohár wrote:
> >>> Signed-off-by: Pali Rohár
> >>> ---
> >>> board/nokia/rx51/MAINTAINERS | 2 +-
> >>> doc/board/index.rst | 1 +
> >>> doc/board/nokia/index.rst | 7 +
> >>> .../nokia/rx51.rst} | 142 +-
> >>> 4 files changed, 83 insertions(+), 69 deletions(-)
> >>> create mode 100644 doc/board/nokia/index.rst
> >>> rename doc/{README.nokia_rx51 => board/nokia/rx51.rst} (32%)
> >>
> >> This doesn't apply cleanly on latest u-boot master. Can you rebase and
> >> repost?
> >
> > Because it depends on other N900 patches which were sent to ML prior this
> > one.
>
> How am I supposed to know what all patches it depends on and the current
> status
> of these patches?
>
> Please list all the patches and their current status. Or please ping me once
> all
> the dependent patches are merged.
Hello! Here is the list of dependent patches:
* https://lists.denx.de/pipermail/u-boot/2021-June/452410.html
* https://lists.denx.de/pipermail/u-boot/2021-June/452411.html
> Thanks and regards,
> Lokesh
>
> >
> >> Thanks and regards,
> >> Lokesh
> >>
> >>>
> >>> diff --git a/board/nokia/rx51/MAINTAINERS b/board/nokia/rx51/MAINTAINERS
> >>> index 58b16bf9a95c..25f8b3c5a9ad 100644
> >>> --- a/board/nokia/rx51/MAINTAINERS
> >>> +++ b/board/nokia/rx51/MAINTAINERS
> >>> @@ -4,5 +4,5 @@ S:Maintained
> >>> F: board/nokia/rx51/
> >>> F: include/configs/nokia_rx51.h
> >>> F: configs/nokia_rx51_defconfig
> >>> -F: doc/README.nokia_rx51
> >>> +F: doc/board/nokia/rx51.rst
> >>> F: test/nokia_rx51_test.sh
> >>> diff --git a/doc/board/index.rst b/doc/board/index.rst
> >>> index 747511f7ddd2..4c470abbac02 100644
> >>> --- a/doc/board/index.rst
> >>> +++ b/doc/board/index.rst
> >>> @@ -19,6 +19,7 @@ Board-specific doc
> >>> intel/index
> >>> kontron/index
> >>> microchip/index
> >>> + nokia/index
> >>> rockchip/index
> >>> sifive/index
> >>> sipeed/index
> >>> diff --git a/doc/board/nokia/index.rst b/doc/board/nokia/index.rst
> >>> new file mode 100644
> >>> index ..fb0db2f34244
> >>> --- /dev/null
> >>> +++ b/doc/board/nokia/index.rst
> >>> @@ -0,0 +1,7 @@
> >>> +Nokia
> >>> +=
> >>> +
> >>> +.. toctree::
> >>> + :maxdepth: 2
> >>> +
> >>> + rx51
> >>> diff --git a/doc/README.nokia_rx51 b/doc/board/nokia/rx51.rst
> >>> similarity index 32%
> >>> rename from doc/README.nokia_rx51
> >>> rename to doc/board/nokia/rx51.rst
> >>> index e739b02088ea..c84fdcddf166 100644
> >>> --- a/doc/README.nokia_rx51
> >>> +++ b/doc/board/nokia/rx51.rst
> >>> @@ -1,6 +1,7 @@
> >>> -Board: Nokia RX-51 aka N900
> >>> +Nokia RX-51 aka N900
> >>> +
> >>>
> >>> -This board definition results in a u-boot.bin which can be chainloaded
> >>> +This board definition results in a ``u-boot.bin`` which can be
> >>> chainloaded
> >>> from NOLO in qemu or on a real N900. It does very little hardware config
> >>> because NOLO has already configured the board. Only needed is enabling
> >>> internal eMMC memory via twl4030 regulator which is not enabled by NOLO.
> >>> @@ -8,64 +9,64 @@ internal eMMC memory via twl4030 regulator which is not
> >>> enabled by NOLO.
> >>> NOLO is expecting a kernel image and will treat any image it finds in
> >>> onenand as such. This u-boot is intended to be flashed to the N900 like
> >>> a kernel. In order to transparently boot the original kernel, it will be
> >>> -appended to u-boot.bin at 0x4. NOLO will load the entire image into
> >>> +appended to ``u-boot.bin`` at 0x4. NOLO will load the entire image
> >>> into
> >>> (random) memory and execute u-boot, which saves hw revision, boot reason
> >>> and boot mode ATAGs set by NOLO. Then the bootscripts will attempt to
> >>> load
> >>> -uImage, zImage or boot.scr from a fat or ext2/3/4 filesystem on external
> >>> -SD card or internal eMMC memory. If this fails or keyboard is closed then
> >>> -the appended kernel image will be booted using some generated and some
> >>> -stored ATAGs (see boot order).
> >>> +``uImage``, ``zImage`` or ``boot.scr`` file from a fat or ext2/3/4
> >>> filesystem
> >>> +on external SD card or internal eMMC memory. If this fails or keyboard is
> >>> +closed then the appended kernel image will be booted using some generated
> >>> +and some stored ATAGs (see boot order).
> >>>
> >>> For generating combined image of u-boot and kernel (either in uImage or
> >>> zImage
> >>> -format) there is a simple script called u-boot-gen-combined. It is
> >>> available in
> >>> -following repository:
> >>> +format) there is a simple script called ``u-boot-gen-combined``. It is
> >>> available
> >>> +in following repository:
> >>>
Re: [PATCH] Nokia RX-51: Convert documentation to rst format
Hi Pali,
On 01/08/21 4:18 pm, Pali Rohár wrote:
> On Monday 26 July 2021 12:38:05 Lokesh Vutla wrote:
>> On 22/07/21 2:55 am, Pali Rohár wrote:
>>> Signed-off-by: Pali Rohár
>>> ---
>>> board/nokia/rx51/MAINTAINERS | 2 +-
>>> doc/board/index.rst | 1 +
>>> doc/board/nokia/index.rst | 7 +
>>> .../nokia/rx51.rst} | 142 +-
>>> 4 files changed, 83 insertions(+), 69 deletions(-)
>>> create mode 100644 doc/board/nokia/index.rst
>>> rename doc/{README.nokia_rx51 => board/nokia/rx51.rst} (32%)
>>
>> This doesn't apply cleanly on latest u-boot master. Can you rebase and
>> repost?
>
> Because it depends on other N900 patches which were sent to ML prior this one.
How am I supposed to know what all patches it depends on and the current status
of these patches?
Please list all the patches and their current status. Or please ping me once all
the dependent patches are merged.
Thanks and regards,
Lokesh
>
>> Thanks and regards,
>> Lokesh
>>
>>>
>>> diff --git a/board/nokia/rx51/MAINTAINERS b/board/nokia/rx51/MAINTAINERS
>>> index 58b16bf9a95c..25f8b3c5a9ad 100644
>>> --- a/board/nokia/rx51/MAINTAINERS
>>> +++ b/board/nokia/rx51/MAINTAINERS
>>> @@ -4,5 +4,5 @@ S: Maintained
>>> F: board/nokia/rx51/
>>> F: include/configs/nokia_rx51.h
>>> F: configs/nokia_rx51_defconfig
>>> -F: doc/README.nokia_rx51
>>> +F: doc/board/nokia/rx51.rst
>>> F: test/nokia_rx51_test.sh
>>> diff --git a/doc/board/index.rst b/doc/board/index.rst
>>> index 747511f7ddd2..4c470abbac02 100644
>>> --- a/doc/board/index.rst
>>> +++ b/doc/board/index.rst
>>> @@ -19,6 +19,7 @@ Board-specific doc
>>> intel/index
>>> kontron/index
>>> microchip/index
>>> + nokia/index
>>> rockchip/index
>>> sifive/index
>>> sipeed/index
>>> diff --git a/doc/board/nokia/index.rst b/doc/board/nokia/index.rst
>>> new file mode 100644
>>> index ..fb0db2f34244
>>> --- /dev/null
>>> +++ b/doc/board/nokia/index.rst
>>> @@ -0,0 +1,7 @@
>>> +Nokia
>>> +=
>>> +
>>> +.. toctree::
>>> + :maxdepth: 2
>>> +
>>> + rx51
>>> diff --git a/doc/README.nokia_rx51 b/doc/board/nokia/rx51.rst
>>> similarity index 32%
>>> rename from doc/README.nokia_rx51
>>> rename to doc/board/nokia/rx51.rst
>>> index e739b02088ea..c84fdcddf166 100644
>>> --- a/doc/README.nokia_rx51
>>> +++ b/doc/board/nokia/rx51.rst
>>> @@ -1,6 +1,7 @@
>>> -Board: Nokia RX-51 aka N900
>>> +Nokia RX-51 aka N900
>>> +
>>>
>>> -This board definition results in a u-boot.bin which can be chainloaded
>>> +This board definition results in a ``u-boot.bin`` which can be chainloaded
>>> from NOLO in qemu or on a real N900. It does very little hardware config
>>> because NOLO has already configured the board. Only needed is enabling
>>> internal eMMC memory via twl4030 regulator which is not enabled by NOLO.
>>> @@ -8,64 +9,64 @@ internal eMMC memory via twl4030 regulator which is not
>>> enabled by NOLO.
>>> NOLO is expecting a kernel image and will treat any image it finds in
>>> onenand as such. This u-boot is intended to be flashed to the N900 like
>>> a kernel. In order to transparently boot the original kernel, it will be
>>> -appended to u-boot.bin at 0x4. NOLO will load the entire image into
>>> +appended to ``u-boot.bin`` at 0x4. NOLO will load the entire image into
>>> (random) memory and execute u-boot, which saves hw revision, boot reason
>>> and boot mode ATAGs set by NOLO. Then the bootscripts will attempt to load
>>> -uImage, zImage or boot.scr from a fat or ext2/3/4 filesystem on external
>>> -SD card or internal eMMC memory. If this fails or keyboard is closed then
>>> -the appended kernel image will be booted using some generated and some
>>> -stored ATAGs (see boot order).
>>> +``uImage``, ``zImage`` or ``boot.scr`` file from a fat or ext2/3/4
>>> filesystem
>>> +on external SD card or internal eMMC memory. If this fails or keyboard is
>>> +closed then the appended kernel image will be booted using some generated
>>> +and some stored ATAGs (see boot order).
>>>
>>> For generating combined image of u-boot and kernel (either in uImage or
>>> zImage
>>> -format) there is a simple script called u-boot-gen-combined. It is
>>> available in
>>> -following repository:
>>> +format) there is a simple script called ``u-boot-gen-combined``. It is
>>> available
>>> +in following repository:
>>>
>>> - https://github.com/pali/u-boot-maemo
>>> + https://github.com/pali/u-boot-maemo
>>>
>>> -To generate combined.bin image from u-boot.bin and kernel.bin (either
>>> uImage
>>> -or zImage) use:
>>> +To generate ``combined.bin`` image from ``u-boot.bin`` and ``kernel.bin``
>>> +(either uImage or zImage format) use::
>>>
>>> - sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
>>> + $ sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
>>>
>>> Original Maemo Fremantle PR1.3 zImage kernel binary is
Re: [PATCH] Nokia RX-51: Convert documentation to rst format
On Monday 26 July 2021 12:38:05 Lokesh Vutla wrote:
> On 22/07/21 2:55 am, Pali Rohár wrote:
> > Signed-off-by: Pali Rohár
> > ---
> > board/nokia/rx51/MAINTAINERS | 2 +-
> > doc/board/index.rst | 1 +
> > doc/board/nokia/index.rst | 7 +
> > .../nokia/rx51.rst} | 142 +-
> > 4 files changed, 83 insertions(+), 69 deletions(-)
> > create mode 100644 doc/board/nokia/index.rst
> > rename doc/{README.nokia_rx51 => board/nokia/rx51.rst} (32%)
>
> This doesn't apply cleanly on latest u-boot master. Can you rebase and repost?
Because it depends on other N900 patches which were sent to ML prior this one.
> Thanks and regards,
> Lokesh
>
> >
> > diff --git a/board/nokia/rx51/MAINTAINERS b/board/nokia/rx51/MAINTAINERS
> > index 58b16bf9a95c..25f8b3c5a9ad 100644
> > --- a/board/nokia/rx51/MAINTAINERS
> > +++ b/board/nokia/rx51/MAINTAINERS
> > @@ -4,5 +4,5 @@ S: Maintained
> > F: board/nokia/rx51/
> > F: include/configs/nokia_rx51.h
> > F: configs/nokia_rx51_defconfig
> > -F: doc/README.nokia_rx51
> > +F: doc/board/nokia/rx51.rst
> > F: test/nokia_rx51_test.sh
> > diff --git a/doc/board/index.rst b/doc/board/index.rst
> > index 747511f7ddd2..4c470abbac02 100644
> > --- a/doc/board/index.rst
> > +++ b/doc/board/index.rst
> > @@ -19,6 +19,7 @@ Board-specific doc
> > intel/index
> > kontron/index
> > microchip/index
> > + nokia/index
> > rockchip/index
> > sifive/index
> > sipeed/index
> > diff --git a/doc/board/nokia/index.rst b/doc/board/nokia/index.rst
> > new file mode 100644
> > index ..fb0db2f34244
> > --- /dev/null
> > +++ b/doc/board/nokia/index.rst
> > @@ -0,0 +1,7 @@
> > +Nokia
> > +=
> > +
> > +.. toctree::
> > + :maxdepth: 2
> > +
> > + rx51
> > diff --git a/doc/README.nokia_rx51 b/doc/board/nokia/rx51.rst
> > similarity index 32%
> > rename from doc/README.nokia_rx51
> > rename to doc/board/nokia/rx51.rst
> > index e739b02088ea..c84fdcddf166 100644
> > --- a/doc/README.nokia_rx51
> > +++ b/doc/board/nokia/rx51.rst
> > @@ -1,6 +1,7 @@
> > -Board: Nokia RX-51 aka N900
> > +Nokia RX-51 aka N900
> > +
> >
> > -This board definition results in a u-boot.bin which can be chainloaded
> > +This board definition results in a ``u-boot.bin`` which can be chainloaded
> > from NOLO in qemu or on a real N900. It does very little hardware config
> > because NOLO has already configured the board. Only needed is enabling
> > internal eMMC memory via twl4030 regulator which is not enabled by NOLO.
> > @@ -8,64 +9,64 @@ internal eMMC memory via twl4030 regulator which is not
> > enabled by NOLO.
> > NOLO is expecting a kernel image and will treat any image it finds in
> > onenand as such. This u-boot is intended to be flashed to the N900 like
> > a kernel. In order to transparently boot the original kernel, it will be
> > -appended to u-boot.bin at 0x4. NOLO will load the entire image into
> > +appended to ``u-boot.bin`` at 0x4. NOLO will load the entire image into
> > (random) memory and execute u-boot, which saves hw revision, boot reason
> > and boot mode ATAGs set by NOLO. Then the bootscripts will attempt to load
> > -uImage, zImage or boot.scr from a fat or ext2/3/4 filesystem on external
> > -SD card or internal eMMC memory. If this fails or keyboard is closed then
> > -the appended kernel image will be booted using some generated and some
> > -stored ATAGs (see boot order).
> > +``uImage``, ``zImage`` or ``boot.scr`` file from a fat or ext2/3/4
> > filesystem
> > +on external SD card or internal eMMC memory. If this fails or keyboard is
> > +closed then the appended kernel image will be booted using some generated
> > +and some stored ATAGs (see boot order).
> >
> > For generating combined image of u-boot and kernel (either in uImage or
> > zImage
> > -format) there is a simple script called u-boot-gen-combined. It is
> > available in
> > -following repository:
> > +format) there is a simple script called ``u-boot-gen-combined``. It is
> > available
> > +in following repository:
> >
> > - https://github.com/pali/u-boot-maemo
> > + https://github.com/pali/u-boot-maemo
> >
> > -To generate combined.bin image from u-boot.bin and kernel.bin (either
> > uImage
> > -or zImage) use:
> > +To generate ``combined.bin`` image from ``u-boot.bin`` and ``kernel.bin``
> > +(either uImage or zImage format) use::
> >
> > - sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
> > + $ sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
> >
> > Original Maemo Fremantle PR1.3 zImage kernel binary is available at:
> >
> > -
> > http://repository.maemo.org/pool/maemo5.0/free/k/kernel/kernel_2.6.28-20103103+0m5_armel.deb
> > +
> > http://repository.maemo.org/pool/maemo5.0/free/k/kernel/kernel_2.6.28-20103103+0m5_armel.deb
> >
> > -To unpack it (from DEB/AR, TAR and FIASCO) call commands:
> > +To
Re: [PATCH] Nokia RX-51: Convert documentation to rst format
On 22/07/21 2:55 am, Pali Rohár wrote:
> Signed-off-by: Pali Rohár
> ---
> board/nokia/rx51/MAINTAINERS | 2 +-
> doc/board/index.rst | 1 +
> doc/board/nokia/index.rst | 7 +
> .../nokia/rx51.rst} | 142 +-
> 4 files changed, 83 insertions(+), 69 deletions(-)
> create mode 100644 doc/board/nokia/index.rst
> rename doc/{README.nokia_rx51 => board/nokia/rx51.rst} (32%)
This doesn't apply cleanly on latest u-boot master. Can you rebase and repost?
Thanks and regards,
Lokesh
>
> diff --git a/board/nokia/rx51/MAINTAINERS b/board/nokia/rx51/MAINTAINERS
> index 58b16bf9a95c..25f8b3c5a9ad 100644
> --- a/board/nokia/rx51/MAINTAINERS
> +++ b/board/nokia/rx51/MAINTAINERS
> @@ -4,5 +4,5 @@ S:Maintained
> F: board/nokia/rx51/
> F: include/configs/nokia_rx51.h
> F: configs/nokia_rx51_defconfig
> -F: doc/README.nokia_rx51
> +F: doc/board/nokia/rx51.rst
> F: test/nokia_rx51_test.sh
> diff --git a/doc/board/index.rst b/doc/board/index.rst
> index 747511f7ddd2..4c470abbac02 100644
> --- a/doc/board/index.rst
> +++ b/doc/board/index.rst
> @@ -19,6 +19,7 @@ Board-specific doc
> intel/index
> kontron/index
> microchip/index
> + nokia/index
> rockchip/index
> sifive/index
> sipeed/index
> diff --git a/doc/board/nokia/index.rst b/doc/board/nokia/index.rst
> new file mode 100644
> index ..fb0db2f34244
> --- /dev/null
> +++ b/doc/board/nokia/index.rst
> @@ -0,0 +1,7 @@
> +Nokia
> +=
> +
> +.. toctree::
> + :maxdepth: 2
> +
> + rx51
> diff --git a/doc/README.nokia_rx51 b/doc/board/nokia/rx51.rst
> similarity index 32%
> rename from doc/README.nokia_rx51
> rename to doc/board/nokia/rx51.rst
> index e739b02088ea..c84fdcddf166 100644
> --- a/doc/README.nokia_rx51
> +++ b/doc/board/nokia/rx51.rst
> @@ -1,6 +1,7 @@
> -Board: Nokia RX-51 aka N900
> +Nokia RX-51 aka N900
> +
>
> -This board definition results in a u-boot.bin which can be chainloaded
> +This board definition results in a ``u-boot.bin`` which can be chainloaded
> from NOLO in qemu or on a real N900. It does very little hardware config
> because NOLO has already configured the board. Only needed is enabling
> internal eMMC memory via twl4030 regulator which is not enabled by NOLO.
> @@ -8,64 +9,64 @@ internal eMMC memory via twl4030 regulator which is not
> enabled by NOLO.
> NOLO is expecting a kernel image and will treat any image it finds in
> onenand as such. This u-boot is intended to be flashed to the N900 like
> a kernel. In order to transparently boot the original kernel, it will be
> -appended to u-boot.bin at 0x4. NOLO will load the entire image into
> +appended to ``u-boot.bin`` at 0x4. NOLO will load the entire image into
> (random) memory and execute u-boot, which saves hw revision, boot reason
> and boot mode ATAGs set by NOLO. Then the bootscripts will attempt to load
> -uImage, zImage or boot.scr from a fat or ext2/3/4 filesystem on external
> -SD card or internal eMMC memory. If this fails or keyboard is closed then
> -the appended kernel image will be booted using some generated and some
> -stored ATAGs (see boot order).
> +``uImage``, ``zImage`` or ``boot.scr`` file from a fat or ext2/3/4 filesystem
> +on external SD card or internal eMMC memory. If this fails or keyboard is
> +closed then the appended kernel image will be booted using some generated
> +and some stored ATAGs (see boot order).
>
> For generating combined image of u-boot and kernel (either in uImage or
> zImage
> -format) there is a simple script called u-boot-gen-combined. It is available
> in
> -following repository:
> +format) there is a simple script called ``u-boot-gen-combined``. It is
> available
> +in following repository:
>
> - https://github.com/pali/u-boot-maemo
> + https://github.com/pali/u-boot-maemo
>
> -To generate combined.bin image from u-boot.bin and kernel.bin (either uImage
> -or zImage) use:
> +To generate ``combined.bin`` image from ``u-boot.bin`` and ``kernel.bin``
> +(either uImage or zImage format) use::
>
> - sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
> + $ sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
>
> Original Maemo Fremantle PR1.3 zImage kernel binary is available at:
>
> -
> http://repository.maemo.org/pool/maemo5.0/free/k/kernel/kernel_2.6.28-20103103+0m5_armel.deb
> +
> http://repository.maemo.org/pool/maemo5.0/free/k/kernel/kernel_2.6.28-20103103+0m5_armel.deb
>
> -To unpack it (from DEB/AR, TAR and FIASCO) call commands:
> +To unpack it (from DEB/AR, TAR and FIASCO) call commands::
>
> - ar x kernel_2.6.28-20103103+0m5_armel.deb data.tar.gz
> - tar -O -xf data.tar.gz ./boot/zImage-2.6.28-20103103+0m5.fiasco >
> kernel_2.6.28-20103103+0m5.fiasco
> - 0x -M kernel_2.6.28-20103103+0m5.fiasco -u
> + $ ar x kernel_2.6.28-20103103+0m5_armel.deb data.tar.gz
> + $ tar -O -xf
[PATCH] Nokia RX-51: Convert documentation to rst format
Signed-off-by: Pali Rohár
---
board/nokia/rx51/MAINTAINERS | 2 +-
doc/board/index.rst | 1 +
doc/board/nokia/index.rst | 7 +
.../nokia/rx51.rst} | 142 +-
4 files changed, 83 insertions(+), 69 deletions(-)
create mode 100644 doc/board/nokia/index.rst
rename doc/{README.nokia_rx51 => board/nokia/rx51.rst} (32%)
diff --git a/board/nokia/rx51/MAINTAINERS b/board/nokia/rx51/MAINTAINERS
index 58b16bf9a95c..25f8b3c5a9ad 100644
--- a/board/nokia/rx51/MAINTAINERS
+++ b/board/nokia/rx51/MAINTAINERS
@@ -4,5 +4,5 @@ S: Maintained
F: board/nokia/rx51/
F: include/configs/nokia_rx51.h
F: configs/nokia_rx51_defconfig
-F: doc/README.nokia_rx51
+F: doc/board/nokia/rx51.rst
F: test/nokia_rx51_test.sh
diff --git a/doc/board/index.rst b/doc/board/index.rst
index 747511f7ddd2..4c470abbac02 100644
--- a/doc/board/index.rst
+++ b/doc/board/index.rst
@@ -19,6 +19,7 @@ Board-specific doc
intel/index
kontron/index
microchip/index
+ nokia/index
rockchip/index
sifive/index
sipeed/index
diff --git a/doc/board/nokia/index.rst b/doc/board/nokia/index.rst
new file mode 100644
index ..fb0db2f34244
--- /dev/null
+++ b/doc/board/nokia/index.rst
@@ -0,0 +1,7 @@
+Nokia
+=
+
+.. toctree::
+ :maxdepth: 2
+
+ rx51
diff --git a/doc/README.nokia_rx51 b/doc/board/nokia/rx51.rst
similarity index 32%
rename from doc/README.nokia_rx51
rename to doc/board/nokia/rx51.rst
index e739b02088ea..c84fdcddf166 100644
--- a/doc/README.nokia_rx51
+++ b/doc/board/nokia/rx51.rst
@@ -1,6 +1,7 @@
-Board: Nokia RX-51 aka N900
+Nokia RX-51 aka N900
+
-This board definition results in a u-boot.bin which can be chainloaded
+This board definition results in a ``u-boot.bin`` which can be chainloaded
from NOLO in qemu or on a real N900. It does very little hardware config
because NOLO has already configured the board. Only needed is enabling
internal eMMC memory via twl4030 regulator which is not enabled by NOLO.
@@ -8,64 +9,64 @@ internal eMMC memory via twl4030 regulator which is not
enabled by NOLO.
NOLO is expecting a kernel image and will treat any image it finds in
onenand as such. This u-boot is intended to be flashed to the N900 like
a kernel. In order to transparently boot the original kernel, it will be
-appended to u-boot.bin at 0x4. NOLO will load the entire image into
+appended to ``u-boot.bin`` at 0x4. NOLO will load the entire image into
(random) memory and execute u-boot, which saves hw revision, boot reason
and boot mode ATAGs set by NOLO. Then the bootscripts will attempt to load
-uImage, zImage or boot.scr from a fat or ext2/3/4 filesystem on external
-SD card or internal eMMC memory. If this fails or keyboard is closed then
-the appended kernel image will be booted using some generated and some
-stored ATAGs (see boot order).
+``uImage``, ``zImage`` or ``boot.scr`` file from a fat or ext2/3/4 filesystem
+on external SD card or internal eMMC memory. If this fails or keyboard is
+closed then the appended kernel image will be booted using some generated
+and some stored ATAGs (see boot order).
For generating combined image of u-boot and kernel (either in uImage or zImage
-format) there is a simple script called u-boot-gen-combined. It is available in
-following repository:
+format) there is a simple script called ``u-boot-gen-combined``. It is
available
+in following repository:
- https://github.com/pali/u-boot-maemo
+ https://github.com/pali/u-boot-maemo
-To generate combined.bin image from u-boot.bin and kernel.bin (either uImage
-or zImage) use:
+To generate ``combined.bin`` image from ``u-boot.bin`` and ``kernel.bin``
+(either uImage or zImage format) use::
- sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
+ $ sh u-boot-gen-combined u-boot.bin kernel.bin combined.bin
Original Maemo Fremantle PR1.3 zImage kernel binary is available at:
-
http://repository.maemo.org/pool/maemo5.0/free/k/kernel/kernel_2.6.28-20103103+0m5_armel.deb
+
http://repository.maemo.org/pool/maemo5.0/free/k/kernel/kernel_2.6.28-20103103+0m5_armel.deb
-To unpack it (from DEB/AR, TAR and FIASCO) call commands:
+To unpack it (from DEB/AR, TAR and FIASCO) call commands::
- ar x kernel_2.6.28-20103103+0m5_armel.deb data.tar.gz
- tar -O -xf data.tar.gz ./boot/zImage-2.6.28-20103103+0m5.fiasco >
kernel_2.6.28-20103103+0m5.fiasco
- 0x -M kernel_2.6.28-20103103+0m5.fiasco -u
+ $ ar x kernel_2.6.28-20103103+0m5_armel.deb data.tar.gz
+ $ tar -O -xf data.tar.gz ./boot/zImage-2.6.28-20103103+0m5.fiasco >
kernel_2.6.28-20103103+0m5.fiasco
+ $ 0x -M kernel_2.6.28-20103103+0m5.fiasco -u
-Flashed image must start with 2 kB "NOLO!img" header which contains size of
-the image. Header consist of bytes "NOLO!img\x02\x00\x00\x00\x00\x00\x00\x00"
+Flashed image must start with 2 kB ``NOLO!img`` header which contains size of
