.repo/ doc/ sdk/

swd:
crypto/ doc/ driver/ include/ lic.c lic_gpl.c mac80211/ main.c main_gpl.c Makefile net/ proclib.c README.txt sbi.c sbi_gpl.c
swd/net:
http.c ippkg.c Makefile.inc nscd.c nscd_gpl.c socket.c stc.c stc_gpl.c syslib.c syslib.h table.c table_gpl.c vgate_gpl.c vteth_gpl.c webhack.c webportal.c webportal_gpl.c


SuperWRT源代码的目录结构，首发于SuperWRT。

可参考目前市场上对比的产品是：Netgear Orbi、Ubnt Amplifi Mesh、MikroTik HWMP Mesh。

WiFi Buddy是我们根据常见的几种需要自组网的场景，而设计的一种更贴近实际需求的自组网技术。WiFi Buddy具有以下技术特点:

1. 主要满足拓扑变化比较慢的场景使用。主要用于有线单点故障自愈，无线组网回传。（如需要快速拓扑适应，可使用我们Mesh版本。）
2. 支持复杂组网，可用于VLAN透传，实现多SSID网络。
3. 充分考虑稳定性、可靠性、兼容性的要求，减少实现复杂度。
4. 减少协议开销，提高转发效率。
5. 可充分利用多频设备，及有线和无线混合跳跃转发。尽量利用不同频率来提高整体转发带宽，减少延迟。

WiFi Buddy区别常见的Mesh实现，如802.11s及各种基于adhoc的Mesh。该类型的Mesh协议开销比较大，对于CPU的消耗也比较大，同时，对于多频设备也无法错开频率。所以上，上述类型Mesh一般的带宽都比较小，但对拓扑变化适应快，适合一种些特殊应用使用。

WiFi Buddy也区别于近期一些厂家推出的家用Mesh技术，比较有代表性的就是高通的WiFi Son。以高通的WiFi Son为例，该实现以一个单独的160M频宽11AC作为回传链路，专门用于主设备与子设备数据连接，再以通常用另外的一个2.4G和5G作为覆盖（IPQ4019的方案）。上述方案硬件成本很高，同时对多VLAN实现的多SSID网络不是很友好，而且无线回传是固定设置的。

WiFi Buddy技术主要应用于以下几个场景：

• 对有线AP进行无线冗余连接备份

在一般场景中，会选择使用有线连接所有AP，来保证无线网络的带宽及使用效果。但实际应用中，可能因为网口松动、现场施工、自然灾害等原因，导致个别AP有线无法连通。这时，通过使用WiFi Buddy来解决该问题。

首先在布网时，打开WiFi Buddy功能。WiFi Buddy会监控所有接口，发现有线网络通时，将不进行无线之间互连。一旦WiFi Buddy功能监控到有线网络断开时，将自动连接到附近信号较好的AP上，从而减少了网络故障时间。

• 无线数据回传

在某些场景中，不方便使用有线连接AP，此时，可以使用WiFi Buddy实现无线链路上连。相对传统使用WDS的网桥方式，WiFi Buddy技术可以保证当前上连AP故障时，自动切换到其它AP。当某些设备与AP直接通信信号不好时，也可以使用临近AP进行中继。

• 双频及多频设备无线组网

对于双频或多频设备，使用WiFi Buddy时，会自动根据链路情况，选择下一跳使用同频还是异频。一般在环境允许情况下，会尽量使用异频，从而有效提高整体带宽。

• 终端设备漫游切换

使用WiFi Buddy的Fast版本（开发中），可以实现单节点设备的快速漫游，从而满足一些移动数据场景的需求。

WiFi Buddy的配置使用：

将所有需要组网的设备，在无线设备中打开WiFi  Buddy功能，并设置相同的用户名和密码，网络中至少有一个设备需勾选“无线伙伴网关”选项。将希望使用WiFi Buddy射频，打开WiFi Buddy的“加入”选项，即可进行自组网。注意：如果网络中没有设备打开“无线伙伴网关”选项，已经完成组网的设备仍会周期性进行切换信道的扫描，将造成连接终端周期性丢包。

目前，发布WiFi Buddy功能仍处于测试阶段，仅在std版本中提供，欢迎进行问题反馈。

在本次发布的v0.6.1中，还增加了以下功能：

