Harucom keeps its settings in a single file, /etc/env.yml. The keyboard layout and the text size at boot are configured there.

The Settings File

Edit the file with the editor.

irb> edit /etc/env.yml

KEYBOARD_LAYOUT: us
CONSOLE_ZOOM: 1

Setting	Values	Description
`KEYBOARD_LAYOUT`	`us` / `jis`	Keyboard layout
`CONSOLE_ZOOM` New in 2.0	`1` / `2`	Text size at boot

Save the file and restart with Ctrl-Alt-Delete to apply the settings.

The file is loaded into the environment variables at boot, so programs can read it through ENV.

irb> ENV["KEYBOARD_LAYOUT"]
=> "us"

You can add settings of your own. Whatever you write ends up in ENV.

A firmware update rewrites the system files, /etc/env.yml included. Set your preferences again after updating.

Changing the Keyboard Layout

KEYBOARD_LAYOUT selects the keyboard layout.

Value	Layout
`us`	US ANSI
`jis`	Japanese JIS

Set it to jis if the symbols come out in the wrong place with a Japanese keyboard. The jis layout also enables the 半角/全角 and カタカナ/ひらがな keys, which makes switching Japanese input easier.

An unknown value falls back to us.

Zooming the Screen

The text screen has two sizes. The larger one helps when the characters are hard to read, for example on a TV.

Zoom	Resolution	Grid
1	640x480	106 columns x 37 rows
2	320x240 (pixels doubled)	53 columns x 18 rows

Press Ctrl-Shift-= at the IRB prompt to switch on the spot.

The zoom command does the same.

irb> zoom
zoom 1 (106x37 characters)

irb> zoom 2

irb> zoom 1

The size at boot comes from CONSOLE_ZOOM in /etc/env.yml. Set it to 2 to start with large characters right after power-on.

Switching the zoom clears the screen. What was displayed is not carried over.

Formatting the Filesystem

You can erase everything you have made and return the board to its factory state. Create a file named /FORMAT and restart.

irb> touch /FORMAT

On the next boot the flash filesystem is formatted and the system files are written again.

Every file you made is erased. Copy anything you want to keep before doing this.