* IDF (3D): httphttps://www.dave.eu/system/files/area-riservata/dwm-3D.zip===Calibration process===The radio interface of the DWM module is configured by several parameters. These parameters are set through a calibration process, that is described in detail [http://processors.wiki.ti.com/index.php/WL12xx_NLCP_Calibration_Process here]. The calibration process—that produces an NVS file—is not trivial. Apart from the chip itself (Texas Instruments WL1271L in this case), it depends on:*the antenna - a list of [https://www.lairdconnect.com/wireless-modules/wifi-modules-bluetooth/tiwi-ble#certified-antennas certified antennas] and cables can be found in the TiWi Module device datasheet. Use of these antennas does not require additional FCC/IC/ETSI certifications.*the firmware version downloaded to the chip: please refer to the proper firmware available on your Linux distribution for matching the kernel driver and run properly the calibration process*the initialization data, typically stored in an INI file: please refer to the [https://www.lairdconnect.com/wireless-modules/wifi-modules-bluetooth/tiwi-ble#documentation Laird Connectivity TiWi documentation] for checking the proper INI file configuration*the Calibrator source code [https://github.com/TI-OpenLink/ti-utils/tree/ol_R5.SP8.01 here]More information about kernel driver and calibration on the [https://www.lairdconnect.com/forum/tiwi-ble/online-documentation/support-and-tools Laird Support and Tools] web page.
===Qualification tests=MAC address ====The MAC address is set at calibration time for WLAN. To use the built in MAC address for WLAN be sure to pass a MAC address of <code>00:00:00:00:00:00</code> as a parameter to the auto-calibrate function. To set a custom MAC address for WLAN just pass the desired value into the auto-calibrate function.
==How == NVS ready-to enable WiFi support on embedded linux platforms-use calibration files ====The following links refer to specific use cases, where the resulting NVS file is provided along with DAVE Embedded Systems products integrating DWM module.*[[XUELK-AN-001:_Using_WiFi-Bluetooth_combo_plugin_with_SBC_Lynx|SBC Lynx (XUELK)]]*[[XUELK-AN-002:_Running_Debian_distribution#Bluetooth_and_WiFi|SBC Lynx (Debian)]]The <code>nvs.bin</code> file has been created using the certified antenna [http://www.molex.com/molex/products/datasheet.jsp?part=active/0479500011_ANTENNAS.xml Molex 47950-0011]
=== References ===Please refer to the below Laird Connectivity TiWi-BLE documentation for more information.
* [http://wireless.kernel.org/en/users/Drivers/wl12xx/calibrator Linux Calibrator]
=== Kernel setup ===
Edit kernel configuration adding support for MMC and WL1271L chipset. If needed, please '''apply the patches''' to enable support for DWM on the platform in use.
=== Make Wireless Tools ===
If the Wirleless Tools package is not included into your root file system, you need to build this component. Modification of the Makefile is required in order to cross-compile and install the tools:
* Check that the root file system path is correct
* Check the env CROSS_COMPILE and PATH variables
* make all
* sudo make install
Please note that this tools are included in some Linux Embedded distributions, so you could use the package manager to install them. See for example the [[Running Ubuntu Core]] page to learn how to run an Ubuntu-based root file system, so you can easily add the required tools using the '''apt''' package manager.
=== Module Firmware ===
Download the firmware binaries and copy them into <RFS>/lib/firmware:
* wl1271-fw.bin
=== Calibration ===
Calibration is a process of determining radio parameters specific for the chip on the specific design. Calibration is a mandatory one-time procedure, performed once after the board assembly and before any WLAN operation.
==== Prerequisites ====
* wifi kernel driver
* wifi device firmware
* wifi tools available into the root file system
* Linux kernel build with '''CONFIG_NL80211_TESTMODE=y''' option and WL12xx build as a module
* INI file downloaded from LSR website: [http://www.lsr.com/products-wiki?topic=TiWi-BLE+Downloads] (930-0056 - ETSI All certified antennas)
* The NVS file (wl127x-nvs.bin) must not be included into the root file system
N.B: When compiling the calibrator tool for an Ubuntu Core root file system (Ubuntu 12.04 LTS ARM HF), the following packages are required:
* libnl-3-dev
* libnl-gen1-3-dev
If the libnl-3 headers are not included into /usr/include/libnl-3, it is possible to download and uncompress the following deb file:
For detailed information, please refer to the [http://processors.wiki.ti.com/index.php/WL12xx_NLCP_Calibration_Proccess#Calibration_Getting_Started Calibration Getting Started Guide].
For the calibration commands, please refer to the following shell session: