SAM Driver for the Optelec Easylink 12,  Easylink 12 Touch, Harpo BraillePen12 and Harpo BraillePen12 Touch.

This is a fully functional SAM driver for use with Easylink12 and BraillePen12 refreshable Braille displays.

This driver currently only supports the EasyLink12 / BraillePen12 displays and Touch versions. The EasyLink and BraillePen (without the 12 braille cells) are not supported.

Please report any bugs to Dolphin. If it crashes please tell us the crash address and registers etc, from the crash message box, also report the driver version number (check with explorer - file properties).

+++ Features
Auto-detects Braille displays.

Note: We recommend that you go through the normal Windows Bluetooth pairing procedure for the EasyLink before running this SAM driver. Make a note of any COM port created by the pairing process and select this COM port in the SAM driver configuration dialog. Make sure that the EasyLink / BraillePen is switched on and ready before running this driver.


+++ Button Layout:
On the top of the Easylink / BraillePen, there are 6 buttons arranged like a standard braille writer: from left to right they are labelled 3, 2, 1, 4, 5, 6.

Beneath these buttons is a row of three longer buttons, from left to right they are labelled Shift, Space and Ctrl.

On the EasyLink12 / BraillePen12, there are additional buttons as follows:
The buttons at the end of the braille line are labelled Tab and AltTab. Above the Space key is a joystick that can be moved up, down, left and right, or pressed (called Action).

Important note: The key combination Dot 1 + Dot 3 + Space turns the EasyLink on and off. Do not turn the unit off while connected. If you do by mistake, then restart the driver by reselecting the EasyLink display in the Supernova Control Panel.


+++ Key assignments
The following lists the default keys to press for each Braille operation.
Your screen reader may not support some of these operations.

Note that any actions involving the Tab or AltTab keys or the joystick only apply to the EasyLink 12.

