User Tools

Site Tools


toh:linksys:wrt_ac_series

Linksys WRT AC Series

To prevent discombobulation, please follow the format already in place within this Wiki when editing
(incl. the Table of Contents)

Introduction

  • OpenWrt 18.06.1 is the currently recommended OpenWrt branch for the WRT AC Series family of routers
    • Official OpenWrt support for the WRT AC Series began under Chaos Calmer

Supported Hardware

Devices

OEM Source Code

WRT1200AC

WRT1900AC

Model VersionSupported Since CommitSupported Since RelPackage architectureCPU MHzCPU CoresFlash MBRAM MBSwitchWLAN HardwarePower SupplyDevice TechdataComments
WRT1900ACv1 (mamba)https://git.lede-project.org/?p=source.git;a=commit;h=ac91824b3675977edb391a6d801657e533d2905d15.05arm_cortex-a9_vfpv313002128NAND256Marvell 88E6172Marvell 88W886412 VDC, 4.0 AView/Edit data[Launch Date: 2014.03] Serial 13J1; OEM Firmware Name: blk-mamba.128mb.img
WRT1900ACv2 (cobra)https://git.lede-project.org/?p=source.git;a=commit;h=2705cda81389e84687fb0325d2bf6c8bc2756bee15.05arm_cortex-a9_vfpv316002128NAND512Marvell 88E6176Marvell 88W886412 VDC, 3.0 AView/Edit data[Launch Date: 2015.04] Serial 13J2; OEM Firmware Name: cobra.img

WRT1900ACS

WRT3200ACM

WRT32X

Flash Layout

  • If booting from primary partition, mtd5 || mtd6 will be named ubi, with mtd7 || mtd8 as ubi if booting from alternate partition
    • italics: title for section of flash storage
    • bold: mtd device name for the partition
    • monospace: name of the mtd partition

Armada XP

WRT1900AC v1

Armada 385

WRT1200AC / WRT1900AC v2 / WRT1900ACS

WRT3200ACM

WRT32X

Marvell WiFi

WiFi Bug Reports

If experiencing instability, see WiFi Stability Issues

mwlwifi 88W8864 / 88W8964

Query Installed Version

opkg list-installed | grep mwlwifi

Source Code Compilation Instructions Repo

Official Marvell source

Prerequisites:

Compile:

Current Build:

Photos

WRT3200ACM

Switch Layout

eth0/eth1: physical PCB connection LAN: physical LAN ports on router WAN: physical Internet port on router

Marvell 88E6172

WRT1900AC v1
sw.port 0 1 2 3 4 5 6 vlan ID
LAN 4 3 2 1 eth0 1
WAN Internet eth1 2

Marvell 88E6176

WRT1200AC / WRT1900AC v2 / WRT1900ACS
sw.port 0 1 2 3 4 5 6 vlan ID
LAN 4 3 2 1 eth1 1
WAN Internet eth0 2

Marvell 88E6352

WRT3200ACM / WRT32X
sw.port 0 1 2 3 4 5 6 vlan ID
LAN 4 3 2 1 eth1 1
WAN Internet eth0 2

</WRAP>

Firmware Images

Bug Reports

Synopsis

There are several build sources for the WRT AC Series, with LuCI included in all except bare Development Branch builds

  • OpenWrt Branches
    Recommended for new members
    These are builds released officially by OpenWrt

    • Stable
      Kernel 4.14.63

      As name implies, this is the stable branch and is called OpenWrt 18.06.1

    • Development
      Latest OpenWrt kernel version

      Snapshots built daily by BuildBot and should not be considered stable

  • Third Party Builds
    Based on the Development Branch, these are built, and maintained, by the parties listed

    • davidc502
      Latest OpenWrt kernel version

      Built for stability, containing latest WiFi drivers, patches, & package repo

    • escalade
      Users may find the config files of interest, as his builds offer a complete OOBE

Please verify checksums prior to flashing firmware (ensures download is not corrupted)

OEM Builds

Official Linksys OEM Firmware (Updated February 23rd, 2018)
Based on kernel versions 3.2.40 & 3.10.39

Devices

OpenWrt Branches

Stable

Changelog Docs Release Notes Repository Source OpenWrt 18.06.1 (Released August 17, 2018)
Based on kernel version 4.14.63

config gpg manifest sha256sums Recommended for new members

Devices

Development

BuildBot Git Repository Daily Snapshot
Based on latest OpenWrt kernel version

Config gpg manifest sha256sums

Should not be considered stable

Devices

Third Party Builds

These are built, and maintained, by the parties listed

davidc502

Repository Moderately Customized Development Builds (Released December 1st, 2018)
Based on latest build kernel and Wifi driver

Build Info Downloads sha256sums

Devices

escalade

Configs GitHub Repository Fully Customized OpenWrt Build (Released June 14, 2018)
Users may find the config files of interest, as their builds offer a complete OOBE

