diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/README.hwconfig | 50 | ||||
-rw-r--r-- | doc/README.imximage | 4 | ||||
-rw-r--r-- | doc/README.mpc8536ds | 2 |
3 files changed, 53 insertions, 3 deletions
diff --git a/doc/README.hwconfig b/doc/README.hwconfig new file mode 100644 index 0000000..cf54965 --- /dev/null +++ b/doc/README.hwconfig @@ -0,0 +1,50 @@ +To enable this feature just define CONFIG_HWCONFIG in your board +config file. + +This implements a simple hwconfig infrastructure: an +interface for software knobs to control hardware. + +This a is very simple implementation, i.e. it is implemented +via the `hwconfig' environment variable. Later we could write +some "hwconfig <enable|disable|list>" commands, ncurses +interface for Award BIOS-like interface, and frame-buffer +interface for AMI GUI[1] BIOS-like interface with mouse +support[2]. + +Current implementation details/limitations: + +1. Doesn't support options dependencies and mutual exclusion. + We can implement this by integrating apt-get[3] into Das + U-Boot. But I haven't bothered yet. + +2. Since we don't implement a hwconfig command, i.e. we're working + with the environement directly, there is no way to tell that + toggling a particular option will need a reboot to take + effect. So, for now it's advised to always reboot the + target after modifying the hwconfig variable. + +3. We support hwconfig options with arguments. For example, + + set hwconfig "dr_usb:mode=peripheral,phy_type=ulpi" + + This selects three hwconfig options: + 1. dr_usb - enable Dual-Role USB controller; + 2. dr_usb_mode:peripheral - USB in Function mode; + 3. dr_usb_phy_type:ulpi - USB should work with ULPI PHYs. + +The purpose of this simple implementation is to refine the +internal API and then we can continue improving the user +experience by adding more mature interfaces, like a hwconfig +command with bells and whistles. Or not adding, if we feel +that the current interface fits people's needs. + +[1] http://en.wikipedia.org/wiki/American_Megatrends +[2] Regarding ncurses and GUI with mouse support -- I'm just + kidding. +[3] The comment regarding apt-get is also a joke, meaning that + dependency tracking could be non-trivial. For example, for + enabling HW feature X we may need to disable Y, and turn Z + into reduced mode (like RMII-only interface for ethernet, + no MII). + + It's quite trivial to implement simple cases though. diff --git a/doc/README.imximage b/doc/README.imximage index 9048ef6..3378f7e 100644 --- a/doc/README.imximage +++ b/doc/README.imximage @@ -159,8 +159,8 @@ Disk /dev/mmcblk0: 1967 MB, 1967128576 bytes Units = cylinders of 16065 * 512 = 8225280 bytes Disk identifier: 0xb712a870 - Device Boot Start End Blocks Id System -/dev/mmcblk0p1 3 16 112455 83 Linux + Device Boot Start End Blocks Id System +/dev/mmcblk0p1 3 16 112455 83 Linux I have set 100MB, leaving the first 2 sectors free. I will copy u-boot there. diff --git a/doc/README.mpc8536ds b/doc/README.mpc8536ds index 4d0bee0..2a38bd6 100644 --- a/doc/README.mpc8536ds +++ b/doc/README.mpc8536ds @@ -98,7 +98,7 @@ For boot from eSDHC: | 0x90-0x93 | 0xFF720000 | Config Addr 3 | | 0x94-0x97 | 0x80010000 | Config Data 3 | -------------------------------------------------------- - | 0x98-0x9b | 0xFF72e40e | Config Addr 4 | + | 0x98-0x9b | 0xFF72e40c | Config Addr 4 | | 0x9c-0x9f | 0x00000040 | Config Data 4 | -------------------------------------------------------- | 0xa0-0xa3 | 0x40000001 | Config Addr 5 | |