User Guide
bmLogger App icon

bmLogger App

Complete guide to using the bmLogger mobile app with your Blue Maestro temperature and humidity logging devices.

If links don't work, search for "bmLogger" in your app store

Version 2.0|bmLogger App v12+

1. Introduction

The bmLogger app is a mobile application designed to interface with Bluetooth Low Energy (BLE) data logging devices. These devices continuously record environmental measurements such as temperature, humidity, pressure, and dew point.

Discover and connect to nearby logging devices
Download recorded data from devices
View data in interactive graphs
Configure device settings (logging intervals, alerts, calibration)
Export data to CSV format via email
Store data locally or sync to the cloud

2. Getting Started

Initial Setup

  1. Download the App: Install bmLogger from the App Store (iOS) or Google Play Store (Android).
  2. Enable Bluetooth: Ensure Bluetooth is enabled on your phone. The app requires Bluetooth Low Energy (BLE) to communicate with devices.
  3. Grant Permissions: When prompted, allow the app to access:
    • Bluetooth (required for device communication)
    • Location (required for BLE scanning on Android)
    • Notifications (optional, for threshold alerts)
  4. Select Language: On first launch, select your preferred language.
  5. Choose Units: Navigate to Settings to select your preferred temperature units (Celsius or Fahrenheit) and pressure units (hPa, inHg, or mbar).

First Time Use

  1. Open the app and navigate to the Bluetooth tab
  2. The app will automatically begin scanning for nearby devices
  3. Devices within range will appear in the list
  4. Tap on a device to view its details and begin monitoring

3. App Navigation

The app uses a bottom navigation bar with five main tabs:

Tab Bar Icons

TabIconDescription
BluetoothScan for and connect to BLE devices
InternetView cloud-connected devices
LogsAccess saved downloads and history
SettingsConfigure app preferences
AccountManage user account

Bluetooth Tab

Purpose: Discover and connect to BLE data logging devices

This is your starting point for finding devices. The tab displays a list of all detected devices within Bluetooth range, showing their name, signal strength, and current status.

Header Actions:

  • Filter devices
  • Refresh scan

Internet Tab

Purpose: View cloud-connected devices and remote data

Access devices and data that have been uploaded to the cloud. Requires signing in to your account.

Status Icons:

  • Connected to cloud (with pulse animation)
  • Not connected to cloud

Logs Tab

Purpose: View saved downloads and device history

Browse all previously downloaded data organized by device. Access historical graphs, statistics, and export options.

Actions:

  • Refresh history list
  • View log details

Settings Tab

Purpose: Configure app-wide preferences

Adjust temperature units, pressure units, notification preferences, and other app settings.

Account Tab

Purpose: Manage your user account

Sign up, sign in, manage your account, and control cloud synchronization settings.

Account Icons:

  • User profile
  • Create account
  • Sign out
  • Signed in status

4. Supported Devices

The bmLogger app supports multiple device versions, each with different sensor capabilities:

Device Version Comparison

Featurev8/v10v13v23v27v41v42v43
Temperature
Humidity---
Pressure-----
Dew Point---
24h Hi/Lo----
Precision1 dec1 dec1 dec1 dec1-2 dec1-2 dec1-2 dec
Settings StorageDeviceLocalLocalLocalDeviceDeviceDevice
Max Logs10,00010,00010,00010,000100,00050,00025,000

Device v13

Sensors: Temperature only (higher precision)

Settings Storage: Local only - Settings are stored on your phone

Device name (stored locally) Logging interval Temperature calibration offset Delete logs Reset device

Device v23

Sensors: Temperature, Humidity, Dew Point

Settings Storage: Local only

Separate calibration adjustments for temperature, humidity, and dew point (all stored locally)

Device v27

Sensors: Temperature, Humidity, Pressure, Dew Point

Settings Storage: Local only

Comprehensive 4-parameter environmental monitoring

Device v41, v42, v43

Modern

Settings Storage: On device - Settings persist across phones

Special Features:

Automatic download Enhanced alerts Adjustable precision Airplane mode LED blink Button enable/disable Device PIN lock

Precision Setting (v41+ only)

For the latest device versions (v41, v42, v43), you can control the display precision:

  • Default: 1 decimal place (e.g., 23.5°C)
  • Enhanced: 2 decimal places (e.g., 23.54°C)

How to Change Precision:

  1. Navigate to the device's Focussed view
  2. Tap Settings
  3. Select "Precision"
  4. Choose between 1 or 2 decimal places

5. Scanning for Devices

How Scanning Works

