The iPhone Wiki - User contributions [en]

Editing Braille Command Property Lists

2010-11-30T21:06:13Z

Aman:

The files needed for editing the braille display keystrokes are two. One, needed for informational purposes only, is located in the English.lproj directory and is called InfoPlist.strings
This file contains mappings of the names of buttons on the braille display to button codes. The button codes are what are used in the specific .plist file for the display, and these codes are in turn mapped to commands which are executed when the buttons are pressed.

An example of the button name to code mappings from the Alva InfoPlist.strings

<key>com.apple.scrod.braille.driver.alva.6.series.65536</key> 
<string>Router Row 1</string> 
<key>com.apple.scrod.braille.driver.alva.6.series.65537</key> 
<string>Thumb 1</string> 
<key>com.apple.scrod.braille.driver.alva.6.series.67841</key> 
<string>Smartpad 1</string> 
<key>com.apple.scrod.braille.driver.alva.6.series.69633</key> 
<string>Smartpad 3</string> 
<key>com.apple.scrod.braille.driver.alva.6.series.68865</key> 
<string>Smartpad Up</string> 

These are the button codes needed in the .plist file for one's particular display. How these button codes are determined is not known. Some of the English button names are cryptic, but most can be figured out and, if real difficulties come up in this, one can always assign the unknown button codes to a known command, go into the practice VoiceOver gestures application, and hit the possible buttons until one gets the right command. Practice VoiceOver Gestures will announce the name of the button/buttons used.

An example of the button code to command mapping from com.apple.scrod.braille.driver.alva.6.series.BC640.plist

<dict> 
<key>SCRBrailleInputIdentifier</key> 
<string>68865</string> 
<key>SCRCommand</key> 
<string>VOTEventCommandSearchRotorUp</string> 
</dict> 

To modify what the buttons do, it is simply necessary to change the command keyword, in this case "SearchRotorUp", to one of the other keywords. A list of keywords is below. Most are in plain English, and will be simple for any user who's used iOS. To modify what buttons perform the command, all that's needed is to change the button code to the desired button or buttons. For example, the above command mapping maps the up arrow on the display to the swipe up on the touch screen, getting to the previous item using the rotor. If one wanted smartpad 3 to do this, it would be changed to the below:

<dict> 
<key>SCRBrailleInputIdentifier</key> 
<string>69633</string> 
<key>SCRCommand</key> 
<string>VOTEventCommandSearchRotorUp</string> 
</dict> 

If one wanted to change the up arrow to do a flick left, one would change the above mapping like this:

<dict> 
<key>SCRBrailleInputIdentifier</key> 
<string>68865</string> 
<key>SCRCommand</key> 
<string>VOTEventCommandPreviousElement</string> 
</dict> 

If one wants to have multiple buttons pressed together perform an action, one enters the button codes separated by a period into the button code designation string field. This example has two buttons on the Baum braille display perform the swipe down to search for the next item according to the rotor. It can be found in com.apple.scrod.braille.driver.baum.varioconnect.12.plist

<dict> 
<key>SCRBrailleInputIdentifier</key> 
<string>66818.67586</string> 
<key>SCRCommand</key> 
<string>VOTEventCommandSearchRotorDown</string> 
</dict> 

This is a list of all the braille command keywords known so far:

*BrailleRouter
*BrailleStatusRouter
*PreviousElement
*NextElement
*SearchRotorUp
*SearchRotorDown
*SimpleTap
*SearchRotorLeft
*SearchRotorRight
*FirstElement
*LastElement
*ReadAll
*ReadFromTop
*HomeButtonPress
*MoveToStatusBar
*VolumeUpButtonPress
*VolumeDownButtonPress
*Escape
*EjectButtonPress
*Delete
*Return
*Tab
*ShiftTab
*Cut
*Copy
*Paste
*Undo
*Redo
*SelectAll
*ToggleScreenCurtain
*ToggleSpeaking
*ToggleMute
*StartHelp
*ScrollLeftPage
*ScrollRightPage
*SelectLeft
*SelectRight
*BraillePanLeft
*BraillePanRight
*BrailleAnnouncementModeOn
*BrailleToggleContractions

Editing Braille Command Property Lists

2010-11-30T20:58:21Z

Aman: New page: The files needed for editing the braille display keystrokes are two. One, needed for informational purposes only, is located in the English.lproj directory and is called InfoPlist.strings ...

