====RisingHF LRWAN GS HF1====
<wrap right>
{{interfaces:risinghf.jpg?100}}
</wrap>

This SX1301 LoRaWAN gateway daughterboard comes attached to [[boards:f746zg|NUCLEO-F746ZG]] as
part of the [[boards:lrwan2|P-NUCLEO-LRWAN2]] kit.

This product is considered obsolete since the gateway firmware on
the [[boards:f746zg|NUCLEO-F746ZG]] has not been updated since 2018 and it is not
fully compatible with modern services, however, it is compatible
with [[:tools:lorawan-server|this]] LoRaWAN server.

===Setup===

   * Refer to the [[https://www.st.com/resource/en/user_manual/um2587-getting-started-with-the-pnucleolrwan2-and-pnucleolrwan3-starter-packs-stmicroelectronics.pdf|LRWAN2 user manual]] and configure the jumpers.
   * Connect the ethernet to the LAN.
   * Power up the RisingHF daughterboard with a 1A PSU.
   * Connect the ST-LINK to a PC as a terminal console.

A 2A RPi3 PSU is ideal to power the gateway.

===Jumpers===

On the NUCLEO-F746ZG board, verify the jumper settings:

<code>
JP1 (PWR-EXT) OFF
JP3 (power source) on VIN-5V
JP5 (IDD) ON
</code>
===Console===

The ST-LINK port acts as a terminal console which is used to configure the gateway
from a PC.

<code>
picocom -b 115200 /dev/ttyACM1
</code>

===Boot===

<code>
    _/_/_/    _/_/_/    _/_/_/  _/_/_/  _/      _/    _/_/_/  _/    _/  _/_/_/
   _/    _/    _/    _/          _/    _/_/    _/  _/        _/    _/  _/
  _/_/_/      _/      _/_/      _/    _/  _/  _/  _/  _/_/  _/_/_/_/  _/_/_/
 _/    _/    _/          _/    _/    _/    _/_/  _/    _/  _/    _/  _/
_/    _/  _/_/_/  _/_/_/    _/_/_/  _/      _/    _/_/_/  _/    _/  _/

Powered by RisingHF & STMicroelectronics
-------------------------------------------------------------------------------
           VERSION: 2.1.7, Nov  6 2018
               LOG: OFF
           AT ECHO: ON
          BAUDRATE: 115200bps
           MACADDR: xx:xx:xx:xx:xx:xx
          ETHERNET: DHCP
              DNS1: 114.114.114.114
              DNS2: 8.8.8.8
        NTP SERVER: 1.ubuntu.pool.ntp.org
       EUI PADDING: {3, FF}, {4, FF}
        GATEWAY ID: xxxxxxxxxxxxxxxx
           LORAWAN: Public
    LORAWAN SERVER: eu1.loriot.io
   UPLINK UDP PORT: 1780
 DOWNLINK UDP PORT: 1780
          CHANNEL0: 867100000, A, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL1: 867300000, A, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL2: 867500000, A, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL3: 867700000, A, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL4: 867900000, A, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL5: 868100000, B, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL6: 868300000, B, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL7: 868500000, B, SF7/SF12, BW125KHz    (LORA_MULTI_SF)
          CHANNEL8: 868300000, B, SF7, BW250KHz         (LORA_STANDARD)
          CHANNEL9: 868800000, B, 50Kbps                (FSK)
-------------------------------------------------------------------------------
Concentrator starting...
Concentrator Radio A type SX1257
Concentrator Radio B type SX1257
Concentrator started (2926ms)
ST LoRa GW V2
Ethernet starting...
Ethernet started
DHCP IP: 192.168.0.254
Downlink UDP Connected
Uplink UDP Connected
</code>

===Help===

<code>
AT+HELP
+HELP: OK

         AT -- AT Ping

       HELP -- Print command list
                   -> AT+HELP

   FDEFAULT -- Restore factory default
                   -> AT+FDEFAULT

      RESET -- Reset gateway
                   -> AT+RESET

        SYS -- Check device configuration
                   -> AT+SYS

        VER -- Version
                   -> AT+VER

        LOG -- Logging
                   -> AT+LOG
                   -> AT+LOG=ON
                   -> AT+LOG=OFF

       ECHO -- AT echo on/ff
                   -> AT+ECHO
                   -> AT+ECHO=ON
                   -> AT+ECHO=OFF

        MAC -- MAC address
                   -> AT+MAC
                   -> AT+MAC=mac_address

         IP -- Gateway DHCP/STATIC ip
                   -> AT+IP
                   -> AT+IP=DHCP
                   -> AT+IP=STATIC,ip,netmask,gateway

        DNS -- DNS record
                   -> AT+DNS
                   -> AT+DNS=dns1,dns2

        NTP -- NTP server address
                   -> AT+NTP
                   -> AT+NTP=ntp_server_address

        EUI -- MACADDRESS (EUI48) to EUI64 padding
                   -> AT+EUI
                   -> AT+EUI=pos0,val0_hex,pos1,val1_hex

    LORAWAN -- LORAWAN Public/Private
                   -> AT+LORAWAN
                   -> AT+LORAWAN=PUBLIC
                   -> AT+LORAWAN=PRIVATE

     PKTFWD -- Packet forwarder server address and port
                   -> AT+PKTFWD
                   -> AT+PKTFWD=address,port_up,[port_down]

         CH -- Packet forwarder channels
                   -> AT+CH
                   -> AT+CH=0~7,freq,radio                 // Set multi SF LoRa channel
                   -> AT+CH=8,freq,radio,sf,bw             // Set standard LoRa channel
                   -> AT+CH=9,freq,radio                   // Set FSK channel
                   -> AT+CH=0~9,0                          // Turn off a channel
                   -> AT+CH=0~9,OFF                        // Turn off a channel
                   -> AT+CH=EU868|US915|EU433|CN780|AU915|AS923|KR920|CN470|IN866|CN470PREQUEL

   BAUDRATE -- UART baudrate
                   -> AT+BAUDRATE
                   -> AT+BAUDRATE=new_br                         // MAX 4000000bps
</code>

===Connect===

[[tools:lorawan-server|This]] LoRaWAN server works with the gateway.

<code>
AT+PKTFWD=192.168.0.115,1680,1680
+PKTFWD: 192.168.0.115, 1680, 1680
AT+RESET
</code>

===Firmware===

Last known firmware for the [[:boards:f746zg|NUCLEO-F746ZG]] host board.

{{:downloads:st-nucleo-lora-gw-at-fw-v2.1.7-eu868-ttn.bin|st-nucleo-lora-gw-at-fw-v2.1.7-eu868-ttn.bin}}



===Resources===

[[https://www.st.com/resource/en/user_manual/um2587-getting-started-with-the-pnucleolrwan2-and-pnucleolrwan3-starter-packs-stmicroelectronics.pdf|P-NUCLEO-LRWAN2 User manual]]

[[https://www.thethingsnetwork.org/docs/gateways/st/|The Things Network]]