a5061ecec5
An effort was started some time ago to consolidate all internal documentation in the git tree. However, this was just an accumulation of files in various formats without any strucutre or way to browse it, which results in no one even knowing that we have docs here. This converts most of the files to restructuredtext and uses Sphinx to generate an HTML browsable user manual (with a table of content and a first attempt to put things in a global hierarchy). There are almost no changes to the documentation content in this commit (some obviously obsolete things were removed). The plan is to get the toolchain up and running to make these docs easily available, and only then see about improving the content. We can migrate some things off the wiki and website, and rework the table of contents to have some more hierarchy levels because currently it's a bit messy. Change-Id: I924ac9dc6e753887ab56f18a09bdb0a1e1793bfd Reviewed-on: https://review.haiku-os.org/c/haiku/+/4370 Reviewed-by: Niels Sascha Reedijk <niels.reedijk@gmail.com>
120 lines
3.2 KiB
ReStructuredText
120 lines
3.2 KiB
ReStructuredText
The Sam460ex Haiku port
|
|
=======================
|
|
|
|
Complications for this port comes from the fact that the CPU used was designed for embedded devices,
|
|
and has a much simpler MMU than the one on desktop machines. As a result, completely different
|
|
memory management code needs to be written.
|
|
|
|
U-Boot commands
|
|
---------------
|
|
|
|
no-fdt no-initrd
|
|
****************
|
|
|
|
seems the U-Boot input buffer is quite limited, can't paste much more on single line in minicom
|
|
|
|
setenv ipaddr 192.168.4.100; tftpboot 0x4000000 192.168.4.2:haiku_loader_linux.ub; bootm 0x4000000
|
|
|
|
with FDT and tgz as initrd
|
|
**************************
|
|
|
|
setenv ipaddr 192.168.4.100
|
|
tftpboot 0x4000000 192.168.4.2:haiku_loader_linux.ub
|
|
tftpboot 0x8000000 192.168.4.2:haiku_initrd.ub
|
|
tftpboot 0xc000000 192.168.4.2:sam460ex.dtb
|
|
fdt addr 0xc000000
|
|
fdt header
|
|
bootm 0x4000000 0x8000000 0xc000000 plop
|
|
|
|
for environment
|
|
***************
|
|
|
|
setenv booth1 'setenv ipaddr 192.168.4.100; tftpboot 0x4000000 192.168.4.2:haiku_loader_linux.ub'
|
|
setenv booth2 'tftpboot 0x8000000 192.168.4.2:haiku_initrd.ub'
|
|
setenv booth3 'tftpboot 0xc000000 192.168.4.2:sam460ex.dtb'
|
|
setenv booth4 'bootm 0x4000000 0x8000000 0xc000000 plop'
|
|
setenv booth 'run booth1; run booth2; run booth3; run booth4'
|
|
saveenv
|
|
run booth
|
|
|
|
TODOs
|
|
-----
|
|
|
|
* U-Boot API?
|
|
* move Partenope hack to proper official U-Boot API?
|
|
* reserved regs?
|
|
|
|
BoardSetup +=:?
|
|
TARGET_BOOT_CCFLAGS += -ffixed-r2 -ffixed-r14 -ffixed-r29 ;
|
|
TARGET_BOOT_C++FLAGS += -ffixed-r2 -ffixed-r14 -ffixed-r29 ;
|
|
|
|
* kdebug/disasm/ppc http://code.google.com/p/ppcd/
|
|
|
|
Other ports
|
|
-----------
|
|
|
|
* `AROS port <https://www.gitorious.org/aros/aros/commits/sam460>`_
|
|
* `Linux port <http://kernel.org/doc/ols/2003/ols2003-pages-340-350.pdf>`_
|
|
* `NetBSD <https://wiki.netbsd.org/users/rkujawa/sam4x0/>`_
|
|
|
|
PowerPC information
|
|
-------------------
|
|
|
|
Classic
|
|
*******
|
|
|
|
* http://class.ee.iastate.edu/cpre211/labs/quickrefPPC.html
|
|
* http://www.ibm.com/developerworks/library/l-ppc/
|
|
* http://www.csd.uwo.ca/~mburrel/stuff/ppc-asm.html
|
|
|
|
Book-E
|
|
******
|
|
|
|
* http://www.linux-kvm.org/page/PowerPC_Book_E_MMU
|
|
* http://wiki.freebsd.org/powerpc/BookE
|
|
* http://en.wikipedia.org/wiki/Memory_management_unit#PowerPC
|
|
|
|
ePAPR
|
|
*****
|
|
|
|
* https://www.power.org/wp-content/uploads/2012/06/Power_ePAPR_APPROVED_v1.1.pdf
|
|
* PPC440: http://elinux.org/Book_E_and_PPC_440
|
|
|
|
amcc 4x0
|
|
********
|
|
|
|
* http://c0ff33.net/drop/PPC440_UM2013.pdf
|
|
* http://www.embeddeddeveloper.com/assets/processors/amcc/datasheets/PP460EX_DS2063.pdf
|
|
|
|
Freescale 440
|
|
*************
|
|
|
|
This version has a different mmu!!
|
|
|
|
* http://www.freescale.com/files/32bit/doc/white_paper/POWRPCARCPRMRM.pdf
|
|
|
|
FDT
|
|
---
|
|
|
|
* http://www.denx.de/wiki/U-Boot/UBootFdtInfo
|
|
* http://wiki.freebsd.org/FlattenedDeviceTree#Supporting_library_.28libfdt.29
|
|
* (see also arm docs)
|
|
|
|
Sam440 dts
|
|
**********
|
|
|
|
* http://lxr.linux.no/linux+v3.4/arch/powerpc/boot/dts/sam440ep.dts
|
|
* Sam460ex dts: identical to amcc,Canyonlands !?
|
|
* http://www.denx.de/wiki/view/DULG/Appendix#Section_13.1.
|
|
|
|
OpenFirmware framebuffer
|
|
************************
|
|
|
|
(not really usable from U-Boot (yet?))
|
|
|
|
* http://www.feedface.com/howto/forth.html
|
|
* http://mail-index.netbsd.org/port-macppc/2004/12/13/0046.html
|
|
* http://lists.freebsd.org/pipermail/svn-src-user/2012-January/004806.html
|
|
* http://www.openfirmware.info/Bindings
|
|
|