diff --git a/README.md b/README.md index b94c2c8..c8961a5 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ **openwifi:** Linux mac80211 compatible full-stack IEEE802.11/Wi-Fi design based on SDR (Software Defined Radio). -This repository includes Linux driver and software. [openwifi-hw](https://github.com/open-sdr/openwifi-hw) repository has the FPGA design. [[Project document](https://github.com/open-sdr/openwifi/tree/master/doc)] +This repository includes Linux driver and software. [openwifi-hw](https://github.com/open-sdr/openwifi-hw) repository has the FPGA design. [[Quick start](#Quick-start)], [[Project document](https://github.com/open-sdr/openwifi/tree/master/doc)], [[Application notes](doc/app_notes/README.md)] [[Videos](#Videos)] [[Papers](#Papers)] [openwifi [maillist](https://lists.ugent.be/wws/subscribe/openwifi)] [[Cite openwifi project](#Cite-openwifi-project)] @@ -54,6 +54,8 @@ zcu102_9371|Xilinx ZCU102 dev board + ADRV9371|Future|None [[Build openwifi Linux img from scratch](#Build-openwifi-Linux-img-from-scratch)] [[Special note for 11b](#Special-note-for-11b)] [[Porting guide](#Porting-guide)] +[[Project document](https://github.com/open-sdr/openwifi/tree/master/doc)] +[[Application notes](doc/app_notes/README.md)] ## Quick start - Burn openwifi board specific img file (from the table) into a SD card ("Open With Disk Image Writer". Or "dd" command after unzip). The SD card has two partitions: BOOT and rootfs. You need to config the **correct files in the BOOT partition** according to the **board you have** by operation on your computer: diff --git a/doc/app_notes/ad-hoc-two-sdr.md b/doc/app_notes/ad-hoc-two-sdr.md index 0eedd18..64ebd63 100644 --- a/doc/app_notes/ad-hoc-two-sdr.md +++ b/doc/app_notes/ad-hoc-two-sdr.md @@ -1,2 +1,48 @@ -- To be done. -- Tobe done +- Power on two SDR boards. Call one board "adhoc1" and the other "adhoc2". On each board, the TX and RX antenna should vertical/orthogonal to each other as much as possible to gain a good TX/RX isolation. +- Connect a computer to the adhoc1 via Ethernet cable. The computer should have static IP 192.168.10.1. Open a terminal on the computer, and then in the terminal: + ``` + ssh root@192.168.10.122 + (password: openwifi) + service network-manager stop + cd openwifi + ./wgd.sh + (Wait for the script completed) + ifconfig sdr0 up + ./sdr-ad-hoc-up.sh sdr0 44 192.168.13.1 + (Above command setup ad-hoc network at channel 44 with static IP assigned to sdr0 NIC) + iwconfig sdr0 + ``` +- You shold see output like: + ``` + sdr0 IEEE 802.11 ESSID:"sdr-ad-hoc" + Mode:Ad-Hoc Frequency:5.22 GHz Cell: 92:CA:14:27:1E:B0 + Tx-Power=20 dBm + Retry short limit:7 RTS thr:off Fragment thr:off + Encryption key:off + Power Management:off + ``` + If you see "Cell: Not-Associated", please wait and run "iwconfig sdr0" again until a randomly generated Cell ID appears. + +- Connect another computer to the adhoc2 via Ethernet cable. The computer should have static IP 192.168.10.1. Open a terminal on the computer, and then in the terminal: + ``` + ssh root@192.168.10.122 + (password: openwifi) + service network-manager stop + cd openwifi + ./wgd.sh + ifconfig sdr0 up + ./sdr-ad-hoc-up.sh sdr0 44 192.168.13.1 + iwconfig sdr0 + ``` +- You shold see output like: + ``` + sdr0 IEEE 802.11 ESSID:"sdr-ad-hoc" + Mode:Ad-Hoc Frequency:5.22 GHz Cell: 92:CA:14:27:1E:B0 + Tx-Power=20 dBm + Retry short limit:7 RTS thr:off Fragment thr:off + Encryption key:off + Power Management:off + ``` + The "Cell: 92:CA:14:27:1E:B0" should be the same as adhoc1, because the later joined node should discover the Cell ID of the existing network and join/get it automatically. If not, please adjust the antenna/distance and re-run the commands. + + Now the communication link should be already setup between the two ad-hoc nodes, and you can ping each other.