playstation2: add README, FREEMCB.CNF sample, .editorconfig & .gitattributes handling for md/doctoc

Ref: thlorenz/doctoc#161

gayming/playstation2/.editorconfig

@@ -7,3 +7,7 @@ end_of_line = crlf
 [*.{sh,bash}]
 # Not for PS2 consumption
 end_of_line = lf
+
+[*.md]
+# https://github.com/thlorenz/doctoc/issues/161
+end_of_line = lf

gayming/playstation2/.gitattributes

@@ -4,3 +4,5 @@
 * text=auto eol=crlf
 # Not for PS2 consumption
 *.bash text eol=lf
+# https://github.com/thlorenz/doctoc/issues/161
+*.md text eol=lf

gayming/playstation2/FreeMCB/INSTALL/SYS-CONF/FREEMCB.CNF

@@ -0,0 +1,89 @@
+# ----------------------------------------
+# Free MCBoot Config File
+# must be in mc?:/SYS-CONF/FREEMCB.CNF or mass:/FREEMCB.CNF
+# ----------------------------------------
+CNF_version = 1
+# ----------------------------------------
+Debug_Screen = 0
+FastBoot = 1
+ESR_Path_E1 = mass:/BOOT/ESR.ELF
+ESR_Path_E2 = mc?:/BOOT/ESR.ELF
+ESR_Path_E3 = mc?:/B?DATA-SYSTEM/ESR.ELF
+pad_delay = 0
+LK_Auto_E1 = OSDSYS
+LK_Circle_E1 = OSDSYS
+LK_Cross_E1 = OSDSYS
+LK_Square_E1 = OSDSYS
+LK_Triangle_E1 = OSDSYS
+LK_L1_E1 = mass:/BOOT/HDLOADER.ELF
+LK_L1_E2 = mc?:/BOOT/HDLOADER.ELF
+LK_L1_E3 = mc?:/B?DATA-SYSTEM/HDLOADER.ELF
+LK_R1_E1 = mass:/BOOT/BOOT.ELF
+LK_R1_E2 = mc?:/BOOT/BOOT.ELF
+LK_R1_E3 = mc?:/B?DATA-SYSTEM/BOOT.ELF
+LK_L2_E1 = mass:/BOOT/SMS.ELF
+LK_L2_E2 = mc?:/BOOT/SMS.ELF
+LK_L2_E3 = mc?:/B?DATA-SYSTEM/SMS.ELF
+LK_R2_E1 = mass:/BOOT/ESR.ELF
+LK_R2_E2 = mc?:/BOOT/ESR.ELF
+LK_R2_E3 = mc?:/B?DATA-SYSTEM/ESR.ELF
+LK_L3_E1 = OSDSYS
+LK_R3_E1 = OSDSYS
+LK_Up_E1 = OSDSYS
+LK_Down_E1 = OSDSYS
+LK_Left_E1 = OSDSYS
+LK_Right_E1 = OSDSYS
+LK_Start_E1 = mc?:/SYS-CONF/FMCB_CFG.ELF
+LK_Start_E2 = OSDSYS
+LK_Select_E1 = OSDSYS
+hacked_OSDSYS = 1
+OSDSYS_video_mode = AUTO
+OSDSYS_Skip_Logo = 1
+OSDSYS_Skip_Disc = 0
+OSDSYS_Inner_Browser = 0
+OSDSYS_selected_color = 0x10,0x80,0xE0,0x80
+OSDSYS_unselected_color = 0x33,0x33,0x33,0x80
+OSDSYS_scroll_menu = 1
+OSDSYS_menu_x = 320
+OSDSYS_menu_y = 110
+OSDSYS_enter_x = 30
+OSDSYS_enter_y = -1
+OSDSYS_version_x = -1
+OSDSYS_version_y = -1
+OSDSYS_cursor_max_velocity = 1000
+OSDSYS_cursor_acceleration = 100
+OSDSYS_left_cursor = o009
+OSDSYS_right_cursor = o008
+OSDSYS_menu_top_delimiter = y-99Free MCBoot              c1[r0.80Version %VER%r0.00]y-00
+OSDSYS_menu_bottom_delimiter = c0r0.60y+99Use o006/o007 to browse listy-00r0.00
+OSDSYS_num_displayed_items = 7
+OSDSYS_Skip_MC = 1
+OSDSYS_Skip_HDD = 1
+name_OSDSYS_ITEM_1 = LaunchELF
+path1_OSDSYS_ITEM_1 = mass:/BOOT/BOOT.ELF
+path2_OSDSYS_ITEM_1 = mc?:/BOOT/BOOT.ELF
+path3_OSDSYS_ITEM_1 = mc?:/B?DATA-SYSTEM/BOOT.ELF
+name_OSDSYS_ITEM_2 = ESR
+path1_OSDSYS_ITEM_2 = mass:/BOOT/ESR.ELF
+path2_OSDSYS_ITEM_2 = mc?:/BOOT/ESR.ELF
+path3_OSDSYS_ITEM_2 = mc?:/B?DATA-SYSTEM/ESR.ELF
+name_OSDSYS_ITEM_3 = HD Loader
+path1_OSDSYS_ITEM_3 = mass:/BOOT/HDLOADER.ELF
+path2_OSDSYS_ITEM_3 = mc?:/BOOT/HDLOADER.ELF
+path3_OSDSYS_ITEM_3 = mc?:/B?DATA-SYSTEM/HDLOADER.ELF
+name_OSDSYS_ITEM_4 = Simple Media System
+path1_OSDSYS_ITEM_4 = mass:/BOOT/SMS.ELF
+path2_OSDSYS_ITEM_4 = mc?:/BOOT/SMS.ELF
+path3_OSDSYS_ITEM_4 = mc?:/B?DATA-SYSTEM/SMS.ELF
+name_OSDSYS_ITEM_5 = Launch disc
+path1_OSDSYS_ITEM_5 = FASTBOOT
+name_OSDSYS_ITEM_6 = OpenPS2Loader
+path1_OSDSYS_ITEM_6 = mass:/BOOT/OPNPS2LD-v1.1.0.ELF
+path2_OSDSYS_ITEM_6 = mc?:/BOOT/OPNPS2LD-v1.1.0.ELF
+path3_OSDSYS_ITEM_6 = mc?:/B?DATA-SYSTEM/OPNPS2LD-v1.1.0.ELF
+name_OSDSYS_ITEM_98 = Free MCBoot Configurator
+path1_OSDSYS_ITEM_98 = mc?:/SYS-CONF/FMCB_CFG.ELF
+name_OSDSYS_ITEM_99 = Restart System
+path1_OSDSYS_ITEM_99 = OSDSYS
+name_OSDSYS_ITEM_100 = Shutdown System
+path1_OSDSYS_ITEM_100 = POWEROFF

