Login the Vision Web Service: https://server.kk-t.eu/

Before creating a fixture let me introduce you to our concept. If you are a manufacturer who brands your fixtures for one or more customer please read this carefully:

RDM Manufacturer ID in combination with the Device Model ID is crucial for detecting the specific type of fixtures. We do not allow to change them after a release of a fixture. Changing would mean that possible fixture on the field would stop working because they don’t get recognized anymore. So especially these 2 values should stay the same over lifetime of the product. Of course, descriptions, images, website urls and names can be changed.

Often the first fixtures will be used to show the customer how it works. Afterwards it gets customized for their needs.

A good workflow for creating fixtures is the following:

1. Create a fixture in your company and your naming scheme. That means also in your RDM Manufacturer and Device Model ID.  This is the fixture you can use for showing your customers. In order that the end user cannot detect your fixture there is a setting which can hide the fixture in the app for end users. This is standard on hide.
2. When the customer likes the product and buys it you can create another fixture using your customers naming scheme, RDM Manufacturer and Device Model ID. With the same or other pictures for example. This fixture can then be also linked to their Account that they can have an overlook over the collected data from the field and some more information.

Create Fixture

1. Naviagte to „My Fixtures“:

2. Click the red “+” Icon in the top right to create a new fixture:

3. Fill in all the required information (see detailed description below):

• RDM ESTA Manufacturer ID
  You need to convert the number from Hex in Decimal
  If you are not an RDM Manufacturer you can use your personal Vision Replacement Id and a RDM Device Model Id. This combination can only exists once on the whole server. If there are problems contact us.
• RDM Device Model ID
  You need to convert the number from Hex in Decimal
• Serial number Validation
  Enter the regex for the serial number validation. If you do not have further specifications it is: \d\d\d\d\d\d\d\d\d
  Serial Validation is used to Verify Server uploads and prevent errors.
• Hardware Version
  This is optional so you do not need to fill it out. If you want to enter the regex for the hardware Version. With the hardware version in the serial number there can be different configuration for the same fixture. Test your regex strings on the links.
• Fixture Name
• Fixture Nick Name
  This is a shorter Version of the fixture name. If the fixture name is already short you can enter the fixture name as well
• Representative Manufacture name
  You can enter your company name. Exept if this fixture is baranded for another company then you have to add the name of the company who will sell this fixture to the end-user
• Representative fixture website Url
• Category
• Image
  
  
  -Format 800x600px
  -Make sure the background is transparent
  -The fixture must not have any light output
  -Make sure that on the left and right side is a safety margin of at least 12% this is equal to at least 96px
• Icon
  
  -This is the same as the image just with a lower resolution
  -Format 200x150px
  -Make sure the background is transparent
  -The fixture must not have any light output
  -Make sure that on the left and right side is a safety margin of at least 12% this is equal to at least 24px
• Icon Creative
  
  -Format 200x150px
  -Make sure the background is transparent
  -The fixture must not have any light output
  -The creative Icon is white were the fixture can light up so you need to provide an image were the lighting area of a fixture is white with a transparency of around 60 percent. See the example for a better understanding.
  -The Icon Creative is used to define the illumination area in the icon so the app can handle the lighting correctly. If your device does not have any light output component, you can upload a fully transparent image.
• Description
  Shot description of fixture

4. Click “Add fixture” to add it to the library

5. After adding the fixture it will displayed on the My Fixtures Page. Every fixture will get a unique ID and will be created as Draft (not released).

6. Click on the fixture to manage it properly. You can see all configurations on this page and do general changes on the edit button.

---

Software Upload
In the second area you can upload and manage the firmware of your fixture. You can also add release notes for the customer.

1. Navigate to the „Software“ Section.
   
2. Click the red plus icon in the top right to add a new firmware for the fixture
3. Enter firmware Version and upload firmware file:
   
   • Use the format X.X.X.255, as only versions ending in 255 are intended for release.
   • Upload the firmware file as a .bin file.
   • Click „Add software“
4. At this point the software is saved as „draft“ and is only visible to internal users of your company.
5. To make the software accessible to all users, click on Draft, then select Release in the popup.
   
6. The green Release shows that the firmware is available for all users.
   

---

Upload Resources

In the third area you can upload and manage ressources/documents for your fixture. This can be manuals, dmx sheets, technical specifications and so on.

---

Upload Libraries

In the fourth area you configure the creative config you created for your fixture in the Test & Run – App Control Chapter. Upload this configuration here.

• Creative Configuration: Necessary for all Vision Products
• DMX Configuration: Optional, necessary if controlled via DMX Adapter
• Core Config: Only required for Core fixtures.

Clicking on the add button brings you to the add page. Choose the Software Version number the config should fit. If you only need one config set it to 0.0.0. If your software has changed and you need a new config add a new one with the the correct Versioning. Example:

Uploaded Configs:

Config 1: V0.0.0

Config 2: V2.0.0

Fixture Usings:

Fixture Firmware Version 0.0.5 – Uses Config 1

Fixture Firmware Version 1.0.0 – Uses Config 1

Fixture Firmware Version 1.1.0 – Uses Config 1

Fixture Firmware Version 2.0.0 – Uses Config 2

Fixture Firmware Version 2.2.0 – Uses Config 2

Fixture Firmware Version 3.1.0 – Uses Config 2

After adding the configs, they will be displayed. They will be added as draft first and are not visible to your users. Click on Draft to release them.

Core Config is only needed for Core Modules. For External Module implementation you can skip this.

---

Settings

Vision Module Setting: Ensure that the „Vision Module“ setting is set to „True“ for all fixtures that have a Vision Module inside. If the fixture does not have a Vision Module, set this setting to „False“.

Server Upload Setting: Always make sure that the „Server Upload“ setting is set to „True“.

Release

After testing your fixture and uploading all necessary data, including the Verify certification, you can click on the „Request Release“. Please upload an video that demonstrates the functionality of the fxture.

Sharing a Fixture with Another Company

When you manufacture a fixture as an OEM and sell it to another company that brands it, it’s necessary for this company to access the fixture on Vision Web Services so they can upload their data. Here’s how you can share a fixture with another company:

1. Navigate to Settings:
   
2. Click on „Share“:
   
3. Enter the Company ID: Input the company ID of the company you want to share the fixture with. If you’re unsure of the ID, please contact your point of contact at the company, and they will provide it to you.
   
4. View Shared Company: You can then see which company the fixture is shared with.