Update doc strings

This commit is contained in:
Triston Armstrong 2021-09-21 10:27:39 -05:00
parent 6cd1e8506f
commit a595f61602
28 changed files with 310 additions and 177 deletions

View File

@ -1,15 +1,21 @@
class CircuitBreakerInterface(): class CircuitBreakerInterface():
""" This class provides a common interface to a circuit breaker on an Extron product (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class provides a common interface to a circuit breaker on an Extron product (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
- Host (object) - handle to Extron device class that instantiated this interface class - Host (object) - handle to Extron device class that instantiated this interface class
- Port (string) - port name (e.g. 'CBR1') - Port (string) - port name (e.g. 'CBR1')
---
Parameters: Parameters:
- Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
- Port - Returns (string) - port name - Port - Returns (string) - port name
- State - Returns (string) - current state of the circuit breaker ('Closed', 'Tripped') - State - Returns (string) - current state of the circuit breaker ('Closed', 'Tripped')
---
Events: Events:
- Offline - (Event) Triggers when the device goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when the device goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
- Online - (Event) Triggers when the device comes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when the device comes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').

View File

@ -7,6 +7,8 @@ class ClientObject():
Note: Note:
- This class cannot be instantiated by the programmer. It is only created by the `EthernetServerInterfaceEx` object. - This class cannot be instantiated by the programmer. It is only created by the `EthernetServerInterfaceEx` object.
---
Parameters: Parameters:
- Hostname - Returns (string) - Hostname DNS name of the connection. Can be the IP Address - Hostname - Returns (string) - Hostname DNS name of the connection. Can be the IP Address
- IPAddress - Returns (string) - the IP Address of the connected device - IPAddress - Returns (string) - the IP Address of the connected device

View File

@ -1,15 +1,21 @@
class ContactInterface(): class ContactInterface():
""" This class will provide a common interface for controlling and collecting data from Contact Input ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class will provide a common interface for controlling and collecting data from Contact Input ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
- Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
- Port (string) - port name (e.g. 'CII1') - Port (string) - port name (e.g. 'CII1')
---
Parameters: Parameters:
- Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
- Port - Returns (string) - port name - Port - Returns (string) - port name
- State - Returns (string) - current state of IO port ('On', 'Off') - State - Returns (string) - current state of IO port ('On', 'Off')
---
Events: Events:
- Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
- Online - (Event) Triggers when port goes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').

View File

@ -1,23 +1,29 @@
class DigitalIOInterface(): class DigitalIOInterface():
""" This class will provide a common interface for controlling and collecting data from Digital IO ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class will provide a common interface for controlling and collecting data from Digital IO ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'DIO1') - Port (string) - port name (e.g. 'DIO1')
(optional) Mode (string) - Possible modes are: 'DigitalInput' (default), and 'DigitalOutput' - (optional) Mode (string) - Possible modes are: 'DigitalInput' (default), and 'DigitalOutput'
(optional) Pullup (bool) - pull-up state on the port - (optional) Pullup (bool) - pull-up state on the port
---
Parameters: Parameters:
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Mode - Returns (string) - mode of the Digital IO port ('DigitalInput', 'DigitalOutput') - Mode - Returns (string) - mode of the Digital IO port ('DigitalInput', 'DigitalOutput')
Port - Returns (string) - port name - Port - Returns (string) - port name
Pullup - Returns (bool) - indicates if the Input port is being pulled up or not - Pullup - Returns (bool) - indicates if the Input port is being pulled up or not
State - Returns (string) - current state of Input port ('On', 'Off') - State - Returns (string) - current state of Input port ('On', 'Off')
---
Events: Events:
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
StateChanged - (Event) Triggers when the input state changes. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('On' or 'Off'). - StateChanged - (Event) Triggers when the input state changes. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('On' or 'Off').
""" """
Host = None Host = None
Port = '' Port = ''

View File

@ -1,17 +1,23 @@
class DigitalInputInterface(): class DigitalInputInterface():
""" This class will provide a common interface for collecting data from Digital Input ports on Extron devices (extronlib.device). he user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class will provide a common interface for collecting data from Digital Input ports on Extron devices (extronlib.device). he user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
- Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
- Port (string) - port name (e.g. 'DII1') - Port (string) - port name (e.g. 'DII1')
- (optional) Pullup (bool) - pull-up state on the port - (optional) Pullup (bool) - pull-up state on the port
---
Parameters: Parameters:
- Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
- Port - Returns (string) - port name - Port - Returns (string) - port name
- Pullup - Returns (bool) - indicates if the Input port is being pulled up or not - Pullup - Returns (bool) - indicates if the Input port is being pulled up or not
- State - Returns (string) - current state of Input port ('On', 'Off') - State - Returns (string) - current state of Input port ('On', 'Off')
---
Events: Events:
- Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
- Online - (Event) Triggers when port goes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes online. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').

View File

