Skip to content

Altenative Sensor Connection Methods

Material Foundry edited this page Feb 17, 2024 · 2 revisions

This wiki is deprecated, new documentation here.

Connecting Through Material Server

Most users will not need to use Material Server, however, using Material Server can be useful in the following situations:

  • Your Foundry server is secure (uses SSL): For security reasons, a secure Foundry server will not allow you to connect to the sensor. Material Server can act as a proxy, bypassing this restriction
  • You want to connect to the sensor through USB: If, for whatever reason, you can't or don't want to connect to the sensor through WiFi, you can use Material Server to connect to the sensor through USB

You will have to run Material Server on each computer that runs a Foundry client that connects to the sensor. This is the GM and target (TV) client. Note that the GM does not have to connect to the sensor for Material Plane to function, but if it does, it will allow the GM to configure the sensor.
If you use Material Server, and you don't want to connect the GM client to the sensor, you can disable 'Enable Module' in the module configuration.

You can get Material Server from the Material Server Github repository.
Documentation on how to install and run it can be found in the Material Server wiki.
Documentation on how to use Material Server with Material Plane can be found here

Using the Sensor as WiFi Access Point

While this is technically possible, at this point in time I cannot promise that performance will be good.

When the sensor is not connected to any access point, of when you have configured it to do so, the sensor will start its own access point. The main purpose for this is to make the initial setup easier, however, you could make use of this as a normal WiFi access point (without internet).
Multiple computers could connect to that access point, and a Foundry server can be run from one of those computers and the other computers can then connect to it.

If you do this, you will have to set the 'Sensor Module IP Address' in the module settings to 192.168.4.1:3000.

Clone this wiki locally