StudioX Plugins/en: Difference between revisions

From BEASTX Wiki
Jump to navigation Jump to search
FuzzyBot (talk | contribs)
Importing a new version from external source
FuzzyBot (talk | contribs)
Importing a new version from external source
(23 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Basic functionality|noerror}}
{{DISPLAYTITLE:Basic functionality|noerror}}
{{TOC_StudioX}}
__TOC__
__TOC__
<br />
<br />
=General=
 
Due to a plugin-based architecture StudioX is compatible with many different devices. At the moment these plugins are available:
=Connecting a device to StudioX=
* MICROBEAST
StudioX can be used to work with serveral types of hardware from BEASTX and RCWARE. Connection to the devices is usually established using the USB port of your computer.<br />
* MICROBEAST PLUS / MICROBEAST PLUS HD
<br />
* SPEKTRUM AR7200BX / SPEKTRUM AR7300BX
 
* SPEKTRUM AR7210BX
== Connecting a BEASTX gyro to the computer ==
* RCWare RX2SIM
All BEASTX gyros come with a serial communication port which typically is marked with the letters ''SYS''. Connect the servo wire coming from your USB interface to this port. Make sure to connect the wire in correct polarity on both sides! When using the USB2SYS interface you have to power the device with a separate power supply, i.e. receiver battery or BEC of the R/C model. It will not be powered from the USB port.<br />
<br />
<div style= "padding: 0px 50px;">
[[File:USB2SYS_MBPlus.png|400px|none]]
</div>
<br />
<br />
The plugins provide the following functionality for these devices*:
* administration
* configuration
* updating
* backup and restore
''*The range of functions can vary depending on the plugin used.''
<br />
<br />
Also you can use a RX2SIM Wireless Multi-Sim Adapter instead of the USB2SYS interface. For this you can switch the RX2SIM into an USB2SYS emulation mode (push button on the RX2SIM several times until the LED lights up in orange color). In this configuration the BEASTX gyro will be powered from the USB port. Anyhow, this only will work when receiver and servos are not connected to the gyro! Otherwise the power of the USB port will not be sufficient to supply all consumers. In this case you have to power the device from the receiver battery as well. '''But here when using more than 6 Volts (i. e. using a 2s Lipo battery as receiver power supply) you must disconnect the red wire (plus pole) from the servo wire going to the interface. Otherwise you will damage the RX2SIM and/or USB port of your computer!'''<br />
<br />
<table>
  <tr>
    <td style= "padding: 0px 50px;">[[File:RX2SIM_MBPlus.png|400px]]</td>
    <td style= "padding: 0px 50px;">[[File:RX2SIM_MBPlus_powered.png|400px]]</td>
  </tr>
</table><br />
<br />
<br />


== Connecting the RX2SIM Multi-Sim Adapter ==
== Connecting the RX2SIM Wireless Multi-Sim Adapter ==
When RX2SIM is used as USB2SYS interface emulator to connect your BEASTX device (MICROBEAST / SPEKTRUM AR7xxxBX) as mentioned above, StudioX will not recognize the RX2SIM itself. To control it with StudioX as Stand-Alone device, i.e. for updating the firmware you must push and hold the button on the RX2SIM before and while connecting it to the computer. Then it will start in bootloader mode and StudioX will open the RX2SIM Plugin.<br />
When RX2SIM is used as USB2SYS interface emulator to connect your BEASTX device (MICROBEAST / SPEKTRUM AR7xxxBX) as mentioned above, StudioX will not recognize the RX2SIM itself. To control it with StudioX as Stand-Alone device, i.e. for updating the firmware of the RX2SIM you must push and hold the button on the RX2SIM before and while connecting it to the computer. Then it will start in bootloader mode and StudioX will open the RX2SIM Plugin. You can see that bootloader mode is active when both blue LEDs AUX and PPM light up solid.<br />
<br />
<br />
== Connecting the BLE2SYS bluetooth LE adapter ==
To configure and update your BLE2SYS bluetooth LE adapter with StudioX connect it with the USB2SYS interface or RX2SIM wireless simulator interface to the computer. Using the USB2SYS you must power the device with an external power supply connected to a Y-harness. Watch out for correct polarity!<br />
<br />
<table>
  <tr>
    <td style= "padding: 0px 50px;">[[File:BLE2SYS_to_USB2SYS.png|x150px]]</td>
    <td style= "padding: 0px 50px;">[[File:BLE2SYS_to_RX2SIM.png|x130px]]</td>
  </tr>
</table>
When using the RX2SIM Wireless Multi-Sim Adapter make sure it is set to USB2SYS emulation mode (push button on the RX2SIM several times until the LED lights up in orange color)!<br />
<br />
<br />


