Difference between revisions of "Connect-170 Mini Editor"

From I-CubeX Wiki
Jump to: navigation, search
Line 5: Line 5:
 
[[File:connect-170_digitizer_view_wd_mini_editor_standalone.png|500px]]  
 
[[File:connect-170_digitizer_view_wd_mini_editor_standalone.png|500px]]  
  
 +
 +
==Activation status==
  
 
Each sensor/actuator port that is configured with a sensor processing setting will be shown as a button. When the port is active (on), it will be shown in blue as shown above.  
 
Each sensor/actuator port that is configured with a sensor processing setting will be shown as a button. When the port is active (on), it will be shown in blue as shown above.  
 +
 +
 +
==Ghost mode==
  
 
In stand alone mode, if holding down the Shift key on the keyboard while clicking a button, the sensor input will be set to ghost mode. The input will then process the data from the adjacent lower-numbered input such that this data can be mapped to another MIDI message. Use the same sensor type and method selection for inputs set to ghost mode and the input from which the data originates.
 
In stand alone mode, if holding down the Shift key on the keyboard while clicking a button, the sensor input will be set to ghost mode. The input will then process the data from the adjacent lower-numbered input such that this data can be mapped to another MIDI message. Use the same sensor type and method selection for inputs set to ghost mode and the input from which the data originates.
Line 13: Line 18:
 
[[File:connect-170_digitizer_view_wd_input_ghost.png|120px]]  
 
[[File:connect-170_digitizer_view_wd_input_ghost.png|120px]]  
  
 +
 +
==Solo==
  
 
In stand alone mode, if holding down the Control key on the keyboard while clicking a button, the sensor input will be set to Solo operation so that only that sensor input sends messages. All other buttons will be disabled and show as greyed out. This feature is intended for use when configuring the (software or hardware) device that receives the messages, making it easier to determine which input is sending the message.
 
In stand alone mode, if holding down the Control key on the keyboard while clicking a button, the sensor input will be set to Solo operation so that only that sensor input sends messages. All other buttons will be disabled and show as greyed out. This feature is intended for use when configuring the (software or hardware) device that receives the messages, making it easier to determine which input is sending the message.
Line 19: Line 26:
 
[[File:connect-163_digitizer_view_wd_solo.png|120px]]  
 
[[File:connect-163_digitizer_view_wd_solo.png|120px]]  
  
 +
 +
==Actuator output==
  
 
If holding down the Alt/Option key on the keyboard while clicking the button will turn on or off the actuator output. If the port is configured for an analog sensor the actuator output pin is switched between logic 1 (on) or 0 (off). If the port is configured for a digital I2C actuator, the actuator is turned on or off. The button will show the number  underlined if the output is turned on.
 
If holding down the Alt/Option key on the keyboard while clicking the button will turn on or off the actuator output. If the port is configured for an analog sensor the actuator output pin is switched between logic 1 (on) or 0 (off). If the port is configured for a digital I2C actuator, the actuator is turned on or off. The button will show the number  underlined if the output is turned on.
Line 25: Line 34:
 
[[File:connect-163_digitizer_view_wd_actuators.png|120px]]  
 
[[File:connect-163_digitizer_view_wd_actuators.png|120px]]  
  
 +
 +
==Level indicator==
  
 
For each sensor/actuator port, below the on/off button, there is a grey/green slider indicating the current sensor value if it's an analog sensor, with an update frequency of approx. 20 Hz. For digital I2C sensors, since they usually output multiple parameters with different values which cannot be separately displayed by this slider, the slider shows the maximum value, ie. it remains green if sensor data data was received. Since the updating of these input level indicators is somewhat CPU intensive, for best real-time performance when using analog sensors, close (hide) the digitizer view window. If an actuator is connected to the port, no level will be indicated.
 
For each sensor/actuator port, below the on/off button, there is a grey/green slider indicating the current sensor value if it's an analog sensor, with an update frequency of approx. 20 Hz. For digital I2C sensors, since they usually output multiple parameters with different values which cannot be separately displayed by this slider, the slider shows the maximum value, ie. it remains green if sensor data data was received. Since the updating of these input level indicators is somewhat CPU intensive, for best real-time performance when using analog sensors, close (hide) the digitizer view window. If an actuator is connected to the port, no level will be indicated.
  
By clicking on the slider the sensor can be selected from a menu, so that the digitizer can be configured for the sensor or actuator that is connected to the port. The available menu entries vary according to the digitizer firmware (the picture below shows the available menu entries for a WiDig with firmware 8.2).  
+
 
 +
==Sensor or actuator selection==
 +
 
 +
By clicking on the grey/green slider below on/off button, the sensor can be selected from a menu, so that the digitizer can be configured for the sensor or actuator that is connected to the port. The available menu entries vary according to the digitizer firmware (the picture below shows the available menu entries for a WiDig with firmware 8.2).  
  
 
Each sensor input on/off button also doubles as a control for turning an actuator output on or off by clicking the button while holding down the Alt/Option key on the keyboard.
 
Each sensor input on/off button also doubles as a control for turning an actuator output on or off by clicking the button while holding down the Alt/Option key on the keyboard.
Line 36: Line 50:
  
  
By clicking again on this slider and selecting the same sensor or actuator a field will appear that allows you to enter the method (only applicable to digital I2C sensors or actuators).  
+
By clicking again on this slider and selecting the same sensor or actuator a field will appear that allows you to enter the method (only applicable to digital I2C sensors or actuators). For sensors, methods are software routines that select, process and/or format the available data from the sensor. For actuators, methods are software routines that execute a feature of the actuator.
  
  
Line 47: Line 61:
 
