{"type":"doc","content":[{"type":"paragraph"},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"This object provides support for the BP200/BP900 USB button boards, GPIO ports, and side buttons on the BrightSign player. Button presses are returned as ","type":"text"},{"text":"roControlUp","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"roControlDown ","type":"text","marks":[{"type":"em"}]},{"text":"events. The object is used to configure output levels on the I/O connector and monitor inputs. Typically, LEDs and buttons are attached to the GPIO connector on the BrightSign player or the BrightSign Expansion Module.","type":"text"}]},{"type":"paragraph","content":[{"text":"The JavaScript equivalent is ","type":"text"},{"text":"controlport","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6579678"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Object Creation: The ","type":"text"},{"text":"roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"object is created with a single parameter that specifies the port being used.","type":"text"}]},{"type":"codeBlock","content":[{"text":"CreateObject(\"roControlPort\", port As String)","type":"text"}]},{"type":"paragraph","content":[{"text":"The port parameter can be one of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BrightSign","type":"text","marks":[{"type":"code"}]},{"text":": Specifies the onboard GPIO connector (including the SVC (GPIO12) button).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expander-GPIO","type":"text","marks":[{"type":"code"}]},{"text":": Specifies the DB-25 connector on the BrightSign Expansion Module. If no BrightSign Expansion module is attached, then object creation will fail and Invalid will be returned.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expander--GPIO","type":"text","marks":[{"type":"code"}]},{"text":": Specifies a ","type":"text"},{"text":"USB-to-GPIO device","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.brightsign.biz/digital-signage-products/accessories/USB-C-Cables"}}]},{"text":" connected to the player. Multiple USB-to-GPIO devices can be controlled using separate ","type":"text"},{"text":"roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"instances: The first device corresponds to ","type":"text"},{"text":"\"Expander-0-GPIO\"","type":"text","marks":[{"type":"code"}]},{"text":", the second to ","type":"text"},{"text":"\"Expander-1-GPIO\"","type":"text","marks":[{"type":"code"}]},{"text":", etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expander-DIP","type":"text","marks":[{"type":"code"}]},{"text":": Specifies the eight DIP switches on the BrightSign Expansion Module. If no BrightSign Expansion module is attached, then object creation will fail and Invalid will be returned.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Hot-plugging the BrightSign Expansion Module is not supported.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Touchboard--GPIO","type":"text","marks":[{"type":"code"}]},{"text":": Retrieves events from the specified BP200/BP900 button board. Events are handled in the same manner as events from the BrightSign port.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Touchboard--LED-SETUP","type":"text","marks":[{"type":"code"}]},{"text":": Sets various LED output options for the specified BP200/BP900 button board.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Touchboard--LED","type":"text","marks":[{"type":"code"}]},{"text":": Sets the bits for each button on the specified BP200/BP900 button board. The bits indicate whether the associated LED should be on or off.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Since multiple BP200/BP900 button boards can be connected to a player simultaneously, the value specifies the port enumeration of each board. This value corresponds to the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" value returned by the ","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"roDeviceInfo.GetUSBTopology()","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527362#roDeviceInfo-getusbtopology"}}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"method. An unspecified enumeration value is synonymous with a button board with an enumeration value of 0 (e.g. Touchboard-GPIO and Touchboard-0-GPIO are identical).","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":" ifControlPort","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The \"button\" numbers described below are not the same as GPIO \"pin\" numbers: Some pins act as power supply or ground, so they are not included in the button numbering scheme. See the ","type":"text"},{"text":"hardware manual","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527536"}}]},{"text":" associated with your player model to view a mapping of buttons to pins.","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"GetVersion() As String","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the version number of the firmware (either the main BrightSign firmware or the BrightSign Expansion Module firmware) responsible for the control port.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"EnableOutput(button As Integer) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Marks the specified button as an output. If an invalid button number is passed, ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":" will be returned. If successful, the function returns ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". The output will be driven high or low depending on the current output state of the pin.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"this page","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6534715#XTx43HardwareInterfaces-gpio_table"}}]},{"text":" for a table of pins and corresponding buttons for the onboard GPIO connector.","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"EnableInput(button As Integer) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Marks the specified button as an input. If an invalid button number is passed, ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":" will be returned. If successful, the function returns ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". The button will be tri-stated and can be driven high or low externally.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"EnableAlternateFunction(button As Integer, pin_function As String) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Enables an alternate function on a GPIO button. This method applies to the onboard GPIO connector and is currently supported on the XTx44, XTx43, XDx34, XDx33, HDx24, HDx23, and HO523 models.","type":"text"}]},{"type":"paragraph","content":[{"text":"The first argument specifies the GPIO button number (between 0 and 7). The second argument specifies the alternate function setting; the following table outlines the possible alternate setting for each pin:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"d4d37d71-dd3d-412e-9e5b-c4062e33a706"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"GPIO Pin","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","content":[{"text":"Button Number","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"Alternate Function","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"0","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"\"serial1\"","type":"text","marks":[{"type":"code"}]},{"text":" (Rx)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"\"irin1\"","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"\"irout\"","type":"text","marks":[{"type":"code"}]},{"text":" (HDx23, HO523 only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"9","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"\"serial0\"","type":"text","marks":[{"type":"code"}]},{"text":" (Rx - console port)*","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"10","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"\"serial0\"","type":"text","marks":[{"type":"code"}]},{"text":" (Tx)*","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"11","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"\"serial1\"","type":"text","marks":[{"type":"code"}]},{"text":" (Tx)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"12","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[182.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[362.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"*Models that do not have a 3.5mm serial port (e.g. HD223, XD233) do not support serial port 0.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"To revert a GPIO button to its primary function, specify the ","type":"text"},{"text":"pin_function","type":"text","marks":[{"type":"code"}]},{"text":" as \"gpio\".","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"GetWholeState() As Integer","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the state of all the inputs attached to the control port as bits in an integer. Individual buttons can be checked using binary operations, although it is normally easier to call ","type":"text"},{"text":"IsInputActive()","type":"text","marks":[{"type":"code"}]},{"text":" instead.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"IsInputActive(button As Integer) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the state of the specified input. If the button is not configured as an input, then the result is undefined.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetWholeState(state As Integer) As Boolean ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"setwholestate"}},"macroMetadata":{"macroId":{"value":"5b3aa2eb-fab7-47cd-b631-57713ca826b1"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"9b6fe427-e295-484a-b923-84ce7925660b"}}]},{"type":"paragraph","content":[{"text":"Specifies the desired state of all outputs attached to the control port as bits in an integer. The individual buttons can be set using binary operations, although it is normally easier to call","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"SetOutputState()","type":"text","marks":[{"type":"code"}]},{"text":" instead.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"port = CreateObject(\"roControlPort\", \"BrightSign\")\ngpio1 = 2 '2^1\ngpio3 = 8 '2^3\ngpio5 = 32 '2^5\ngpio7 = 128 '2^7\nport.SetWholeState(gpio1 + gpio2 + gpio5 + gpio7) 'turns on ports 1, 3, 5, and 7","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"panel","parameters":{"macroParams":{"borderColor":{"value":"#3D3D3D"},"bgColor":{"value":"#F4F4F4"},"titleColor":{"value":"#3D3D3D"},"borderWidth":{"value":"0"},"titleBGColor":{"value":"#3D3D3D"},"borderStyle":{"value":"solid"}},"macroMetadata":{"macroId":{"value":"6041596c-97c4-48dc-8f94-eb2b1d949b1e"},"schemaVersion":{"value":"1"},"title":"Panel"}},"localId":"e82b3878-95c8-4470-b96e-e4ed7bde0ed3"},"content":[{"type":"paragraph","content":[{"text":"ON THIS PAGE","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"indent":{"value":"20px"}},"macroMetadata":{"macroId":{"value":"306a0ee2-1071-4041-8848-67b7049dedf1"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"83203678-8ff1-452a-8a43-3ad8356583d5"}}]}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":5},"content":[{"text":"SetOutputState(button As Integer, level As Boolean) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Configures the output of the specified pin, which can be either \"off\" (0) or \"on\" (1). If the button is not configured as an output, the resulting level is undefined. This method can also be used to configure LED output behavior on BP200/B900 button boards; see the ","type":"text"},{"text":"BP200/BP900 Setup","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"#"}}]},{"text":" section below for more details.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetOutputValue(offset As Integer, bit-mask As Integer) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Configures a button on a BP200/BP900 button board. This method can only be used when the ","type":"text"},{"text":"roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"object is instantiated with the ","type":"text"},{"text":"Touchboard--LED-SETUP","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"Touchboard--LED","type":"text","marks":[{"type":"code"}]},{"text":" parameter. See the ","type":"text"},{"text":"BP200/BP900 Setup","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"#"}}]},{"text":" section below for more details.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetOutputValues(values As roAssociativeArray) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Configures buttons on a BP200/BP900 button board. This method can only be used when the ","type":"text"},{"text":"roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"object is instantiated with the ","type":"text"},{"text":"Touchboard--LED-SETUP","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"Touchboard--LED","type":"text","marks":[{"type":"code"}]},{"text":" parameter. See the ","type":"text"},{"text":"BP200/BP900 Setup","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"#"}}]},{"text":" section below for more details.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"GetProperties() As roAssociativeArray","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns an associative array of values related to the attached BP200/BP900 button board, including hardware, header, and revision. This method can only be used with an ","type":"text"},{"text":"roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"instantiated with the ","type":"text"},{"text":"Touchboard--GPIO","type":"text","marks":[{"type":"code"}]},{"text":" parameter.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetPulseParams(parameters As roAssociativeArray) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Specifies a period of time, as well as the time slices within that period, for pulsing GPIO LEDs. These properties are applied to all GPIO outputs. This method is passed an associative array with the following parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"milliseconds","type":"text","marks":[{"type":"code"}]},{"text":": An integer specifying the time period (in ms) for pulsing","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"slices","type":"text","marks":[{"type":"code"}]},{"text":": An integer specifying the number of divisions within the milliseconds time period: For example, a 500ms time period with slices:2 is divided into two 250ms slices.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetPulse(button As Integer, bit-field As Integer) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Sets the off/on bit field for a particular GPIO. Use the ","type":"text"},{"text":"slices","type":"text","marks":[{"type":"code"}]},{"text":" parameter of the ","type":"text"},{"text":"SetPulseParams()","type":"text","marks":[{"type":"code"}]},{"text":" method to determine the number of bits in the bit field. For example, specifying ","type":"text"},{"text":"milliseconds:500, slices:2","type":"text","marks":[{"type":"code"}]},{"text":", and a bit field of ","type":"text"},{"text":"10","type":"text","marks":[{"type":"code"}]},{"text":" will cause the button to turn on every other 250 millisecond period.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"RemovePulse(button As Integer) As Boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Removes the specified GPIO from the set affected by the pulse.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ifMessagePort","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetPort(port As Object)","type":"text"}]},{"type":"paragraph","content":[{"text":"Posts messages of type ","type":"text"},{"text":" ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527195"}}]},{"text":"roControlUp ","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527195"}}]},{"text":"and ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527195"}}]},{"text":"roControlDown","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527195"}}]},{"text":" ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6527195"}}]},{"text":" to the attached message port.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ifUserData","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"SetUserData(user_data As Object)","type":"text"}]},{"type":"paragraph","content":[{"text":"Sets the user data that will be returned when events are raised.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"GetUserData() As Object","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the user data that has previously been set via ","type":"text"},{"text":"SetUserData()","type":"text","marks":[{"type":"code"}]},{"text":". It will return Invalid if no data has been set.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ifIdentity","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"GetIdentity() As Integer","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns an identity value that can be used to associate ","type":"text"},{"text":"roControlUp","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"roControlDown","type":"text","marks":[{"type":"em"}]},{"text":" events with this control port.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"ifIdentity ","type":"text","marks":[{"type":"em"}]},{"text":"interface has been deprecated. We recommend using the ","type":"text"},{"text":"ifUserData ","type":"text","marks":[{"type":"em"}]},{"text":"interface instead.","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"This example script applies timed pulses to a set of GPIOs:","type":"text"}]},{"type":"codeBlock","content":[{"text":"' set up button 2 and 3 to flash at 2Hz (i.e. on & off twice in a second) in an alternating ' fashion.\n\ngpioPort = CreateObject(\"roControlPort\", \"BrightSign\")\n\ngpioPort.EnableOutput(2)\ngpioPort.SetOutputState(2, true)\n\ngpioPort.EnableOutput(3)\ngpioPort.SetOutputState(3, true)\n\n' set up pulse to have two time slices of 250ms each.\ngpioPort.SetPulseParams({ milliseconds: 500, slices: 2 })\n\n' button 2 will have slice 1 on and slice 2 off.\ngpioPort.SetPulse(2, &h01)\n\n' button 3 will have the reverse of button 2.\ngpioPort.SetPulse(3, &h02)\n\n' wait for a bit.\nsleep(10000)\n\n' stop pulsing on button 2.\ngpioPort.RemovePulse(2)","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"This example script enables various alternate functions on the GPIO:","type":"text"}]},{"type":"codeBlock","content":[{"text":"c = CreateObject(\"roControlPort\", \"BrightSign\")\n \n'Enable serial port 1 on the GPIO.\n \nc.EnableAlternateFunction(0, \"serial1\")\nc.EnableAlternateFunction(6, \"serial1\")\n\ns1 = CreateObject(\"roSerialPort\", 1, 115200)\ns1.SendLine(\"This is serial port 1\")\n\nmp = CreateObject(\"roMessagePort\")\ns1.SetLineEventPort(mp)\n? wait(10000, mp)\n\n'Switch serial port 0 from the 3.5mm serial port to the GPIO.\n'[Note: it is advised use telnet/ssh or a script when testing this]\n\nc.EnableAlternateFunction(4, \"serial0\")\nc.EnableAlternateFunction(5, \"serial0\")\n\ns = CreateObject(\"roSerialPort\", 0, 115200)\ns.SendLine(\"Hello on the console?\")\n\nmp = CreateObject(\"roMessagePort\")\ns.SetLineEventPort(mp)\n? wait(10000, mp)\n\n'Restore normal operation on serial port 0.\n\nc.EnableAlternateFunction(4, \"gpio\")\nc.EnableAlternateFunction(5, \"gpio\")\n\n'Enable IR input on the GPIO.\n\nc = CreateObject(\"roControlPort\", \"brightsign\")\n? c.EnableAlternateFunction(1, \"irin1\")\n\nnexus_encodings = [ \"NEC\", \"NEC32\" ]\nir_gpio = CreateObject(\"roIRReceiver\", { source: \"GPIO\", encodings: nexus_encodings })\n\nmp = CreateObject(\"roMessagePort\")\nir_gpio.SetPort(mp)\n\nm = wait(10000, mp)\n\n'Enable IR output on the GPIO (HDx23, HO523 only--the XT/XD models have a dedicated 3.5mm IR socket)\n\nc.EnableAlternateFunction(2, \"irout\")\n\nir = CreateObject(\"roIRTransmitter\", { destination: \"GPIO\"} )\nir.Send(\"NEC32\", &H12345)","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"BP200/BP900 Setup ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"bp_setup"}},"macroMetadata":{"macroId":{"value":"e7683055-bcfb-431b-9f82-b1461e5c92fe"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"79de9247-86f8-493f-afbd-278eea567ecc"}}]},{"type":"paragraph","content":[{"text":"To send a configuration to the BP200/BP900 button board, instantiate","type":"text"},{"text":" roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"with the ","type":"text"},{"text":"Touchboard--LED-SETUP","type":"text","marks":[{"type":"code"}]},{"text":" parameter and call the ","type":"text"},{"text":"SetOutputValue()","type":"text","marks":[{"type":"code"}]},{"text":" method. This method accepts two integers: the first integer specifies one of three command types (offsets); the second integer is a bit field consisting of 32 bits.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Offset 0","type":"text","marks":[{"type":"strong"}]},{"text":": Configures the button board using a bit field that is split into four bytes of eight bits each. Each byte is a separate part of the configuration. In the script, these bytes need to be listed from right to left in hex value (i.e. Byte 1 + Byte 2 + Byte 3 + Byte 4).","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Byte 1: Specifies the configuration type for the button board. Currently, the only configuration type is for LED output, which is specified with the value &hA0.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Byte 2: The button number(s) that will be configured. Buttons are numbered beginning from 1. The value is set to 0 (&h00) if this command is not required.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Byte 3: The LED bit-field configuration. This value specifies how many on/off bits should be used (up to 32 bits) when ","type":"text"},{"text":"SetOutputValue()","type":"text","marks":[{"type":"code"}]},{"text":" is called on a ","type":"text"},{"text":"Touchboard--LED","type":"text","marks":[{"type":"code"}]},{"text":" instance (see the ","type":"text"},{"text":"BP200/BP900 LED Output","type":"text","marks":[{"type":"strong"}]},{"text":" section below for details). Set the value to 0 (&h00) if this command is not required (the bit field will be set to eight bits by default).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Byte 4: This value is currently always set to 0 (&h00).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Offset 1","type":"text","marks":[{"type":"strong"}]},{"text":": Disables buttons on the button board according to values in the bit field. Each button is disabled individually by setting bits 0-10: For example, passing the hex value &h00000008 will disable button 4 only.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Offset 2","type":"text","marks":[{"type":"strong"}]},{"text":": Disables LEDs on the button board according to values in the bit field. Each LED is disabled individually by setting bits 0-10: For example, passing the hex value &h00000080 will disable the LED on button 8 only.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Disabling a button LED will not automatically disable the button itself (and vice-versa). To disable both the button and the LED, make separate SetOutputValue() calls for Offset 1 and Offset 2.","type":"text"}]}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"BP200/BP900 LED Output","type":"text"}]},{"type":"paragraph","content":[{"text":"To control the behavior of individual button LEDs, instantiate","type":"text"},{"text":" roControlPort ","type":"text","marks":[{"type":"em"}]},{"text":"with the ","type":"text"},{"text":"Touchboard--LED","type":"text","marks":[{"type":"code"}]},{"text":" parameter, then pass per-LED bit fields to the ","type":"text"},{"text":"SetOutputValue()","type":"text","marks":[{"type":"code"}]},{"text":" method. This method accepts two integers: the first integer specifies the button number (0-11), while the second integer uses a bit field to specify the on/off behavior of the button LED. The size of the bit field (up to 32 bits) is determined with the Offset 0 – Byte 3 value described in the section above.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each bit specifies the on/off behavior of a single cycle, and the BP200/BP900 button boards run at approximately 11Hz. For example, if you want an LED to cycle on every other second, you would set the Offset 0 – Byte 3 value to &h16 (22 bits) and the bit field itself to &h3FF800 (0000000000011111111111).","type":"text"}]},{"type":"paragraph","content":[{"text":"This example script sets a BP900 to “twinkle” by turning off each button LED at a different point in the cycle:","type":"text"}]},{"type":"codeBlock","content":[{"text":"led=CreateObject(\"roControlPort\", \"TouchBoard-0-LED\")\nled_setup=CreateObject(\"roControlPort\", \"TouchBoard-0-LED-SETUP\")\nled_setup.SetOutputValue(0, &h000B00A0)\nled.SetOutputValue(0, &h07fe)\nled.SetOutputValue(1, &h07fd)\nled.SetOutputValue(2, &h07fb)\nled.SetOutputValue(3, &h07f7)\nled.SetOutputValue(4, &h07ef)\nled.SetOutputValue(5, &h07df)\nled.SetOutputValue(6, &h07bf)\nled.SetOutputValue(7, &h077f)\nled.SetOutputValue(8, &h06ff)\nled.SetOutputValue(9, &h05ff)\nled.SetOutputValue(10, &h03ff)","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"controlport#Example","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6579678#controlport-Example"}}]},{"text":" for the equivalent example (setting a BP900 to twinkle) in JavaScript.","type":"text"}]}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph"}]}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported