RBgrid

Settings

Overview

The System Settings page is designed for basic configuration of the RBgrid electrical power measurement device. Here you can configure core system parameters, device identification, logging, and startup behavior.

Settings Edit Process

Activating Edit Mode

  1. Click the EDIT CONFIGURATION button to enter edit mode
  2. All fields will become editable
  3. Make necessary changes to the parameters

Saving Changes

  1. After making changes, click the SAVE button
  2. The system will offer to perform a software reboot of the device
  3. Action options:
    • Reboot now - immediate activation of settings
    • Postpone reboot - continue configuring other parameters with subsequent unified reboot

Note: Settings are saved to the hub's internal flash and persist across reboots; no external memory module is required in v1.1.x.

Settings Parameters

Device Information

version

  • Type: String (read-only)
  • Description: Device firmware version
  • Example: 1.0.0

device_id

  • Type: String
  • Description: Unique device identifier in the system
  • Example: ESP32-RBGrid
  • Recommendations: Use a clear name to identify the device in RBgrid-NOW network, for MQTT telemetry, JSON

Location Identification

home_name

  • Type: String
  • Description: Name of the object/house/building where the device is installed
  • Example: House-2
  • Usage: Used for device grouping and in reports

location

  • Type: String
  • Description: Geographic location, locale, or installation address
  • Example: HongKong
  • Usage: Helps identify the device when remotely managing a group of devices

Regional Settings

language

  • Type: String (ISO 639-1 language code)
  • Description: Device interface language
  • Available values: EN, DE, RU, ES, FR, CN
  • Default: EN
  • Usage: Language selection for web-app interface, logging, alerts

Logging Settings

logging_level

  • Type: Number (0-4)
  • Description: System log detail level
  • Values:
    • 0 - OFF (logging disabled)
  • 1 - ERROR (critical errors only)
  • 2 - WARNING (warnings and errors)
  • 3 - INFO (informational messages)
  • 4 - DEBUG (full debug information)
  • Recommendation: Use level 3 for normal operation

enable_logging

  • Type: Boolean
  • Description: Global enable/disable of logging system
  • Default: true

Telemetry and Monitoring

enable_telemetry

  • Type: Boolean
  • Description: Send diagnostic data to remote server
  • Default: false
  • Note: When enabled, the device will send operational statistics to configured MQTT brokers or addresses via HTTP, Websocket. Configure on the Telemetry page.

Network Parameters

max_retry_attempts

  • Type: Number
  • Description: Maximum number of retry attempts on network failures
  • Range: 1-10
  • Default: 3

retry_delay_ms

  • Type: Number
  • Description: Delay between retry attempts (milliseconds)
  • Range: 100-10000
  • Default: 1000
  • Recommendation: Increase value for unstable networks

Hub access point (Settings → Network)

The Hub access point card manages the hub's own Wi-Fi network, named rbgrid-xxxx (the last four of the hub's MAC).

  • Status: shows first-login password while the hub still uses the password it shipped with, or your password once you have set your own.
  • Reminder (shown only while the first-login password is in use): "The hub's own Wi-Fi still uses the first-login password. Set your own so that only you can join it."
  • New access-point password: the field to set your own AP password. Rule: "8–63 characters: Latin letters, digits, symbols. Applies at once — devices on the hub's Wi-Fi reconnect."
  • Change password: applies the new password immediately (connected devices reconnect).
  • Back to the first-login password: reverts the AP to the password the hub shipped with.
  • Requires an admin token (Settings → Access).

The AP password is set only by you; the hub never stores a password you did not enter. Keep it where you keep your other device passwords — there is no recovery other than reverting to the first-login password.

Data Transfer Optimization

enable_json_compression

  • Type: Boolean
  • Description: Compress JSON data during network transfer
  • Default: false
  • Advantages: Reduces amount of transmitted data
  • Disadvantages: Increases processor load

enable_encryption

  • Type: Boolean
  • Description: Encrypt data during transmission
  • Default: false
  • Important: Recommended to enable when working through public networks. Increases processor load

System Behavior

auto_start_measurements

  • Type: Boolean
  • Description: Automatically start measurements when device powers on
  • Default: true
  • Usage: When false, measurements must be started manually via web interface

Requirements and Limitations

  1. Settings storage: settings are saved to the hub's internal flash and persist across reboots; no external memory module is required in v1.1.x
  2. Reboot: All settings require a reboot to apply
  3. Validation: System automatically checks the correctness of entered values
  4. Backup: System saves previous configuration to backup file. Previous settings can be rolled back

Troubleshooting

Settings Not Saving

  • Check the hub is flashed with the full v1.1 image, including the partition table
  • Ensure the save process completes correctly

Device Not Responding After Changing Settings

  • Perform hardware reboot of the device
  • Reset to factory settings using physical RESET button (hold for 10 seconds)

High Processor Load

  • Reduce logging level
  • Disable JSON compression on weak processor
  • Disable telemetry if not being used