Build Info Downloads Change Log Thread Firmware is not for this series

Flashing Firmware

Synopsis

OpenSSH PuTTY Win32-OpenSSH

Always update firmware using a wired connection, never via WiFi
Failure to adhere to this substantially raises the probability of bricking the router

  • Flashing occurs via a round-robin:
    • If booted to primary partition, alternate partition will be flashed, and vice versa
  • WiFi is disabled by default; SSIDs and passwords for the two [WiFi] radios will need to be set:
    • It's imperative the WiFi Security section is read prior to enabling WiFi
    • For best results, change the wifi channels from Auto to actual channel numbers
      • 5GHz radios function best at channels in the 150 range
    • Antenna direction and angle matters for signal strength
      • Adjust antennas while viewing dB levels via WebGUI [Network Wireless Wireless Overview]
  • Network connection may need to be refreshed after a flash: (release || renew IP)
    • Unplug LAN cable, wait ~5s, and plug back in
  • Modem's memory may need to be cleared if internet connection is not restored:
    1. Unplug modem and router (~15s)
    2. Turn modem back on and wait for it to fully boot (~60s)
    3. Turn router back on.

OEM >> OpenWrt

Backup:

Flash:

OpenWrt >> OEM

Backup:

Flash:

Update

Backup:

Flash:

Restore:

Bootloader

Flash

Commands

USB instead of TFTP

Video Tutorials

TFTP Flash

HowTo

Anyone wishing to make a video tutorial for Linux, please do so

Troubleshooting

Boot Log

OEM

Armada XP

Armada 385

OpenWrt

Armada XP

Armada 385

Bootloader

Corrupt Environment Recovery

If the U-Boot bootloader environment becomes corrupted, it can be reset or restored

Corrupt Bootloader Recovery

contributed by: nitroshift, Stefan Roese, & Chadster766
Chadster766's GitHub

Information

Please send a thank you to:

Prerequisites
  • Hardware
    • PC running Linux
      • x86 libraries if x64
    • USB – TTL Cable
Instructions

Boot from UART:

Dependency Errors

Problem: Dependency errors are received when installing pkgs

Solution: This is an either / or occurrence

  1. /etc/opkg.conf is pointing to the wrong repository
    rm /etc/opkg.conf && cp /rom/etc/opkg.conf /etc/opkg.conf && opkg update
  2. Package repository has been updated to comply with an updated kernel version
    • Flash, or build, a new image with the updated kernel version

Firmware Recovery

Switch router from primary to alternate partition or vice versa

LuCI:

Serial:

SSH:

Switch:

Revert to Default

To reset all settings to default, execute the firstboot script via ssh: (or LuCI if luci-app-commands is installed)

/sbin/firstboot
  • This will only reset the environment to the default environment contained within the firmware image flashed
    • If flashing non-official OpenWrt images, this will restore the defaults in that image, not OpenWrt defaults.

Serial Port

Synopsis

Serial Port is labeled J1 on the board, utilizing a JST PH 6 pin connector with a 2.0mm pitch, operating at 3.3v

  • The more common 2.54mm pitch will not fit properly.
    • In a pinch, removing the plastic casing from 2.54mm female connectors allows for a stable enough connection.
      • Ensure leads are insulated with electrical tape
  • If flashing regularly, you may wish to invest in a USB-TTL AJ cable
    • USB-TTL AJ cables require installation of a 3.5mm Jack (F) on the router

Serial Header

Pin Out
Pins 1 2 3 4 5 6
Function Gnd Tx n/a Rx n/a n/a

Armada XP

Armada 385

Serial Interfaces

USB-TTL AJ

Pin Out

Cable

3.5mm Jack Install

Arduino

Pin Out

Header

MAX232

Pin Out

Line Driver

USB-to-UART

Pin Out

Adapter

Serial Flash

Prerequisites

  1. USB-TTL Cable

  2. Serial Interface

  3. TFTP Server

  4. OEM Firmware Names

Instructions

Flash via Serial:

Flash Output

Successful

Unsuccessful

WiFi

Missing Drop Down Values

Problem: To accommodate a wider variety of kernels for compatibility with the series, path values were modified.

Solution: If experiencing missing drop down values, add platform back to path in /etc/config/wireless.

Armada XP

Armada 385

Slow Throughput w/ Intel WiFi

Problem: Intel enabled Receive Side Coalescing (RSC) in their 18.x drivers

Solution:

Windows:

Stability Issues

Problem: WiFi instability experienced

Solution:

  1. Verify installed WiFi driver version & update if newer version is offered:
    opkg list-installed | grep mwlwifi
  2. If issue still present:
    1. Post in OpenWrt Forum
    2. File WiFi Bug Report

Historical

Historical:


Tags

toh/linksys/wrt_ac_series.txt · Last modified: 2018/12/10 14:34 by jw0914