Skip to content

Initial Sensor Setup

Jump to bottom
Material Foundry edited this page Feb 17, 2024 · 5 revisions

This wiki is deprecated, new documentation here.

Note: It is possible to connect to the sensor through USB instead of WiFi. Info on how to configure that can be found here

For this guide, I will assume that you use the sensor in a standard configuration. This means that it is connected to your local WiFi network, your Foundry server is run locally and unsecured (no SSL), and the sensor connects to Foundry directly (without Material Server, and over WiFi).
If you run into any issues during this process, please refer to the fallback method.

  1. When the sensor is switched on, and it is not able to connect to any WiFi network (as will be the case when the sensor is new), the sensor will create its own WiFi network. This will be an open network called 'Material Sensor'
  2. Connect to this network (you might lose your connection to the internet)
  3. Using an internet browser, browse to http://materialsensor.local/. Make sure it starts with 'http' and not with 'https'
  4. You will be greeted by a screen with the text 'Establishing websocket connection with the sensor.' Please wait a few seconds

  1. Once the websocket connection is established, the main screen will open

  1. Click the 'Network' tab, and under 'Access Points', click 'Scan'
  2. Wait a few seconds while the sensor scans for nearby WiFi networks. Once it's done, the detected access points will be displayed

  1. Click on your network, fill in the password and press 'connect'. The sensor will now attempt to connect to your network
  2. If all went well, after a few seconds the 'Network Status' fields should update with the SSID of your network, and the IP address of the sensor

Fallback Method

  1. Open the Arduino Software
  2. Set the correct port under 'Tools'
  3. Open the 'Serial Monitor' in the top-right
  4. In the 'Serial Monitor', in the bottom right, set the line-ending to 'Both NL & CR' and set the baud to '250000'
  5. We want to connect the sensor to your WiFi. You can get a list of WiFi stations it can see by sending the SCAN WIFI command
  6. To connect to your WiFi station, send the following command: SET WIFI SSID "[ssid name]" "[password]". The 'ssid name' and 'password' fields are case sensitive. The sensor should then attempt to connect to the internet. If it's successful, it'll print 'WiFi connected with IP address: ...'
  7. Send the GET STATUS command again and test if 'Connected' is set to 'True'

Clone this wiki locally