Wi-Fi and Bluetooth - Qualcomm Dragonwing Documentation

The Qualcomm Dragonwing IQ-8275 EVK features integrated Wi-Fi and Bluetooth connectivity via the NFA765A module (WCN6856 NSP288 chip) over an M.2 interface.

Specifications

Wi-Fi

Feature	Specification
Standard	Wi-Fi 6E (802.11ax)
Bands	2.4 GHz, 5 GHz, 6 GHz (tri-band)
Peak PHY Rate	2.9 Gbps with 1K QAM
Operation	Dual Band Simultaneous (DBS), STA and AP modes
Driver	ath11k

Bluetooth

Feature	Specification
Standard	Bluetooth Core Specification v5.2
BLE Speed	Up to 2 Mbps
Long Range	500 Kbps and 125 Kbps
Stack	BlueZ

Hardware Setup

Install Wi-Fi Module

Insert the NFA765A module into the M.2 slot at a 30-degree angle, press flat, and secure with the provided screw.

Connect Antennas

ANT0 (2.4G) — shared between Wi-Fi and Bluetooth
ANT1 (5G/6G) — Wi-Fi 5 GHz and 6 GHz only

Connect UART Debug Cable

Connect the UART cable to the debug port and note the assigned COM port or /dev/ttyUSB device.

Connect Power and Boot

Power on and observe the boot sequence via UART console. Default login: ubuntu / ubuntu.

Architecture

Wi-Fi Software Architecture

Component	Description
hostapd	Access point and authentication server (WPA/WPA2/WPA3)
cfg80211	Wireless device configuration management
mac80211	Open-source WLAN protocol implementation
ath11k MAC Interface	Interface between mac80211 and lower ath11k layers
ath11k Control/Data Path	Scan, auth, association; data traffic management
WMI/HTT	High-level protocols between host driver and firmware

Bluetooth Software Architecture

Component	Description
bluetoothd	Central Bluetooth daemon with D-Bus interfaces
bluetoothctl	CLI tool for Bluetooth functionality testing
HCI Core	Sends/receives HCI commands between user space and driver
L2CAP	Breaks large packets into frames; handles QoS
Qualcomm BT Driver	GPIO config, regulators, patch and NV data download

Verify Components

Wi-Fi

# Check driver
lsmod | grep ath11k

# Check interface
iw dev

# Check firmware
ls -la /lib/firmware/ath11k/

Bluetooth

# Check driver
lsmod | grep bt

# Check HCI device
hciconfig

# Check firmware
ls -la /lib/firmware/qca/

# Check BlueZ daemon
systemctl status bluetooth

Wi-Fi Configuration

Station Mode

# Scan for networks
nmcli dev wifi list

# Connect
nmcli dev wifi connect <SSID> password <password>

# Verify connection
nmcli general status
nmcli dev status
ip addr show wlp1s0
ping 8.8.8.8

Set MAC Address (Optional)

The manually set MAC address persists only until the next reboot, then reverts to the factory OTP address.

ip link set wlp1s0 down
ip link set wlp1s0 hw ether XX:XX:XX:XX:XX:XX
ip link set wlp1s0 up

Hotspot Mode

Add SoftAP interface

iw dev wlp1s0 interface add wlan1 type managed

Configure and start hostapd

# Pull default config (optional)
scp -r ubuntu@<IP>:/etc/hostapd.conf .

#Update the hostapd.conf file with the SSID, password, 
#Interface name and relevant configurations & push the file.
scp -r hostapd.conf root@<IP_address>:/etc

# Start the hostapd process:
hostapd -B /etc/hostapd.conf

Start DHCP server

#Create bridge interface
brctl addbr br0

#Add wlan1 to bridge
brctl addif br0 wlan1

#Assign IP address to bridge
ip addr add 192.168.225.1/24 dev br0

#Restart dnsmasq
killall dnsmasq

#Start dnsmasq with DHCP configuration
dnsmasq --conf-file=/etc/dnsmasq.conf --dhcp-leasefile=/var/run/dnsmasq.leases \
  --addn-hosts=/data/hosts --pid-file=/var/run/dnsmasq.pid -i br0 -I lo -z \
  --dhcp-range=br0,192.168.225.20,192.168.225.60,255.255.255.0,43200 --dhcp-hostsfile=/data/dhcp_hosts \
  --dhcp-option-force=6,192.168.225.1 --dhcp-script=/bin/dnsmasq_script.sh 

Monitor connections

#To establish a connection with the *hostapd_cli*
hostapd_cli -i wlan1 -p /var/run/hostapd

Stop hotspot:

#To stop the hostapd process
killall hostapd

#To disable the interface
ip link set wlan1 down

#To delete *ctrl_interface*
rm -rf /var/run/hostapd/wlan1

Bluetooth Configuration

Set Bluetooth MAC Address (Optional)

A manually set Bluetooth MAC address does not persist across reboots.

hciconfig hci0 down
btmgmt public-addr 22:22:9B:2C:79:1E
hciconfig

GAP Operations

# Launch bluetoothctl
bluetoothctl

# Enable Bluetooth
power on

# Enable discoverable mode
discoverable on

# Scan for devices
scan on

# Pair with device
pair F8:7D:76:9D:9B:6B

# List paired devices
devices

# Disable Bluetooth
power off

Supported Bluetooth Profiles

Profile	Role	Version
GAP	Central and Peripheral	—
SPP	Client and Server	v1.2
GATT	Central and Peripheral	—
OPP	Client and Server	v1.2
FTP	Client and Server	v1.2
PBAP	Client and Server	v1.1
MAP	Client and Server	v1.2

A2DP, AVRCP, and HFP are supported on WCN6750/WCN6856.

Debugging

# Wi-Fi
echo "module ath11k +p" > /sys/kernel/debug/dynamic_debug/control
dmesg > /tmp/dmesg.txt

# Bluetooth
#Enable BlueZ logs
vi /lib/systemd/system/bluetooth.service

#Append -d option to the following line in the file and save 
ExecStart=/usr/libexec/bluetooth/bluetoothd -d

#Restart Bluetooth
systemctl daemon-reload
systemctl restart bluetooth

# Collect HCI snoop log 
hcidump --save-dump=/var/log/snoop.log 

Troubleshooting

wlp1s0 Interface Not Found

dmesg | grep ath11k
ls /lib/firmware/ath11k/

Cannot Connect to AP

Verify SSID and password; check AP security settings.

Bluetooth Not Powering On

dmesg | grep -i bluetooth
ls /lib/firmware/qca/

Pairing Fails

Ensure both devices confirm the same passkey; retry pairing.

Audio Profile Not Working

A2DP and HFP require WCN6750/WCN6856 — verify profile support.

​Specifications

​Wi-Fi

​Bluetooth

​Hardware Setup

​Architecture

​Wi-Fi Software Architecture

​Bluetooth Software Architecture

​Verify Components

​Wi-Fi

​Bluetooth

​Wi-Fi Configuration

​Station Mode

​Set MAC Address (Optional)

​Hotspot Mode

​Bluetooth Configuration

​Set Bluetooth MAC Address (Optional)

​GAP Operations

​Supported Bluetooth Profiles

​Debugging

​Troubleshooting

​Resources

Specifications

Wi-Fi

Bluetooth

Hardware Setup

Architecture

Wi-Fi Software Architecture

Bluetooth Software Architecture

Verify Components

Wi-Fi

Bluetooth

Wi-Fi Configuration

Station Mode

Set MAC Address (Optional)

Hotspot Mode

Bluetooth Configuration

Set Bluetooth MAC Address (Optional)

GAP Operations

Supported Bluetooth Profiles

Debugging

Troubleshooting

Resources