Netrunr B24C V2 Quick Start Guide

Thank you for choosing Netrunr B24C V2 Bluetooth gateway. For any issues with the setup or use of this product, please contact us at support@axiomware.com for assistance.

Package contents



Please note: A 5V, 500mA (2.5 W) power supply like VEL05 is required to power up the gateway. This power supply is not included with the gateway.



Getting to know the gateway

Take a few minutes to familiarize yourself with the indicators and connection ports on the gateway.

All Netrunr B Bluetooth gateways follow the exact same setup procedures.




Gateway Modes

Netrunr B24C V2 can operate in two modes:

  • Autonomous Mode
  • Managed Mode
The original version of Netrunr B24C only operated in Managed Mode.

Autonomous mode provides complete control of the gateway from a client application program. In Autonomous mode, applications send commands and receive responses from Netrunr through an MQTT Server using a Gateway Application Interface (GAPI). Netrunr may also be configured to be fully autonomous and perfom continuous device scan operations. In this case, applications do not need to send commands to Netrunr; they only receive Netrunr data.

Managed mode also provides control the gateway from a client application program, but through a cloud service. The cloud service provisions, manages, and updates the gateway.


Netrunr Configuration - Autonomous Mode

In Autonomous mode, Netrunr is configured using a web interface, and built-in Wi-Fi access point.

Note: for security, the Netrunr web interface and Wi-Fi access points provide separate passwords (external Wi-Fi networks have a different password).


Configure Netrunr over Wi-Fi Access Point

To use the Netrunr built-in Wi-Fi access point, scan Wi-Fi from your mobile device, laptop or other machine:

  • SSID: AXM-Netrunr-xxxx
    where 'xxxx' are the last 4-characters of the MAC address written on the label on the bottom of the Netrunr.
  • Password: liberte0

Note: see Change Netrunr Wi-Fi Access Point Password to change this password.

In a web browser, enter the following URL to view the login page:

  • URL: http://192.168.8.1

The default login password is empty. However, it is strongly recommended to add a login password immediately to secure against unauthorized access.





Configure Netrunr for a Wireless Network

To configure Netrunr to use a wireless (Wi-Fi) network:

  • Select the Network->Wireless menu
  • Click Scan


  • Locate the SSID of your wireless network and click Join Network


  • Enter the WPA passphrase and click Submit


  • Click Save & Apply and wait for the configuration to be stored.





Change Netrunr Wi-Fi Access Point Password

To change the Netrunr Wi-Fi Access Point password:

    • Select the Network->Wireless menu
    • Click Edit for the access point (AXM-Netrunr-xxxx)


    • Select the Wireless Security tab
    • Enter the new Key (password)
    • Click Save & Apply




    Configure Netrunr Applications

    To configure Netrunr to run a primary gateway application:

    • Select the Netrunr->Applications menu




    Configure Netrunr Applications - Scan

    To configure Netrunr for continuous scan of Bluetooth Low Energy devices:

    • Select Scan
    • Enter configuration information (* indicates minimal required information)
    • Click Submit

    Note that configuration information depends upon the MQTT server. The fields shown here assume that MQTT traffic is not encrypted (TLS not checked) and that no authentication (username/password or MQTT Client Certificate/Private Key) is needed.



    Once configured, the primary gateway application server may be stopped and restarted using the Control tab, and configuration tests may be run using the Test tab.



    Configure Netrunr Applications - Gateway Application Interface (GAPI)

    To configure Netrunr for the Gateway Application Interface (GAPI):

    • Select Gateway API (GAPI)
    • Enter configuration information (* indicates required information)
    • Click Submit

    Note that configuration information depends upon the MQTT server. The fields shown here assume that MQTT traffic is not encrypted (TLS not checked) and that no authentication (username/password or MQTT Client Certificate/Private Key) is needed.



    Once configured, the primary gateway application server may be stopped and restarted using the Control tab, and configuration tests may be run using the Test tab.



    Netrunr Configuration - Managed Mode

    In Managed mode, Netrunr is configured using a mobile app and Netrunr Account as described in the sections below.

    These sections may be skipped if Netrunr is configured to operate in Autonomous mode.


    Creating an account

    This is a one-time process to create an Axiomware Cloud Account. If you already have an account, you can skip this step.

    • Download the Netrunr app from the link above and open the app.
    • Select Create An Account link.
    • Enter an user name. User name must be in email format. This email is also used for password recovery.
    • Enter a password and reconfirm it.
    • Press Submit.


    Congratulations! you have created an Axiomware Cloud Account. You can use this account to add, manage and check status of your Netrunr gateways. You will also use the account credentials to access the Netrunr Gateway API.



    Provisioning a Netrunr B24C Gateway

    Provisioning is a one-time step to add a Netrunr gateway to your account:

    • Start Netrunr app.
    • Using your account credentials, sign-in into your account.
    • Select Gateways.




    • Using the micro-USB cable, power up the Netrunr Gateway. The micro-USB port is located at the back of the gateway. Any 5V, 0.5A USB power supply can be used as a power source for the gateway.
    • Monitor the blue color status LED on the front of the gateway.
    • The gateway requires about 30 seconds to boot-up. During this phase, the blue status LED will transition from steady light to fast blink to finally slow blink (one second ON and one second OFF).
    • The slow blink state of the status LED indicates that the gateway is in the Provisioning State.
    • With the gateway in the Provisioning State, select Scan for Netrunr Gateways button in the app.



    • Wait a few moments for the scan to complete.
    • Any newly discovered gateways that are Unregistered to any accounts will be listed under Unregistered.
    • Select the gateway.
    • A Gateway Registration confirmation box will be displayed.
    • Select OK to Register the gateway.
    • If you do not see your gateway listed, verify that the gateway is in the Provisioning State and run the scan again. This step uses the Bluetooth radio for configuration. Your gateway has to be within the Bluetooth range.

    You have now Registered your Netrunr gateway.



    Network Connection

    If you are using a wired network connection, plug the network cable into the WAN port of the gateway. You are done!

    If you are using a Wi-Fi network connection, proceed to the next section.


    Add Wi-Fi credentials

    The Netrunr app is used to configure Wi-Fi access.

    • Start Netrunr app.
    • Using your account credentials, sign-in into your account.
    • Select Gateways.
    • Make sure the gateway is powered-up and in the Provisioning State (The blue status LED should be blinking slowly).
    • With the gateway in the Provisioning State, press Scan for Netrunr Gateways button in the app.
    • Wait a few moments for the scan to complete.
    • All gateways that are Registered to the account will be listed as Registered.
    • Only the gateways that are in the Provisioning State can be selected.
    • If you do not see your gateway listed, verify that the gateway is in the Provisioning State, and run the scan again.
    • Under the Registered list, select the Netrunr gateway that matches the ID printed on the bottom of your gateway.
    • To scan for available Wi-Fi routers, press Scan for Wi-Fi
    • Select the Wi-Fi router that you want to use.




    Next:

    • Enter Wi-Fi password and press OK.
    • If the Wi-Fi credentials are correct, the Netrunr B24C gateway will be connected to your network.




    Congratulations! You have successfully configured the network connection for your gateway.

    Try it now!