Final touches to documentation, adding firmware files to the git repo

FPGA/ocm-pld v3.9x/LEIAME.MD

@@ -24,6 +24,27 @@ não tem uma característica ou a combinação que quer, NÃO USE UM FIRMWARE DE
 OUTRO DISPOSITIVO, IRÁ BRICAR SEU DISPOSITIVO E SÓ IRÁ VOLTAR A FUNCIONAR SE
 USAR UMA USB BLASTER E UM PC. VOCÊ FOI AVISADO!
 
+# Estou perdido e não sei o que escolher
+
+O arquivo ESCOLHENDO.TXT irá lhe ajudar, mas se quer a versão curta da estória:
+primeiro baixe o arquivo ocmsm_XXXX_3.9.1plus.7z aonde XXXX é o seu dispositvo.
+IMPORTANTE: SM-X HB Mini É UM DISPOSITIVO SM-X HB E USA OS ARQUIVOS DO SM-X HB.
+NUNCA JAMAIS PENSE EM USAR SM-X Mini PARA UM SM-X HB Mini! Via de regra a
+versão mais divertida e interessante para a maioria, na minha opinião, é a
+FRANKY com a língua do seu teclado PS/2, dual EPBIOS e backslash. Essa versão
+permite rodar jogos do Coleco (COL4MMM, use versão COM - Franky), SG1000 
+(SG1000 ou SSMS) e de Master System (SSMS ou jogos convertidos). Note que no
+SMX-HB se abre mão do Mouse PS/2 como mouse MSX, MIDI e PCM do Turbo-R quando
+utilizando essa versão.
+
+# Não gosto de ler manuais, como atualizo?
+
+Leia acima, e pegue a versão correta pro seu dispositivo, dentro do arquivo há
+um arquivo PLD e outro arquivo JIC. Copie o arquivo PLD junto com o arquivo
+SMXFLASH.COM pro seu cartão, e no MSX DOS execute SMXFLASH OCM-SM.PLD
+
+Porém, não irá aproveitar muito as novidades se não ler o MINI-MANUAL-PT-BR.txt
+
 # Novidades em relação a v3.9d
 
 - Incorporadas todas mudanças da 3.9.1 que ainda não estavam na 3.9d, verifique
@@ -32,6 +53,9 @@ USAR UMA USB BLASTER E UM PC. VOCÊ FOI AVISADO!
   podem não funcionar com o novo controlador a menos que faça algumas mudanças
   propostas no hardware.
 
+- Três "sabores" disponíveis, normal, Franky e Snd. Veja na tabela o que cada
+  uma tem ou não. Para MC2P existe uma única versão com tudo junto.
+
 # Notas de liberação da versão
 
 OCM-PLD v3.9.1plus é uma extensão da OCM v3.9.1 do KdL. O que essa versão tem
@@ -48,13 +72,6 @@ de diferente:
       (HB e EX apenas), tem suas peculiaridades (algumas não se aplicam ao HB
       MINI que usa apenas teclados PS/2):
 
-        - Permite o debounce das portas de joystick ser desligado, talvez possa
-        ajudar com problemas que algumas pessoas estavam tendo com paddles.
-        Para desligar o debounce use o comando SETSMART -89 , para religar use
-        SETSMART -8A , ao desligar e religar a placa, o padrão é debounce
-        ligado. NOTA: temporariamente essa opção está indisponível e o debounce
-        está permanentemente ativado independente da seleção. (HB,EX e HB MINI)
-
         - Suporte a um terceiro mapa de teclados, então tem o mapa da versão
         (us/br/fr/es/it) e japonês se usar PS/2 e um para o teclado do Hotbit
         ou Expert. Os teclados do Hotbit/Expert não seguem o padrão dos

FPGA/ocm-pld v3.9x/docs/LEIAME.MD

@@ -26,12 +26,16 @@ USAR UMA USB BLASTER E UM PC. VOCÊ FOI AVISADO!
 
 # Estou perdido e não sei o que escolher
 
