NAME

ap51-flash - firmware flasher for ethernet connected routers and access points

SYNOPSIS

ap51-flash [ -vh ] [ -m mac ] [ interface image ... ]

DESCRIPTION

ap51-flash listens on traffic of a network interface, detects remote devices and checks the traffic for known identification markers. These markers are send out automatically by supported devices during the initial boot process of the embedded boot loader.

On success, it will search the list of provided images for a matching firmware. A device specific communication procedure is initiated to begin the flashing process. The firmware data is extracted from the selected image and transferred to the device in TFTP server or client mode.

ap51-flash will run in foreground and continue using the interface until it is interrupted by an SIGINT signal (typically generated by control-C) or SIGTERM signal (for example generated by the kill(1) command).

The interface doesn't require a valid layer 3 network configuration but has to be set in the UP state (using the ip-link(8) command). ap51-flash requires enough privileges to capture and inject raw ethernet packets on the selected interface. These are often only accessible to the root user.

While ap51-flash doesn't require a target device specific network configuration or TFTP client/server on the same machine, it is recommended to disable any other TFTP client or server on the system running ap51-flash to avoid interferences by a different TFTP program.

OPTIONS

Listed below are the command line options for ap51-flash:

-m mac, --mac mac

Adds mac address to the allowlist filter. Only these addresses will be tried to be flashed when one or more addresses are supplied. The option has to be supplied multiple times to add multiple addresses to the allowlist filter. If not specified, all detected devices will be flashed.

-v, --version

print ap51-flash version and exit

-h, --help

print ap51-flash help and exit

NOTES

The currently supported devices are

• Alfa Network AP121F
• Datto AP440
• Datto AP840
• Datto AP840E
• Datto TW420
• Dlink DIR-300
• Engenius EOC-1650
• Engenius EOC-2610
• Engenius EOC-2610p
• Engenius 3660
• FON La Fonera (2100)
• Open Mesh A40
• Open Mesh A42
• Open Mesh A60
• Open Mesh A62
• Open Mesh D200
• Open Mesh G200
• Open Mesh MR500
• Open Mesh MR600 (v1, v2)
• Open Mesh MR900 (v1, v2)
• Open Mesh MR1750 (v1, v2)
• Open Mesh OM1P
• Open Mesh OM2P (v1, v2, v4)
• Open Mesh OM2P-HS (v1, v2, v3, v4)
• Open Mesh OM2P-LC
• Open Mesh OM5P
• Open Mesh OM5P-AN
• Open Mesh OM5P-AC (v1, v2)
• Plasma Cloud PA300
• Plasma Cloud PA1200
• Plasma Cloud PA2200
• Plasma Cloud PAX1800 (v1, v2)
• Ubiquiti Bullet2 & HP
• Ubiquiti NanoStation2
• Ubiquiti NanoStation5
• Ubiquiti Pico2 & HP
• Ubiquiti RouterStation
• UniAppliance Colibrì (!UniData)
• Zyxel NBG6817

AUTHOR

ap51-flash was written by Marek Lindner and others. This manual page was written by Sven Eckelmann <sven@narfation.org>. It is licensed under the terms of the GNU GPL (version 3 or later).