Difference between revisions of "DWM ADD-ON/DWM Hardware/Integration guide"

From DAVE Developer's Wiki
Jump to: navigation, search
(Created page with "{{subst:Hardware versioning|nome-som=DWM}}")
 
Line 7: Line 7:
 
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
 
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
 
|-
 
|-
|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"|X.Y.Z
+
|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
|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"|Month Year
+
|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 2020
|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"|TBD
+
|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"|[TBD_link X.Y.Z]
 
|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"|Month Year
 
|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"|TBD
 
|-
 
|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"|...
 
|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"|...
 
|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"|...
 
 
|-
 
|-
 
|}
 
|}
Line 25: Line 16:
 
<section begin=Body/>
 
<section begin=Body/>
  
''TBD: aggiungere le 2 foto TOP e BOTTOM con il CS e il serial number''
+
==Integration guide==
 +
This section provides useful information and resources that let the system designer integrate the DWM module in the application very quickly.
 +
 
 +
=== Typical scenario===
 +
 
 +
The following picture shows the conceptual block diagram of the application where the host is an Embedded PC.
  
== Hardware versioning and tracking==
+
[[File:Dwm-epc-scenario.png|thumb|center|400px|Typical scenario]]
 +
[[File:AXEL_Lite-EVB-DWM-connector.png|thumb|center|400px|Real case scenario on AXEL Lite SOM Evaluation Kit|link=AXEL Lite SOM/AXEL Lite Evaluation Kit]]
  
DWM SOM implements well established versioning and tracking mechanisms:
+
===Electrical guidelines===
 +
*Keep SDIO lines as short as possible.
 +
*5V and 3.3V rails can power up in any order
 +
*Keep WIFI_EN asserted during power-up sequence
  
* PCB version is copper printed on PCB itself, as shown in Fig. 1
+
===Calibration process===
* serial number: it is printed on a white label, as shown in Fig. 2: see also [[Product_serial_number | Product serial number]] page for more details
+
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].
* ConfigID: it is used by software running on the board for the identification of the product model/hardware configuration. For more details, please refer to [[ConfigID_and_UniqueID | this link]]
 
** (''TBD: definire/identificare dove è memorizzato il CONFIGID nel prodotto in questione'') On DWM SOM ConfigID is stored in these areas of OTP
 
  
 +
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
 +
*the firmware version downloaded to the chip
 +
*the initialization data, typically stored in an INI file.
  
[[File:DWM-bottom.png|thumb|300px|center|Fig.1 PCB version]]
+
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)]]
  
 +
=== References ===
 +
* [http://processors.wiki.ti.com/index.php/WL127x WL127x Main page]
 +
* [http://processors.wiki.ti.com/index.php/WL127x_WLAN_API_Information WL127x WLAN API]
 +
* [http://processors.wiki.ti.com/index.php/WL12xx_NLCP_Calibration_Proccess Calibration Process]
 +
* [http://www.lsr.com/products-wiki?topic=TiWi-BLE+Downloads TiWi-BLE Downloads]
 +
* [http://www.lsr.com/downloads/products/330-0078.pdf INI Guide]
 +
* [http://www.lsr.com/downloads/products/330-0105.pdf Antenna Design]
 +
* [http://www.lsr.com/downloads/products/330-0053.pdf EMC Guide]
 +
* [http://wireless.kernel.org/en/users/Drivers/wl12xx/calibrator Linux Calibrator]
  
[[File:DWM-top.png|thumb|300px|center|Fig.2 Serial number]]
 
  
  

Revision as of 15:15, 5 November 2020

History
Version Issue Date Notes
1.0.0 Nov 2020 New documentation layout



Integration guide[edit | edit source]

This section provides useful information and resources that let the system designer integrate the DWM module in the application very quickly.

Typical scenario[edit | edit source]

The following picture shows the conceptual block diagram of the application where the host is an Embedded PC.

Typical scenario
Real case scenario on AXEL Lite SOM Evaluation Kit

Electrical guidelines[edit | edit source]

  • Keep SDIO lines as short as possible.
  • 5V and 3.3V rails can power up in any order
  • Keep WIFI_EN asserted during power-up sequence

Calibration process[edit | edit source]

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 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
  • the firmware version downloaded to the chip
  • the initialization data, typically stored in an INI file.

The following links refer to specific use cases, where the resulting NVS file is provided along with DAVE Embedded Systems products integrating DWM module.

References[edit | edit source]