The files needed for editing the braille display keystrokes are two. One, needed for informational purposes only, is located in the English.lproj directory and is called InfoPlist.strings
This file contains mappings of the names of buttons on the braille display to button codes. The button codes are what are used in the specific .plist file for the display, and these codes are in turn mapped to commands which are executed when the buttons are pressed.

An example of the button name to code mappings from the Alva InfoPlist.strings

<key>com.apple.scrod.braille.driver.alva.6.series.65536</key>
<string>Router Row 1</string>
<key>com.apple.scrod.braille.driver.alva.6.series.65537</key>
<string>Thumb 1</string>
<key>com.apple.scrod.braille.driver.alva.6.series.67841</key>
<string>Smartpad 1</string>
<key>com.apple.scrod.braille.driver.alva.6.series.69633</key>
<string>Smartpad 3</string>
<key>com.apple.scrod.braille.driver.alva.6.series.68865</key>
<string>Smartpad Up</string>

These are the button codes needed in the .plist file for one's particular display. I don't know how these button codes are determined. Some of the English button names are cryptic, but most can be figured out and, if real difficulties come up in this, one can always assign the unknown button codes to a known command, go into the practice VoiceOver gestures application, and hit the possible buttons until one gets the right command. Practice VoiceOver Gestures will announce the name of the button/buttons used.

An example of the button code to command mapping from com.apple.scrod.braille.driver.alva.6.series.BC640.plist

<dict>
<key>SCRBrailleInputIdentifier</key>
<string>68865</string>
<key>SCRCommand</key>
<string>VOTEventCommandSearchRotorUp</string>
</dict>

To modify what the buttons do, it is simply necessary to change the command keyword, in this case "SearchRotorUp", to one of the other keywords. I have put a list of keywords, that I know of, at the end of this document. Most are in plain English, and will be simple for any user who's used iOS. To modify what buttons perform the command, all that's needed is to change the button code to the desired button or buttons. For example, the above command mapping maps the up arrow on the display to the swipe up on the touch screen, getting to the previous item using the rotor. If one wanted smartpad 3 to do this, it would be changed to the below:

<dict>
<key>SCRBrailleInputIdentifier</key>
<string>69633</string>
<key>SCRCommand</key>
<string>VOTEventCommandSearchRotorUp</string>
</dict>

If one wanted to change the up arrow to do a flick left, one would change the above mapping like this:

<dict>
<key>SCRBrailleInputIdentifier</key>
<string>68865</string>
<key>SCRCommand</key>
<string>VOTEventCommandPreviousElement</string>
</dict>

If one wants to have multiple buttons pressed together perform an action, one enters the button codes separated by a period into the button code designation string field. This example has two buttons on the Baum braille display perform the swipe down to search for the next item according to the rotor. It can be found in com.apple.scrod.braille.driver.baum.varioconnect.12.plist

<dict>
<key>SCRBrailleInputIdentifier</key>
<string>66818.67586</string>
<key>SCRCommand</key>
<string>VOTEventCommandSearchRotorDown</string>
</dict>

This is a list of all the braille command keywords which I have found. I would be grateful for any other keywords, which I have missed, particularly if anyone wants to try this on 4.2 and finds ones which are in that OS version:

BrailleRouter
BrailleStatusRouter
PreviousElement
NextElement
SearchRotorUp
SearchRotorDown
SimpleTap
SearchRotorLeft
SearchRotorRight
FirstElement
LastElement
ReadAll
ReadFromTop
HomeButtonPress
MoveToStatusBar
VolumeUpButtonPress
VolumeDownButtonPress
Escape
EjectButtonPress
Delete
Return
Tab
ShiftTab
Cut
Copy
Paste
Undo
Redo
SelectAll
ToggleScreenCurtain
ToggleSpeaking
ToggleMute
StartHelp
ScrollLeftPage
ScrollRightPage
SelectLeft
SelectRight
BraillePanLeft
BraillePanRight
BrailleAnnouncementModeOn
BrailleToggleContractions

I hope all this is of use to someone.
Aman

BrailleDrivers

2010-11-30T20:56:39Z

Aman:

The following folders and files make up the braille drivers in this folder.
*.English.lproj A directory containing a file with descriptions of the button codes on the braille display
*A file, with its name differing depending upon the braille display group, which cannot easily be read.
*Files for each of the displays, the names ending with .plist, defining what each of the buttons on the display do.
*A file called info.plist with generic information about the braille display group. 

<li>[[Editing Braille Command Property Lists|Editing Braille Command Property Lists]]

