Add and configure a sensor
Connect your sensor to PlantOS and assign it to a measurement location.
Use + Device in the PlantOS mobile app to register and configure a sensor so it can send monitoring data.
These instructions cover new FitMachine, vEdge and Eqsense devices. Some setup screens differ by device type.
Before you start
Make sure:
- You’re signed in to the correct PlantOS server.
- You have access to the plant where the sensor will be installed.
- Bluetooth is enabled and the app has the required permissions.
- The sensor is powered on and your phone is nearby.
- You have the Wi-Fi network details for the installation location.
During setup, you’ll assign the sensor to a measurement location (ML). This is the point on an asset where the sensor collects monitoring data.
1. Start device setup
- Open the Home Dashboard.
- Tap + Device.
- If prompted, select the plant where you want to add the sensor.
2. Find your sensor
Choose either option:
- Scan the QR code on the sensor.
- Tap Scan Nearby Sensors to discover nearby devices.
Each device card displays a colour indicating its setup status.
| Colour | What it means | What to do |
|---|---|---|
| Blue | The device hasn’t been assigned to a plant or measurement location. | Complete the setup steps below. |
| Amber | The device is assigned to a plant but has no measurement location. | Continue from measurement location mapping. |
| Yellow | The device is mapped, but communication setup is incomplete or has failed. | Review Wi-Fi settings and retry connectivity checks. |
| Green | The device is fully configured and actively monitoring. | No new onboarding is required. |
3. Register the sensor
For a new device:
- Tap its blue device card.
- Select the Device Type.
- Check the MAC ID and Plant.
- Tap Register.
4. Assign a measurement location
Choose an existing, unmapped measurement location or create a new one through the hierarchy setup flow.
You must complete measurement location mapping before continuing.
Check that the location belongs to the correct asset and equipment.
5. Add installation photos
You can capture photos of the measurement location to document the sensor’s position.
- Tap Capture Image to take photos, then Save & Continue.
- Tap Skip to continue without adding photos.
6. Configure Wi-Fi
Choose one of the available setup methods:
| Method | What to do |
|---|---|
| Select a Saved Network | Choose an existing Wi-Fi profile. |
| Scan Nearby Networks | Select a network detected nearby. |
| Enter details manually | Enter the SSID, password and authentication type. Add static IP settings if required. |
Tap Set WiFi to apply the settings.
The Wi-Fi connection must succeed before you can continue.
FitMachine note: FitMachine devices support saving multiple Wi-Fi profiles.
7. Confirm cloud configuration
This step depends on your device:
| Device | What happens |
|---|---|
| vEdge / Eqsense | Cloud routing is configured automatically based on your selected server. Tap Next to continue. |
| FitMachine | The app skips this step automatically. |
8. Check connectivity
The app checks that your sensor can communicate successfully.
| Device | Checks shown |
|---|---|
| vEdge / Eqsense | Wi-Fi Connected and Data Streaming Active |
| FitMachine | WLAN, HTTP, HTTPS, SNTP and RSSI |
All required checks must pass before setup is complete.
If a check fails:
- Verify the Wi-Fi network details.
- Confirm the sensor is within Wi-Fi range.
- Check that the network supports the selected authentication type.
- Retry the connectivity check.
9. Review the setup summary
After successful setup, the app displays a summary.
You can return to the Home Dashboard or start onboarding another device. For vEdge and Eqsense, you can also use Monitor Device to check live device communication.
FitMachine does not use the same Monitor Device screen as vEdge and Eqsense.
What should happen next?
The sensor should appear green when you scan nearby devices, and the required connectivity checks should have passed.
Next, confirm that monitoring data is arriving for the correct measurement location.
Need help?
| Issue | What to check |
|---|---|
| Sensor doesn’t appear during scanning | Confirm Bluetooth is enabled, check app permissions, move closer and make sure the sensor is powered on. |
| You can’t continue past measurement location mapping | Select an existing unmapped location or finish creating a new one. Mapping is mandatory. |
| Sensor remains yellow | Review the Wi-Fi settings and retry the connectivity check. |