GR8BIT Knowledge base article #KB0004

GR8BIT: the Real Engineering Experience
PDF PDF version  Back Back to KB list

Aug 14, 2012
(initial release of Mar 03, 2012)
Severity: InformationEugeny Brychkov (RU)

Using GR8BIT Language Pack and PS/2 Keyboard

Overview

Language pack allows you to easily switch between locales - character sets and keyboard layouts, without need to change GR8BIT main ROM chip or its contents. These properties may be changed independently, but not all combinations are valid.

Support statement

Currently supported configurations are

JA-JAJapanese character set with native Japanese compatible keyboard
JA-PS2Japanese character set with PS/2 keyboard
RU-RURussian character set with native Russian compatible keyboard
RU-PS2Russian character set with PS/2 keyboard
IntlInternational character set, can be used with JA or PS2 layout (untested)
PTPortuguese character set, can be used with JA or PS2 layout (untested)

Description

When GR8BIT starts, you may press and hold GRAPH and CTRL keys (for compatible keyboards) or ALT and CTRL keys (for PS/2 keyboard) to invoke Language configuration menu. During the initialization you can see the current saved configuration - Japanese character set (fig. 1a), or Russian character set (fig. 1b). If no configuration displayed, it is assumed that international or Portuguese character set is selected.

Once you got to Language setup menu, you can select character set and keyboard layout from the list (fig. 2). Fields in brackets are changeable by the pressing and releasing space key. Item Save is used to save settings to the RTC chip (non-volatile memory) so that GR8BIT remember your preference and next time start with saved locale configuration.

Item Use! does not save locale settings to the NVRAM, but exits setup program using selected settings for current session. If you do not save settings to NVRAM using Save item, your changes will be lost after next reboot or power cycle.

GR8BIT with Japanese locale
(a)
  GR8BIT with Russian locale
(b)
GR8BIT system boot message indicating locale

GR8BIT language pack setup menu
GR8BIT language pack setup menu

You also have an opportunity to change Language settings in the BASIC using LANG command.

LANG <charset>[,<keyboard layout>]

Argument <charset> is required, argument <keyboard layout> is optional. Character set is assigned as follows: 0=Japanese, 1=Russian, 2=International, 3=Portuguese. Keyboard layouts are: 0=Japanese, 1=PS/2, 2=Russian, 3=International.

Using PS/2 keyboard

You can enjoy PS/2-type keyboard with GR8BIT, connected to the PS/2 port of the main board. In order for PS/2 keyboard to function, the following prerequisites should be met:

  1. Your GR8BIT should have functional PS/2 controller installed on the main board - IC2, microcontroller PIC16F1828;
  2. Your GR8BIT should have jumpers JP2 and JP4 configured properly;
  3. Keyboard you connect should be PS/2-type keyboard.

You may have PS/2 keyboard connected to the GR8BIT before power up, or after power up. As soon as keyboard gets power (after power up or after it got connected to your GR8BIT), microcontroller initializes it. This initialization takes about 4 seconds, and is exhibited by flashing keyboard LEDs. You should not type or press/release any keyboard keys during this time. Therefore if you wish to get to Language Pack setup menu, please wait until keyboard will complete initialization and only then press CTRL and ALT keys.

Using Compatible keyboard with PS/2 controller installed*

* Please note that information described in this section applies to GR8BIT PS/2 keyboard microcontroller firmware version 1.0b and above.

Unfortunately due to electrical conflict both devices - PS/2 keyboard and Compatible MSX keyboard - can not be used simultaneously. If PS/2 controller is active and Compatible keyboard is connected to GR8BIT, PS/2 keyboard will work properly, but Compatible keyboard may not.