@ -4,31 +4,30 @@ class EthernetClientInterface():
Note: In synchronous mode, the user will use SendAndWait to wait for the response. In asynchronous mode, the user will assign a handler function to ReceiveData event handler. Then responses and unsolicited messages will be sent to the users receive data handler. Note: In synchronous mode, the user will use SendAndWait to wait for the response. In asynchronous mode, the user will assign a handler function to ReceiveData event handler. Then responses and unsolicited messages will be sent to the users receive data handler.
Arguments: Arguments:
Hostname (string) - DNS Name of the connection. Can be IP Address - Hostname (string) - DNS Name of the connection. Can be IP Address
IPPort (int) - IP port number of the connection - IPPort (int) - IP port number of the connection
(optional) Protocol (string) - Value for either 'TCP', 'UDP', or 'SSH' - (optional) Protocol (string) - Value for either 'TCP', 'UDP', or 'SSH'
(optional) ServicePort (int) - Sets the port on which to listen for response data, UDP only, zero means listen on port OS assigns - (optional) ServicePort (int) - Sets the port on which to listen for response data, UDP only, zero means listen on port OS assigns
(optional) Credentials (tuple) - Username and password for SSH connection. - (optional) Credentials (tuple) - Username and password for SSH connection.
Parameters: Parameters:
Credentials - Returns (tuple, bool) - Username and password for SSH connection. - Credentials - Returns (tuple, bool) - Username and password for SSH connection.
- Note:
>Note: - returns tuple: ('username', 'password') if provided otherwise None.
> returns tuple: ('username', 'password') if provided otherwise None. - only applies when protocol 'SSH' is used.
> only applies when protocol 'SSH' is used. - Hostname - Returns (string) - server Host name
Hostname - Returns (string) - server Host name - IPAddress - Returns (string) - server IP Address
IPAddress - Returns (string) - server IP Address - IPPort - Returns (int) - IP port number of the connection
IPPort - Returns (int) - IP port number of the connection - Protocol - Returns (string) - Value for either TCP, UDP, 'SSH' connection.
Protocol - Returns (string) - Value for either TCP, UDP, 'SSH' connection. - ServicePort - Returns (int) - the port on which the socket is listening for response data
ServicePort - Returns (int) - the port on which the socket is listening for response data
Events: Events:
Connected - (Event) Triggers when socket connection is established. - Connected - (Event) Triggers when socket connection is established.
Disconnected - (Event) Triggers when the socket connection is broken - Disconnected - (Event) Triggers when the socket connection is broken
ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the EthernetClientInterface instance triggering the event and the second one is a bytes string. - ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the EthernetClientInterface instance triggering the event and the second one is a bytes string.
>Note: - Note:
> The maximum amount of data per ReceiveData event that will be passed into the handler is 1024 bytes. For payloads greater than 1024 bytes, multiple events will be triggered. - The maximum amount of data per ReceiveData event that will be passed into the handler is 1024 bytes. For payloads greater than 1024 bytes, multiple events will be triggered.
> When UDP protocol is used, the data will be truncated to 1024 bytes. - When UDP protocol is used, the data will be truncated to 1024 bytes.
""" """
Hostname = '' Hostname = ''
IPAddress = '' IPAddress = ''

View File

@ -3,26 +3,32 @@ class EthernetServerInterface():
:Warning:: This class is no longer supported. For any new development, EthernetServerInterfaceEx should be used. :Warning:: This class is no longer supported. For any new development, EthernetServerInterfaceEx should be used.
---
Arguments: Arguments:
IPPort (int) - IP port number of the listening service. - IPPort (int) - IP port number of the listening service.
(optional) Protocol (string) - Value for either 'TCP' or 'UDP' - (optional) Protocol (string) - Value for either 'TCP' or 'UDP'
(optional) Interface (string) - Defines the network interface on which to listen ('Any', 'LAN' of 'AVLAN') - (optional) Interface (string) - Defines the network interface on which to listen ('Any', 'LAN' of 'AVLAN')
(optional) ServicePort (int) - sets the port from which the client will send data. Zero means any service port is valid. - (optional) ServicePort (int) - sets the port from which the client will send data. Zero means any service port is valid.
Note: ServicePort is only applicable to 'UDP' protocol type. Note: ServicePort is only applicable to 'UDP' protocol type.
---
Parameters: Parameters:
Hostname - Returns (string) - Hostname DNS name of the connection. Can be the IP Address - Hostname - Returns (string) - Hostname DNS name of the connection. Can be the IP Address
IPAddress - Returns (string) - the IP Address of the connected device - IPAddress - Returns (string) - the IP Address of the connected device
IPPort - Returns (int) - IP Port number of the listening service - IPPort - Returns (int) - IP Port number of the listening service
Interface - Returns (string) - name of interface on which the server is listening - Interface - Returns (string) - name of interface on which the server is listening
Protocol - Returns (string) - Value for either TCP, UDP connection. - Protocol - Returns (string) - Value for either TCP, UDP connection.
ServicePort - Returns (int) - ServicePort port on which the client will listen for data - ServicePort - Returns (int) - ServicePort port on which the client will listen for data
---
Events: Events:
Connected - (Event) Triggers when socket connection is established. - Connected - (Event) Triggers when socket connection is established.
Disconnected - (Event) Triggers when the socket connection is broken - Disconnected - (Event) Triggers when the socket connection is broken
ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the EthernetServerInterface instance triggering the event and the second one is a bytes string. - ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the EthernetServerInterface instance triggering the event and the second one is a bytes string.
""" """
IPPort = 0 IPPort = 0

