PCB Package - User Guide

PCB Package - User Guide

Quick start guide

Step-by-step using the PCB Package for demonstration.

Step 1 - Plug the provided gateway into power and ensure an internet connection

  1. Power on the Raspberry Pi.

  2. Power on the sensors, and use the provided magnet.

  3. Make sure the gateway has an internet connection

Please note: for the measurement to be uploaded to the server, it takes about 5 minutes. Furthermore, for the measurement to be visible on the website, it can take up to 30 minutes.

Step 2 - Monitor

  1. Log in to https://appeu.vib.cloud/

  2. Open Dashboard to see machine condition at a glance.

  3. Click Open Analysis on a machine card to view the Machine Dashboard.

  4. Use Vibration Analysis for detailed spectrum and trend analysis.

  5. Use Email Report to share machine status with colleagues.

Step 3 - Close

  1. Power down the sensors (Turn off BluVib Sensors - step-by-step guide )

  2. Power down the gateway

  3. Log out of the VibCloud web portal

If you lack access to the Raspberry Pi interface or are pressed for time, you may always remove the top part of the sensor and extract the batteries.


VibCloud Online monitoring module

The PCB Package is the online client-monitoring demonstration module within VibCloud. It utilises only BluVib (Sensor-Works) hardware, offering a streamlined, standalone interface that resellers can use to showcase the solution to potential clients. This allows them to monitor machines, view vibration data, manage sensors, and configure the monitoring setupβ€”all via a modern web dashboardβ€”without requiring the full VibCloud application.

Log in at your VibCloud URL and you will land on the (Home) page. The top navigation bar provides access to all PCB Package pages.


Navigation

All PCB Package pages share a common top navigation bar with four main sections:

Menu item

Description

Menu item

Description

Dashboard

Home page - overview of all machines and sensors

Vibration analysis

Detailed vibration data analysis - spectra, trends, waveforms

Configuration

Manage company details, machines, sensors, and alarm limits

Full VibCloud

Switch to the full VibCloud application (for advanced users)

Your user name, role, and profile photo are displayed on the right side of the navigation bar. Click the icon to log out.


1. Dashboard (Home Page)

The Dashboard is the main landing page after login. It provides an at-a-glance overview of your monitoring setup.

image-20260416-190418.png

Β 

1.1 Welcome banner

At the top of the page, a branded banner displays:

  • Your company logo (or a placeholder icon if no logo is uploaded)

  • Your company name and address

1.2 Machines section

The left column displays all machines registered to your account as machine cards. Usually, only one machine is used for demonstration. Each card shows:

Element

Description

Element

Description

Machine photo

Photo of the machine (or a placeholder gear icon)

Condition badge

Colour-coded badge in the top-right corner of the photo showing the overall condition

Machine name

The descriptive name of the machine

Code

Optional machine reference code

Last collection

Date and time of the most recent data collection

Condition

Text description of the worst alarm status across all measurement points

Condition colour codes

Condition colour codes are derived from the ISO 10816 velocity limits.

ISO Vibration Severity Checker - ISO 10816-3 & 10816-7 Calculator | VibCloud

Colour

Status

Meaning

Colour

Status

Meaning

Green

Nominal

All values are within normal operating range

Cyan

Investigate

Values have crossed the investigation threshold β€” further analysis recommended

Orange

Warning

Values are approaching alarm levels β€” plan maintenance

Red

Alarm

Values exceed alarm thresholds β€” immediate attention required

Grey

No Status

No data has been collected yet, or no alarm limits are configured

Machine card actions

  • Open Analysis - Navigates to the page for the selected machine

  • Email Report - Opens a confirmation dialog to email a machine status report

Machine status indicators

Depending on the machine's sensor and data state, additional messages may appear:

  • "No sensors assigned" - The machine exists but has no sensors linked yet. A link to the BluVib sensor product page is provided.

  • "Sensors connected - Awaiting first data collection" β€” Sensors are assigned but no measurement data has been received yet.

1.3 Sensors section

The right column displays a table of all sensors registered for your account:

Column

Description

Column

Description

Sensor name

User-defined name for the sensor

Sensor type

The sensor model (e.g., BluVib-M3, BluVib-P1, BluVib-P3). Clickable links open a product info modal.

Sensor UUID

The unique identifier for the sensor (BT UUID)

Frequency (min)

The configured data collection interval in minutes

1.4 Email machine report

Clicking "Email Report" on a machine card opens a confirmation modal:

  1. A report summary is shown (machine name, condition, last collection date).

  2. The recipient email field is pre-populated with your account email. You can modify it.

  3. Click "Send Report" to deliver the report.

The emailed report includes:

  • VibCloud branding and your company name

  • Machine name, code, and overall condition

  • Last measurement date and number of active sensors

  • Overall values table β€” the latest Acceleration (Acc), Velocity (Vel), Demodulation (Dem), and Temperature readings for each measurement point, colour-coded by alarm status

  • A direct link to open the machine analysis in VibCloud


2. Machine Dashboard

The Machine Dashboard provides detailed condition monitoring data for a single selected machine.

image-20260416-190504.png

Β 

2.1 Component schematic

The left panel shows:

  • The selected machine name

  • A machine photo with sensor location indicators overlaid. Each indicator is colour-coded to represent the condition at that measurement point.

  • Directional arrows (up/down/left/right) show the sensor mount orientation.

2.2 Overall values table

Below the schematic, a table displays the latest overall measurements for each measurement point:

Column

Description

Column

Description

Measurement Point

Name and last collection date

Acc

Acceleration overall value and unit

Vel

Velocity overall value and unit

Dem

Demodulation overall value and unit

Temp

Temperature value and unit

Cells are colour-coded based on alarm status (same colour legend as the Dashboard page). Clicking a measurement point name navigates to the Vibration Analysis page for that parameter.

