pof2 / ti-utils Goto Github PK
View Code? Open in Web Editor NEWThis project forked from idor/ti-utils
The calibrator and other useful utilities for TI wireless solution based on wl12xx driver
License: Other
This project forked from idor/ti-utils
The calibrator and other useful utilities for TI wireless solution based on wl12xx driver
License: Other
The calibrator and other useful utilities for TI wireless solution, based on wl12xx driver. Calibration is a process in which specific radio configuration parameters are generated and saved into the NVS file, later to be used by the wl12xx driver upon initialization. These configuration parameters are specific to the chip on the specific design and therefore are sent back to the driver to store in non-volatile memory for later use. Upon initialization, the wl12xx driver will load an NVS file where it expects to read those parameters and send them to the chip. The NVS file contains 2 main parts - one stores the calibration parameters and the other one stores initialization information required for the wl12xx driver. --- Build procedure Kernel configuration. Make sure your kernel is configured to support nl80211 testmode commands (NL80211_TESTMODE=y). Also enable following configurations: CRC7=m FW_LOADER=m In userspace there is dependent on libnl v2.x package. It can be downloaded from http://www.infradead.org/~tgr/libnl/files/libnl-2.0.tar.gz Set follow environment variables: export NFSROOT=<path to roofs of a target where installed libnl library> export CROSS_COMPILE=arm-none-linux-gnueabi- make make install Make sure that calibrator utility and wl12xx-tool.sh script placed at the same dir. --- How to calibrate Native Linux calibration procedure. ./wl12xx-tool.sh -c <path to INI file> [<path to firmware directory>] Android calibration procedure. Based on adb utility which comes native with Android SDK adb shell "echo Going to stop GUI" adb shell "stop" adb shell "echo Create reference NVS" adb shell "calibrator set ref_nvs /data/TQS_D_1.7.ini" adb shell "echo Copy reference NVS file" adb shell "cat ./new-nvs.bin > /system/etc/firmware/ti-connectivity/wl1271-nvs.bin" adb shell "echo Insert wl12xx SDIO module" adb shell "insmod /system/lib/modules/wl12xx_sdio.ko" adb shell "echo Calibrate device" adb shell "calibrator wlan0 plt power_mode on" adb shell "calibrator wlan0 plt tune_channel 0 7" adb shell "calibrator wlan0 plt tx_bip 1 1 1 1 1 1 1 1" adb shell "calibrator wlan0 plt power_mode off" adb shell "echo Set MAC address in NVS file" adb shell "calibrator set nvs_mac ./new-nvs.bin 08:00:28:90:64:31" adb shell "echo Remove wl12xx modules" adb shell "rmmod wl12xx_sdio wl12xx" adb shell "rmmod wl12xx" adb shell "echo Copy calibrated NVS file" adb shell "cat ./new-nvs.bin > /system/etc/firmware/ti-connectivity/wl1271-nvs.bin" adb shell "insmod /system/lib/modules/wl12xx.ko" adb shell "echo Going to start GUI" adb shell "start" --- How to calibrate with AutoFEM The wl12xx driver has ability to use it's NVS file with radio parameters for 2 different frontend modules. The driver requires firmware at boot time which FEM parameters it needs and provides radio parameters according to answer. There is also scenario when driver decides which radio parameters to give to firmware. In such case, 2 parameters should be set. The autofem should be 0 and fem_manuf should be 0 or 1, depends on FEM manufacturer. In order to prepare NVS file with radio parameters for 2 FEMs, do follows ./wl12xx-tool.sh -c2 <path to INI file> [<path to INI file>] There is option to use the feature manualy. In such case, there is need to set AutoFEM flag to 0 and explicitly set fem_manuf flag. ./calibrator set autofem <0-manual|1-auto> [<nvs file>] ./calibrator set fem_manuf <0|1> [<nvs file>] --- How to choose INI file It is very important to select INI file according to the firmware (see below). Those files organized in 3 directories: station - currently supported station firmware (wl1271-fw.bin) access_point - currently supported access point (wl1271-fw-ap.bin) For Beagle board and Panda board use ini_files/station/127x/TQS_S_2.6.ini For Blaze board with ES2.1 or ES2.1 use ini_files/station/128x/TQS_D_1.7.ini --- How to change MAC address in calibrated NVS ./calibrator set nvs_mac <nvs file> [<mac addr xx:xx:xx:xx:xx:xx>] If the MAC address missing, the random valid value will be added. --- How to dump NVS file calibrator get dump_nvs [<nvs filename>] --- Firmware files The firmware files can be reached from git repository git://git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git under directory ti-connectivity. There are 2 firmware files there: wl1271-fw.bin - station firmware wl1271-fw-ap.bin - access point firmware --- Detailed instructions for calibrator procedures The following detailed instructions are collection of commands done by default calibration procedure. TxBip procedure (calibration) It is important to set MAC address to an interface before the procedure. For example, `ifconfig wlan0 hw ether xx:xx:xx:xx:xx:xx' There are 2 ways to do it - short where all parameters has default values and full where you have to set all parameters manually. Short way: calibrator plt calibrate Full way: calibrator wlan0 plt power_mode on calibrator wlan0 plt tx_bip <0|1> <0|1> <0|1> <0|1> <0|1> <0|1> <0|1> <0|1> calibrator wlan0 plt power_mode off Result of this procedure is new NVS file created locally ./new-nvs.bin In order to use it, copy the file to /lib/firmware/wl1271-nvs.bin and reload. TxCont procedure calibrator wlan0 plt power_mode on calibrator wlan0 plt tune_channel <band> <channel> calibrator wlan0 plt tx_cont <delay> <rate> <size> <amount> <power> <seed> <pkt mode> <DC on/off> <gi> <preamble> <type> <scramble> <clpc> <seq nbr mode> <dest mac> calibrator wlan0 plt tx_stop calibrator wlan0 plt power_mode off Description: This test sends packets of data directly to air. It receives several parameters as described bellow, to enable diversity of operational modes. It is mostly used to see Energy and radio impact on Air. Content of Packet can be Random, or Zero, One, Zero, one... Packets send are configurable with following parameters: Delay between packets in microseconds Rate 1 Mbps - 0x00000001 MCS_0 - 0x00002000 2 Mbps - 0x00000002 MCS_1 - 0x00004000 5.5 Mbps - 0x00000004 MCS_2 - 0x00008000 6 Mbps - 0x00000008 MCS_3 - 0x00010000 9 Mbps - 0x00000010 MCS_4 - 0x00020000 11 Mbps - 0x00000020 MCS_5 - 0x00040000 12 Mbps - 0x00000040 MCS_6 - 0x00080000 18 Mbps - 0x00000080 MCS_7 - 0x00100000 24 Mbps - 0x00000200 36 Mbps - 0x00000400 48 Mbps - 0x00000800 54 Mbps - 0x00001000 Size of data field in MPDU (in bytes, 0 - 2284) Amount - number of packets in case of using series mode Power - output power in dBm*1000 Seed - value for the scrambler Packet mode - 0-single, 1-multipile, 3-continuous, 4-FCC DC on/off - activate DCF gi - guard interval on/off for 11n rates Preamble 1 Mbps - long preamble mode=0 2, 5.5, 11 Mbps - long preamble mode=0, short preamble mode=1 6, 9, 12, 18, 24, 36, 48, 54 Mbps - ofdm preamble mode=4 from MCS_0 to MCS_7 - n mixed mode preamble mode=6, greenfield preamble mode=7 Type is 0-data packet, 1-ack, 2-probe req, 3-random data, 4-user data Scrambler - on/off CLPC range 0-100 is disable calibration Sequence number mode (incremented or fixed) Destination Mac address RxStat procedure There are 2 ways to do it - short where all parameters has default values and full where you have to set all parameters manually. Short way: calibrator plt rx_statistics In the short way each time the statistics will be reseted. Full way: calibrator wlan0 plt power_mode on calibrator wlan0 plt start_rx_statcs calibrator wlan0 plt get_rx_statcs calibrator wlan0 plt stop_rx_statcs calibrator wlan0 plt power_mode off While willing to reset the statistic run: calibrator wlan0 plt reset_rx_statcs Update NVS file procedure This is procedure changes ini part of NVS file. It helps when there is need to change ini part of NVS which already calibrated. calibrator set upd_nvs <ini file> [<nvs file>] If NVS filename parameter not provided the current NVS file will be used from destination directory (usually /lib/firmware). --- Miscellaneous procedures Read MAC address from NVS file calibrator get nvs_mac <nvs filename> Push local NVS to the system: calibrator phy <phyname> set push_nvs <nvs filename> Set NVS to use auto FEM detection calibrator set autofem 1 Set FEM manufacturer calibrator set fem_manuf 0|1 Tone transmission testing Get in PLT mode calibrator wlan0 plt power_mode on Run TxTone transmission calibrator wlan0 plt tx_tone <tone type> <power> Tone type 1 - Single tone 2 - Carrier FeedThrough Power [0 - 10000] mdB Stop transmission calibrator wlan0 plt tx_stop Get out from PLT mode calibrator wlan0 plt power_mode off ------------------------------------------------------------------------------- The project can be accessed from git repository: git clone git://github.com/gxk/ti-utils.git Please send all patches to Gery Kahn <[email protected]> and CC [email protected] for community review.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.