View File

@ -1,23 +1,29 @@
class EthernetServerInterfaceEx(): class EthernetServerInterfaceEx():
""" This class provides an interface to an Ethernet server that allows a user-defined amount of client connections. After instantiation, the server is started by calling StartListen(). This class allows the user to send data over the Ethernet port in an asynchronous manner using Send() and ReceiveData after a client has connected. """ This class provides an interface to an Ethernet server that allows a user-defined amount of client connections. After instantiation, the server is started by calling StartListen(). This class allows the user to send data over the Ethernet port in an asynchronous manner using Send() and ReceiveData after a client has connected.
---
Arguments: Arguments:
IPPort (int) - IP port number of the listening service. - IPPort (int) - IP port number of the listening service.
(optional) Protocol (string) - Value for either 'TCP' or 'UDP' - (optional) Protocol (string) - Value for either 'TCP' or 'UDP'
(optional) Interface (string) - Defines the network interface on which to listen ('Any', 'LAN' of 'AVLAN') - (optional) Interface (string) - Defines the network interface on which to listen ('Any', 'LAN' of 'AVLAN')
(optional) MaxClients (int) - maximum number of client connections to allow (None == Unlimited, 0 == Invalid) - (optional) MaxClients (int) - maximum number of client connections to allow (None == Unlimited, 0 == Invalid)
---
Parameters: Parameters:
Clients - Returns (list of ClientObject) - List of connected clients. - Clients - Returns (list of ClientObject) - List of connected clients.
IPPort - Returns (int) - IP Port number of the listening service - IPPort - Returns (int) - IP Port number of the listening service
Interface - Returns (string) - name of interface on which the server is listening ('Any', 'LAN' of 'AVLAN') - Interface - Returns (string) - name of interface on which the server is listening ('Any', 'LAN' of 'AVLAN')
MaxClients - Returns (int or None) - maximum number of client connections to allow (None == Unlimited, 0 == Invalid) - MaxClients - Returns (int or None) - maximum number of client connections to allow (None == Unlimited, 0 == Invalid)
Protocol - Returns (string) - socket protocol ('TCP', 'UDP') - Protocol - Returns (string) - socket protocol ('TCP', 'UDP')
---
Events: Events:
Connected - (Event) Triggers when socket connection is established. The callback takes two arguments. The first one is the ClientObject instance triggering the event and the second one is a string ('Connected'). - Connected - (Event) Triggers when socket connection is established. The callback takes two arguments. The first one is the ClientObject instance triggering the event and the second one is a string ('Connected').
Disconnected - (Event) Triggers when the socket connection is broken. The callback takes two arguments. The first one is the ClientObject instance triggering the event and the second one is a string ('Disconnected'). - Disconnected - (Event) Triggers when the socket connection is broken. The callback takes two arguments. The first one is the ClientObject instance triggering the event and the second one is a string ('Disconnected').
ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the ClientObject instance triggering the event and the second one is a bytes string. - ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the ClientObject instance triggering the event and the second one is a bytes string.
""" """
IPPort = 0 IPPort = 0

View File