There're several ways how you can manage your keyboards:

  1. Use Compatible (MSX) keyboard only - remove PS/2 keyboard controller (IC2);
  2. Use PS/2 keyboard - do not connect Compatible keyboard;
  3. Use both PS/2 and Compatible keyboards, one at a time - configure JP2 on the GR8BIT main board according to your Compatible keyboard specifications, and open main board's jumper JP4 (as described in GR8BOOK1 section 3.10 and GR8BOOK2 section 3.5). You use PS/2 keyboard when PS/2 controller is enabled. If you wish to use Compatible keyboard (e.g. for gaming), you disable output of PS/2 controller by pressing F12 key on the PS/2 keyboard (Num Lock LED will turn on), and then Compatible keyboard works without issues. If you want to use PS/2 keyboard back again, press its F12 key to enable it (Num Lock LED will go off).

MSX Keyboard Scan Codes

F1
35
F2
36
F3
37
F4
38
F5
39
  STOP
3C
SELECT
3E
CLS
41
INS
42
DEL
43
  ESC
3A
010203040506 070809000A0B0C BS
3D
TAB
3B
262C1A27292E 2A1E24250D0E 
CTRL
31
1628191B1C1D 1F20210F1011

3F
SHIFT
30
2F2D182B1723 2212131415SHIFT
30
 Caps
33
Grph
32
Space key
40
Kana
34
  7
52
8
53
9
54
*
4A
4
4F
5
50
6
51
-
55
1
4C
2
4D
3
4E
+
49
0
4B
.
57
,
56
RET
48
 
44

45

46

47

expand View MSX Keyboard Scan Codes as image MSX Keyboard Scan Codes as image


PS/2 keyboard layout, when using GR8BIT PS/2 keyboard controller

PS/2 keyboard layout, main pane


PS/2 keyboard layout, numeric and arrows

日本語のキーボードレイアウト (Japanese keyboard layout)

Kana = off, Graph = released

1!2" 3#4$ 5%6& 7'8( 9)0  -=^~ ¥¦   QWERTYUIO P@`[{  ASDFGHJ KL;+:* ]}  ZXCVBNM ,<.> /? _

expand Japanese keyboard layout 1, view as an image Japanese keyboard layout, image 1

Kana = on, Graph = released

ぬ ヌ ふ フ















ほ ホ へ ヘ
  た タ て テ

す ス か カ ん ン な ナ に 二 ら ラ せ セ ° 「
  ち チ と ト し シ は ハ き キ く ク ま マ の ノ り リ れ レ け ケ

 

さ サ そ ソ ひ ヒ こ コ み ミ も モ





ろ ロ

expand Japanese keyboard layout 2, view as an image Japanese keyboard layout, image 2

Graph = pressed

                  π          

expand Japanese keyboard layout 3, view as an image Japanese keyboard layout, image 3


Русская раскладка клавиатуры (Russian keyboard layout)

Kana (РУС) = off, Graph = released

+;!1 "2#3 ¤4%5 &6'7 (8)9 $0=_ -^   JCUKENG [{]} ZH*:  FYWAPRO LDV\>.  Q¦~S MITXB@ <,?/

expand Russian keyboard layout 1, view as an image Russian keyboard layout, image 1

Kana (РУС) = on, Graph = released

+;!1 "2#3 ¤4%5 &6'7 (8)9  0Ъ_ -^   ЙЦУКЕН ГШЩЗХ *:  ФЫВАП РО ЛДЖЭ>.  ЯЧС МИТЬБЮ <,?/

expand Russian keyboard layout 2, view as an image Russian keyboard layout, image 2

Graph = pressed

Russian keyboard layout, image 3

KB article release notes: KB0004 was initially released on March 03, 2012, covering operation of Language pack only. It was re-released on August 14, 2012, to cover operation of the PS/2 keyboard.

End of KB0014 "Using GR8BIT Language Pack and PS/2 Keyboard".


© 2011-2017 Eugeny Brychkov http://www.gr8bit.ru Status: Released

    Counter     Pagerank
    Valid CSS     Valid HTML5

GR8BIT™, GR8BOOK™, GR8BUS™, GR8BOX™ and GR8STORM™ are trademarks copyright © 2010-2017 Eugeny Brychkov.
Please refer to: copyright statement, privacy policy.