= freakware Network Account =
= The freakware Network =
A freakware Network user account is mandatory to use functions like online manuals and firmware updates. You can create your own account very easily by opening the ''freakware Network'' connector dialog by clicking the '''fw''' button:<br />
The freakware Network is our online network which is used to keep in touch with our customers and which is used to distribute firmware updates and other online content for our hardware devices. To solely change settings and configure your device neither you need an internet connection nor do you need to login to the freakware Network or create a freakware network Account.
 
==freakware Network Account==
A freakware Network user account is mandatory to use functions like online manuals and firmware updates. You can create your own account very easily by opening the ''freakware Network'' connector dialog by clicking the '''fw''' button in the top left corner of StudioX:<br />
<br />
<br />


Line 42: Line 63:
<br />
<br />


  {{QUOTE|If you don't get the confirmation mail please check your account's SPAM folder. As this is an automatic email it is likely that some mail providers consider the mail as spam mail.}}
  [[File:ConfirmLogin.png|border|none|x200px]]<br />
 
<br />
{{QUOTE|If you don't get the confirmation mail please check your account's SPAM folder. As this is an automatic email it is likely that some mail providers consider the mail as spam mail.}}<br />
<br />
<br />


= Registering Devices =
==Registering Devices==
The access to ''freakware Network Common Data'', like manuals, is available for everyone who is logged in.
''freakware Network Common Data'' like .pdf manuals and other general information is available when you're logged in.


But to access ''Custom Data'' like firmware update you need to register your device, what means you permanently link the device to your user account.
To access ''Custom Data'' like firmware update you need to register your device what means that you permanently link the device to your user account.


If you connect your device, you should see something like this (as an example we will use a Microbeast Plus here):<br />
If you connect your device you should see something like this (as an example we will use a Microbeast Plus here):<br />
<br />
<br />


Line 58: Line 80:
Click the "Register Device" button to link your device to your ''freakware Network'' account.
Click the "Register Device" button to link your device to your ''freakware Network'' account.


After this the message should be gone, and the "Update Firmware" tab should offer you something.
After this the message should be gone, and the "Update Firmware" tab should offer you something.<br />
<br />


<br />
<br />
= Updating Devices =
==Updating Devices==


A firmware with the status "available" can be requested, and will be generated server-sided on the fly.
A firmware with the status "available" can be requested, and will be generated server-sided on the fly.


Once done the status will show "done" and you can update to this firmware.
Once done the status will show "done" and you can update to this firmware.
All firmware available currently are tested and stable. Feel free to update!