@ -1,33 +1,35 @@
class FlexIOInterface(): class FlexIOInterface():
""" This class will provide a common interface for controlling and collecting data from Flex IO ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class will provide a common interface for controlling and collecting data from Flex IO ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'FIO1') - Port (string) - port name (e.g. 'FIO1')
(optional) Mode (string) - Possible modes are: 'AnalogInput', 'DigitalInput' (default), and 'DigitalOutput'. - (optional) Mode (string) - Possible modes are: 'AnalogInput', 'DigitalInput' (default), and 'DigitalOutput'.
(optional) Pullup (bool) - pull-up state on the port - (optional) Pullup (bool) - pull-up state on the port
(optional) Upper (float) - upper threshold in volts - (optional) Upper (float) - upper threshold in volts
(optional) Lower (float) - lower threshold in volts - (optional) Lower (float) - lower threshold in volts
---
Parameters: Parameters:
AnalogVoltage - Returns (float) - current voltage of analog input port - AnalogVoltage - Returns (float) - current voltage of analog input port
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Lower - Returns (float) - lower threshold for digital input in volts - Lower - Returns (float) - lower threshold for digital input in volts > Note: Only applicable when Flex IO is in 'DigitalInput' mode.
>Note: Only applicable when Flex IO is in 'DigitalInput' mode. - Mode - Returns (string) - mode of the Flex IO port ('AnalogInput', 'DigitalInput', 'DigitalOutput').
Mode - Returns (string) - mode of the Flex IO port ('AnalogInput', 'DigitalInput', 'DigitalOutput'). - Port - Returns (string) - port name
Port - Returns (string) - port name - Pullup - Returns (bool) - indicates if the input port is being pulled up or not
Pullup - Returns (bool) - indicates if the input port is being pulled up or not - State - Returns (string) - current state of IO port ('On', 'Off')
State - Returns (string) - current state of IO port ('On', 'Off') - Upper - Returns (float) - upper threshold for digital input in volts > Note: Only applicable when Flex IO is in 'DigitalInput' mode.
Upper - Returns (float) - upper threshold for digital input in volts
>Note: Only applicable when Flex IO is in 'DigitalInput' mode. ---
Events: Events:
AnalogVoltageChanged - (Event) triggers when the input voltage changes. The callback takes two arguments. The first one is the extronlib.interface.FlexIOInterface instance triggering the event and the second one is the voltage. - AnalogVoltageChanged - (Event) triggers when the input voltage changes. The callback takes two arguments. The first one is the extronlib.interface.FlexIOInterface instance triggering the event and the second one is the voltage. > Note: Minimum voltage change required to trigger event is 0.05V.
>Note: Minimum voltage change required to trigger event is 0.05V. - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - StateChanged - (Event) Triggers when the input state changes. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('On' or 'Off'). > Note: Only triggers for ports in Input mode.
StateChanged - (Event) Triggers when the input state changes. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('On' or 'Off').
>Note: Only triggers for ports in Input mode.
""" """
Host = None Host = None

View File

@ -3,19 +3,25 @@ class IRInterface():
Note: If an IR/Serial port is passed in and it has already been instantiated as an SerialInterface, an exception will be raised. Note: If an IR/Serial port is passed in and it has already been instantiated as an SerialInterface, an exception will be raised.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g., 'IRS1') - Port (string) - port name (e.g., 'IRS1')
File (string) - IR file name (e.g. 'someDevice.eir') - File (string) - IR file name (e.g. 'someDevice.eir')
---
Parameters: Parameters:
File - Returns (string) - file name - File - Returns (string) - file name
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Port - Returns (string) - port name - Port - Returns (string) - port name
---
Events: Events:
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
""" """
Host = None Host = None

View File

@ -1,21 +1,27 @@
class PoEInterface(): class PoEInterface():
""" This is the interface class for the Power over Ethernet ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This is the interface class for the Power over Ethernet ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g., 'POE1') - Port (string) - port name (e.g., 'POE1')
---
Parameters: Parameters:
CurrentLoad - Returns (float) - the current load of PoE port in watts - CurrentLoad - Returns (float) - the current load of PoE port in watts
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Port - Returns (string) - port name - Port - Returns (string) - port name
PowerStatus - Returns (string) - State of power transmission on the port ('Active', 'Inactive'). 'Active' if there is a device being powered by the port. - PowerStatus - Returns (string) - State of power transmission on the port ('Active', 'Inactive'). 'Active' if there is a device being powered by the port.
State - Returns (string) - current state of IO port ('On', 'Off') - State - Returns (string) - current state of IO port ('On', 'Off')
---
Events: Events:
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
PowerStatusChanged - (Event) Triggers when the state of power transmission on the port changes (e.g. a PoE device is plugged into the port). The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Active' or 'Inactive'). - PowerStatusChanged - (Event) Triggers when the state of power transmission on the port changes (e.g. a PoE device is plugged into the port). The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Active' or 'Inactive').
""" """
Host = None Host = None
@ -46,6 +52,5 @@ class PoEInterface():
pass pass
def Toggle(self, State): def Toggle(self, State):
""" Changes the state to the logical opposite of the current state. """ Changes the state to the logical opposite of the current state. """
"""
pass pass

View File