[[File:connect-150_digitizer_view_config_error.png]]  
 
[[File:connect-150_digitizer_view_config_error.png]]  
  
 +
 +
==Auto-load==
  
 
The Auto-Load feature, when the toggle is set, saves the configuration to Connect's preferences file. Now, when switching mode, or when Connect is re-started, the configuration will be loaded from Connect's preferences file.  
 
The Auto-Load feature, when the toggle is set, saves the configuration to Connect's preferences file. Now, when switching mode, or when Connect is re-started, the configuration will be loaded from Connect's preferences file.  
 +
 +
 +
==Reset==
  
 
The Reset button sends a RESET message to the digitizer, which will instruct the digitizer to execute a software reset. Clicking the Reset button while holding down the Alt/Option key on the keyboard, and while the digitizer is in standalone mode, will send a CLEAR CONFIG message to the digitizer, which will clear the digitizer's standalone configuration. See the digitizer's [[Firmware | firmware specification]] for details.
 
The Reset button sends a RESET message to the digitizer, which will instruct the digitizer to execute a software reset. Clicking the Reset button while holding down the Alt/Option key on the keyboard, and while the digitizer is in standalone mode, will send a CLEAR CONFIG message to the digitizer, which will clear the digitizer's standalone configuration. See the digitizer's [[Firmware | firmware specification]] for details.

Revision as of 13:39, 2 May 2023

The mini editor provides some control over the internal configuration of the digitizer. To access all the digitizer's standalone mode configuration settings use EditorX.


Connect-170 digitizer view wd mini editor host.png Connect-170 digitizer view wd mini editor standalone.png


Activation status

Each sensor/actuator port that is configured with a sensor processing setting will be shown as a button. When the port is active (on), it will be shown in blue as shown above.


Ghost mode

In stand alone mode, if holding down the Shift key on the keyboard while clicking a button, the sensor input will be set to ghost mode. The input will then process the data from the adjacent lower-numbered input such that this data can be mapped to another MIDI message. Use the same sensor type and method selection for inputs set to ghost mode and the input from which the data originates.


Connect-170 digitizer view wd input ghost.png


Solo

In stand alone mode, if holding down the Control key on the keyboard while clicking a button, the sensor input will be set to Solo operation so that only that sensor input sends messages. All other buttons will be disabled and show as greyed out. This feature is intended for use when configuring the (software or hardware) device that receives the messages, making it easier to determine which input is sending the message.


Connect-163 digitizer view wd solo.png


Actuator output

If holding down the Alt/Option key on the keyboard while clicking the button will turn on or off the actuator output. If the port is configured for an analog sensor the actuator output pin is switched between logic 1 (on) or 0 (off). If the port is configured for a digital I2C actuator, the actuator is turned on or off. The button will show the number underlined if the output is turned on.


Connect-163 digitizer view wd actuators.png


Level indicator

For each sensor/actuator port, below the on/off button, there is a grey/green slider indicating the current sensor value if it's an analog sensor, with an update frequency of approx. 20 Hz. For digital I2C sensors, since they usually output multiple parameters with different values which cannot be separately displayed by this slider, the slider shows the maximum value, ie. it remains green if sensor data data was received. Since the updating of these input level indicators is somewhat CPU intensive, for best real-time performance when using analog sensors, close (hide) the digitizer view window. If an actuator is connected to the port, no level will be indicated.


Sensor or actuator selection

By clicking on the grey/green slider below on/off button, the sensor can be selected from a menu, so that the digitizer can be configured for the sensor or actuator that is connected to the port. The available menu entries vary according to the digitizer firmware (the picture below shows the available menu entries for a WiDig with firmware 8.2).

Each sensor input on/off button also doubles as a control for turning an actuator output on or off by clicking the button while holding down the Alt/Option key on the keyboard.


Connect-165 digitizer view input menu.png


By clicking again on this slider and selecting the same sensor or actuator a field will appear that allows you to enter the method (only applicable to digital I2C sensors or actuators). For sensors, methods are software routines that select, process and/or format the available data from the sensor. For actuators, methods are software routines that execute a feature of the actuator.


Connect-150 digitizer view input method field.png


If a sensor or actuator is selected from the menu while it is not physically connected to the port on the digitizer, the digitizer may output error messages. If the configuration error applies to a specific port, its input level indicator will switch between its minimum and maximum level each time an error message is received, and an error message text will be shown to the right of the interval field. Error message 90 as shown below refers to a configuration error, which in this case is the port being configured for a different sensor than connected.


Connect-150 digitizer view config error.png


Auto-load

The Auto-Load feature, when the toggle is set, saves the configuration to Connect's preferences file. Now, when switching mode, or when Connect is re-started, the configuration will be loaded from Connect's preferences file.


Reset

The Reset button sends a RESET message to the digitizer, which will instruct the digitizer to execute a software reset. Clicking the Reset button while holding down the Alt/Option key on the keyboard, and while the digitizer is in standalone mode, will send a CLEAR CONFIG message to the digitizer, which will clear the digitizer's standalone configuration. See the digitizer's firmware specification for details.