Difference between revisions of "Template:TFTP Flashing Steps"

Jump to navigation Jump to search
 
(6 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
This template allows easy inclusion of TFTP flashing instructions across the wiki.
 
This template allows easy inclusion of TFTP flashing instructions across the wiki.
  
== Steps ==
+
== Example ==
{{Template:TFTP Flashing Steps}}</noinclude>
+
<pre>{{Template:TFTP Flashing Steps}}</pre>
 +
{{Template:TFTP Flashing Steps}}
 +
 
 +
Additional parameters may be passed to customize the instructions:
 +
<pre>
 +
{{Template:TFTP Flashing Steps
 +
|factory_reset_steps=
 +
# Power off the device
 +
# Use a paper clip to hold in the reset button
 +
# Plug in the device
 +
# Continue holding the reset button until the LED flashes
 +
|firmware_link=[https://example.com/12345.bin firmware file]
 +
|firmware_filename=firmware.bin
 +
|firmware_renamed=yes
 +
|device_ip=192.168.1.20
 +
|user_ip=192.168.1.25/24
 +
}}
 +
</pre>
 +
{{Template:TFTP Flashing Steps
 +
|factory_reset_steps=
 +
# Power off the device
 +
# Use a paper clip to hold in the reset button
 +
# Plug in the device
 +
# Continue holding the reset button until the LED flashes
 +
|firmware_link=[https://example.com/12345.bin firmware file]
 +
|firmware_filename=firmware.bin
 +
|firmware_renamed=yes
 +
|device_ip=192.168.1.20
 +
|user_ip=192.168.1.25/24
 +
}}
 +
 
 +
</noinclude>
 
<includeonly>
 
<includeonly>
=== Enter TFTP Mode ===
+
<div style="margin-left: 1.6em;">
 +
====== Enter TFTP Mode ======
 
{{{factory_reset_steps|Follow the steps for your device to enter TFTP Mode}}}
 
{{{factory_reset_steps|Follow the steps for your device to enter TFTP Mode}}}
  
=== Set Up a Static IP Address ===
+
====== Set Up a Static IP Address ======
The next step is to assign your computer a static IP address of <code>192.168.1.25/24</code>
+
The next step is to assign your computer a static IP address {{#if: {{{user_ip|}}}|of <code>{{{user_ip}}}</code>|in the appropriate subnet for your device. See the wiki page for your device if you are unsure}}.
 
# '''Windows:''' [https://winaero.com/blog/set-static-ip-address-windows-10/ Setting a static IP address in Windows 10]
 
# '''Windows:''' [https://winaero.com/blog/set-static-ip-address-windows-10/ Setting a static IP address in Windows 10]
 
# '''Mac:''' [https://osxdaily.com/2010/12/17/set-static-ip-address-mac/ Setting a static IP address in OSX]
 
# '''Mac:''' [https://osxdaily.com/2010/12/17/set-static-ip-address-mac/ Setting a static IP address in OSX]
 
# '''Linux:''' [https://linuxize.com/post/how-to-configure-static-ip-address-on-ubuntu-18-04/#configuring-static-ip-address-on-ubuntu-desktop Setting a static IP address in Ubuntu 18.04 desktop]
 
# '''Linux:''' [https://linuxize.com/post/how-to-configure-static-ip-address-on-ubuntu-18-04/#configuring-static-ip-address-on-ubuntu-desktop Setting a static IP address in Ubuntu 18.04 desktop]
  
=== Downgrade Ubiquiti AirOS ===
+
====== Sending Firmware via TFTP ======
 
+
# Download {{{firmware_link|the firmware file you wish to flash}}}{{#if: {{{firmware_renamed|}}}{{{firmware_filename|}}}|
Because we are "jailbreaking" the Ubiquiti router, we have to downgrade to an older version of their proprietary firmware first. Using a tool called TFTP, we can do this quite simply.
+
# Rename the firmware file to <code>{{{firmware_filename}}}</code>, as the device will look for this file name| }}
 
 
# Download {{{firmware_link|the firmware file you wish to flash}}}
 
 
 
{{#if: {{{rename_firmware|}}}|# Rename the firmware file to <code>{{{rename_firmware}}}</code>, as the device will look for this file name| }}
 
 
 
 
# Launch a command prompt/terminal, and enter the following, one line at a time:
 
# Launch a command prompt/terminal, and enter the following, one line at a time:
  
Line 30: Line 57:
 
  tftp> rexmt 1
 
  tftp> rexmt 1
 
  tftp> timeout 60
 
  tftp> timeout 60
  tftp> put {{{rename_firmware|{{{firmware_filename|firmware.bin}}}}}}
+
  tftp> put {{{firmware_filename|<firmware_filename>}}}
 
  Sent x bytes in x seconds
 
  Sent x bytes in x seconds
 
+
</div>
 
</includeonly>
 
</includeonly>

Latest revision as of 10:44, 15 September 2020

This template allows easy inclusion of TFTP flashing instructions across the wiki.

Example

{{Template:TFTP Flashing Steps}}


Enter TFTP Mode

Follow the steps for your device to enter TFTP Mode

Set Up a Static IP Address

The next step is to assign your computer a static IP address in the appropriate subnet for your device. See the wiki page for your device if you are unsure.

  1. Windows: Setting a static IP address in Windows 10
  2. Mac: Setting a static IP address in OSX
  3. Linux: Setting a static IP address in Ubuntu 18.04 desktop
Sending Firmware via TFTP
  1. Download the firmware file you wish to flash
  2. Launch a command prompt/terminal, and enter the following, one line at a time:
tftp
tftp> connect <device_ip>
tftp> binary
tftp> rexmt 1
tftp> timeout 60
tftp> put <firmware_filename>
Sent x bytes in x seconds


Additional parameters may be passed to customize the instructions:

{{Template:TFTP Flashing Steps
|factory_reset_steps=
# Power off the device
# Use a paper clip to hold in the reset button
# Plug in the device
# Continue holding the reset button until the LED flashes
|firmware_link=[https://example.com/12345.bin firmware file]
|firmware_filename=firmware.bin
|firmware_renamed=yes
|device_ip=192.168.1.20
|user_ip=192.168.1.25/24
}}


Enter TFTP Mode
  1. Power off the device
  2. Use a paper clip to hold in the reset button
  3. Plug in the device
  4. Continue holding the reset button until the LED flashes
Set Up a Static IP Address

The next step is to assign your computer a static IP address of 192.168.1.25/24.

  1. Windows: Setting a static IP address in Windows 10
  2. Mac: Setting a static IP address in OSX
  3. Linux: Setting a static IP address in Ubuntu 18.04 desktop
Sending Firmware via TFTP
  1. Download firmware file
  2. Rename the firmware file to firmware.bin, as the device will look for this file name
  3. Launch a command prompt/terminal, and enter the following, one line at a time:
tftp
tftp> connect 192.168.1.20
tftp> binary
tftp> rexmt 1
tftp> timeout 60
tftp> put firmware.bin
Sent x bytes in x seconds