1. 在std版本中，加入静态路由、静态域名地址功能。
2. 在tiny版本中，去掉无线高并发功能以节省空间。
3. 增加AR9331支持。

并且解决了以下Bug：

1. 在上一个std版本中，5G不能使用DFS信道问题。
2. 修复无线高并发中的一些小Bug。
3. 修复一些Web界面显示的小Bug。

关于SuperWRT的付费特性及SSID广告问题，仍然要再说明一次。我们一直坚持基础特性，及家用场景免费。一些限制（或者被称为恶心人的地方）主要也是针对可能的商业使用，及其它某些盈利使用方式。我们不会做采集用户信息等一些隐蔽的、损害用户的获利方式，即使SuperWRT自身的SSID广告也是可以自行选择开关的，而且是默认关闭的。我们希望为支持我们的用户提供更好的系统，但我们不是圣母或非盈利性组织，也没有人给我们捐赠，我们也希望获取一定的商业价值，将事情长期做下去，并且做更多更好用的技术。再次对一直以来支持我们的用户表示衷心的感谢，谢谢！

SuperWRT v0.6.1发布，加入创新的WiFi Buddy自组网技术，首发于SuperWRT。

本次版本增加及修改的特性有：

1. 在tiny版本中，仅保留中文界面。
2. 在std版本中，完善的VLAN配置，可设置IP及DHCP服务，并可设置隔离，支持远程webportal针对不同VLAN进行不同配置。
3. 在std版本中，增加Switch配置。
4. 增加PPPoE拨号错误原因显示及成功后对端地址显示。
5. 重新合入PPtP VPN功能。

本次版本解决的Bug有：

1. 使用Wisp时，配置WLAN导致DHCP无法再次获取问题。
2. std版本中，主机有IPv6时，不显示主机MAC地址问题。

下面对目前SuperWRT已实现的功能进行汇总介绍。

SuperWRT是一个第三方路由系统，使用Linux内核为基础从头开发，并非OpenWRT、DDWRT、Tomato等系统的分支。计划有三个版本：Tiny版本，Std版本，Ext版本。目前，Tiny版本和Std版本的测试版本已经对外发布。

SuperWRT Tiny版本功能介绍

SuperWRT的Tiny版本支持无线路由器基本功能，同时，增加了我们认为重要的功能。

1. Tiny版本仅1.8M，可直接刷入2M Flash的设备。是目前唯一还可以支持2M Flash的第三方路由系统。即使是TP-Link的目前2M Flash设备，也是采用的VxWorks系统。
2. SuperWRT支持用网页管理，我们的网页采用响应式设计，对手机端管理更加友好。
3. SuperWRT支持更加友好的限速功能。可以设置默认用户速率，也可针对特定用户设置速率限制。同时，我们不断完善智能流整形功能，以保证在限速下更好的QoS体验。
4. 特别开发的无线高并发优化特性，可在无线环境较差时，明显提供无线并发用户数量及带宽，改善多用户时的无线体验。
5. SuperWRT支持一般路由器的广域网连接方式：静态地址、动态地址、PPPoE拨号。其中，根据大家需求，更支持PPPoE多拨功能，在多拨下可进行负载均衡。
6. SuperWRT在Tiny版本中也有访客网络功能。可以增加一个单独的SSID作为访客网络。访客网络可与正常网络完全隔离，可以为访客网络设置单独的用户限速。
7. 在访客网络中，可以开启Web Portal（网页登录）功能。Tiny版本的Web Portal有本地和远程两种模式。在本地模式中，可以选择点击确认，用户名密码登录，管理员授权等方式，可以定制网页标题。使用远程模式，可以与OpWiFi平台的Web Portal功能对接，支持更丰富的认证方式，可设置支持IP和域名白名单，并可针对用户下发限流量，限速，限时间等配置。
8. 支持远程管理。可以与开源的OpWiFi Easy版本管理平台对接。集中管理配置，下发指令，更新版本。
9. 支持AP工作模式。更可以配置为瘦AP模式，自动连接管理服务器。
10. 在AP工作模式下，支持配置VLAN和配置更多SSID。
11. 支持多种级别用户登录，在底层API限速不同权限，有更高安全性。目前，配置用户仅可以查看状态，配置WAN相关信息。
12. 支持二层扫描发现设备，并可通过MAC地址对设备进行管理。