Action Open Control Panel = Dot 1 + Dot 3 + Dot 5 + Space
Action Control Panel Popup Menu = Dot 1 + Dot 2 + Dot 3 + Dot 4 + Space
List System Tray = Dot 2 + Dot 3 + Dot 4 + Dot 5 + Space + Shift
Action Application Hotkey Information = Dot 1 + Dot 2 + Dot 5 + Space
Speech Key Describe Mode on off = Dot 1 + Dot 4 + Dot 5 + Dot 6 + Space
Speech Mute = Ctrl
Read from Here Read from here = Dot 1 + Dot 2 + Dot 3 + Dot 5 + Space
Read from Here Stop Reading = Ctrl
Read from Here Stop Reading = Dot 1 + Dot 5 + Space
Read from Here Stop Reading and Switch Focus = Dot 1 + Dot 2 + Dot 4 + Space
Dolphin Cursor (Movement) Move To Application Cursor = Dot 1 + Dot 6 + Space
Dolphin Cursor (General) Turn Dolphin Cursor on = Dot 1 + Dot 2 + Dot 4 + Space
Dolphin Cursor (General) Turn Dolphin Cursor off = Dot 1 + Dot 2 + Dot 4 + Space
Dolphin Cursor (General) Forms Mode toggle = Dot 4 + Dot 6 + Space + Ctrl
Dolphin Cursor (General) Find with Dolphin Cursor = Dot 1 + Dot 2 + Dot 4 + Ctrl
Dolphin Cursor (General) Find Next with Dolphin Cursor = Dot 1 + Dot 3 + Dot 4 + Dot 5 + Ctrl
Dolphin Cursor (General) Find Previous with Dolphin Cursor = Dot 1 + Dot 2 + Dot 3 + Dot 4 + Ctrl
Speak Keys Character (MultiKey) = Dot 3 + Dot 6 + Space
Speak Keys Word (MultiKey) = Dot 2 + Dot 5 + Space
Speak Keys Line (MultiKey) = Dot 1 + Dot 4 + Space
Speak Keys Status (Multikey) = Dot 2 + Dot 3 + Space + Shift
Speak Keys Selection (Multikey) = Dot 2 + Space + Shift
Speak Keys Focus (MultiKey) = Dot 3 + Dot 5 + Dot 6 + Space + Shift
Speak Keys Headings (MultiKey) = Dot 2 + Dot 5 + Space + Shift
Speak Keys Control (MultiKey) = Dot 4 + Dot 6 + Space + Shift
Speak Keys Window (MultiKey) = Dot 3 + Dot 5 + Space + Shift
Speak Keys Where am I? = Dot 2 + Dot 4 + Space
Speak Keys Describe Focus position (Multikey) = Dot 2 + Dot 3 + Dot 6 + Space + Shift
Simulate Key Press Up = Dot 1 + Space
Simulate Key Press Up = Joystick Up
Simulate Key Press Down = Dot 4 + Space
Simulate Key Press Down = Joystick Down
Simulate Key Press Left = Dot 3 + Space
Simulate Key Press Left = Joystick Left
Simulate Key Press Right = Dot 6 + Space
Simulate Key Press Right = Joystick Right
Speak Keys Word Move to Next = Dot 5 + Space
Speak Keys Word Move to Next = Joystick Right + Ctrl
Speak Keys Word Move to Previous = Dot 2 + Space
Speak Keys Word Move to Previous = Joystick Left + Ctrl
Simulate Key Press Home = Dot 1 + Dot 2 + Dot 3 + Space + Shift
Simulate Key Press Home = Joystick Left + Space
Simulate Key Press End = Dot 4 + Dot 5 + Dot 6 + Space + Shift
Simulate Key Press End = Joystick Right + Space
Simulate Key Press Enter = Dot 4 + Dot 6 + Space
Simulate Key Press Enter = Space + Ctrl
Simulate Key Press Enter = Joystick Action
Simulate Key Press Space = Space
Simulate Key Press Page Up = Dot 1 + Dot 2 + Dot 6 + Space
Simulate Key Press Page Up = Joystick Up + Space
Simulate Key Press Page Down = Dot 3 + Dot 4 + Dot 5 + Space
Simulate Key Press Page Down = Joystick Down + Space
Simulate Key Press Tab = Dot 5 + Dot 6 + Space
Simulate Key Press Tab = Dot 5 + Dot 6 + Shift + Space
Simulate Key Press Shift Tab = Dot 2 + Dot 3 + Space
Simulate Key Press Ctrl Tab = Dot 5 + Dot 6 + Space + Ctrl
Simulate Key Press Ctrl Shift Tab = Dot 2 + Dot 3 + Space + Shift + Ctrl
Simulate Key Press Escape = Dot 1 + Dot 5 + Space
Simulate Key Press Backspace = Dot 1 + Dot 2 + Space
Simulate Key Press Delete = Dot 1 + Dot 4 + Dot 5 + Space
Simulate Key Press Windows = Dot 2 + Dot 4 + Dot 5 + Dot 6 + Space
Simulate Key Press Ctrl Home = Dot 1 + Dot 2 + Dot 3 + Space
Simulate Key Press Ctrl Home = Joystick Up + Ctrl
Simulate Key Press Ctrl End = Dot 4 + Dot 5 + Dot 6 + Space
Simulate Key Press Ctrl End = Joystick Down + Ctrl
Custom Global  8 (Read Time and Date) = Dot 2 + Dot 3 + Dot 4 + Dot 5 + Space
Simulate Key Press Alt = Shift + Ctrl


Only on the EasyLink 12 / BraillePen 12:

Braille Back = Tab
Braille Forward = AltTab
Braille Line Start = Tab + Shift
Braille Line End = AltTab + Shift
Braille Bottom = AltTab + Ctrl
Braille Top = Tab + Ctrl
Braille Cycle Attributes = Dot 1 + Dot 3 + Dot 4 + Dot 6 + Space
Braille Describe Character on off = Dot 1 + Dot 3 + Dot 4 + Dot 6 + Shift + Space
Braille Go To Focus = Tab + AltTab
Braille Literary Braille on off = Dot 1 + Dot 2 + Dot 4 + Dot 5 + Shift + Space
Braille Enhance on off = Dot 1 + Dot 2 + Dot 3 + Dot 4 + Dot 6 + Space
Braille Braille Document Read Forward = Space + AltTab
Braille Braille Document Read Back = Tab + Space

[End of file] - January 2014
