Bureaucrats, dave_user, Administrators
8,226
edits
Changes
no edit summary
<section begin="History" />
{| style="border-collapse:collapse; "
!colspan="4" style="width:100%; text-align:left"; border-bottom:solid 2px #ededed"|History
|-
|-
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|1.0.0{{oldid|11485|2020/11/10}}| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |New documentation layout|-| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |{{oldid|12599|2021/01/19}}|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Nov 2020More information about antenna calibration|-! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|New documentation layout2021/02/12! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |Non EU antenna regulator warning
|-
|}
<section end="History" />
__FORCETOC__
<section begin="Body" />
==Integration guide==
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. ==== 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.
==== NVS ready-to-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 antenna [http://www.molex.com/molex/products/datasheet.jsp?part=active/0479500011_ANTENNAS.xml Molex 47950-0011]
Please refer to the below Laird Connectivity TiWi-BLE documentation for more information.
===Tested Antennas===
Following a list of tested and approved antennas:
* Laird technology 001-0001 with UFL to SMA adapter [[File:001-0001.png|thumb|100px|none]] [[File:1300-00041.png|thumb|100px|none]]
* {{ImportantMessage|text=Molex 47950-0011 valid only for '''No EU''' countries - see [https://www.lairdconnect.com/documentation/regulatory-information-tiwi-ble link][[File:4795.png|thumb|100px|none]]}}
=== References ===
* [httphttps://processors.wikiwww.tilairdconnect.com/index.phpwireless-modules/WL127x WL127x Main page]* [http:wifi-modules-bluetooth//processors.wiki.ti.com/index.php/WL127x_WLAN_API_Information WL127x WLAN APItiwi-ble#documentation Laird Connectivity TiWi-BLE documentation]* [httphttps://processorswww.wiki.tilairdconnect.com/index.php/WL12xx_NLCP_Calibration_Proccess Calibration Process]* [http:documentation//www.lsr.com/productstiwi-wiki?topic=TiWible-BLE+Downloads datasheet TiWi-BLE Downloadsdatasheet]* [httphttps://www.lsrlairdconnect.com/downloadsdocumentation/products/330tiwi-antenna-design-0078.pdf INI guide Antenna Design Guide]* [httphttps://www.lsrlairdconnect.com/downloadsdocumentation/products/330tiwi-emc-compliance-0105.pdf Antenna Designguide EMC Compliance Guide]* [httphttps://www.lsrlairdconnect.com/downloadsdocumentation/products/330wlan-ini-etsi-all-certified-0053.pdf EMC Guideantennas WLAN INI all certified antennas]* [http://wirelesslinuxwireless.kernelsipsolutions.orgnet/en/users/Drivers/wl12xx/calibrator WL127x Linux Calibrator]
----
[[Category:DWM]]