NetBurner 3.5.6
PDF Version
Wifi Client

WiFi Client Application

Overview

This application demonstrates how to connect to a WiFi network using NetBurner's WiFi driver and access comprehensive status information about the connection. The application provides detailed monitoring capabilities for both Ethernet and WiFi network interfaces.

Features

  • WiFi Network Connection: Automatically connects to a configured WiFi network using stored credentials
  • Network Scanning: Scans and displays available WiFi networks
  • Status Monitoring: Provides real-time status information including:
    • IP configuration (address, mask, gateway, DNS)
    • MAC addresses
    • Signal strength (RSSI)
    • Security protocols and cipher types
    • Connection status
    • Hardware and firmware versions
  • Interactive Interface: Serial debug port menu for real-time status updates
  • Multi-Interface Support: Displays both Ethernet and WiFi interface information

Hardware Compatibility

This application is designed for NetBurner platforms, with special considerations for:

  • 5270 and 5234 processors: Automatically enables spread spectrum mode to reduce radio interference
  • External Antenna Support: Optimized for WiFi modules with external antennas

Security Protocols Supported

The application can identify and display the following security types:

  • Open (no security)
  • WEP
  • WPA
  • WPA2
  • WPS

Cipher Support

Supported cipher types include:

  • None
  • TKIP
  • AES
  • Mixed (TKIP/AES)

Configuration

WiFi Credentials

The application uses stored configuration records for WiFi credentials:

  • SSID and passphrase are loaded from the system configuration
  • Total length of SSID and passphrase must not exceed 68 characters
  • Credentials can be configured using IPSetup utility

SPI Interface Configuration

The WiFi module connects via SPI with the following default parameters:

  • IRQ Number: 3
  • Module Number: 1
  • CS Number: Default
  • Connector Number: Default
  • GPIO Pin Number: Default
  • Reset Pin Number: 42

Usage

  1. Startup: The application automatically scans for available networks on startup
  2. Connection: Attempts to connect using stored WiFi credentials
  3. Status Display: Shows comprehensive network status information
  4. Interactive Mode: Press any key to refresh and display current status

Output Information

Ethernet Interface

  • IP Address, Subnet Mask, Gateway, DNS
  • MAC Address

WiFi Interface

  • Interface number and IP configuration
  • SSID (Service Set Identifier) - network name
  • BSSID (Basic Service Set Identifier) - Access Point MAC address
  • Signal strength (RSSI)
  • Channel information
  • Security and cipher protocols
  • Connection status
  • Hardware and firmware revision information

Code Structure

Main Components

  • DisplaySecurity(): Converts security protocol values to human-readable labels
  • DisplayCipher(): Converts cipher type values to human-readable labels
  • DisplayWifiStatus(): Comprehensive status information display
  • DisplayWifiConfigRecordParameters(): Shows configured SSID and passphrase
  • UserMain(): Primary application entry point and main loop

Troubleshooting

  • If WiFi interface fails to initialize, check SPI connections and module power
  • Ensure WiFi credentials are properly configured in system config records
  • Verify antenna connections for optimal signal strength
  • Check that the WiFi module is compatible with your NetBurner platform