update readme files

diff --git a/README.md b/README.md
index 98fc54d..7d15497 100644 (file)
--- a/README.md
+++ b/README.md
@@ -41,9 +41,10 @@ be activated via the `Keyboard` emulator hotkey.
 Both physical keyboard support and a virtual keyboard overlay are available.
 Physical keyboards are assigned a default key mapping corresponding to an
 American PC layout, but the mapping can be redefined in the `Controls`
-configuration menu. Note that only 'unmodified' physical key presses can be
-mapped to emulated keyboard input; special characters entered via 'shift'
-key combinations may not match the emulated keyboard layout.
+configuration menu. Note that only 'unmodified' physical key presses (e.g.
+`A`, `1` etc) can be mapped to emulated keyboard input; special characters
+entered via modifier/meta keys (e.g. `Ctrl`, `Shift` etc) will not work.
+Additional information may be found in `platform/base_readme.txt`.
 
 ### Sega SC-3000 Cassette Drive
 

diff --git a/platform/base_readme.txt b/platform/base_readme.txt
index dce9472..cd5030e 100644 (file)
--- a/platform/base_readme.txt
+++ b/platform/base_readme.txt
@@ -100,6 +100,45 @@ positioning is done through the D-pad if the screen has been switched to either
 pages or pad.\r
 \r
 \r
+How to load SC-3000 tapes\r
+-------------------------\r
+\r
+The SC-3000 microcomputer has a connector for connecting a cassette tape drive\r
+to it. PicoDrive supports using tape recordings in WAV or bitstream format.\r
+Run one of the BASIC cartridges, then load the tape with the "Load tape" menu.\r
+Entering the LOAD command using the keyboard emulation automatically starts\r
+the emulated tape drive. You will get a confirmation after the tape has been\r
+loaded.\r
+\r
+The emulated tape drive has an automatic start/stop feature. Tapes requiring\r
+several load operations don't need any additional handling.\r
+\r
+\r
+How to use keyboard input\r
+-------------------------\r
+\r
+Both the SC-3000 and the Sega Pico support keyboard input. To activate keyboard\r
+input in PicoDrive, press the "Switch keyboard" emulator hotkey while running\r
+a cartridge with keyboard support. Depending on the keyboard configuration\r
+settings, either the physical or the virtual keyboard can be used.\r
+\r
+If the physical keyboard is configured, activating the keyboard will switch off\r
+all other hotkeys as well as pad functions. All keyboard input is routed to\r
+the emulated keyboard, as configured in the physical keyboard mapping.\r
+\r
+The virtual keyboard displays an overlay when activated. The currently selected\r
+key is highlighted, and the selection can be changed with the left, right, up,\r
+and down keys. Pressing the A button will send the selected key to the emulated\r
+keyboard. Pressing B will show what the key value would be if the emulated Shift\r
+key is active. The C button will move the keyboard overlay from the top of the\r
+screen to the bottom and vice versa.\r
+\r
+All meta keys, like Shift, Ctrl, have a built-in toggle function. Pressing the\r
+A button on them will toggle their state between pressed and released. Depending\r
+on the state the color of the key changes slightly. Only one meta key can be\r
+active at the same time.\r
+\r
+\r
 Other important stuff\r
 ---------------------\r
 \r
@@ -427,6 +466,11 @@ unit. Some games made use of this for providing better music and effects.
 Disabling this improves performance for games using the FM unit, and usually\r
 means falling back to the non-FM sound.\r
 \r
+@@7. "SMS palette in TMS modes"\r
+The Master System graphics chip can emulate the TMS grafic modes used in MSX and\r
+SG-1000 games, but it is using a color palette which is much darker and the\r
+colours aren't a good match. This option uses the original color palette of the\r
+TMS graphics chip, which gives better results for MSX/SG-1000 ports.\r
 \r
 Advanced options\r
 ----------------\r
@@ -468,7 +512,8 @@ It also decodes MP3s in Sega/Mega CD mode.
 Key configuration\r
 -----------------\r
 \r
-Select "Configure controls" from the options menu. Then selecting "Player <n>"\r
+Select "Configure controls" from the options menu. The "Player <n>" entry allows\r
+for selecting a player with the left/right buttons. Then selecting "Player <n>"\r
 will display 2 columns. The left column lists names of Genesis/MD controller\r
 buttons, the right column shows which key on your handheld is assigned to it.\r
 \r
@@ -480,6 +525,21 @@ device 1, and the game is supporting this. Only 3 button pads are currently
 supported in 4 player mode.\r
 \r
 \r
+Keyboard configuration\r
+----------------------\r
+\r
+The SC-3000 and the Sega Pico can use a keyboard as input device. Select\r
+"Configure controls" to configure keyboard support in PicoDrive. The "Keyboard"\r
+entry allows choosing the keyboard type by using the left/right buttons. The\r
+virtual keyboard doesn't need any configuration. For configuring the physical\r
+keyboard mapping, select "Keyboard" when the physical keyboard is selected.\r
+\r
+Physical host keyboard keys are mapped 1:1 on emulated keyboard keys. Only the\r
+unmodified base keys (like A, 1 etc) can be mapped. Don't use Shift, Ctrl or\r
+Alt when changing the mapping, as it won't work. The default mapping matches\r
+a standard American PC104 keyboard.\r
+\r
+\r
 Cheat support\r
 -------------\r
 \r