How to use WILC3000 on SAM development boards
Introduction
This page describes how WILC3000 devices could be used on SAM development boards.
Supported devices
The following table specifies the boards where WILC3000 is soldered and the boards where WILC3000 could be soldered.
| |||||||||||||
*) WILC3000 could be soldered on the corresponding socket
Kernel support
The driver that is used to control the WILC3000 devices is WILC1000 driver. The compatible strings available for these devices are:
"microchip,wilc1000" "microchip,wilc3000
Overlay support
For boards where WILC3000 module is already soldered on, there is no need to follow the instructions in this chapter.
For boards where WILC3000 module is soldered, the proper device tree overlay should be loaded from U-Boot. To check the available WILC device tree overlays, check the files *_wilc.dtso in the dt-overlay-mchp
repository.
To load WILC overlay, follow the next steps:
1. Enter U-Boot prompt by hitting enter when Hit any key to stop autoboot message appears on console:
U-Boot 2019.04-linux4sam_6.2 (Oct 25 2019 - 03:10:23 +0000) CPU: SAM9X60 Crystal frequency: 24 MHz CPU clock : 600 MHz Master clock : 200 MHz DRAM: 256 MiB MMC: sdhci-host@80000000: 0 Loading Environment from FAT... OK In: serial Out: serial Err: serial Net: eth0: ethernet@f802c000 Hit any key to stop autoboot: 3
2. Edit bootcmd U-Boot environment variable and add #wilc string at the end:
U-Boot> edit bootcmd edit: fatload mmc 0:1 0x24000000 sam9x60ek.itb; bootm 0x24000000#kernel_dtb#wilc
3. Enter boot command. The Linux kernel would be loaded using the WILC device tree overlay:
U-Boot> boot
4508836 bytes read in 225 ms (19.1 MiB/s)
## Loading kernel from FIT Image at 24000000 ...
Using 'kernel_dtb' configuration
Trying 'kernel' kernel subimage
Description: Linux4SAM Linux kernel
Type: Kernel Image
Compression: uncompressed
Data Start: 0x240000d8
Data Size: 4447104 Bytes = 4.2 MiB
Architecture: ARM
OS: Linux
Load Address: 0x22000000
Entry Point: 0x22000000
Hash algo: crc32
Hash value: 2c706949
Hash algo: sha1
Hash value: d8d72f7fb8603a35a39a6803d9b418abebbca9a5
Verifying Hash Integrity ... crc32+ sha1+ OK
## Loading fdt from FIT Image at 24000000 ...
Using 'kernel_dtb' configuration
Trying 'base_fdt' fdt subimage
Description: SAM9X60-EK Flattened Device Tree blob
Type: Flat Device Tree
Compression: uncompressed
Data Start: 0x2443dd90
Data Size: 28407 Bytes = 27.7 KiB
Architecture: ARM
Load Address: 0x23000000
Hash algo: crc32
Hash value: b8c3d3b7
Hash algo: sha1
Hash value: b538fc9f410be576b6bba6e18add7010e68f6f7b
Verifying Hash Integrity ... crc32+ sha1+ OK
Loading fdt from 0x2443dd90 to 0x23000000
## Loading fdt from FIT Image at 24000000 ...
Using 'wilc' configuration
Trying 'fdt_wilc' fdt subimage
Description: Device Tree blob WILC3000 overlay
Type: Flat Device Tree
Compression: uncompressed
Data Start: 0x2444b168
Data Size: 1572 Bytes = 1.5 KiB
Architecture: ARM
Load Address: 0x23180000
Hash algo: crc32
Hash value: e8fbf3b2
Hash algo: sha1
Hash value: e36920209c1e758e6e67207b4a1646896b3a8784
Verifying Hash Integrity ... crc32+ sha1+ OK
Loading fdt from 0x2444b168 to 0x23180000
Booting using the fdt blob at 0x23000000
Loading Kernel Image ... OK
Loading Device Tree to 2feeb000, end 2fef51c8 ... OK
Starting kernel ...
Configuration steps
Kernel module
To be able to use the WILC devices, the following kernel needs to be inserted after kernel boots:
cfg80211.ko pwrseq_sd8787.ko wilc-sdio.ko
Check that the above modules are inserted by running lsmod command:
root@sama5d27-wlsom1-ek-sd:~# lsmod Module Size Used by pwrseq_sd8787 12288 1 cfg80211 311296 0 usb_f_acm 12288 1 u_serial 16384 1 usb_f_acm g_serial 12288 0 libcomposite 40960 2 g_serial,usb_f_acm atmel_usba_udc 20480 0 autofs4 24576 0
If one of the above modules is missing, try inserting them using insmod or modprobe command. In the above example, the wilc-sdio.ko module is missing. To insert it:
root@sama5d27-wlsom1-ek-sd:~# insmod /lib/modules/$(uname -r)/kernel/drivers/net/wireless/microchip/wilc1000/wilc-sdio.ko wilc_sdio mmc1:0001:1: Driver Initializing success
In case the other modules are missing, try inserting them using insmod or modprobe commands:
insmod /lib/modules/$(uname -r)/kernel/net/wireless/cfg80211.ko insmod /lib/modules/$(uname -r)/kernel/drivers/mmc/core/pwrseq_sd8787.ko insmod /lib/modules/$(uname -r)/kernel/drivers/net/wireless/microchip/wilc1000/wilc-sdio.ko
After all kernel modules are installed, the wlan0 interface should appear in ifconfig:
root@sama5d27-wlsom1-ek-sd:~# ifconfig -a
eth0 Link encap:Ethernet HWaddr 54:10:ec:ff:fa:16
UP BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
Interrupt:30 Base address:0x8000
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
inet6 addr: ::1/128 Scope:Host
UP LOOPBACK RUNNING MTU:65536 Metric:1
RX packets:2 errors:0 dropped:0 overruns:0 frame:0
TX packets:2 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:140 (140.0 B) TX bytes:140 (140.0 B)
p2p0 Link encap:Ethernet HWaddr 00:00:00:00:00:00
BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
sit0 Link encap:UNSPEC HWaddr 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00
NOARP MTU:1480 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
wlan0 Link encap:Ethernet HWaddr 00:00:00:00:00:00
BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
From here on, the WILC device could be used in either direct WiFi client mode, Access Point mode or BT.
Configuration modes using systemd
Client mode
In this mode, a WILC device would behave as a WiFi client by connecting to an Access Point device and requesting from it IP addresses, DNS etc.
Step-by-step configuration
To work in this mode, create or edit the /etc/wpa_supplicant.conf file. The content of file should be as follows:
ctrl_interface=/var/run/wpa_supplicant
update_config=1
network={
ssid="access-point-name"
psk="access-point-password"
}
Where the SSID and PSK variables keep the access point name and password, the WILC device will be connected. Save the file.
Stop the hostapd service using the following command (if it is already running ):
systemctl stop hostapd@<Configured authentication mode>
where Configured authentication mode might be any one of open, wpa or wep.
Replace network configurations from existing examples in rootfs and start the WPA supplicant service using the following commands:
For Buildroot:
cp /usr/lib/systemd/system/wpa_supplicant.service.example /etc/systemd/system/wpa_supplicant.service cp /usr/lib/systemd/network/80-wifi-station.network.example /etc/systemd/network/wlan0.network systemctl restart wpa_supplicant.service
For Yocto Project:
cp /lib/systemd/network/80-wifi-station.network.example /etc/systemd/network/wlan0.network systemctl restart wpa_supplicant.service
Reload the network configuration using the following command:
networkctl reload
At this point, an IP address should be assigned to the WLAN interface, and IP connectivity should be active.
Pre-defined script
Starting with the Linux4SAM-2020.04 release, for boards where WILC devices are soldered, the Buildroot root file system provides a demo script that allows configuring WILC devices in STA mode by running just one command. To do this, run the following script:
/root/Start_STA.sh
Note: Starting with the Linux4SAM-2024.04 release, the Yocto Project also includes the predefined scripts in root filesystem.
Provisioning mode
Starting with the Linux4SAM-2020.04 release for boards where WILC devices are soldered, the Buildroot root file system provides a provisioning mechanism that allows the configuration of WILC devices in STA mode.
To start provisioning, execute the script /root/Start_Provision.sh:
/root/Start_Provision.sh
This will reboot the board. After reboot, the WILC device will enter SoftAP mode with name wilc_SoftAP and IP 192.168.0.1. This allow connecting to the WILC device using any Wi-Fi device for provisioning. Connecting to 192.168.0.1 will allow the configuration for Access Point to connect to. The meaning of fields in the opened web page are as follows:
Network Name: The Access Point name that WILC in STA mode should connect to Pass phrase: The Access Point password Device Name: The name of the WILC device
After filling in the above fields and pressing the Connect button, the board will reboot, and the WILC device will start in STA mode and connect to the configured access point.
Access Point mode
WILC device could work in Access Point mode in different configurations depending on the level of security. This could be Open, WEP, or WPA, where the default access point names for Yocto Project would be wilc_OpenAP (No Password), wilc_WepAP (Password = 1234567890) and wilc_WpaAP (Password = 12345678) respectively.
To configure custom ssid names and passphrases, one can edit hostapd configuration files available in the /etc/* directory, where the configuration file could be one of the following:
/etc/wilc_hostapd_open.conf /etc/wilc_hostapd_wep.conf /etc/wilc_hostapd_wpa.conf
Note: Starting with the Linux4SAM-2024.04 release, both Buildroot and the Yocto Project root filesystem include the required hostapd configuration files in the /etc/* directory itself.
Stop the wpa_supplicant service using the following command( if it is already running):
systemctl stop wpa_supplicant.service
Replace network configurations from existing examples in rootfs and reload network configurations using the following commands:
For Buildroot:
cp /usr/lib/systemd/system/hostapd@.service.example /etc/systemd/system/hostapd@.service cp /usr/lib/systemd/network/80-wifi-softap.network.example /etc/systemd/network/wlan0.network networkctl reload
For Yocto Project:
cp /lib/systemd/network/80-wifi-softap.network.example /etc/systemd/network/wlan0.network networkctl reload
Bring up the wlan0 interface using the following command:
networkctl up wlan0
Start Access Point
To start WILC working in Access Point:
Start the hostapd service with any one of the following commands, depending on authentication:
systemctl start hostapd@open.service
or
systemctl start hostapd@wpa.service
or
systemctl start hostapd@wep.service
This will start the WILC device in the corresponding access point mode.Connect from an WiFi client to the newly created access point and try a ping.
To switch between different authentication modes in run time, make sure the current hostapd service stopped properly using systemctl stop command and wilc-sdio module need to be reloaded using insmod or modprobe command.
Note: Default build support for WEP Authentication was removed from the hostapd 2.10 version, so this test will fail by default. (CONFIG_WEP=y can be used to enable it if needed).
Configuration modes using SysVinit
Client mode
In this mode, a WILC device would behave as a WiFi client by connecting to an Access Point device and requesting from it IP addresses, DNS, etc.
Step by step configuration
To work in this mode, create or edit the /etc/wpa_supplicant.conf file. The content of file should be as follows:
ctrl_interface=/var/run/wpa_supplicant
update_config=1
network={
ssid="access-point-name"
psk="access-point-password"
}
Where the SSID and PSK variables keep the access point name and password, the WILC device will be connected. Save the file.
Start the WPA supplicant service using the following command:
wpa_supplicant -B -iwlan0 -Dnl80211 -c /etc/wpa_supplicant.conf &
Initiate a DHCP request so that a proper IP address and DNS settings can be installed for the WILC device:
udhcpc -i wlan0 &
At this point, an IP address should be assigned to the WLAN interface, and IP connectivity should be active.
Access Point mode
WILC device could work in Access Point mode in different configurations depending on the level of security. This could be Open, WEP, WPA.
Open Access Point configuration
For this mode, create or edit the /etc/wilc_hostapd_open.conf file as follows:
interface=wlan0 driver=nl80211 ctrl_interface=/var/run/hostapd ssid=wilc_OpenAP dtim_period=2 beacon_int=100 channel=7 hw_mode=g max_num_sta=8 ap_max_inactivity=300
Where the Access Point name would be wilc_OpenAP.
WEP Access Point configuration
For this mode, create or edit the /etc/wilc_hostapd_wep.conf file as follows:
interface=wlan0 driver=nl80211 ctrl_interface=/var/run/hostapd ssid=wilc_WepAP dtim_period=2 beacon_int=100 channel=7 hw_mode=g max_num_sta=8 ap_max_inactivity=300 ieee80211n=1 auth_algs=1 ######### WEP ########### wep_default_key=0 wep_key0=1234567890 wep_key1="vwxyz" wep_key2=0102030405060708090a0b0c0d wep_key3=".2.4.6.8.0.23" wep_key_len_broadcast=5 wep_key_len_unicast=5 wep_rekey_period=300
Where the access point name would be wilc_WepAP and password =1234567890.
Note: Default build support for WEP Authentication was removed from the hostapd 2.10 version, so this test will fail by default. (CONFIG_WEP=y can be used to enable it if needed).
WPA Access Point configuration
For this mode, create or edit the /etc/wilc_hostapd_wpa.conf file as follows:
interface=wlan0 driver=nl80211 ctrl_interface=/var/run/hostapd ssid=wilc_WpaAP dtim_period=2 beacon_int=100 channel=7 hw_mode=g max_num_sta=8 ap_max_inactivity=300 ieee80211n=1 auth_algs=1 ######### WPA/WPA2 ########### wpa=3 wpa_passphrase=12345678 wpa_key_mgmt=WPA-PSK wpa_pairwise=TKIP CCMP rsn_pairwise=CCMP
Where the Access Point name would be wilc_WpaAP and password would be 12345678.
DHCP server configuration
To enable offering IPs to WiFi clients DHCP server service have to be enabled.
Create or edit* /etc/dhcp/dhcpd.conf with the following content (if the image is based on Buildroot):
option domain-name "tecmint.lan";
option domain-name-servers ns1.tecmint.lan, ns2.tecmint.lan;
default-lease-time 3600;
max-lease-time 7200;
authoritative;
subnet 192.168.1.0 netmask 255.255.255.0 {
option routers 192.168.1.1;
option subnet-mask 255.255.255.0;
option domain-search "tecmint.lan";
option domain-name-servers 192.168.1.1;
range 192.168.1.10 192.168.1.100;
range 192.168.1.110 192.168.1.200;
}
If the image is based on the Yocto Project, Create or edit* /etc/kea/kea-dhcp4.conf with the contents below:
{
"Dhcp4": {
"interfaces-config": {
"interfaces": ["wlan0"]
},
"subnet4": [
{
"subnet": "192.168.1.0/24",
"pools": [
{ "pool": "192.168.1.100 - 192.168.1.200" }
],
"option-data": [
{ "code": 3, "data": "192.168.1.1" },
{ "code": 6, "data": "192.168.1.1, 8.8.8.8" }
]
}
]
}
}
Start Access Point
To start WILC working in Access Point: 1. Start hostapd service with file configured above:
hostapd -B <configuration file>
where the configuration file could be one of the following:
/etc/wilc_hostapd_open.conf /etc/wilc_hostapd_wep.conf /etc/wilc_hostapd_wpa.conf
2. Configure an IP address for the wlan0 interface:
ifconfig wlan0 192.168.1.1 netmask 255.255.255.0 up
3. Start DHCP server:
For Buildroot:
dhcpd -cf /etc/dhcp/dhcpd.conf
For Yocto Project:
keactrl start
This will start WILC device in Open Access Point mode.
4. Connect from an WiFi client to newly created access point and try a ping.
Bluetooth mode
To be able to use WILC device in Bluetooth mode on devices where WILC device is not soldered to the board, user has to wire WILC BT serial with one of the serials supported by SoC. The table below specifies what serial pins could be used on SAM boards. On boards where WILC device is soldered, there is no need for extra wires and the table specifies NA in connector and connector pins columns.
| |||||||||||||||||||||||||||||||||||||
Step-by-step configuration
Insert the next commands to configure WILC device in Bluetooth mode:
echo BT_SDIO_INIT > /dev/wilc_bt echo BT_POWER_UP > /dev/wilc_bt echo BT_FW_CHIP_WAKEUP > /dev/wilc_bt echo BT_DOWNLOAD_FW > /dev/wilc_bt echo BT_FW_CHIP_ALLOW_SLEEP > /dev/wilc_bt hciattach <bluetooth-serial> any 115200 noflow # see table at the beginning of this chapter hciconfig hci0 up ln -svf /usr/libexec/bluetooth/bluetoothd /usr/sbin bluetoothd -p time -n &
If the last command returns a D-Bus error, check if the bluetooth daemon is already started. If yes, kill it and retry the last command:
kill bluetoothd bluetoothd -p time -n &
Check bluetooth interface status:
hciconfig -a
Enable LE activity:
hciconfig hci0 leadv
Try to scan and connect to a device.
bluetoothctl scan on connect <identifier-listed-by-scan>
If scan fails, run the following command:
power on
Pre-defined script
Starting with Linux4SAM-2020.04 release for boards where WILC device are soldered, Buildroot root file system provides a demo script that allows configuring WILC device in Bluethoot mode by running just one command. To do this, run the following script:
/root/Start_BT.sh
This will start WILC device in Bluetooth mode.
References
The above documentation is inspired from documentation already present on Microchip WILC3000 webpage, more precisely the ATWILC1000/ATWILC 3000 Wi-Fi Link Controller Linux User Guide.
Related Topics
Boards
Sam9x60Curiosity
Sama7g5-ek
Sama5d2icp
Sam9x60EK
Sama5d27WLSom1EK
Components
Summary
How to use WILC3000 on SAM development boards