EnvSensor Reader - iOS App

An iOS application for scanning and reading environmental sensor data from BLE devices named "EnvSensor".

Features

• Real-time BLE scanning for EnvSensor devices
• Displays environmental readings:
  • Temperature (°C)
  • Humidity (%)
  • Pressure (hPa)
• Displays power metrics:
  • Voltage (V)
  • Current (mA)
  • Power (mW)
• Shows signal strength (RSSI in dBm)
• Automatic deduplication of readings based on nonce
• Clean, modern SwiftUI interface

Requirements

• iOS 15.0 or later
• iPhone or iPad with Bluetooth LE support
• Xcode 15.0 or later (for building)

BLE Protocol

The app scans for BLE devices with the following characteristics:

• Device Name: EnvSensor
• Company ID: 0xFFFF
• Data Format (16 bytes, little-endian):
  • Bytes 0-1: Nonce (UInt16)
  • Bytes 2-3: Temperature (Int16, divide by 100 for °C)
  • Bytes 4-5: Humidity (UInt16, divide by 100 for %)
  • Bytes 6-9: Pressure (UInt32, divide by 10 for hPa)
  • Bytes 10-11: Voltage (UInt16, divide by 100 for V)
  • Bytes 12-15: Current (Int32, divide by 100 for mA)

Building the App

Using Xcode

1. Open EnvSensorReader.xcodeproj in Xcode
2. Select your target device or simulator
3. Press Cmd+R to build and run

Using xcodebuild (command line)

For iOS device:

xcodebuild clean build \
  -project EnvSensorReader.xcodeproj \
  -scheme EnvSensorReader \
  -sdk iphoneos \
  -configuration Release

For iOS Simulator:

xcodebuild clean build \
  -project EnvSensorReader.xcodeproj \
  -scheme EnvSensorReader \
  -sdk iphonesimulator \
  -configuration Release

GitHub Actions

This project includes a GitHub Actions workflow that automatically builds the app on every push to main/master/develop branches. The workflow:

• Builds for both iOS device and simulator
• Runs on macOS runners
• Archives build artifacts for download
• Supports manual triggering via workflow_dispatch

Permissions

The app requires Bluetooth permissions to function. The following permissions are declared in Info.plist:

• NSBluetoothAlwaysUsageDescription: For scanning BLE devices
• NSBluetoothPeripheralUsageDescription: For BLE peripheral access

Users will be prompted to grant Bluetooth access when the app first launches.

Project Structure

EnvSensorReader/
├── EnvSensorReader/
│   ├── EnvSensorReaderApp.swift    # App entry point
│   ├── ContentView.swift           # Main UI
│   ├── BLEManager.swift            # BLE scanning and parsing
│   ├── SensorReading.swift         # Data model
│   ├── Assets.xcassets/            # App assets
│   └── Info.plist                  # App configuration
├── EnvSensorReader.xcodeproj/      # Xcode project
└── .github/
    └── workflows/
        └── build.yml               # CI/CD workflow

Python Version

This iOS app is a port of the Python script env_reader.py which uses the Bleak library for BLE scanning. Both versions implement the same protocol and functionality.

License

This project is provided as-is for educational and development purposes.