If you don't see anything in the list, then you haven't registered this device yet. Please check accordingly.<br />
If you don't see anything in the list, then you haven't registered this device yet. Please check accordingly.<br />
<br />
<br />
[[File:online_update.png|noframes|300px|none]]<br />
[[File:online_update.png|noframes|300px|none]]<br />
Have a look at the product overview page to see which are the latest firmwares at the moment:
Have a look at [[Help:FAQ:General/en#Differences_between_firmware_versions_.28changelog.29|General questions about the product]] to see which are the latest firmwares at the moment.<br />
* [[BEASTX_Devices/en#Microbeast|MICROBEAST]]
<br />
* [[BEASTX_Devices/en#Microbeast_PLUS_und_Microbeast_PLUS_HD|MICROBEAST PLUS / MICROBEAST PLUS HD]]
 
* [[BEASTX_Devices/en#AR7200BX_und_AR7300BX|SPEKTRUM AR7200BX / SPEKTRUM AR7300BX]]
=StudioX options=
* [[BEASTX_Devices/en#AR7210BX|SPEKTRUM AR7210BX]]
You can edit some global options for the StudioX software when clicking "Edit" and choosing "Preferences..." from the menu bar.<br />
<br />
 
==Check for Updates automatically==
If your PC is connected to the internet this option makes sure that your StudioX installation is up-to-date. All 7 days the update dialog is shown automatically, showing whether an update is available or not.<br />
<br />
Updating StudioX is simple and straight forward.<br />
[[File:studiox_update.png|200px|noframe|none]]<br />
From the "Update StudioX" dialog, you can press the "Download" button if an update is available.<br />
Execute the downloaded package and follow the instructions given.<br />
Make sure you closed the application before trying to install a newer version.<br />
<br />
 
==Language Selection==
If the "Auto" option is selected, StudioX will use the language detected from the system's settings.
Otherwise you can force on of the following languages:
* English
* German
 
'''Attention:''' Switching the language may require a restart of the StudioX Application.<br />
<br />

Revision as of 11:12, 13 November 2017


Connecting a device to StudioX

StudioX can be used to work with serveral types of hardware from BEASTX and RCWARE. Connection to the devices is usually established using the USB port of your computer.

Connecting a BEASTX gyro to the computer

All BEASTX gyros come with a serial communication port which typically is marked with the letters SYS. Connect the servo wire coming from your USB interface to this port. Make sure to connect the wire in correct polarity on both sides! When using the USB2SYS interface you have to power the device with a separate power supply, i.e. receiver battery or BEC of the R/C model. It will not be powered from the USB port.



Also you can use a RX2SIM Wireless Multi-Sim Adapter instead of the USB2SYS interface. For this you can switch the RX2SIM into an USB2SYS emulation mode (push button on the RX2SIM several times until the LED lights up in orange color). In this configuration the BEASTX gyro will be powered from the USB port. Anyhow, this only will work when receiver and servos are not connected to the gyro! Otherwise the power of the USB port will not be sufficient to supply all consumers. In this case you have to power the device from the receiver battery as well. But here when using more than 6 Volts (i. e. using a 2s Lipo battery as receiver power supply) you must disconnect the red wire (plus pole) from the servo wire going to the interface. Otherwise you will damage the RX2SIM and/or USB port of your computer!



Connecting the RX2SIM Wireless Multi-Sim Adapter

When RX2SIM is used as USB2SYS interface emulator to connect your BEASTX device (MICROBEAST / SPEKTRUM AR7xxxBX) as mentioned above, StudioX will not recognize the RX2SIM itself. To control it with StudioX as Stand-Alone device, i.e. for updating the firmware of the RX2SIM you must push and hold the button on the RX2SIM before and while connecting it to the computer. Then it will start in bootloader mode and StudioX will open the RX2SIM Plugin. You can see that bootloader mode is active when both blue LEDs AUX and PPM light up solid.

Connecting the BLE2SYS bluetooth LE adapter

To configure and update your BLE2SYS bluetooth LE adapter with StudioX connect it with the USB2SYS interface or RX2SIM wireless simulator interface to the computer. Using the USB2SYS you must power the device with an external power supply connected to a Y-harness. Watch out for correct polarity!

When using the RX2SIM Wireless Multi-Sim Adapter make sure it is set to USB2SYS emulation mode (push button on the RX2SIM several times until the LED lights up in orange color)!

The freakware Network

The freakware Network is our online network which is used to keep in touch with our customers and which is used to distribute firmware updates and other online content for our hardware devices. To solely change settings and configure your device neither you need an internet connection nor do you need to login to the freakware Network or create a freakware network Account.

freakware Network Account

A freakware Network user account is mandatory to use functions like online manuals and firmware updates. You can create your own account very easily by opening the freakware Network connector dialog by clicking the fw button in the top left corner of StudioX:

noframes
noframes


From there open the Create New Account tab, and use your eMail address as login and select a secure password:

noframes
noframes


A confirmation mail will be sent to this address. Once your account is confirmed, you can log in using the Login tab.

The address you provide will also be used to recover your password or get in touch with you if needed, i.e. when urgent firmware updates are required.

Therefore we strongly recommend to use a real address and not a one-time email provider.



If you don't get the confirmation mail please check your account's SPAM folder. As this is an automatic email it is likely that some mail providers consider the mail as spam mail.



Registering Devices

freakware Network Common Data like .pdf manuals and other general information is available when you're logged in.

To access Custom Data like firmware update you need to register your device what means that you permanently link the device to your user account.

If you connect your device you should see something like this (as an example we will use a Microbeast Plus here):

noframes
noframes


Click the "Register Device" button to link your device to your freakware Network account.

After this the message should be gone, and the "Update Firmware" tab should offer you something.


Updating Devices

A firmware with the status "available" can be requested, and will be generated server-sided on the fly.

Once done the status will show "done" and you can update to this firmware.

If you don't see anything in the list, then you haven't registered this device yet. Please check accordingly.

noframes
noframes


Have a look at General questions about the product to see which are the latest firmwares at the moment.

StudioX options

You can edit some global options for the StudioX software when clicking "Edit" and choosing "Preferences..." from the menu bar.

Check for Updates automatically

If your PC is connected to the internet this option makes sure that your StudioX installation is up-to-date. All 7 days the update dialog is shown automatically, showing whether an update is available or not.

Updating StudioX is simple and straight forward.

noframe
noframe


From the "Update StudioX" dialog, you can press the "Download" button if an update is available.
Execute the downloaded package and follow the instructions given.
Make sure you closed the application before trying to install a newer version.

Language Selection

If the "Auto" option is selected, StudioX will use the language detected from the system's settings. Otherwise you can force on of the following languages:

  • English
  • German

Attention: Switching the language may require a restart of the StudioX Application.