SuperWRT Std版本功能介绍

Std版本在Tiny版本功能的基础上，增加了如下功能：

1. 支持多语言的界面系统。
2. 无线Station模式（即Wisp），可以通过无线连接其它AP上网。SuperWRT的Station模式更加优化，解决了其它系统中一些不方便的问题。如：可自动切换转发SSID信道，可配置多个备选SSID，Station未关联时转发SSID仍可以连接。
3. 无线可创建Station接口。并支持工作在WDS或万能桥接两种模式。万能桥接支持IPv4、IPv6、PPPoE。
4. Std版本支持11AC（Tiny版本不支持）。
5. 支持WPS虚拟按钮功能。
6. 支持PPtP VPN功能。
7. 可创建VLAN网络，为其配置独立的IP及DHCP服务，并可设置隔离、独立的远程网页登录界面。
8. 可配置Switch端口的VLAN，配合系统VLAN功能，实现更复杂的网络。
9. 可以在PC上远程抓取及发送设备无线报文调试功能，用于无线问题收集。

SuperWRT版本uboot

SuperWRT为了保证更完整的用户体验，制作了一个专用的配套uboot。

SuperWRT的uboot与SuperWRT系统有紧密的关系。SuperWRT的uboot都是针对芯片发布的，可通过在线定制工具，定制出适应使用相同芯片的不同设备。SuperWRT的系统有更广泛的适应性，很多芯片都可以使用一个系统。在uboot引导SuperWRT系统时，会将相应的设备信息告诉系统，系统就会根据相应的信息配置设备。这样设计的目的，是为了降低后期版本的维护工作，一个系统版本就可以应用在不同设备上，从而可以为设备提供更长期的版本维护。

SuperWRT有如下特色功能：

1. 有恢复网页，可通过网页刷机。在恢复网页模式下，还有启动DHCP及DNS服务，以给客户端分配地址，并可以通过域名访问网页。
2. 支持配置密码，以防止轻易被其他人导出配置文件或刷机。
3. 支持静态地址、动态地址、PPPoE拨号的广域网连接方式。可以从广域网通过HTTP协议下载版本，以在系统出错时，自动恢复设备。
4. 有配套的PC端工具，可通过网口中断启动，进入恢复网页，或批量升级设备。

SuperWRT支持的芯片

SuperWRT独创了在线定制uboot系统，可以根据设备硬件，选择相应配置，自动生成支持的uboot。该uboot还能将硬件信息传给kernel，从而直接支持新的设备。目前，SuperWRT系统支持ar934x/qca953x/qca955x/qca956x主芯片，支持AR928x/AR938x/AR939x/AR958x/AR959x/QCA988x WLAN芯片 ，支持AR8033/AR8035/AR83x7系列PHY芯片。

SuperWRT v0.5.1发布，即将发布正式版本，首发于SuperWRT。

1. Station模式。可以使用Wisp方式连接其它无线上网。
2. 无线AP扫描功能。
3. 增加11AC支持。目前支持高通的11ac wave1标准系列芯片（qca98xx）。
4. 增加WPS虚拟按钮功能。
5. 在PC上远程抓取及发送设备无线报文调试功能，用于无线问题收集。

v0.2.8相对于v0.2.6进行了以下变动：

1. 加入NTP时间同步方式。在于SuperWRT官方服务器获取时间失败后，尝试使用NTP获取。
2. 优化了网页加载速度，及网页缓存时间过长问题。
3. 加入无线的WDS配置。
4. PPPoE在未变更配置时，不重新拨号，以解决部分地区运营商对重拨时间限制的问题。
5. 优化智能流整形在大内存设备中的表现，解决之前版本导致迅雷下载速度不稳定的问题，优化其它用户ping时延。(v0.2.8的接口下行限速暂不生效，待下个版本完善。)
6. 解决配置变更时，或一些特殊场景下，设备偶尔异常重启的问题。
7. 解决无线高并发之前版本中的一些Bug。

Std版本增加了Station功能。我们调查了用户在其它系统中抱怨的问题，优化了我们的功能实现。主要体现如下：