gayming/playstation2/README.md

@@ -0,0 +1,129 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [PlayStation 2 notes](#playstation-2-notes)
+  - [PlayStation 2 System Configuration](#playstation-2-system-configuration)
+  - [TV configuration](#tv-configuration)
+  - [Samba](#samba)
+  - [FreeMCBoot](#freemcboot)
+    - [FreeMCBoot Installer configuration](#freemcboot-installer-configuration)
+    - [FreeMCBoot Configurator](#freemcboot-configurator)
+  - [Open PS2 Loader configuration](#open-ps2-loader-configuration)
+    - [VMC configuration](#vmc-configuration)
+      - [Why share VMC?](#why-share-vmc)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+# PlayStation 2 notes
+
+I have a ProCaster TV which isn't anything special unless it not being smart
+counts. PS2 is connected through
+[RCA HDMI adapter/signal converter](https://infshop.fi/hdmi/92919-rca-hdmi-sovitin-signaalimuunnin-7314280105281.html)
+
+NOTE! This directory contains `.editorconfig` and `.gitattributes` as for
+some reason everything related to PS2 is using `crlf` (aka "Windows style")
+line-endings, so I am assuming that using `lf` would just mean things won't
+work, so be cautious when editing things.  
+The `file` command may be helpful e.g.
+
+```bash
+% file SCES_509.16.cfg
+SCES_509.16.cfg: ASCII text, with CRLF line terminators
+```
+
+## PlayStation 2 System Configuration
+
+_System Configuration_ is the second option when booting without a disc.
+
+- Screen Size: `16:9` as screens aren't squares nowadays (if yours was, `4:3` or `full`)
+- Digital Out (Optical): mine says `On` although I don't remember touching it
+- Component Video Out: `Y Cb/Pb Cr/Pr` removed letterboxing for me.
+
+## TV configuration
+
+My TV has an aspect ratio setting and the universal remote control I am using has a `16:9` button that I just kept pressing until it said `16:9`
+
+## Samba
+
+- https://gitea.blesmrt.net/mikaela/shell-things/src/branch/master/etc/samba/playstation2.conf
+- Remember firewalls!
+  - `sudo ufw allow samba`
+  - `sudo firewall-cmd --add-service=samba --permanent --zone=home && sudo firewall-cmd --reload`
+
+## FreeMCBoot
+
+I downloaded it from [ps2-home.com](https://www.ps2-home.com/forum/viewtopic.php?f=11&t=1890) which apparently removes `BOOT/LAUNCHELF.CNF` which is reported to cause black screens.
+
+### FreeMCBoot Installer configuration
+
+If you place files in `INSTALL/BOOT` directory of FreeMCBoot installation
+device, those will get copied to the memory card saving time and effort.  
+However they may not get automatically added to the menu, unless they are
+added into `INSTALL/SYS-CONF/FREEMCB.CNF`.
+
+While it's included here for reference, DON'T USE IT DIRECTLY just in case,
+use something like `code --diff` to compare it with your file and just use
+the piece if necessary.
+
+The relevant piece is near the end,
+
+```
+name_OSDSYS_ITEM_6 = OpenPS2Loader
+path1_OSDSYS_ITEM_6 = mass:/BOOT/OPNPS2LD-v1.1.0.ELF
+path2_OSDSYS_ITEM_6 = mc?:/BOOT/OPNPS2LD-v1.1.0.ELF
+path3_OSDSYS_ITEM_6 = mc?:/B?DATA-SYSTEM/OPNPS2LD-v1.1.0.ELF
+```
+
+In my case nothing else was using the ITEM6, so I copied prior example and put it in place. I also had a `ESR.ELF` named there, while I had to add OpenPS2Loader.
+
+### FreeMCBoot Configurator
+
+_FreeMCBoot Configurator_ is the seventh option for me and I set the following so that the boot animation with the boxes play, because of both nostalgia and the secret there :wink:
+
+- Configure OSDSYS options
+  - Skip Disc Boot: `OFF`
+  - Skip Sony LOGO: `OFF`
+  - RETURN
+- Save CMF to MC<0|1>
+- EXIT
+
+## Open PS2 Loader configuration
+
+Start (menu), settings. This is mostly personal opinions too.
+
+- PS2 Logo: `on`
+  - Some games allow progressive scanning by holding Triangle and Cross when the logo appears, so seeing them is easier.
+- Write Operations `On`
+  - Required for using same VMC across multiple games. [ps2homebrew/Open-PS2-Loader#654 (Comment)](https://github.com/ps2homebrew/Open-PS2-Loader/issues/654#issuecomment-1140989005)
+- Remember Last Played Game `On` Auto Start `9`
+- ETH Device Start Mode `auto`
+- Default Menu `ETH Games`
+
+Controller settings
+
+- Configure PADEMU
+  - Settings Mode: `Global`
+  - Pad Emulator `Off`
+    - Required for some games to work [Open-PS2-Loader#842](https://github.com/ps2homebrew/Open-PS2-Loader/issues/842)
+      - I experienced this with _Kingdom Hearts II_ not having background music.
+
+Network Settings don't have anything special to note. Remember to `save changes`
+
+### VMC configuration
+
+- Select a game and press `Triangle` for `Options`
+- Configure VMC
+- This should be clear without extra documentation
+- Remember to `Save Changes`
+
+#### Why share VMC?
+
+Using VMC shares space on the physical memory card and makes backups easier (e.g. script in this directory). When all games have their own memory card, there is less to lose if something goes wrong.
+
+However there are games that give some benefit for having played other games e.g.
+
+- If you have a Ratchet & Clank save on your memory card
+  - Ratchet & Clank 2 provides the weapons returning from it for free.
+  - Ratchet & Clank 3 provides skin and employee discount in vendors.
+- If you have a Ratchet & Clank 2 save on your memory card
+  - Ratchet & Clank 3 provides the weapons returing from 2 for free.