BrailleDrivers

2010-11-30T20:05:11Z

Aman:

BrailleDrivers

2010-11-30T20:01:42Z

Aman:

The following folders and files make up the braille drivers in this folder.
*.English.lproj
A directory containing a file with descriptions of the button codes on the braille display
*A file, with its name differing depending upon the braille display group, which cannot easily be read.
*Files for each of the displays, the names ending with .plist, defining what each of the buttons on the display do.
*A file called info.plist with generic information about the braille display group.

BrailleDrivers

2010-11-30T20:00:54Z

Aman:

The following files make up the braille drivers in this folder.
*.English.lproj
A directory containing a file with descriptions of the button codes on the braille display
*A file, with its name differing depending upon the braille display group, which cannot easily be read.
*Files for each of the displays, the names ending with .plist, defining what each of the buttons on the display do.
*A file called info.plist with generic information about the braille display group.

BrailleDrivers

2010-11-30T19:59:53Z

Aman: New page: The following files make up the braille drivers in this folder. *.English.lproj A directory containing a file with descriptions of the button codes on the braille display *A file, with its...

The following files make up the braille drivers in this folder.
*.English.lproj
A directory containing a file with descriptions of the button codes on the braille display *A file, with its name differing depending upon the braille display group, which cannot easily be read.
*Files for each of the displays, the names ending with .plist, defining what each of the buttons on the display do.
*A file called info.plist with generic information about the braille display group.

/System/Library/ScreenReader

2010-11-30T19:56:55Z

Aman:

This folder contains some of the files needed to allow braille displays on the iOS platform.
<li>[[BrailleDrivers|BrailleDrivers]]

/System/Library/ScreenReader

2010-11-30T19:56:17Z

Aman:

This folder contains some of the files needed to allow braille displays on the iOS platform.
<li>[[BrailleDrivers|BrailleDrivers]]</li>

/System/Library/ScreenReader

2010-11-30T19:53:29Z

Aman: New page: This folder contains some of the files needed to allow braille displays on the iOS platform.

This folder contains some of the files needed to allow braille displays on the iOS platform.

/System/Library

2010-11-30T18:11:40Z

Aman: /* Children */

== Children ==
<ul>
<li>[[/System/Library/AccessibilityBundles|AccessibilityBundles]]</li>
<li>[[/System/Library/ApplePTP|ApplePTP]]</li>
<li>[[/System/Library/AppleUSBDevice|AppleUSBDevice]]</li>
<li>[[/System/Library/Audio|Audio]]</li>
<li>[[/System/Library/Caches|Caches]]</li>
<li>[[/System/Library/Carrier Bundles|Carrier Bundles]]</li>
<li>[[/System/Library/CoreServices|CoreServices]]</li>
<li>[[/System/Library/DataClassMigrators|DataClassMigrators]]</li>
<li>[[/System/Library/Extensions|Extensions]]</li>
<li>[[/System/Library/Filesystems|Filesystems]]</li>
<li>[[/System/Library/Fonts|Fonts]]</li>
<li>[[Frameworks|Frameworks]]</li>
<li>[[/System/Library/Internet Plug-Ins|Internet Plug-Ins]]</li>
<li>[[/System/Library/KeyboardDictionaries|KeyboardDictionaries]]</li>
<li>[[/System/Library/LaunchDaemons|LaunchDaemons]]</li>
<li>[[/System/Library/Lockdown|Lockdown]]</li>
<li>[[/System/Library/ManagedConfigurationBundles|ManagedConfigurationBundles]]</li>
<li>[[/System/Library/MediaCapture|MediaCapture]]</li>
<li>[[/System/Library/PreferenceBundles|PreferenceBundles]]</li>
<li>[[Frameworks|PrivateFrameworks]]</li>
<li>[[/System/Library/PublishingBundles|PublishingBundles]]</li>
<li>[[/System/Library/ScreenReader|ScreenReader]]</li>
<li>[[/System/Library/SearchBundles|SearchBundles]]</li>
<li>[[/System/Library/SpringBoardPlugins|SpringBoardPlugins]]</li>
<li>[[/System/Library/SystemConfiguration|SystemConfiguration]]</li>
<li>[[/System/Library/TextInput|TextInput]]</li>
<li>[[/System/Library/VideoDecoders|VideoDecoders]]</li>
<li>[[/System/Library/VideoEncoders|VideoEncoders]]</li>
<li>[[/System/Library/VoiceServices|VoiceServices]]</li>
</ul>