The Bluetooth tab continuously scans for nearby BLE devices. When a compatible device is detected, it appears in the list with:

  • Device Name: The name assigned to the device (editable)
  • MAC Address: Unique identifier for the device
  • Signal Strength (RSSI): Indicates connection quality
  • Battery Level: Current battery percentage
  • Current Reading: Latest temperature (and other readings if applicable)
  • Log Count: Number of stored readings

Filter and Sort Options

IconSort By
Name (A-Z)
Signal strength
Number of logs
Battery level

Device Status Indicators

  • Device detected, not connected
  • Connected and ready
  • Device is PIN locked (v41+ only)

Scanning Tips

  1. Move Closer: If a device isn't appearing, try moving closer to it
  2. Check Battery: Devices with dead batteries won't transmit
  3. Remove Obstacles: Metal objects and thick walls can block Bluetooth signals
  4. Wait for Updates: New devices may take 10-30 seconds to appear
  5. Refresh Scan: Tap to manually restart scanning

6. Viewing Device Details

Tap on any device in the scan list to view its detailed information on the Focussed Device screen.

Current Readings Display

Temperature

Displayed in your chosen units (°C or °F)

Shows change indicator: rising (↑), falling (↓), or stable (—)

Humidity

Displayed as percentage relative humidity (%RH)

Range: 0-100%

v23, v27, v42, v43

Pressure

Displayed in hPa, inHg, or mbar

v27, v43

Dew Point

Calculated from temperature and humidity

v23, v27, v42, v43

Status Indicators

ColorStatusDescription
Yellow"Connecting..."Establishing connection to device
Blue"Downloading X logs - Y%"Data transfer in progress
Green"Processing and Storing"Download complete, saving data
Red"Download failed"Connection or transfer error
Grey"Up to date"No new data to download

Quick Actions Menu

ActionIconDescription
Device DownloadDownload data from device
StatisticsView min/max/average stats
Table ViewView data in table format
Export via EmailSend data as CSV via email
Store in CloudUpload to cloud account
Device SettingsConfigure device

7. Downloading Data

Downloading retrieves stored readings from the device's memory to your phone.

Starting a Download

  1. Navigate to the device's Focussed view
  2. Tap the Download button or use menu > "Device Download"
  3. A confirmation dialog shows the number of logs to download
  4. Tap Download to confirm

Download Progress

  1. Connecting (Yellow): Establishing Bluetooth connection
  2. Downloading X logs - Y% (Blue): Transferring data
  3. Processing and Storing X logs (Green): Saving to local database

Download Failures

If a download fails, a red "Download failed" chip appears. Common causes:

  • Device moved out of range
  • Bluetooth interference
  • Device battery depleted

Try moving closer to the device and retry.

Automatic Download (v41+ devices)

Some devices support automatic downloading:

  1. Go to Device Settings
  2. Enable Auto-Download
  3. Data will automatically download when the device connects

8. Graphs and Data Visualization

After downloading data, graphs automatically display on the Focussed view.

Graph Controls

  • Zoom: Pinch to zoom in/out, or drag to select a time range
  • Pan: Swipe left/right to move through time
  • Reset: Double-tap to reset to full view

Time Period Selector

1h1d1w1m1yAll

Graph Types by Device

Single Parameter (v8, v10, v13, v41)

Temperature graph with min/max/average lines

Multi-Parameter (v23, v42)

Combined view: Temperature, Humidity, Dew Point

Full Environmental (v27, v43)

All four parameters on one graph

Color Coding

Temperature
Humidity
Pressure
Dew Point

9. Device Settings

Access device settings by tapping the Settings button on the Focussed view.

General Settings

Device Name

Change device name (max 16 characters)

v13/v23/v27: Stored locally | v41+: Stored on device

Device Notes (v41+ only)

Add custom notes (max 500 characters)

Logging Settings

Logging Interval

Set recording frequency (5 seconds to 1 hour)

Shorter intervals = more data = faster battery drain

Auto-Download (v41+)

Enable automatic downloads when device connects

Delayed Start (v41+)

Schedule when the device begins logging

Calibration Settings

Adjust readings to match a reference instrument. Each sensor type can be calibrated independently.

How to Calibrate:

  1. Tap on "Calibration"
  2. Use the stepper or enter a value
  3. Tap "Submit"
  4. Calibration applies to all displayed and exported data

v13/v23/v27: Calibration saved locally | v41+: Calibration sent to device

Alert Thresholds

Set limits that trigger alerts when exceeded:

  • Temperature High/Low
  • Humidity High/Low (v23, v27, v42, v43)
  • Pressure High/Low (v27, v43)
  • Dew Point High/Low (v23, v27, v42, v43)

Device Controls (v41+ only)

Airplane Mode

Disable Bluetooth broadcasting to save battery

Blink LED

Identify a specific device by making its LED blink

Device Button

Enable or disable the physical button

Device Lock

Protect settings with a 4-digit PIN

Reset Device

Restore device to factory settings

Delete Logs

Remove downloaded data from your phone

10. History and Saved Data

The Logs tab provides access to all previously downloaded data.

Local History

Downloads are grouped by device, showing:

  • Device name
  • Download date and time
  • Number of readings
  • Date range of data

Statistics View

For each download, statistics show:

  • Minimum: Lowest recorded value
  • Maximum: Highest recorded value
  • Average: Mean of all readings
  • Reading Count: Total number of data points
  • Date Range: Start and end times

For v13/v23/v27 devices, statistics include calibration offsets that you have configured.

11. Exporting Data

Export your data to CSV format for analysis in spreadsheet applications.

Export via Email

  1. Navigate to the download you want to export
  2. Tap menu > "Export via Email"
  3. Enter or confirm the email address
  4. Tap "Send Email"

CSV File Format

CSV Header Example
=== EXPORT METADATA ===
Device Name: [name]
MAC Address: [address]
Device Version: [version]
Download Date: [date and time]
Logging Interval: [interval] seconds
Total Readings: [count]

=== CALIBRATION VALUES ===
Temperature Calibration: [value]°C
Humidity Calibration: [value]%
Pressure Calibration: [value] hPa

=== DATA ===
Index, Date (Device), Temperature, Humidity, Pressure, Dew Point

12. Cloud Features

Cloud features require creating an account and signing in.

Account Management

Creating an Account

  1. Go to the Account tab
  2. Tap "Sign Up"
  3. Enter your email address
  4. Create a password (minimum 8 characters)
  5. Tap "Create Account"
  6. Check your email for a verification code
  7. Enter the 6-digit code
  8. Account is now active

Forgot Password

  1. On the sign-in screen, tap "Forgot Password"
  2. Enter your email address
  3. Check email for reset code
  4. Enter the code and create a new password
  5. Success confirmation

Cloud Upload

  1. Navigate to a device's Focussed view
  2. Tap menu > "Store in Cloud"
  3. If not signed in, you'll be prompted to sign in first
  4. Confirm the upload
  5. Data is synced to your cloud account

Benefits of Cloud Storage:

  • Access data from multiple phones
  • Backup protection against phone loss
  • Share data with team members (future feature)

Cloud Status Icons

  • Connected to cloud
  • Not connected / offline
  • Upload in progress

13. App Settings

Access app-wide settings from the Settings tab .

Temperature Units

Choose between Celsius (°C) or Fahrenheit (°F)

Pressure Units (v27, v43)

Options: hPa, inHg, or mbar

1013.25 hPa = 29.92 inHg = 1013.25 mbar

Notifications

Enable alerts when thresholds are exceeded

About

View app version and company information

Rate the App

Leave a review on the App Store or Google Play

Send Feedback

Contact the development team

14. Troubleshooting

Device Not Appearing in Scan

Bluetooth Disabled

Check that Bluetooth is enabled. Try toggling off and on.

Device Out of Range

Move closer to the device. Remove obstacles between phone and device.

Device Battery Dead

Replace the device battery.

Location Permission Denied (Android)

Go to phone Settings > Apps > bmLogger > Permissions. Enable Location permission.

Download Keeps Failing

Weak Signal

Move closer to the device. Stay stationary during download.

App Needs Restart

Force close the app and reopen.

Data Looks Incorrect

Calibration Needed

Compare device reading to a known accurate thermometer. Adjust calibration offset in Device Settings.

Wrong Units Selected

Check Settings > Temperature Units and Pressure Units.

Device Shows "Locked"

(v41+ devices only)

  1. Tap on Device Settings
  2. Tap "Device Lock"
  3. Enter the correct 4-digit PIN
  4. Device will unlock

15. Icon Reference

Complete reference of all icons used in the bmLogger app:

Navigation Icons

Back
Forward
More options
Close
Clear

Tab Bar Icons

Bluetooth
Internet
Logs
Settings
Account

Status Icons

Success
Warning
Error
Info

Device Control Icons

Locked
Unlocked
Airplane mode
Blink LED
Button on
Button off

Cloud Icons

Cloud
Offline
Upload
Download

Sensor Icons

Temperature
Humidity
Pressure

Need Help?

For additional support with your bmLogger app or Blue Maestro devices: