Difference between revisions of "StudioX Plugins/en"

From BEASTX Wiki
Jump to navigation Jump to search
(Importing a new version from external source)
(Importing a new version from external source)
 
(34 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/PLUS HD
+
<br />
* AR7200BX/AR7300BX
+
 
* RCWare RX2SIM
+
== 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.<br />
 +
<br />
 +
<div style= "padding: 0px 50px;">
 +
[[File:USB2SYS_MBPlus.png|400px|none]]
 +
</div>
 +
<br />
 
<br />
 
<br />
The plugins provide the following functionality for these devices*:
+
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 />
* administration
 
* configuration
 
* updating
 
* backup and restore
 
''*The range of functions can vary depending on the plugin used.''
 
 
<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 />
  
= freakware Network Account =
+
== Connecting the RX2SIM Wireless Multi-Sim Adapter ==
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 />
+
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 />
 +
 
 +
== 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 />
 +
 
 +
= 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.<br />
 +
<br />
 +
 
 +
==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: open the ''freakware Network'' dialog by clicking the '''fw''' button in the top left corner of StudioX:<br />
 
<br />
 
<br />
  
 
[[File:fwnetwork_open_connector.png|noframes|300px|none]]<br />
 
[[File:fwnetwork_open_connector.png|noframes|300px|none]]<br />
  
From there open the ''Create New Account'' tab, and use your eMail address as login and select a secure password:<br />
+
From there open the ''Create New Account'' tab, use your eMail address as login and enter a secure password:<br />
 
<br />
 
<br />
  
Line 33: Line 62:
 
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.
 
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.<br />
+
Therefore we strongly recommend to use a real address and not a one-time email provider!<br />
 
<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 52: Line 82:
 
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 />
* [[Update_request/de#MICROBEAST|MICROBEAST]]
+
<br />
* [[Update_request/de#MICROBEAST_PLUS|MICROBEAST PLUS / MICROBEAST PLUS HD]]
+
 
* [[Update_request/de#AR7200BX|SPEKTRUM AR7200BX / SPEKTRUM AR7300BX]]
+
==Changing login password==
* [[Update_request/de#AR7210BX|SPEKTRUM AR7210BX]]
+
If not already done, login to the freakware Network with your email adress and open the ''freakware Network'' dialog again by clicking the '''fw''' button in the top left corner of StudioX:<br />
 +
<br />
 +
[[File:fwnetwork_open_connector.png|noframes|300px|none]]<br />
 +
<br />
 +
Then choose "Change Password", enter your current password and a new one and click the "Change Password" button.<br />
 +
<br />
 +
[[File:ChangePasswordDialog.png|noframes|300px|none]]<br />
 +
<br />
 +
'''Please note:''' In order to change the password you must be logged in. In case you've forgotten your current password and can't log in you can request a new password after entering a wrong password 3 times in the "Login" dialog (or simply click the "Login" button repeatedly). Click the appearing "Recover Password" button, then you will get an email with a new password immediately. '''Please make sure you've entered the correct email address and especially make sure this email is a valid freakware Network account!''' If this mail address is not linked to an account of course we can't send you a password.<br />
 +
<br />
 +
[[File:ForgotPW.PNG|border|none|300px]]<br />
 +
<br />
 +
<br />
 +
 
 +
=StudioX options=
 +
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 />

Latest revision as of 07:44, 10 January 2018


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.

USB2SYS MBPlus.png



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!

RX2SIM MBPlus.png RX2SIM MBPlus powered.png



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!

BLE2SYS to USB2SYS.png BLE2SYS to RX2SIM.png

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: open the freakware Network dialog by clicking the fw button in the top left corner of StudioX:

noframes


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

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!

ConfirmLogin.png



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


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


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

Changing login password

If not already done, login to the freakware Network with your email adress and open the freakware Network dialog again by clicking the fw button in the top left corner of StudioX:

noframes



Then choose "Change Password", enter your current password and a new one and click the "Change Password" button.

noframes



Please note: In order to change the password you must be logged in. In case you've forgotten your current password and can't log in you can request a new password after entering a wrong password 3 times in the "Login" dialog (or simply click the "Login" button repeatedly). Click the appearing "Recover Password" button, then you will get an email with a new password immediately. Please make sure you've entered the correct email address and especially make sure this email is a valid freakware Network account! If this mail address is not linked to an account of course we can't send you a password.

ForgotPW.PNG




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


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.