Differences

This shows you the differences between two versions of the page.

--- content:meshextender:prototyping_on_mr3020 [10/10/2013 21:39]
Paul Gardner-Stephen
+++ content:meshextender:prototyping_on_mr3020 [27/03/2017 13:55]
Paul Gardner-Stephen [Hardware Assembly]
@@ Line 1: / Line 1: @@
+====== TP-LINK MR3020 prototype ======
 This prototype is heavily based on the previous [[prototyping_on_mp2|TPLINK 703N prototype]], but avoids the need for a USB to serial adapter and USB hub.
-Parts:
+**Do not use the MR3020 for further prototypes. Instead use a GL-AR150, and see the [[content:meshextender:2ng|Mesh Extender 2 prototyping]] page.**
+====== Parts ======
+  * [[http://wiki.openwrt.org/toh/tp-link/tl-mr3020|TP-LINK MR3020 Router]]
+    * 32MB RAM
+    * 4MB FLASH
+    * serial port header
+    * USB port
+    * 802.11N Atheros 9k WiFi
+    * 400MHz MIPs processor
+  * [[http://rfdesign.com.au|RFD900a Radio]]
+  * SanDisk Cruzer Fit(tm) tiny USB memory stick
+====== 3D Printable Case ======
+Thanks to Musti, we now have a 3D printable case for the Mesh Extender:
+{{:content:meshextender:serval-case-mr3020-12.jpg?nolink&200|}}
+Here are the STL files for printing your own Mesh Extender case:
+{{:content:meshextender:stl.tgz|}}
+Images and related details for these cases:
+{{:content:meshextender:images.tgz|}}
+{{:content:meshextender:photos.tgz|}}
+{{:content:meshextender:servalcase-mr3020-documentation.pdf|}}
+====== Hardware Assembly ======
+  - Remove lid by following the instructions at http://wiki.openwrt.org/toh/tp-link/tl-mr3020#opening.the.case
+  - Remove the PCB
+  - Drill two holes on the top edge of the case to accomodate the RFD900 radio (6.5mm holes 20mm apart, centred approximately 9mm in from the top edge and the first hole starting approximately 20mm in from the left edge.  I will supply a photo that makes this clearer).
+  - If you have obtained a normal RFD900, desolder the 16pin header.  Ask RFDesign if they can supply it without the header installed in the first place, as it saves a bit of effort. They may or may not be able to depending on where they are in their manufacturing cycle, but the more people ask, the more they are likely to stock them this way.
+  - Solder a 4-pin ribbon cable between the MR3020 PCB and RFD900 radio connecting 5v, GND, TX and RX lines appropriately.  See photo for pictorial explanation.
+** NOTE: This pinout is wrong. There is no 5V on that header. You need to source it from elsewhere, and there is no really good place. This is one reason we stopped using the MR3020 for prototyping.  If you feed the RFD900 with 3.3v it will seem to work, but your range will be only 1/20th of what it should be. **
+{{:20131011_145936.jpg?1024|}}
+** NOTE: This pinout is wrong. There is no 5V on that header. You need to source it from elsewhere, and there is no really good place. This is one reason we stopped using the MR3020 for prototyping.  If you feed the RFD900 with 3.3v it will seem to work, but your range will be only 1/20th of what it should be. **
+====== Firmware Installation (the new way) ======
+Perform the following steps on a Linux box, but first ...
+===== SYSADMIN GENERAL'S WARNING =====
+Because of the inherent risk of human error when instructing the scripts to format and repartition memory sticks, we recommend that you use an old laptop or similar, and dedicate it to this process, so that you do not endanger your data.
+===== MR3020 Instructions =====
+  - Make sure you have git, csh and expect installed
+Depending on your Linux distribution, something like the following should suffice:
+<code>
+$ sudo yum install csh expect git
+</code>
+Alternatively you may need to use
+<code>
+$ sudo apt-get install csh expect git
+</code>
+  - Download the Mesh Extender Builder software
+<code>
+$ git clone --quiet https://github.com/servalproject/mesh-extender-builder.git
+</code>
+  - Build the OpenWRT image (this will download a lot of stuff the first time you run it, but you can re-run it quickly there after if you change something).
+<code>
+$ cd mesh-extender-builder
+$ ./make_image
+</code>
+  - Build the serval.up file
+<code>
+$ ./gather-image-files
+</code>
+  - Insert the USB memory stick into the installation computer, noting its device name(can be found by typing "df" into the console), then unmount all the device partitions, then partition it using the following script, replacing deviceid with the Linux disk device, e.g., sdf.  MAKE SURE YOU GIVE IT THE RIGHT DEVICE OR IT MIGHT TRY TO REPARTITION YOUR HARD DRIVE!
+<code>
+$ umount /dev/deviceid
+$ ./partition-memory-stick.sh deviceid
+</code>
+  - Remove and reinsert the USB memory stick so that the kernel notices the new partition table.
+  - Unmount the USB partitons again
+  - Populate the USB memory stick, again replacing deviceid with the right device, e.g., sdf. MAKE SURE YOU GIVE IT THE RIGHT DEVICE OR IT MIGHT ERASE THE PARTITIONS ON YOUR HARD DRIVE!
+<code>
+$ ./populate-memory-stick deviceid
+</code>
+  - Unplug the USB memory stick and insert it into the MR3020 that is to become a mesh extender.
+  - Power up the MR3020, and connect it via ethernet to the installation machine, and wait a couple of minutes for it to boot up.
+  - If the MR3020 is still running the stock firmware, flash it this way:
+<code>
+$ ./flash-virgin-mr3020
+</code>
+You may need to specify the IP address on the command line if the script doesn't auto-detect the IP address. The most likely address is 192.168.0.254
+  - If the MR3020 already has OpenWRT, flash it this way.  (You might need to boot the Mesh Extender into fail-safe mode first.)
+<code>
+$ ./reflash-mesh-extender
+</code>
+You may need to specify the IP address on the command line if the script doesn't auto-detect the IP address. The most likely address is 192.168.1.1 or 192.168.2.1, e.g.:
+<code>
+$ ./reflash-mesh-extender 192.168.2.1
+</code>
+The MR3020 should reboot as a fully functional Mesh Extender.
+===== Configuration=====
+==== SSH access ====
+First thing to make sure of is that the noroot  file has been deleted on the USB stick. Once this has been done use
+<code>
+$ ssh root@192.168.2.1
+</code>
+ If this works you should be greeted by a splash screen showing serval version and some other details.\
+From this you can check if the serval node is functioning properly by using
+<code>
+root@192.168.2.1 $ servald status
+</code>
+this will return either a few lines saying the status and should contain a line saying whether it is running or it will return a message saying servald is not found. If the latter is what is displayed delete noroot and reboot the mesh node with
+<code>
+$ rm /dos/noroot
+$ reboot
+</code>
+The serval node should reboot and work once it has rebooted.
+====Changing name of the device====
+This is useful as it allows you to identify specific nodes if a few different ones are within range of each other rather than using sid or the phone number.
+<code>
+servald keyring set did `servald id self | tail -1` "Phone number" "Name"
+</code>
+This line allows the user to set the phone number and the name of the device for easy identification.
+====Disabling noroot lockout====
+WARNING! THIS CAN ALLOW ANYONE ROOT ACCESS IF NECESSARY PRECAUTIONS AREN'T TAKEN WHICH MIGHT INCLUDE CHANGING THE ROOT PASSWORD.
+ssh into the node using the above method. Once you have access use the following to navigate to the folder which contains the script that produces the noroot file.Then open the script in Vi
+<code>
+$ cd /etc/init.d
+$vi dropbear
+</code>
+Find the two lines in this script that are as follows
+<code>
+passwd -l root # lock
+[ -e /dos/noroot ] && return 1
+</code>
+and comment them out by adding a # to the front as follows
+<code>
+# passwd -l root # lock
+# [ -e /dos/noroot ] && return 1
+</code>
+Once this has been done you will have root access at all times without having to delete noroot However it is a good idea to change the root password after doing this to discourage unauthorized access. this is achieved by using
+<code>
+$ passwd
+</code>
+===== Enabling SSH on a Mesh Extender =====
+Remember if you wish to ssh to the Mesh Extender to power it down, remove the USB memory stick and insert it into any computer, and delete the NOROOT file from the FAT file system partition, and reinsert it into the Mesh Extender.  ssh as root with password root will now be available until next reboot.
+=====Troubleshooting====
+====Sysupgrade not found====
+This means that the openwrt currently on the router cannot find the sysupgrade file
+  - Download the sysupgrade image for the router you are flashing from this list [[http://downloads.openwrt.org/attitude_adjustment/12.09/ar71xx/generic/]]
+  - navigate to the folder where the image is located
+  - use the following to get the image onto the routers RAM
+<code>
+$ scp openwrt-ar71xx-generic-tl-mr3020-v1-squashfs-sysupgrade.bin root@192.168.1.1:/tmp
+</code
+  - ssh into the router then use the following command to flash the sysupgrade image
+<code>
+# sysupgrade -v /tmp/openwrt-ar71xx-generic-tl-mr3020-v1-squashfs-
+sysupgrade.bin
+</code>
+  - Follow the serval instructions for your device to reflash serval to the device
-  * TP-LINK MR3020 Router (32MB RAM, 4MB FLASH, serial port header, USB port, 802.11N Atheros 9k WiFi, 400MHz MIPs processor).
+====Cannot ssh into the device====
-  * RFD900a Radio (see http://rfdesign.com.au).
+There can be a few diffferent causes for this issue.
-  * SanDisk Cruzer Fit(tm) tiny USB memory stick.
+===Telnet===
+This occurs when a root password hasn't been set on the device
+  - Telnet into the device
+  - set the root password
+<code>
+$ telnet 192.168.1.1
+# passwd
+</code>
+  - after this reboot the device and check if the ssh is working if not try the failsafe route
-Hardware Assembly:
+===Failsafe===
-  * Remove lid by following the instructions at http://wiki.openwrt.org/toh/tp-link/tl-mr3020#opening.the.case
+  - change your computer from DHCP to static ip with an address of 192.168.1.2 and subnet 255.255.255.0
-  * Remove the PCB
+  - boot your router into failsafe mode e.g. TP-Link models can be booted into failsafe by holding the reset button once the light starts blinking on boot
-  * Drill two holes on the top edge of the case to accomodate the RFD900 radio (6.5mm holes 20mm apart, centred approximately 9mm in from the top edge and the first hole starting approximately 20mm in from the left edge.  I will supply a photo that makes this clearer).
+  - telnet into the router
-  * If you have obtained a normal RFD900, desolder the 16pin header.  Ask RFDesign if they can supply it without the header installed in the first place, as it saves a bit of effort. They may or may not be able to depending on where they are in their manufacturing cycle, but the more people ask, the more they are likely to stock them this way.
+<code>
-  * Solder a 4-pin ribbon cable between the MR3020 PCB and RFD900 radio connecting 5v, GND, TX and RX lines appropriately.  See photo for pictorial explanation.
+$ telnet 192.168.1.1
+</code>
+  - mount the JFSS2 partition to allow you to edit the password or other files that could be causing the issues with
+<code>
+# mount_root
+</code>
+  - set the passwd if you forgot your password
+<code>
+# passwd
+</code>
+  - Reset the router to stock openwrt if issue is not password related by using
+<code>
+# firstboot
+</code>
+  - Once this is done reboot the router into normal mode using
+<code>
+# reboot -f
+</code>
-{{:20131011_145936.jpg?nolink&200|}}
+After this you will need to change your network settings back to dhcp to connect to the router through telnet/ssh
+====== Firmware Installation (the old way) ======
+  - [[[building_on_openwrt|Build an OpenWRT firmware image]]
+  - Download mesh extender firmware installation tools from https://github.com/gardners/mesh-extender (once only):<code>
+$ cd ~/src
+$ git clone --quiet https://github.com/servalproject/mesh-extender.git
+$ cd mesh-extender
+$ ls -a
+.  ..  .git  mr3020
+$
+</code>
+  - Partition the USB memory stick in any computer to have exactly three partitions of any size (this is to work around a bug when running fdisk on OpenWRT and creating partitions, where it doesn't create the /dev/ entries until after reinsert or reboot).
+  - Plug the MR3020 into the Ethernet jack on your workstation and activate the Ethernet port:
+    * the MR3020 is a DHCP server, so your workstation's Ethernet port must be configured to obtain an IP using DHCP
+    * if the MR3020 assigns your workstation an IP in the subnet 192.168.1, then this is a **virgin install** (the TP-LINK MR3020 is still running its factory firmware)
+    * if the MR3020 assigns your workstation an IP in the subnet 192.168.2, then the Mesh Extender firmware has **already been installed**
+  - Continuing in the same command line as above:<code>
+$ cd mr3020
+$ ./0.install-openwrt
+...
+$
+</code>
+  - Wait for the MR3020 to reboot, then:<code>
+$ ./1.upgrade_openwrt 192.168.1.1
+...
+$
+</code>
+  - Wait for the MR3020 to reboot again, then:<code>
+$ ./2.install_mesh_extender 192.168.1.1
+...
+$
+</code>
+  - Wait for router to reboot for a third time
+  - Kill the runservald process and run servald stop to stop all servald processes.
+  - Run export TERM=xterm ; minicom -s and use minicom to configure to use /dev/ttyATH0 @ 57600, no hardware or software flow-control. Then use +++ to connect to radio and make sure it is happy. Adjust channels, frequencies, bit rates as required. More on this later.  Required once only.  We also hope to make this step redundant by making servald do this.
-Software Installation:
+You should now have a working Mesh Extender.
-  * Download mesh extender software installation tools from http://github.com/servalproject/mesh-extender (once only)
-  * Partition the USB memory stick in any computer to have exactly three partitions of any size (this is to work around a bug when running fdisk on OpenWRT and creating partitions, where it doesn't create the /dev/ entries until after reinsert or reboot).
-  * Plug virgin MR3020 into ethernet jack on computer.
-  * cd mr3020
-  * ./0.install-openwrt
-  * Wait for router to reboot
-  * ./1.upgrade_openwrt 192.168.1.1
-  * Wait for router to reboot
-  * ./2.install_mesh_extender 192.168.1.1
-  * Wait for router to reboot
-  * Kill the runservald process and run servald stop to stop all servald processes.
-  * Run export TERM=xterm ; minicom -s and use minicom to configure to use /dev/ttyATH0 @ 57600, no hardware or software flow-control. Then use +++ to connect to radio and make sure it is happy. Adjust channels, frequencies, bit rates as required. More on this later.  Required once only.  We also hope to make this step redundant by making servald do this.
-  * You should now have a working mesh extender.
 We intend to refine and simplify this process further to make it easier for you to build your own mesh extenders. Of course you will need a pair to use them productively.

The Serval Project Wiki

User Tools

Site Tools

Differences

Page Tools