Xaptum Enf xap-rw-001 User manual

The Internet for Things

Quick Start Guide

ENF™ Router Card

with Wi-Fi

Model: XAP-RW-001

Introduction

Thank you for purchasing the Xaptum®ENF™ Router Card with

Wi-Fi. This Quick Start Guide contains instructions for installing

and conguring this card in an edge gateway or IoT device.

Package Contents

XAP-RW-001 DAA Group Label

Full Height Adapter M2 Phillips Screw

(Qty. 2)

Installation Requirements

• Mini PCIe slot and compatible mounting screw(s)

• U.FL to RP-SMA coaxial pigtail

• RP-SMA external Wi-Fi antenna

• Phillips screwdriver (for full-height adapter option)

Host Requirements

• Linux

• USB Ethernet driver

• DHCPv6 client

IMPORTANT: The XAP-RW-001 requires an IPv6 network

stack and a compatible USB Ethernet driver. Most Linux

distributions include both.

Conguration Requirements

• Edge Network Fabric (ENF) account

•enfcliconguration utility

• QR code scanner or phone app

• Wi-Fi access point

IMPORTANT: The XAP-RW-001 requires an Edge Network

Fabric account. Contact your Xaptum sales representative

to create one.

NOTE: The enfcliconguration utility is available online

at downloads.xaptum.com.

regulations, including operation within legal frequency channels, output power, an-

tenna placment, indoor cabling requirements, and Dynamic Frequency Selection (DFS)

requirements.

Hardware Overview

Router Card

Edge Connector

RF Jack

Edge Connector The Mini PCIe edge connector plugs into a

Mini PCIe slot on the host. It provides power and a USB 2.0

connection to the router card.

NOTE: The XAP-RW-001 uses only the power and USB pins

on the connector. The PCIe lines are not required.

RF Jack The U.FL RF jack connects to an external Wi-Fi antenna

via a U.FL to RP-SMA coaxial pigtail.

Approved Antennas

Antennas with the following characteristics may be used with

the XAP-RW-001.

Approved Anntena Characteristics

Type External Dipole

Max Gain

2.4 GHz 2.2 dBi

5 GHz 5 dBi

DAA Group Label

QR Code

Group ID

The DAA group label displays details about the group of router

card(s) in this package.

QR Code The QR code contains the group public key used to

cryptograhically authenticate each router card in this package.

When prompted by the enfcli, scan this code to assign the

group to a network.

NOTE: Router cards are assigned to ::/64networks in

groups, eliminating time-consuming and error-prone

conguration of individual cards.

Full Height Adapter

Alignment Tab

Screw Hole

The full height adapter enables installation in a full height Mini

PCIe slot on the host. Its use is optional.

Assigning a Network

You must assign the router card(s) in this package to a ::/64ENF network before they can be used.

1. Launch the enfcli, specifying the host and username for

your ENF account. Enter your password when prompted.

$enfcli--hostdemo.xaptum.io--useruser@demoConnectingto'https://demo.xaptum.io'.....EnterPassword:2. Choose a ::/64network, and assign these router cards to it

using the iamadd-group-to-networkcommand. Scan1the

DAA group label QR code when prompted.

enfcli-user@demo>iamadd-group-to-network--set-as-default--network=2607:8f80:8080:1::/64ScanDAAgroupinformation:IMPORTANT: On rst boot, the router card will be assigned

an IPv6 address from this network.

1If you don’t have a barcode scanner, use a smartphone

app to scan the code. Paste the resulting text into the enfcliprompt.

Installing the Router Card

If installing in a half height Mini PCIe slot, skip to step 2.

1. Align the top edge of the router card with the full height

adapter alignment tab and attach with the provided Phillips

screws.

2. Insert the router card into the Mini PCIe slot on the host de-

vice, and secure according to the host device’s instructions.

3. Connect the antenna pigtail to the U.FL RF jack.

4. Connect an approved external antenna to the RP-SMA con-

nector on the host device.

Connecting to Wi-Fi

The router card is precongured to connect to a Wi-Fi network

with the following credentials.

SSID WPA2-PSK

xaprc_defaultpassword123!Once connected, you can change the conguration remotely

using the enfcli.

1. Congure a Wi-Fi access point2with the SSID and passphrase

listed in the preceding table.

IMPORTANT: The Wi-Fi access point must be connected to

the Internet.

2. Power on the host device and wait 30 seconds for the router

card to connect. Check the connection status using the

captiveget-device-statuscommand. Use the serial num-

ber printed on the router card as the device id.

enfcli-user@demo>captiveget-device-status--device-id=XRW04419003028SerialNumber:XRW04419003028WIFI:connected:trueSSID:xaprc_defaultIPv4addresses:[192.168.1.56]The following steps create a new prole and Wi-Fi conguration

for this device. To use an existing prole, skip to step 5.

2If you don’t have an access point, congure a smartphone

hotspot instead.

NOTE: Aprole describes the desired conguration for a

router card. Multiple router cards can be easily managed

at once by assigning them to the same prole.

3. Create a new wi cong JSON le and upload it using the

captivecreate-wifi-configurationcommand.

$cat<<EOF>wifi.json{"name":"Demo","networks":[{"name":"Factory","SSID":"ACME-OT","SSID_type":"string","auth":{"type":"psk","passphrase":"pass123"},"IPv4":{"type":"dhcp"}}]}EOFenfcli-user@demo>captivecreate-wifi-configuration--wifi-config-file=wifi.jsonID:1aad6bdd-8b09-49bc-bd43-d5255d543c78Name:DemoNetworks:Name:FactorySSID:ACME-OTauth:pskIPv4:dhcpIPv6:off9