LogoLogo
  • Ruuvi Developer Documentation
  • Ruuvi Hardware
    • RuuviTag B
    • RuuviTag Pro
    • Ruuvi Gateway
    • Ruuvi DevShield
    • Ruuvi Connector Kit
    • TMP 117 External Sensor
  • Ruuvi Connector System
    • Introduction
    • Expansion boards
    • Cables
    • Connectors
  • Ruuvi Sensor Firmware
    • 1.2.12
    • 2.5.9
    • 3.X
      • 3.x Sensors
      • 3.x Heartbeat
    • Device Firmware Update (DFU)
  • Ruuvi Gateway Firmware
    • GW Getting Started
    • GW Web-UI
      • Greeting window
      • Internet connection settings
        • Connection via Wi-Fi
        • Connection via Ethernet
      • Software update
      • Automatic configuration download
      • Automatic updates
      • Access Settings from LAN
      • Cloud Options
        • Backend: HTTP(s)
        • Backend: MQTT(s)
        • Backend: Statistics
      • Time Synchronisation Options
      • Bluetooth Scanning Settings
      • Configuration completion
      • Authentication when accessing from LAN
    • GW Install custom firmware
    • GW nRF52811 Firmware
      • GW nRF52811 selftest
      • GW nRF52811 scanning
      • GW nRF52811 repeating
      • GW nRF52811 UART communication
  • GW ESP32 Firmware
    • GW ESP32 WiFi Hotspot
    • GW ESP32 Button
    • GW ESP32 LED
    • GW ESP32 HTTP Client
    • GW ESP32 MQTT client
  • GW Data formats
    • HTTP: Time-stamped data from Bluetooth-sensors
    • HTTP: Data from Bluetooth-sensors without timestamps
    • MQTT: Time-stamped data from Bluetooth-sensors
    • MQTT: Data from Bluetooth-sensors without timestamps
    • HTTP GET /history (with timestamps) and decoding
    • HTTP: Gateway status
    • Gateway configuration
  • GW Examples
    • Polling mode
    • Poll endpoint "/metrics"
    • Configuration update via API
    • Firmware update via API
    • Configuration download from a remote server via API
    • MQTT examples
    • Home Assistant
    • MQTT+AWS IoT Core
  • Communicate with RuuviTag devices via Bluetooth
    • Bluetooth advertisements
      • Data format 3 (RAWv1)
      • Data format 4 (URL)
      • Data format 5 (RAWv2)
      • Data format C5 (Cut-RAWv2)
      • Data format 8 (Encrypted environmental)
    • Bluetooth connection
      • DIS (Device Information Service)
      • NUS (Nordic UART Service)
        • Heartbeat transmissions
        • Read logged history
    • Real Time Transfer (RTT)
  • Communicate with Ruuvi Cloud
    • Ruuvi Cloud
      • User API
      • Gateway API
      • Internal API
      • Alerts
      • Cloud stored app settings
  • Ruuvi Community projects
    • Integrations
Powered by GitBook
On this page
  • Quickstart
  • LEDs
  • Button
  • Using the Gateway with your own server
  • Using the Gateway with Ruuvi Station app
Edit on GitHub
  1. Ruuvi Gateway Firmware

GW Getting Started

Quickstart

  1. Turn on Ruuvi Gateway by powering it with USB-C.

    - Quickstart using Ethernet: Connect Gateway to your router with Ethernet cable, wait one minute, and you're connected using default settings. - Quickstart using Wi-Fi: Activate WPS on your router by pressing the WPS button (make sure that the WPS is active on 2.4 GHz Wi-Fi).

    - Note: Ethernet cable must not be connected before the configuration is complete if you do not want to use default settings.

  2. Start configuration by connecting to Wi-Fi hotspot "Configure Ruuvi Gateway XXXX".

    - If the browser doesn't open automatically, type http://10.10.0.1 into the address bar.

  3. Follow the steps in the configurator to complete the setup with your preferred settings.

  4. The Gateway is now ready to use and will send data to Ruuvi Cloud or a third-party server according to your configured settings.

LEDs

Ruuvi Gateway has 4 LEDs: Green, Red, Ethernet green, and Ethernet yellow.

The green LED is on when receiving data from Bluetooth sensors and communicating with the cloud server.

If the red and/or green LEDs are blinking, it means that something is wrong. For more details, seeGW ESP32 LED.

Ethernet Yellow turns on when a cable connection is detected and blinks on data transfer. Green led turns on if Gateway operates at a faster 100 MBit/s speed instead of legacy 10 MBit/s. Most modern routers will have the green LED on at all times.

Button

A short press of the button (for example with a paperclip) re-enables the Gateway's configuration mode.

Keeping the button pressed down for 7+ seconds triggers a factory reset which erases all user-configured settings and enables configuration mode (activates Wi-Fi hotspot). After pressing the button, you need to wait until the red LED flashes at a rate of 2.5 Hz, then release the button. After that, the Gateway will restart with the active Wi-Fi access point.

Using the Gateway with your own server

If you want to use the Gateway with your own server, you can connect via MQTT or HTTP(S). The data formats are detailed on the following pages:

  • HTTP: Time-stamped data from Bluetooth-sensors

  • HTTP: Data from Bluetooth-sensors without timestamps

  • MQTT: Time-stamped data from Bluetooth-sensors

  • MQTT: Data from Bluetooth-sensors without timestamps

  • HTTP: Gateway status

Using the Gateway with Ruuvi Station app

PreviousDevice Firmware Update (DFU)NextGW Web-UI

Last updated 1 year ago

For more details, GW ESP32 Configuration page is a good place to start. If you're interested in using Ruuvi Gateway with your own server, review and pages for details on how data is sent to the Internet.

Please check the .

GW ESP32 HTTP Client
GW ESP 32 MQTT Client
Ruuvi Station instruction page