diff --git a/devices/surface-hub/images/room-control-wiring-diagram.png b/devices/surface-hub/images/room-control-wiring-diagram.png
new file mode 100644
index 0000000000..5a2ecf613e
Binary files /dev/null and b/devices/surface-hub/images/room-control-wiring-diagram.png differ
diff --git a/devices/surface-hub/use-room-control-system-with-surface-hub.md b/devices/surface-hub/use-room-control-system-with-surface-hub.md
index 70f4344966..e3971aa2c6 100644
--- a/devices/surface-hub/use-room-control-system-with-surface-hub.md
+++ b/devices/surface-hub/use-room-control-system-with-surface-hub.md
@@ -13,14 +13,9 @@ Room control systems can be used with your Microsoft Surface Hub.
Using a room control system with your Surface Hub involves connecting room control hardware to the Surface Hub, usually through the RJ11 serial port on the bottom of the Surface Hub.
-## Debugging
+## Terminal settings
-
-You can use the info in this section for debugging scenarios. You shouldn't need it for a typical installation.
-
-### Terminal settings
-
-To connect to a room control system control panel, you don't need to connect to the Surface Hub, or to configure any terminal settings. For debugging purposes, if you want to connect a PC or laptop to your Surface Hub and send commands from the Surface Hub, you can use a terminal emulator program like Tera Term or PuTTY. These are the terminal settings you'll need:
+To connect to a room control system control panel, you don't need to configure any terminal settings on the Surface Hub. If you want to connect a PC or laptop to your Surface Hub and send serial commands from the Surface Hub, you can use a terminal emulator program like Tera Term or PuTTY.
@@ -54,20 +49,24 @@ To connect to a room control system control panel, you don't need to connect to
Flow control |
none |
+
+Line feed |
+every carriage return |
+
-### Wiring diagram
+## Wiring diagram
-You can use a standard RJ-11 (6P6C) connector to connect the Surface Hub serial port to a room control system. This is the recommended method.
+You can use a standard RJ-11 (6P6C) connector to connect the Surface Hub serial port to a room control system. This is the recommended method. You can also use an RJ-11 4-conductor cable, but we do not recommend this method.
-You can also use an RJ-11 4-conductor cable, but we do not recommend this method. You'll need to convert pin numbers to make sure it's wired correctly. The following diagram shows how to convert the pin numbers.
+This diagram shows the correct pinout usedfor an RJ-11 (6P6C) to DB9 cable.
-
+
-### Command sets
+## Command sets
Room control systems use common meeting-room scenarios for commands. Commands originate from the room control system, and are communicated over a serial connection to a Surface Hub. Commands are ASCII based, and the Surface Hub will acknowledge when state changes occur.
@@ -106,7 +105,7 @@ The following command modifiers are available. Commands terminate with a new lin
-### Power
+## Power
Surface Hub can be in one of these power states.
@@ -157,9 +156,72 @@ Surface Hub can be in one of these power states.
-
+In Replacement PC mode, the power states are only Ready and Off and only change the display. The management port can't be used to power on the replacement PC.
-### Brightness
+
+
+
+
+
+
+
+
+
+
+
+0 |
+S5 |
+Off |
+
+
+5 |
+50 |
+Ready |
+
+
+
+
+For a control device, anything other than 5 / Ready should be considered off. Each PowerOn command results in two state changes and reponses.
+
+
+
+
+
+
+
+
+
+
+
+
+PowerOn |
+Device turns on (display + PC). PC service notifies SMC that the PC is ready. |
+Power=0 Power=5 |
+
+
+
+PowerOff |
+Device transitions to ambient state (PC on, display dim). |
+Power=0 |
+
+
+Power? |
+SMC reports the last-known power state. |
+Power=<#> |
+
+
+
+
+
+## Brightness
The current brightness level is a range from 0 to 100.
@@ -191,18 +253,10 @@ Changes to brightness levels can be sent by a room control system, or other syst
PC service notifies SMC of new brightness level.
Brightness = 50 |
-
-Brightness? |
-SMC sends a message over the control channel to request brightness.
-PC service notifies SMC of new brightness level. |
-Brightness = 50 |
-
-
+
-
-
-### Volume
+## Volume
The current volume level is a range from 0 to 100.
@@ -234,47 +288,14 @@ Changes to volume levels can be sent by a room control system, or other system.
PC service notifies SMC of new volume level.
Volume = 50 |
-
-Volume? |
-SMC sends a message over the control channel to request volume.
-PC service notifies SMC of new volume level. |
-Volume = 50 |
-
-### Mute for audio and microphone
+## Mute for audio
-Audio and microphone can be muted.
-
-
-
-
-
-
-
-
-
-
-
-0 |
-Source is not muted. |
-
-
-1 |
-Source is muted. |
-
-
-
-
-
-
-Changes to microphone or audio can be sent by a room control system, or other system.
+Audio can be muted.
@@ -294,32 +315,14 @@ Changes to microphone or audio can be sent by a room control system, or other sy
AudioMute+ |
SMC sends the audio mute command.
PC service notifies SMC that audio is muted. |
-AudioMute=<#> |
-
-
-MicMute+ |
-SMC sends the microphone mute command.
-PC service notifies SMC that microphone is muted. |
-MicMute=<#> |
-
-
-AudioMute? |
-SMC queries PC service for the current audio state.
-PC service notifies SMC that audio is muted. |
-AudioMute=<#> |
-
-
-MicMute? |
-SMC queries PC service for the current microphone state.
-PC service notifies SMC that the microphone is muted. |
-MicMute=<#> |
+none |
-### Video source
+## Video source
Several display sources can be used.
@@ -351,10 +354,6 @@ Several display sources can be used.
3 |
VGA |
-
-4 |
-Wireless |
-
@@ -377,7 +376,7 @@ Changes to display source can be sent by a room control system, or other system.
-Source=<#> |
+Source=# |
SMC changes to the desired source.
PC service notifies SMC that the display source has switched. |
Source=<#> |
@@ -389,7 +388,7 @@ Changes to display source can be sent by a room control system, or other system.
Source=<#> |
-Source+ |
+Source- |
SMC cycles to the previous active input source.
PC service notifies SMC of the current input source. |
Source=<#> |
@@ -403,101 +402,7 @@ Changes to display source can be sent by a room control system, or other system.
-
-
-### Starting apps
-
-Surface Hub keyboard supports starting apps with special keys. Room control systems can invoke those keys through the management port. There is no expected response for these commands.
-
-
-
-
-
-
-
-
-
-
-
-0 |
-Start large-screen experience (LSX) |
-
-
-1 |
-Start LSX custom app 1 |
-
-
-2 |
-Start LSX custom app 2 |
-
-
-3 |
-Start LSX custom app 3 |
-
-
-
-
-
-
-Changes to display source can be sent by a room control system, or other system.
-
-
-
-
-
-
-
-
-
-
-
-
-AppKey=<#> |
-Send a command to
-PC service notifies SMC that the display source has switched. |
-Source=<#> |
-
-
-
-
-
-
-### I'm done
-
-People will be able to start the I'm done feature on a Surface Hub from a room control system. I'm done removes any work that was displayed on the Surface Hub before ending the meeting. No information or files are saved on Surface Hub.
-
-
-
-
-
-
-
-
-
-
-
-
-I'm done |
-Start I'm done activity on Surface Hub. |
-none |
-
-
-
-
-
-
-### Errors
+## Errors
Errors are returned following the format in this table.