Editing Braille Command Property Lists - Revision history

Britta: improving formatting (code blocks)

2013-08-28T21:56:30Z

improving formatting (code blocks)

Aman at 21:06, 30 November 2010

2010-11-30T21:06:13Z

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 ...

2010-11-30T20:58:21Z

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 ...

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
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

@@ Line 4: / Line 4: @@
 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><br>
+ <key>com.apple.scrod.braille.driver.alva.6.series.65536</key>
-<string>Router Row 1</string><br>
+ <string>Router Row 1</string>
-<key>com.apple.scrod.braille.driver.alva.6.series.65537</key><br>
+ <key>com.apple.scrod.braille.driver.alva.6.series.65537</key>
-<string>Thumb 1</string><br>
+ <string>Thumb 1</string>
-<key>com.apple.scrod.braille.driver.alva.6.series.67841</key><br>
+ <key>com.apple.scrod.braille.driver.alva.6.series.67841</key>
-<string>Smartpad 1</string><br>
+ <string>Smartpad 1</string>
-<key>com.apple.scrod.braille.driver.alva.6.series.69633</key><br>
+ <key>com.apple.scrod.braille.driver.alva.6.series.69633</key>
-<string>Smartpad 3</string><br>
+ <string>Smartpad 3</string>
-	<key>com.apple.scrod.braille.driver.alva.6.series.68865</key><br>
+ 	<key>com.apple.scrod.braille.driver.alva.6.series.68865</key>
-	<string>Smartpad Up</string><br>
+ 	<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
+An example of the button code to command mapping from com.apple.scrod.braille.driver.alva.6.series.BC640.plist
-<dict><br>
+ <dict>
-	<key>SCRBrailleInputIdentifier</key><br>
+ 	<key>SCRBrailleInputIdentifier</key>
-	<string>68865</string><br>
+ 	<string>68865</string>
-<key>SCRCommand</key><br>
+ <key>SCRCommand</key>
-	<string>VOTEventCommandSearchRotorUp</string><br>
+ 	<string>VOTEventCommandSearchRotorUp</string>
-</dict><br>
+ </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:
+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><br>
+ <dict>
-	<key>SCRBrailleInputIdentifier</key><br>
+ 	<key>SCRBrailleInputIdentifier</key>
-	<string>69633</string><br>
+ 	<string>69633</string>
-	<key>SCRCommand</key><br>
+ 	<key>SCRCommand</key>
-	<string>VOTEventCommandSearchRotorUp</string><br>
+ 	<string>VOTEventCommandSearchRotorUp</string>
-</dict><br>
+ </dict>
 If one wanted to change the up arrow to do a flick left, one would change the above mapping like this:
-<dict><br>
+ <dict>
-	<key>SCRBrailleInputIdentifier</key><br>
+ 	<key>SCRBrailleInputIdentifier</key>
-	<string>68865</string><br>
+ 	<string>68865</string>
-<key>SCRCommand</key><br>
+ <key>SCRCommand</key>
-	<string>VOTEventCommandPreviousElement</string><br>
+ 	<string>VOTEventCommandPreviousElement</string>
-</dict><br>
+ </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
+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><br>
+ <dict>
-		<key>SCRBrailleInputIdentifier</key><br>
+ 		<key>SCRBrailleInputIdentifier</key>
-		<string>66818.67586</string><br>
+ 		<string>66818.67586</string>
-		<key>SCRCommand</key><br>
+ 		<key>SCRCommand</key>
-	<string>VOTEventCommandSearchRotorDown</string><br>
+ 	<string>VOTEventCommandSearchRotorDown</string>
-	</dict><br>
+ 	</dict>
 This is a list of all the braille command keywords known so far:
@@ Line 95: / Line 95: @@
 *BraillePanRight
 *BrailleAnnouncementModeOn
-*BrailleToggleContractions<br>
+*BrailleToggleContractions

@@ Line 4: / Line 4: @@
 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>