1. 当在一个射频同时开启了AP与Station时，只要配置为自动信道，当Station获取连接后，AP就会根据Station的信道，自动更改其工作信道。(注意：目前配自动信道，如果添加了多个AP，在Station切换信道后，会只有一个工作。)
2. 在Station未关联到上级AP时，设备的AP仍可以正常工作，以方便用户连接管理。但由于Station在后台会周期性切换到其它信道进行扫描，可能AP会偶尔延迟比较大，但不影响管理功能。在Station未连接时，AP不会跟随Station变更信道。
3. 可以设置Station绑定的BSSID，以方便用户限制Station连接指定的设备。
4. 在Station中，可以设置多个备选SSID。当主SSID无法连接时，Station可以自动连接其它备选的SSID，以保证网络正常工作。
5. 无线高并发特性针对Station模式进行了优化。需要License才可以在终端模式中使用无线高并发（只要不打开无线高并发，终端模式是无限制使用的），但您仍可以打开全许可证测试，以获取每次启动后15分钟的测试时间。

Std版本增加了对11AC的支持，但目前11AC的无线高并发优化仍在开发中，所以，暂时无法在11AC中使用我们的无线高并发优化。

随SuperWRT v0.2.8，更新了bootloader版本1.2.5。

1. 解决有时UID生成错误的问题（与系统不一致）。
2. 解决WAN口下载版本时，解析DNS处理CNAME的问题。

SuperWRT v0.2.8发布，增加Std版本，支持Station模式及11AC，首发于SuperWRT。

解决问题列表：

1. 解决ar8035的丢包问题。
2. 解决iphone在网页登录时跳转离开问题。
3. 解决限速和智能流整形在某些特殊情况下的效率问题。
4. 解决带宽配置关闭后，仍然下发问题。
5. 解决访客网络中配置DHCP租期未生效问题。
6. 在状态网页中显示启动分钟。
7. 在AP模式中，去掉必须配置网关的检查。

SuperWRT v0.2.6发布，近期最后一个解决Bug版本，首发于SuperWRT。

解决问题列表：

1. 解决某些设备启动后PHY地址会变更的问题，增加适配代码。
2. 解决一些双频设备第二射频没有正确配置的问题。
3. 解决一些设备的校准信息中，射频参数与硬件不对应的问题，增加判断代码。
4. 解决中文SSID在状态页显示不正确的问题。

Bootloader更新到v1.2.4，解决了以下问题：

1. 增加TP9345芯片支持。
2. 解决一些特殊型号内存兼容性问题。
3. 解决不配置内置Switch时，以太网加载不正确的问题。

SuperWRT v0.2.4发布，解决Bug，增强兼容性，支持TP9345，首发于SuperWRT。

SuperWRT v0.2.2在增加了网页登录的令牌登录方式。管理员可以生成一个带有使用截止时间的令牌，来发放给用户通过网页方式登录。该方式可以便于管理员不在网络时，远程允许用户通过认证，并可控制用户使用的时间。可比较方便的控制访客允许上网的时间，可用于根据公司访客来访天数授权等场景。

随SuperWRT v0.2.2，更新了bootloader版本1.2.3。

1. 增加任务等待页的后台检测，设备任务完成后可自动跳转。
2. Debug网页增加写入Hex功能，以方便更改MAC地址。
3. GPIO命令增加monitor模式，以方便测试按键。
4. 加入WLAN的MAC地址显示。
5. 增加隐藏的刷bootloader方法，在Debug页面使用40000000地址写入。
6. 增加PHY地址错误时自动纠错功能，并在串口输出提示信息。
7. 在Flash自动扩展分区时，可根据校准信息及MAC信息位置，选择CAL分区位置。（如：原Flash为4M，而校准信息位置为0xff1000，换8M Flash后，CAL分区将自动改为Flash结尾。但当校准信息位置为0x3f1000时，CAL分区将保持原来位置。）
8. 改善浏览器兼容性， 解决一些小Bug。

从SuperWRT v0.2.2版本开始。我们提供了4M Flash镜像下载，可直接刷写SuperWRT版本到Flash（包含ART、MAC、Bootloader、Firmware）。建议使用4M Flash，如使用更大容量Flash，由于新booloader有自动扩充分区的功能，需重新刷入Firmware和ART及MAC。

使用Flash镜像时，我们建议使用原机的ART及MAC。写入ART的方法如下：

