Rinnai N-BW2 User manual

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 1 of 48
N-BW2 Networker Bridge (WIFI)
Application Programmers Interface
Issue 1.3

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 2 of 48
1. Document Information _______________________________________________________ 3
1.1 Current Release Document Control & Authorisation __________________________________ 3
1.2 Change History _________________________________________________________________ 3
2. N-BW2 Networker Bridge (WIFI) Operation _____________________________________ 4
2.1 Overview_______________________________________________________________________ 4
2.2 Networker System Connection_____________________________________________________ 5
2.2.1 N-C3 & N-C6 Type Networkers__________________________________________________________ 5
2.2.2 Brivis Touch (N-C7) Type Networker _____________________________________________________ 6
2.3 Default Access Point State_________________________________________________________ 7
2.4 Opening a TCP Connection with the N-BW2 _________________________________________ 8
2.5 Front Panel LEDs ______________________________________________________________ 10
3. WIFI Configuration Mode ___________________________________________________ 11
3.1 Retrieving Configuration Settings _________________________________________________ 12
3.2 Altering Configuration Settings___________________________________________________ 12
3.3 Saving Configuration Settings ____________________________________________________ 13
3.4 Exiting Configuration Mode______________________________________________________ 13
4. Networker System Access Mode _______________________________________________ 14
4.1 Sequence Numbering____________________________________________________________ 15
4.2 System Related –Group 1: {“SYST”: ______________________________________________ 16
4.3 Heating Related –Group 1: {“HGOM”: ____________________________________________ 18
4.3.1 Single Set Point Operation _____________________________________________________________ 19
4.3.2 Multi-Set Point Operation______________________________________________________________ 21
4.4 Cooling (Add-on) Related –Group 1: {“CGOM”:____________________________________ 23
4.4.1 Single Set Point Operation _____________________________________________________________ 24
4.4.2 Multi-Set Point Operation______________________________________________________________ 26
4.5 Cooling (Evaporative) Related –Group 1: {“ECOM”: ________________________________ 28
5. N-BW2 Interface Test Application_____________________________________________ 30
5.1 WIFI Configuration Screen ______________________________________________________ 31
5.2 Networker System Access Screen__________________________________________________ 33
5.3 Heating Operating Mode ________________________________________________________ 35
5.3.1 Single Set Point Operation _____________________________________________________________ 35
5.3.1.1 No Zones Installed ____________________________________________________________________________________ 35
5.3.1.2 Two Zones Installed ___________________________________________________________________________________ 38
5.3.1.3 Schedule Setting (Auto-Program)_________________________________________________________________________ 39
5.3.2 Multi Set Point Operation ______________________________________________________________ 41
5.4 Cooling (Add-on) Operating Mode ________________________________________________ 45
5.5 Cooling (Evaporative) Operating Mode ____________________________________________ 46
5.6 Switching Operating Mode_______________________________________________________ 48

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 3 of 48
1. Document Information
1.1 Current Release Document Control & Authorisation
Name
Signature
Date
Prepared by:
Emilio La Greca
Emilio
04/04/18
Changed by:
Emilio La Greca
Emilio
13/11/19
Checked by:
Emilio La Greca
Emilio
13/11/19
Approved by:
Emilio La Greca
Emilio
13/11/19
1.2 Change History
Issue
Date
Change Details
Change by
Approved by
1.0
04/04/18
First release
Emilio
Emilio
1.1
19/06/18
Added zone temperature measurement descriptor
to ZXS tags for STSP operation (“MT”: “###” )
Emilio
Emilio
1.2
19/03/19
Configuration settings packet delimiter changed
from ‘!’ to carriage return (0x0D).
Extra version number information added to:
{ “SYST”: { “CFG”:
Temperature display option added to:
{ “ECOM”: { “CFG”:
Extra information added to UDP broadcast
packet.
Emilio
Emilio
1.3
13/11/19
Added temperature measurement descriptor to
GSS tag for ECOM operation (“MT”: “###” )
Emilio
Emilio

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 4 of 48
2. N-BW2 Networker Bridge (WIFI) Operation
2.1 Overview
The N-BW2 Networker Bridge (WIFI) (referred to as N-BW2 from here on) provides a means of remotely
interfacing to Rinnai Networker based systems allowing control and monitoring of heating/cooling appliances the
Networker system manages. The primary interface used for access to the Networker system is a TCP connection
over WIFI. Although a USB port is provided this is purely for production testing and setup when the N-BW2 is
produced.
The front/rear panels of the N-BW2 appear as illustrated in FIG 2a:
FIG 2a: N-BW2 Front & Back Panels
The N-BW2 can be in one of two distinct operating modes:
1) WIFI configuration mode.
2) Networker system access mode.
The N-BW2 will operate in one of three distinct WIFI connecting states:
1) Default Access Point (AP) state.
All N-BW2’s are defaulted to this state when first powered on. When in this state only the WIFI
configuration mode is allowed.
2) User configured Access Point (AP) state.
In this state the N-BW2 operates as an access point which can be associated with –The SSID and
WPA pass-phrase are defined by the user. When operating in this state a network router is not needed
to access the Networker system. By default the N-BW2 will operate in the Networker system access
mode but can revert to the WIFI configuration mode.
3) Station state.
In this state the N-BW2 associates with a router, the SSID and WPA pass-phrase configured to match
that of the router. This is the most common state the N-BW2 operates in. By default the N-BW2 will
operate in the Networker system access mode but can revert to the WIFI configuration mode.
Indicator
Description
PWR
Power on/Primary module operation indication
BUS
Networker system communication indication
WIFI
WIFI module operation indication
SER
Not used
Button
Description
PWR
Power on/off button
AP
Force the Default Access Point (AP) state
LNK
Not used
Brivis Touch connection
Networker system
connection
12VDC plug-pack socket

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 5 of 48
2.2 Networker System Connection
2.2.1 N-C3 & N-C6 Type Networkers
The N-BW2 must be powered by its own 12VDC plug-pack and connected to the system as illustrated in FIG
2.2.1a.
FIG 2.2.1a: N-BW2 Connection to N-C3/N-C6
Networker Controls

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 6 of 48
2.2.2 Brivis Touch (N-C7) Type Networker
When a spare port is available on the Brivis Touch Interface Module this port can be used to connect the N-BW2
as it is pin-to-pin compatible with the corresponding connector on the N-BW2. In this case the 12VDC plug-pack
is not needed to power the N-BW2 –See FIG 2.2.2a.
FIG 2.2.2a: N-BW2 Connection to Brivis Touch System –
Using Interface Module Port
When no spare port is available on the Brivis Touch Interface Module then the N-BW2 must be powered by its
own 12VDC plug-pack and connected to the system as illustrated in FIG 2.2.2b.
FIG 2.2.2b: N-BW2 Connection to Brivis Touch System –
Without Using Interface Module Port

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 7 of 48
2.3 Default Access Point State
The product label affixed to the N-BW2 appears as illustrated below:
This label identifies the unique serial number/default password embedded within the N-BW2. The serial number
is used to form the default SSID (RinnaiABC123 in the example above) with the default password used as the
WPA pass-phrase (1234567890 in the example above). When associated with the N-BW2 in this state, the client
device can only access the WIFI configuration mode described in Section 3. This default Access Point state is
reverted to:
1) When the N-BW2 is switched on for the very first time.
2) When the N-BW2 has not had user configuration settings saved to its internal memory.
3) On power up when the AP button has been held pressed for at least 5 seconds.
4) When the N-BW2 has been configured to operate in the Station state but the router it was configured
to associate with could not be located after 3 minutes. The N-BW2 will revert to its Default AP state
for 2 minutes before reverting back to the user configured Station state.
To ease installation a QR code is provided which when scanned provides the device serial number/default
password as follows (using the above label as an example):
ABC123_1234567890
Default Network Name (SSID):
RinnaiABC123
Default Security Key (WPA):
1234567890

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 8 of 48
2.4 Opening a TCP Connection with the N-BW2
Before opening a TCP connection with the N-BW2 either the N-BW2 must:
-Be associated with if it is operating in one of its Access Point states, or
-Associate with the router it was configured to associate with when operating in its Station state.
Once this is the case the N-BW2 broadcasts a 256 byte long UDP packet every second using the following
broadcast settings:
-Broadcast address : ###.###.###.255
-Broadcast port : 50000
Embedded within this UDP broadcast packet is information listed in the example shown in FIG 2.4a.
FIG 2.4a: N-BW2 UDP Broadcast Packet
From this UDP packet the IP address of the N-BW2 (source address) can be determined and together with the
information listed above all the information needed to open a TCP connection with the N-BW2 is available. Once
a valid TCP connection with the N-BW2 is opened the N-BW2 responds with “*HELLO*”. Provided the client
issues commands to the N-BW2 the TCP connection will remain open. If no response from the client that initiates
the connection is received within the TCP timeout time (TTCPOUT), the N-BW2 will terminate the connection and
perform a reboot.
Index
Description
0000h –001Fh
N-BW2 identification tag.
0020h –0021h
TCP port, high byte first.
In this case 6Ch C7h equates to port 27847.
0022h
Default AP operating state indication.
AAh
Operating in Default AP state.
55h
Not operating in Default AP state.
0023h
Overal firmware version of module.
0024h
Wi-Fi Module firmware version.
0025h
WLAN access mode.
0
AP Mode –Default.
1
AP Mode –User Configured.
2
Station Mode –Uer Configured.
00FFh
Number of scanned SSIDs (Default AP mode only).
FOR SCANNED SSIDs n = 0 to 9
0100h + n x 23h
SSID name.
0100h + n x 20h
SSID name length.
0100h + n x 21h
Security type
OPEN –0
WEP –1
WPA –2
WPA2 –3
0100h + n x 22h
Received Signal Strength Indication (RSSI)
N-BW2 IP Address

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 9 of 48
The entire process for connecting to the N-BW2 is illustrated in FLC 2.4a. The TCP packet size to allow for is
2080 bytes minimum.
FLC 2.4a: Connecting to the N-BW2

N-BW2 Networker Bridge (WIFI) API-N-BW2 Issue 1.3 Page 10 of 48
2.5 Front Panel LEDs
The front panel LEDs can be lit green/orange, the meaning of the indications given below in TABLE 2.5a.
TABLE 2.5a: N-BW2 Front Panel LEDs
Indicator
Description
PWR
Power on/Primary module operation indication
Color
Indication
Orange
Flash Fast
Continuous
Primary module is saving operational/configuration settings to
memory.
Solid
Primary module is clearing the configuration settings to their
default values.
Green
Flash Fast
Continuous
Primary module is loading configuration settings from memory.
Solid
Primary module is idle (indicates power on).
BUS
Networker system communication indication
Flashes green once when a Networker System communication packet has been received.
WIFI
WIFI module operation indication
Color
Indication
Orange
Flash Fast
Continuous
WIFI module is saving configuration settings to memory.
WIFI module is configuring itself for Default AP state operation
due to AP pushbutton being pressed.
Flash Slow
Continuous
WIFI module is in the Default AP state with no client associated
with it.
Flash Once
WIFI module is in the Default AP state and a packet transfer has
occurred.
Flash N Times
Repeatedly
WIFI module has experienced a fault, the number of flashes
indicates the fault code.
Solid
WIFI module is waiting for switch over to the Default AP state
after being in the Station state with no connection to the named
router occurring for 3 minutes.
Green
Flash Fast
Continuous
WIFI module is loading configuration settings from memory.
Flash Slow
Continuous
WIFI module is in the user configured AP state with no client
associated with it OR in the user configured Station state and
not associated with the named router.
Flash Once
WIFI module is in the AP or Station state and a packet transfer
has occurred.
Solid
WIFI module is waiting for switch over to the Station state after
being in the Default AP state with no connection by a client for
2 minutes.