+<key>com.apple.scrod.braille.driver.alva.6.series.65536</key><br>
-<string>Router Row 1</string>
+<string>Router Row 1</string><br>
-<key>com.apple.scrod.braille.driver.alva.6.series.65537</key>
+<key>com.apple.scrod.braille.driver.alva.6.series.65537</key><br>
-<string>Thumb 1</string>
+<string>Thumb 1</string><br>
-<key>com.apple.scrod.braille.driver.alva.6.series.67841</key>
+<key>com.apple.scrod.braille.driver.alva.6.series.67841</key><br>
-<string>Smartpad 1</string>
+<string>Smartpad 1</string><br>
-<key>com.apple.scrod.braille.driver.alva.6.series.69633</key>
+<key>com.apple.scrod.braille.driver.alva.6.series.69633</key><br>
-<string>Smartpad 3</string>
+<string>Smartpad 3</string><br>
-	<key>com.apple.scrod.braille.driver.alva.6.series.68865</key>
+	<key>com.apple.scrod.braille.driver.alva.6.series.68865</key><br>
-	<string>Smartpad Up</string>
+	<string>Smartpad Up</string><br>
-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.
+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>
+<dict><br>
-	<key>SCRBrailleInputIdentifier</key>
+	<key>SCRBrailleInputIdentifier</key><br>
-	<string>68865</string>
+	<string>68865</string><br>
-<key>SCRCommand</key>
+<key>SCRCommand</key><br>
-	<string>VOTEventCommandSearchRotorUp</string>
+	<string>VOTEventCommandSearchRotorUp</string><br>
-</dict>
+</dict><br>
-	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:
+	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>
+<dict><br>
-	<key>SCRBrailleInputIdentifier</key>
+	<key>SCRBrailleInputIdentifier</key><br>
-	<string>69633</string>
+	<string>69633</string><br>
-	<key>SCRCommand</key>
+	<key>SCRCommand</key><br>
-	<string>VOTEventCommandSearchRotorUp</string>
+	<string>VOTEventCommandSearchRotorUp</string><br>
-</dict>
+</dict><br>
 If one wanted to change the up arrow to do a flick left, one would change the above mapping like this:
-<dict>
+<dict><br>
-	<key>SCRBrailleInputIdentifier</key>
+	<key>SCRBrailleInputIdentifier</key><br>
-	<string>68865</string>
+	<string>68865</string><br>
-<key>SCRCommand</key>
+<key>SCRCommand</key><br>
-	<string>VOTEventCommandPreviousElement</string>
+	<string>VOTEventCommandPreviousElement</string><br>
-</dict>
+</dict><br>
 	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>
+<dict><br>
-		<key>SCRBrailleInputIdentifier</key>
+		<key>SCRBrailleInputIdentifier</key><br>
-		<string>66818.67586</string>
+		<string>66818.67586</string><br>
-		<key>SCRCommand</key>
+		<key>SCRCommand</key><br>
-	<string>VOTEventCommandSearchRotorDown</string>
+	<string>VOTEventCommandSearchRotorDown</string><br>
-	</dict>
+	</dict><br>
-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:
+This is a list of all the braille command keywords known so far:
-BrailleRouter
+*BrailleRouter
-BrailleStatusRouter
+*BrailleStatusRouter
-PreviousElement
+*PreviousElement
-NextElement
+*NextElement
-SearchRotorUp
+*SearchRotorUp
-SearchRotorDown
+*SearchRotorDown
-SimpleTap
+*SimpleTap
-SearchRotorLeft
+*SearchRotorLeft
-SearchRotorRight
+*SearchRotorRight
-FirstElement
+*FirstElement
-LastElement
+*LastElement
-ReadAll
+*ReadAll
-ReadFromTop
+*ReadFromTop
-HomeButtonPress
+*HomeButtonPress
-MoveToStatusBar
+*MoveToStatusBar
-VolumeUpButtonPress
+*VolumeUpButtonPress
-VolumeDownButtonPress
+*VolumeDownButtonPress
-Escape
+*Escape
-EjectButtonPress
+*EjectButtonPress
-Delete
+*Delete
-Return
+*Return
-Tab
+*Tab
-ShiftTab
+*ShiftTab
-Cut
+*Cut
-Copy
+*Copy
-Paste
+*Paste
-Undo
+*Undo
-Redo
+*Redo
-SelectAll
+*SelectAll
-ToggleScreenCurtain
+*ToggleScreenCurtain
-ToggleSpeaking
+*ToggleSpeaking
-ToggleMute
+*ToggleMute
-StartHelp
+*StartHelp
-ScrollLeftPage
+*ScrollLeftPage
-ScrollRightPage
+*ScrollRightPage
-SelectLeft
+*SelectLeft
-SelectRight
+*SelectRight
-BraillePanLeft
+*BraillePanLeft
-BraillePanRight
+*BraillePanRight
-BrailleAnnouncementModeOn
+*BrailleAnnouncementModeOn
-BrailleToggleContractions
+*BrailleToggleContractions<br>