2.3 Feature trends

The right panel displays trend charts for measurement point features:

  • Each chart shows approximately one month of historical data.

  • Alarm limit lines are drawn on charts: cyan for Investigate, orange for Warning, red for Alarm.

  • All trend charts are synchronised - zooming on one chart automatically zooms all others to the same time range.

  • Clicking the measurement point name above a chart navigates to the full Vibration Analysis view.

2.4 How to read this dashboard (help panel)

A collapsible help panel explains the colour codes and chart features. Click the header to expand or collapse it.


3. Vibration Analysis

The Vibration Analysis page is the most detailed analysis view, allowing you to inspect vibration data at the individual measurement and spectrum level.

image-20260416-190556.png

Β 

3.1 Machine & measurement point selection

  • A machine tree on the left side lets you browse machines and their measurement points.

  • Selecting a measurement point loads its data in the main panels.

3.2 Available analysis views

Panel

Description

Panel

Description

Trend charts

Historical trends for Velocity, Acceleration, and Demodulation overall values with alarm limit lines

Spectrum chart

Frequency-domain spectrum for the selected measurement, with cursor annotations and peak identification

Waveform

Time-domain waveform view (opens in a dialog window)

3.3 Spectrum features

  • Cursor annotations - Click on spectrum peaks to add annotations. Annotations show the frequency (Hz) and amplitude value.

  • Peak annotations - Colour-coded badges appear for different annotation types (e.g., harmonics, bearing frequencies).

  • Zoom & pan - Use the mouse to zoom into specific frequency ranges.

3.4 Waveform dialog

The waveform dialog opens in a pop-up window and displays:

  • The raw time-domain vibration signal

  • Total recording time

  • Interactive chart with zoom capability


4. Configuration

The Configuration page allows you to manage all aspects of your monitoring setup. Some features require administrator privileges.

image-20260416-190628.png

Β 

Permissions: Features marked with πŸ”’ require the Administrator or Client Administrator role.

4.1 Company details

Edit your company profile information:

  • Company Name

  • Address

  • Admin Name (primary contact)

  • Admin Email (primary contact email)

  • Company Logo β€” Upload or replace your company logo (displayed in the Dashboard banner)

4.2 Machines management

Manage the machines (equipment) being monitored:

Action

Description

Action

Description

πŸ”’ Add Machine

Create a new machine with a name, code, and optional photo

Edit

Update machine name, code, or photo

Sensors

Open the sensor location assignment dialog β€” position sensors on the machine photo and link them to measurement points

Limits

Assign ISO-based vibration alarm limit sets to the machine (requires sensors to be assigned first)

πŸ”’ Delete

Permanently remove a machine and its associated photo

Machine Photo

When adding or editing a machine, you can upload a photo. The photo is automatically resized to a maximum of 450Γ—450 pixels. It is displayed on the machine card (Dashboard) and as the background for sensor location positioning (Machine Dashboard).

4.3 Sensor location assignment

When you click "Sensors" on a machine card, a dialog opens where you can:

  • View the machine photo with existing sensor position markers

  • Assign sensors to specific locations on the machine

  • Set the measurement direction for each sensor (up, down, left, right)

  • Configure online monitoring parameters for each sensor position

4.4 Vibration alarm limits

Click "Limits" on a machine card to assign ISO-standard vibration alarm limit sets. These limits define the thresholds for Nominal, Investigate, Warning, and Alarm conditions shown throughout the application.

Sensors must be assigned to the machine before alarm limits can be set. If no sensors are linked, an error message will be displayed.

4.5 Sensors management

Below the machines section, a table lists all sensors for your account:

Column

Description

Column

Description

Sensor name

User-defined name

Sensor type

Model (BluVib-M3, BluVib-P1, BluVib-P3)

Sensor UUID

Unique Bluetooth identifier

Frequency (min)

Collection interval in minutes

Actions

Add, Edit and Delete buttons (admin only)

πŸ”’Adding/Editing a Sensor

Click "Add Sensor" (or the edit button) to open a modal where you configure:

  • Sensor name - A descriptive label

  • Sensor type - Select from available types for your account

  • Sensor UUID - The BT UUID (provided by the sensor vendor)

  • Temperature UUID - The temperature characteristic UUID

  • Parent UUID - For sensors that are part of a multi-sensor node

  • Sensor location - A text description of where the sensor is installed

Β 


5. Supported sensor hardware

The PCB Package is designed to work with Sensor-Works BluVib wireless vibration sensors:

Model

Description

Product Page

Model

Description

Product Page

BluVib-P1

Single-axis piezo vibration sensor

View Specs

BluVib-P3

Three-axis piezo vibration sensor

View Specs

Key specifications:

  • Β±20g range, 0.3–10 kHz bandwidth

  • BT 5 connectivity

  • IP66 rated (industrial-grade, dust-tight, water-resistant)

  • Up to 5-year battery life

  • ISO / CE / RoHS certified


7. Frequently Asked Questions

This means either no data has been collected yet, or no alarm limits have been configured. Ensure sensors are assigned and alarm limits are set via the Configuration page.

The collection frequency is configured per sensor via the sensor scheduler. You can view the current interval in the Frequency (min) column on the Dashboard or Configuration page. Default for demonstration is every 5 minutes.

Yes. When you click Email Report, a dialog appears with an editable email field. You can change the recipient before sending.

Horizontal lines on trend charts represent alarm thresholds:

  • Cyan line - Investigate threshold

  • Orange line - Warning threshold

  • Red line - Alarm threshold

You must assign sensors to a machine before alarm limits can be applied. Go to the machine card in Configuration, click Sensors, and assign at least one sensor first.

Only users with the Administrator or Client Administrator role can delete machines and sensors.