-O arquivo ESCOLHENDO.TXT irá lhe ajudar, via de regra a versão mais divertida e
-interessante para a maioria, na minha opinião, é a FRANKY com a língua do seu
-teclado PS/2, dual EPBIOS e backslash. Essa versão permite rodar jogos do
-Coleco (COL4MMM, use versão COM - Franky), SG1000 (SG1000 ou SSMS) e de Master
-System (SSMS ou jogos convertidos). Note que no SMX-HB se abre mão do Mouse
-PS/2 como mouse MSX, MIDI e PCM do Turbo-R quando utilizando essa versão.
+O arquivo ESCOLHENDO.TXT irá lhe ajudar, mas se quer a versão curta da estória:
+primeiro baixe o arquivo ocmsm_XXXX_3.9.1plus.7z aonde XXXX é o seu dispositvo.
+IMPORTANTE: SM-X HB Mini É UM DISPOSITIVO SM-X HB E USA OS ARQUIVOS DO SM-X HB.
+NUNCA JAMAIS PENSE EM USAR SM-X Mini PARA UM SM-X HB Mini! Via de regra a
+versão mais divertida e interessante para a maioria, na minha opinião, é a
+FRANKY com a língua do seu teclado PS/2, dual EPBIOS e backslash. Essa versão
+permite rodar jogos do Coleco (COL4MMM, use versão COM - Franky), SG1000 
+(SG1000 ou SSMS) e de Master System (SSMS ou jogos convertidos). Note que no
+SMX-HB se abre mão do Mouse PS/2 como mouse MSX, MIDI e PCM do Turbo-R quando
+utilizando essa versão.
 
 # Não gosto de ler manuais, como atualizo?
 

FPGA/ocm-pld v3.9x/docs/README.MD

@@ -30,7 +30,10 @@ USING USB BLASTER AND A PC. YOU'VE BEEN WARNED!
 
 # I'm lost and don't know what version to choose for my device
 
-CHOOSING.TXT file will help you, my first recommendation as the version I use
+CHOOSING.TXT file will help you, but the Lazy Couch Penguin version is: first
+get ocmsm_XXXX_3.9.1plus.7z file where XXXX is your device name. IMPORTANT:
+SM-X HB Mini IS A SM-X HB DEVICE AND USES SM-X HB FILES. NEVER, EVER THINK ON
+USING SM-X Mini FOR SM-X HB Mini! My first recommendation as the version I use
 and find it funnier and more interesting is the FRANKY version, language that
 matches the layout of your PS/2 keyboard, dual EPBIOS and backslash. It allows
 you to play Coleco (COL4MMM, use COM - Franky version), SG1000 (SG1000 or SSMS)
@@ -298,12 +301,16 @@ USAR UMA USB BLASTER E UM PC. VOCÊ FOI AVISADO!
 
 # Estou perdido e não sei o que escolher
 
-O arquivo ESCOLHENDO.TXT irá lhe ajudar, via de regra a versão mais divertida e
-interessante para a maioria, na minha opinião, é a FRANKY com a língua do seu
-teclado PS/2, dual EPBIOS e backslash. Essa versão permite rodar jogos do
-Coleco (COL4MMM, use versão COM - Franky), SG1000 (SG1000 ou SSMS) e de Master
-System (SSMS ou jogos convertidos). Note que no SMX-HB se abre mão do Mouse
-PS/2 como mouse MSX, MIDI e PCM do Turbo-R quando utilizando essa versão.
+O arquivo ESCOLHENDO.TXT irá lhe ajudar, mas se quer a versão curta da estória:
+primeiro baixe o arquivo ocmsm_XXXX_3.9.1plus.7z aonde XXXX é o seu dispositvo.
+IMPORTANTE: SM-X HB Mini É UM DISPOSITIVO SM-X HB E USA OS ARQUIVOS DO SM-X HB.
+NUNCA JAMAIS PENSE EM USAR SM-X Mini PARA UM SM-X HB Mini! Via de regra a
+versão mais divertida e interessante para a maioria, na minha opinião, é a
+FRANKY com a língua do seu teclado PS/2, dual EPBIOS e backslash. Essa versão
+permite rodar jogos do Coleco (COL4MMM, use versão COM - Franky), SG1000 
+(SG1000 ou SSMS) e de Master System (SSMS ou jogos convertidos). Note que no
+SMX-HB se abre mão do Mouse PS/2 como mouse MSX, MIDI e PCM do Turbo-R quando
+utilizando essa versão.
 
 # Não gosto de ler manuais, como atualizo?