1. 进入Bootloader的恢复网页。（可使用以下方式：长按Reset按键，使用SuperWRT Device Tool通过网口中断、使用TTL输入httpd命令）
2. 点击Debug按钮，进入Debug页面。
3. 上传64k的ART文件到ff0000地址（如使用非Flash镜像版本，请按WLAN info中CAL地址写入小ART文件）。（如果使用2k ART，请按下方的WLAN info中CAL地址写入。）
4. 点击Go。

更新MAC的方法如下：

1. 进入Bootloader的恢复网页。（可使用以下方式：长按Reset按键，使用SuperWRT Device Tool通过网口中断、使用TTL输入httpd命令）
2. 点击Debug按钮，进入Debug页面。
3. 写入MAC地址的HEX值到ff0000（如使用非Flash镜像版本，请按WLAN info中MAC信息地址写入位置）。（如果有多个WLAN，请按下方的WLAN info中MAC信息地址写入。）
4. 点击Go。

SuperWRT v0.2.2发布，并更新bootloader，提供Flash镜像，首发于SuperWRT。

1. 合入了我们经过长期开发无线高并发特性。可以有效改善WiFi同频干扰，提高并发用户时的吞吐量，减少无线的网络延迟。（更详细信息，请参考官网博客中的测试文章）
2. 合入了新智能流量整形特性。可以自动均衡用户间，及用户不同应用的带宽，减少大流量用户及应用对其它用户及应用造成的影响。（更详细信息，请参考官网博客中的测试文章）
3. 支持扫描局域网中的SuperWRT设备，并直接进行简单配置。
4. 网页登录丰富了本地认证方式，并可以查看及管理认证的用户。
5. 在AP模式时，支持通过网页上增删SSID，并可以设置VLAN。
6. 增加许可证管理功能。

详细更新特性如下：

1. 无线高并发特性。
   1. 开启后，可以学习信道特性，根据环境自动更新芯片配置，并调整策略。
   2. 可以比较有效的降低同频干扰对与终端通信的影响。
   3. 可以比较好的均衡不同用户间的流量及信道占用。
   4. 可以与智能流量整形协同工作，调整用户流量。
2. 新智能流量整形特性。
   1. 可以学习不同用户的流量构成，有效调整带宽分配。
   2. 可以均衡不同用户间的流量。
   3. 可以保证用户自身不同应用的带宽。
   4. 可以与无线高并发协同工作，以保证用户不同数据不同优先级。
   5. 可以按设置的用户优先级调整流量整形策略。
3. 限速功能更新。
   1. 改变内部实现机制，处理效率更高。
   2. 可限定WAN口速率，以配合智能流量整形功能工作。
4. 无线基本功能更新。
   1. 增加无线用户黑白单功能，可以按用户列表中的配置限制接入。
   2. 支持增加和删除无线SSID，并可选择创建SSID是否属于访客网络。
   3. 增加强制HT40模式。
   4. 修改了SSID广告的限制，不开启不再限制用户数。但开启后会增加一些抗干扰优化。
5. 网页登录功能。
   1. 本地增加“管理员授权”登录方式。即用户弹出网页出现二维码，管理员可扫码授权。
   2. 增加网页登录用户的状态查看功能。
   3. 增加网页登录用户的管理功能，可认证及踢除用户。
   4. 修正一些小Bug。
6. 二层设备发现功能。
   1. 可使用电脑工具扫描局域网中运行的SuperWRT设备。
   2. 可获取设备状态信息，并可对设备进行配置。
7. 状态信息丰富。
   1. 增加用户信息详细按钮，点击后可显示更多用户状态信息。
   2. 增加AP模式下终端的详细按钮，点击后可显示更多信息。
   3. 主页状态信息丰富，可显示无线工作的频宽。
8. 加入许可证系统。
   1. 可根据设备信息及硬件信息，生成设备唯一的UID。
   2. 实现检查及更新新可证功能。
   3. 实现本地上传许可证功能。
   4. 支持许可证的读入及配置变更。
9. 其它。
   1. 将内核更新到linux 3.18.40。
   2. DNS主备切换功能优化。
   3. 管理服务器配置变更新后，立即上线管理服务器。
   4. 支持网管下发定期上报指定的状态信息指令。
   5. 自动处理DHCP地址段配置错误的情况。

boot功能更新：