@ -1,18 +1,24 @@
class RelayInterface(): class RelayInterface():
""" This class provides a common interface for controlling relays on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class provides a common interface for controlling relays on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'RLY1') - Port (string) - port name (e.g. 'RLY1')
---
Parameters: Parameters:
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Port - Returns (string) - port name - Port - Returns (string) - port name
State - Returns (string) - current state of Relay port ('Close', 'Open') - State - Returns (string) - current state of Relay port ('Close', 'Open')
---
Events: Events:
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
""" """
Host = None Host = None
Port = '' Port = ''

View File

@ -1,20 +1,26 @@
class SWACReceptacleInterface(): class SWACReceptacleInterface():
""" This class provides a common interface to a switched AC power receptacle on an Extron product (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class provides a common interface to a switched AC power receptacle on an Extron product (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'SAC1') - Port (string) - port name (e.g. 'SAC1')
---
Parameters: Parameters:
CurrentChanged - Returns (float) - instantaneous current draw in Amperes - CurrentChanged - Returns (float) - instantaneous current draw in Amperes
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Port - Returns (string) - port name - Port - Returns (string) - port name
State - Returns (string) - current state of receptacle ('On', 'Off') - State - Returns (string) - current state of receptacle ('On', 'Off')
---
Events: Events:
CurrentChanged - (Event) triggers when the current draw changes. The callback takes two arguments. The first one is the SWACReceptacleInterface instance triggering the event, and the second is the current. - CurrentChanged - (Event) triggers when the current draw changes. The callback takes two arguments. The first one is the SWACReceptacleInterface instance triggering the event, and the second is the current.
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
""" """
Current = 0.0 Current = 0.0

View File

@ -1,18 +1,24 @@
class SWPowerInterface(): class SWPowerInterface():
""" This is the interface class for the Switched Power ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This is the interface class for the Switched Power ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'SPI1') - Port (string) - port name (e.g. 'SPI1')
---
Parameters: Parameters:
Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class - Host - Returns (extronlib.device) - handle to Extron device class that instantiated this interface class
Port - Returns (string) - port name - Port - Returns (string) - port name
State - Returns (string) - current state of IO port ('On', 'Off') - State - Returns (string) - current state of IO port ('On', 'Off')
---
Events: Events:
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
""" """
Host = None Host = None

View File

@ -1,37 +1,43 @@
class SerialInterface(): class SerialInterface():
""" This class provides an interface to a serial port. This class allows the user to send data over the serial port in a synchronous or asynchronous manner. This class is used for all ports capable of serial communication (e.g., Serial Ports, IR Serial Ports). """ This class provides an interface to a serial port. This class allows the user to send data over the serial port in a synchronous or asynchronous manner. This class is used for all ports capable of serial communication (e.g., Serial Ports, IR Serial Ports).
>Note: Note:
> In synchronous mode, the user will use SendAndWait() to wait for the response. - In synchronous mode, the user will use SendAndWait() to wait for the response.
> In asynchronous mode, the user will assign a handler function to ReceiveData to handle responses. - In asynchronous mode, the user will assign a handler function to ReceiveData to handle responses.
> If an IR/Serial port is passed in and it has already been instantiated as an IRInterface, an exception will be raised. - If an IR/Serial port is passed in and it has already been instantiated as an IRInterface, an exception will be raised.
---
Arguments: Arguments:
Host (extronlib.device) - handle to Extron device class that instantiated this interface class - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'COM1', 'IRS1') - Port (string) - port name (e.g. 'COM1', 'IRS1')
(optional) Baud (int) - baudrate - (optional) Baud (int) - baudrate
(optional) Data (int) - number of data bits - (optional) Data (int) - number of data bits
(optional) Parity (string) - 'None', 'Odd' or 'Even' - (optional) Parity (string) - 'None', 'Odd' or 'Even'
(optional) Stop (int) - number of stop bits - (optional) Stop (int) - number of stop bits
(optional) FlowControl (string) - 'HW', 'SW', or 'Off' - (optional) FlowControl (string) - 'HW', 'SW', or 'Off'
(optional) CharDelay (float) - time between each character sent to the connected device - (optional) CharDelay (float) - time between each character sent to the connected device
(optional) Mode (string) - mode of the port, 'RS232', 'RS422' or 'RS485' - (optional) Mode (string) - mode of the port, 'RS232', 'RS422' or 'RS485'
---
Parameters: Parameters:
Baud - Returns (int) - the baud rate - Baud - Returns (int) - the baud rate
CharDelay - Returns (float) - inter-character delay - CharDelay - Returns (float) - inter-character delay
Data - Returns (int) - the number of data bits - Data - Returns (int) - the number of data bits
FlowControl - Returns (string) - flow control - FlowControl - Returns (string) - flow control
Host - Returns (extronlib.device) - the host device - Host - Returns (extronlib.device) - the host device
Mode - Returns (string) - the current Mode - Mode - Returns (string) - the current Mode
Parity - Returns (string) - parity - Parity - Returns (string) - parity
Port - Returns (string) - the port name this interface is attached to - Port - Returns (string) - the port name this interface is attached to
Stop - Returns (int) - number of stop bits - Stop - Returns (int) - number of stop bits
---
Events: Events:
Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline'). - Offline - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Offline').
Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online'). - Online - (Event) Triggers when port goes offline. The callback takes two arguments. The first one is the extronlib.interface instance triggering the event and the second one is a string ('Online').
ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the SerialInterface instance triggering the event and the second one is a bytes string. - ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the SerialInterface instance triggering the event and the second one is a bytes string.
""" """
Host = None Host = None
Port = '' Port = ''

View File

@ -1,17 +1,22 @@
class VolumeInterface(): class VolumeInterface():
""" This class will provide a common interface for controlling and collecting data from Volume Ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices. """ This class will provide a common interface for controlling and collecting data from Volume Ports on Extron devices (extronlib.device). The user can instantiate the class directly or create a subclass to add, remove, or alter behavior for different types of devices.
Arguments: ---
Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Port (string) - port name (e.g. 'VOL1')
Host - Returns (extronlib.device) - the host device Arguments:
Level - Returns (int) - Current volume level (percentage). - Host (extronlib.device) - handle to Extron device class that instantiated this interface class
Max - Returns (float) - Maximum level (0.0 V < Max <= 10.0 V). - Port (string) - port name (e.g. 'VOL1')
Min - Returns (float) - Minimum level (0.0 V <= Min < 10.0 V).
Mute - Returns (string) - Current state of volume port mute. ('On', 'Off') ---
Port - Returns (string) - the port name this interface is attached to
SoftStart - Returns (string) - Current state of Soft Start. ('Enabled', 'Disabled') Parameters:
- Host - Returns (extronlib.device) - the host device
- Level - Returns (int) - Current volume level (percentage).
- Max - Returns (float) - Maximum level (0.0 V < Max <= 10.0 V).
- Min - Returns (float) - Minimum level (0.0 V <= Min < 10.0 V).
- Mute - Returns (string) - Current state of volume port mute. ('On', 'Off')
- Port - Returns (string) - the port name this interface is attached to
- SoftStart - Returns (string) - Current state of Soft Start. ('Enabled', 'Disabled')
""" """
Host = None Host = None
Port = '' Port = ''

View File

@ -7,6 +7,8 @@ class SummitConnect():
Note: Note:
- System limits 15 SummitConnect clients per system. - System limits 15 SummitConnect clients per system.
---
Arguments: Arguments:
- Hostname (string) - Hostname of the host computer. Can be IP Address. - Hostname (string) - Hostname of the host computer. Can be IP Address.
- IPPort (int) - IP Port the software is listening on (default is 5000) - IPPort (int) - IP Port the software is listening on (default is 5000)
@ -14,12 +16,16 @@ class SummitConnect():
Note: Note:
- Only one object can be instantiated for a given Hostname or IP Address. - Only one object can be instantiated for a given Hostname or IP Address.
---
Parameters: Parameters:
- Hostname - Returns (string) - Hostname of the host computer `Note: If unavailable, returns the IP Address.` - Hostname - Returns (string) - Hostname of the host computer `Note: If unavailable, returns the IP Address.`
- IPAddress - Returns (string) - IP Address of the host computer - IPAddress - Returns (string) - IP Address of the host computer
- IPPort - Returns (int) - IP Port the software is listening on (default is 5000) - IPPort - Returns (int) - IP Port the software is listening on (default is 5000)
- ListeningPort - Returns (int) - IP Port this SummitConnect instance is listening on for received data - ListeningPort - Returns (int) - IP Port this SummitConnect instance is listening on for received data
---
Events: Events:
- Connected (Event) Triggers when communication is established. The callback takes two arguments. The first one is the SummitConnect instance triggering the event and the second one is a string ('Connected'). - Connected (Event) Triggers when communication is established. The callback takes two arguments. The first one is the SummitConnect instance triggering the event and the second one is a string ('Connected').
- Disconnected (Event) Triggers when the communication is broken. The callback takes two arguments. The first one is the SummitConnect instance triggering the event and the second one is a string ('Disconnected'). - Disconnected (Event) Triggers when the communication is broken. The callback takes two arguments. The first one is the SummitConnect instance triggering the event and the second one is a string ('Disconnected').

View File

@ -8,11 +8,15 @@ class Clock():
- When DST causes the clock to spring forward one hour, events scheduled within the skipped hour do not fire. - When DST causes the clock to spring forward one hour, events scheduled within the skipped hour do not fire.
- When DST causes the clock to fall back an hour, events scheduled within the repeated hour fire twice. - When DST causes the clock to fall back an hour, events scheduled within the repeated hour fire twice.
---
Arguments: Arguments:
- Times (list of strings) - list of times (e.g. 'HH:MM:SS') of day to call Function - Times (list of strings) - list of times (e.g. 'HH:MM:SS') of day to call Function
- Days (list of strings) - list of weekdays to set alarm. If Days is omitted, the alarm is set for every weekday - Days (list of strings) - list of weekdays to set alarm. If Days is omitted, the alarm is set for every weekday
- Function (function) - function to execute when alarm time is up - Function (function) - function to execute when alarm time is up
---
Parameters: Parameters:
- Days - Returns (list of strings) - list of days to execute - Days - Returns (list of strings) - list of days to execute
> Note: list will be empty if it was not provided to the constructor (i.e. the Clock is set for every day). > Note: list will be empty if it was not provided to the constructor (i.e. the Clock is set for every day).

View File

@ -6,6 +6,8 @@ class Email():
Note: default sender will be login username@unit-name or hostname@unit-name if there is no authentication. To override, call Sender() Note: default sender will be login username@unit-name or hostname@unit-name if there is no authentication. To override, call Sender()
---
Arguments: Arguments:
- smtpServer (string) - ip address or hostname of SMTP server - smtpServer (string) - ip address or hostname of SMTP server
- port (int) - port number - port (int) - port number

View File

@ -6,6 +6,8 @@ class File():
Note: File class accesses user area with admin privileges. Note: File class accesses user area with admin privileges.
---
Arguments: Arguments:
- Filename (string) - Name of file to open - Filename (string) - Name of file to open
- mode (string) - the mode in which the files is opened. - mode (string) - the mode in which the files is opened.
@ -18,6 +20,8 @@ class File():
Note: For restricted file access, substitute File with RFile in the examples above and below. Note: For restricted file access, substitute File with RFile in the examples above and below.
---
Parameters: Parameters:
- Filename - Returns (string) - name of file - Filename - Returns (string) - name of file
""" """

View File

@ -4,6 +4,8 @@ from typing import Union
class MESet(): class MESet():
""" The Mutually Exclusive set allows for the grouping of objects to allow easy selection of related items. For instance, a group of buttons could be grouped so that selecting one button deselects the others in the group. """ The Mutually Exclusive set allows for the grouping of objects to allow easy selection of related items. For instance, a group of buttons could be grouped so that selecting one button deselects the others in the group.
---
Compatible extronlib classes: Compatible extronlib classes:
- IOInterface (and any children): - IOInterface (and any children):
- extronlib.interface.RelayInterface - extronlib.interface.RelayInterface
@ -12,6 +14,8 @@ class MESet():
- extronlib.interface.SWPowerInterface - extronlib.interface.SWPowerInterface
- Button: - Button:
---
Arguments: Arguments:
- Objects (list) - list of compatible objects - Objects (list) - list of compatible objects
@ -21,6 +25,8 @@ class MESet():
- Any object with a SetState function that takes an integer object is compatible with this class. - Any object with a SetState function that takes an integer object is compatible with this class.
- A programmer can create their own class and use it with MESet. - A programmer can create their own class and use it with MESet.
---
Parameters: Parameters:
- Objects - Returns (list) - the list of objects to track - Objects - Returns (list) - the list of objects to track
""" """

View File

@ -4,6 +4,8 @@ from typing import Union
class RFile(): class RFile():
""" Access to restricted files. These files can only be created and accessed within the program. Files can be uploaded to provide initial values via the Global Scripter® project. """ Access to restricted files. These files can only be created and accessed within the program. Files can be uploaded to provide initial values via the Global Scripter® project.
---
Arguments: Arguments:
- Filename (string) - Name of file to open - Filename (string) - Name of file to open
- mode (string) - the mode in which the files is opened. - mode (string) - the mode in which the files is opened.
@ -16,6 +18,8 @@ class RFile():
Note: For restricted file access, substitute File with RFile in the examples above and below. Note: For restricted file access, substitute File with RFile in the examples above and below.
---
Parameters: Parameters:
- Filename - Returns (string) - name of file - Filename - Returns (string) - name of file
""" """

View File

@ -7,16 +7,22 @@ class Timer():
In addition to being used as a decorator, Timer can be named and modified. In addition to being used as a decorator, Timer can be named and modified.
---
Arguments: Arguments:
- Interval (float) - How often to call the handler in seconds (minimum interval is 0.1s). - Interval (float) - How often to call the handler in seconds (minimum interval is 0.1s).
- Function (function) - Handler function to execute each Interval. - Function (function) - Handler function to execute each Interval.
---
Parameters: Parameters:
- Count - Returns (int) - Number of events triggered by this timer. - Count - Returns (int) - Number of events triggered by this timer.
- Function - Returns (function) - Handler function to execute each Interval. Function must accept exactly two parameters, which are the Timer that called it and the Count. - Function - Returns (function) - Handler function to execute each Interval. Function must accept exactly two parameters, which are the Timer that called it and the Count.
- Interval - Returns (float) - How often to call the handler in seconds. - Interval - Returns (float) - How often to call the handler in seconds.
- State - Returns (string) - Current state of Timer ('Running', 'Paused', 'Stopped') - State - Returns (string) - Current state of Timer ('Running', 'Paused', 'Stopped')
---
Events: Events:
- StateChanged - (Event) Triggers when the timer state changes. The callback takes two arguments. The first is the Timer instance triggering the event and the second is a string ('Running', 'Paused', 'Stopped'). - StateChanged - (Event) Triggers when the timer state changes. The callback takes two arguments. The first is the Timer instance triggering the event and the second is a string ('Running', 'Paused', 'Stopped').
""" """

View File

@ -3,10 +3,14 @@ class Wait():
In addition to being used as a one-shot (decorator), Wait can be named and reusable. In addition to being used as a one-shot (decorator), Wait can be named and reusable.
---
Arguments: Arguments:
- Time (float) - Expiration time of the wait in seconds - Time (float) - Expiration time of the wait in seconds
- Function (function) - Code to execute when Time expires - Function (function) - Code to execute when Time expires
---
Parameters: Parameters:
- Function - Returns (function) - Code to execute when Time expires. - Function - Returns (function) - Code to execute when Time expires.
- Time - Returns (float) - Expiration time of the wait in seconds with 10ms precision. - Time - Returns (float) - Expiration time of the wait in seconds with 10ms precision.

View File

@ -7,32 +7,36 @@ class Button():
A button may trigger several events depending on the configuration; however, Touch Panels only issue Pressed and Released messages to the controller. Other events (e.g., Held, Repeated) are timer driven within the Button instance. A button may trigger several events depending on the configuration; however, Touch Panels only issue Pressed and Released messages to the controller. Other events (e.g., Held, Repeated) are timer driven within the Button instance.
---
Arguments: Arguments:
UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject - `UIHost` (extronlib.device.UIDevice) - Device object hosting this UIObject
ID (int,string) - ID or Name of the UIObject - `ID` (int,string) - ID or Name of the UIObject
(optional) holdTime (float) - Time for Held event. Held event is triggered only once if the button is pressed and held beyond this time. If holdTime is given, it must be a floating point number specifying period of time in seconds of button being pressed and held to trigger Held event. - (optional) `holdTime` (float) - Time for Held event. Held event is triggered only once if the button is pressed and held beyond this time. If holdTime is given, it must be a floating point number specifying period of time in seconds of button being pressed and held to trigger Held event.
(optional) repeatTime (float) - Time for Repeated event. After holdTime expires, the Repeated event is triggered for every additional repeatTime of button being held. If repeatTime is given, it must be a floating point number specifying time in seconds of button being held. - (optional) `repeatTime` (float) - Time for Repeated event. After holdTime expires, the Repeated event is triggered for every additional repeatTime of button being held. If repeatTime is given, it must be a floating point number specifying time in seconds of button being held.
Note: If button is released before holdTime expires, a Tapped event is triggered instead of a Released event. If the button is released after holdTime expires, there will be no Tapped event. Note: If button is released before holdTime expires, a Tapped event is triggered instead of a Released event. If the button is released after holdTime expires, there will be no Tapped event.
Parameters: ---
BlinkState - Returns (string) - the current blink state ('Not blinking' or 'Blinking')
Enabled - Returns (bool) - True if the control object is enabled else False
Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object
ID - Returns (int) - the object ID
Name - Returns (string) - the object Name
PressedState - Returns (bool) - True if the button is pressed, else False
State - Returns (int) - the current visual state number
> Note: It does not return the current state if the button is blinking.
Visible - Returns (bool) - True if the control object is visible else False
Parameters:
- `BlinkState` - Returns (string) - the current blink state ('Not blinking' or 'Blinking')
- `Enabled` - Returns (bool) - True if the control object is enabled else False
- `Host` - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object
- `ID` - Returns (int) - the object ID
- `Name` - Returns (string) - the object Name
- `PressedState` - Returns (bool) - True if the button is pressed, else False
- `State` - Returns (int) - the current visual state number > Note: It does not return the current state if the button is blinking.
- `Visible` - Returns (bool) - True if the control object is visible else False
---
Events: Events:
Held - (Event) Get/Set the callback when hold expire event is triggered. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Held). - `Held` - (Event) Get/Set the callback when hold expire event is triggered. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Held).
Pressed - (Event) Get/Set the callback when the button is pressed. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Pressed). - `Pressed` - (Event) Get/Set the callback when the button is pressed. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Pressed).
Released - (Event) Get/Set the callback when the button is released. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Held). - `Released` - (Event) Get/Set the callback when the button is released. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Held).
Repeated - (Event) Get/Set the callback when repeat event is triggered. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Repeated). - `Repeated` - (Event) Get/Set the callback when repeat event is triggered. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Repeated).
Tapped - (Event) Get/Set the callback when tap event is triggered. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Tapped). - `Tapped` - (Event) Get/Set the callback when tap event is triggered. The callback function must accept exactly two parameters, which are the Button that triggers the event and the state (e.g. Tapped).
""" """
UIHost = None UIHost = None
ID = 0 ID = 0

View File

@ -1,14 +1,20 @@
class Knob(): class Knob():
""" Knob is a rotary control that has 36 steps for a full revolution """ Knob is a rotary control that has 36 steps for a full revolution
---
Arguments: Arguments:
- UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject - UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject
- ID (int) - ID of the UIObject - ID (int) - ID of the UIObject
---
Parameters: Parameters:
- Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object - Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object
- ID - Returns (int) - the object ID - ID - Returns (int) - the object ID
---
Events: Events:
- Turned - (Event) Get/Set callback when knob is turned. The callback takes two parameters. The first one is the Knob itself and the second one is a signed integer indicating steps that was turned. Positive values indicate clockwise rotation. - Turned - (Event) Get/Set callback when knob is turned. The callback takes two parameters. The first one is the Knob itself and the second one is a signed integer indicating steps that was turned. Positive values indicate clockwise rotation.
""" """

View File

@ -4,10 +4,14 @@ import device
class Label(): class Label():
""" Label object displays text string on the screen """ Label object displays text string on the screen
---
Arguments: Arguments:
- UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject - UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject
- ID (int,string) - ID or Name of the UIObject - ID (int,string) - ID or Name of the UIObject
---
Parameters: Parameters:
- Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object - Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object
- ID - Returns (int) - the object ID - ID - Returns (int) - the object ID

View File

@ -5,10 +5,14 @@ import device
class Level(): class Level():
""" This module defines interfaces of Level UI. """ This module defines interfaces of Level UI.
---
Arguments: Arguments:
- UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject - UIHost (extronlib.device.UIDevice) - Device object hosting this UIObject
- ID (int) - ID of the UIObject - ID (int) - ID of the UIObject
---
Parameters: Parameters:
- Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object - Host - Returns (extronlib.device.UIDevice) - UIDevice object that hosts this control object
- ID - Returns (int) - the object ID - ID - Returns (int) - the object ID