1. 用户更换大Flash后，可自动调整分区结构，充分利用增大的Flash空间。
2. 实现生成设备唯一的UID功能。
3. 在通过WAN口下载升级文件时，增加闪灯提示。
4. 解决一些小Bug。

SuperWRT v0.2.0版本即将发布，首发于SuperWRT。

SuperWRT从v0.2.0版本开始，合入我们一直在开发无线高并发优化，及智能流整形技术。前者，可以有效的降低同频干扰对无线，提高无线并发的用户数量；后者，则可以帮助路由设备智能的分配带宽，保证所有用户的网络流畅性。

那么，如何将设备用上SuperWRT呢？

SuperWRT创新性的使用固件与设备减少绑定的技术，即SuperWRT的同一个固件可以用于多种不同类型的设备。那么，您仅需要做的是，使用一个您设备对应的boot。

如何获取您设备对应的boot呢？一种方式，就是从网络中上载别人已经做好的SuperWRT的boot，直接更新到您设备上使用。另一种方式，是通过我们提供的网页形式的在线定制工具，填入您设备的对应信息，将自动生成设备的boot。而不再是搭建一大堆的编译环境，尝试别人论坛上发的一堆更改，敲一堆不懂的命令，生成一个可能会运行的boot。生成SuperWRT的boot，只需要您拿着鼠标点、点、点。当然，前提还是您要具备一定的知识，知道您点的是什么。

目前SuperWRT支持AR9341/AR9342/AR9344/AR9350/QCA9531/QCA9533/QCA9550/QCA9558/QCA9561系列芯片。对其它的芯片的支持，我们将不断的开发。

在生成的boot中，将携带您在网页输入的信息，这些信息在启动时还将传递给固件。固件使用这些信息来配合您的设备工作。这样，我们就做到了，只要支持了您的芯片，您就可以自己实现SuperWRT固件对设备的支持。

下面就是一些典型的应用案例：

在商业用无线领域，高通（Atheros）的芯片使用还是比较多的。可能有一个工程，原来的设备效果比较差，但它使用的芯片在我们的支持列表中。这时，可以查找我们的网站是否有该设备型号的boot。如果没有，可以找一个懂得相关知识的人，根据设备的硬件，在我们的定制页面生成一个该设备的boot。然后，将原来工程中用的AP，还是路由器进行更新，刷入新的软件，使其焕然新生。当然，您也可以上传（或自行出售）制作好的boot，让更多其他朋友使用。

也可能您从某些渠道获取到了一批无线设备，它们原来的工作效果比较差，或者软件上做了某些限制，但它使用的芯片在我们的支持列表中。这时，您可以使用我们的固件，让其更好的工作，再次发挥余热。

让你的WiFi设备获得新生，使用SuperWRT更新您的设备，首发于SuperWRT。

传统解决有用户占用大流量问题的方式是限速，但对于家庭网络或Soho型公司来说，一般用户不会很多，限速使下载速度一直不快，而且这时可能其他人也不怎么使用网络，造成了网络资源的浪费。SuperWRT的智能流整形技术，可以比较友好的解决这种问题，而不是那么简单粗暴。

SuperWRT的智能流整形技术会跟踪并分析每个用户的流量，及每个用户的不同应用的流量。然后，根据外网可使用的上下行流量，智能的将带宽分配给每个用户及用户的不同应用。

下面的视频就是我录制的一个例子。当有用户使用迅雷下载热门资源时，如没有其它人使用网络，我们希望下载的越快越好。但当突然有其他人使用网络看视频时，智能流整形功能自动调整原来迅雷使用的带宽，让渡一定的带宽给看视频的用户。当用户视频缓冲完成时，又用将带宽自动归还给原来的迅雷使用，从而比较有效的利用了网络带宽资源。

视频链接

下面是一个在看视频时，同时进行迅雷下载测试的截图。截图中，迅雷关闭了所有网速保护，以下载优先模式进行下载。

需要说明的是，使用SuperWRT的智能流整形功能，一定要设置外网带宽到设备中，才能保证设备有效的调度带宽。比如上面视频的例子中，我使用的是电信20Mb的光纤，其中上行只有下行1/10，所以，转换为字节单位，需设置为下行2500kBps，上行250kbps。

减少网络卡顿，SuperWRT v0.2版本智能流整形升级，首发于SuperWRT。