This repository has been archived by the owner on Aug 12, 2021. It is now read-only.
forked from openwrt/openwrt
-
Notifications
You must be signed in to change notification settings - Fork 2
/
notes.txt
91 lines (73 loc) · 5.83 KB
/
notes.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
## Don't forget to apply the hotfixes!
For small fixes and annoyances, the hotfix mechanics allows to provide a differential update that can be flashed without reinstalling the firmware.
Here is how it works:
1. Flash the image as always.
2. Once the device boots, go immediately to the `Backup / Flash Firmware` in LuCI.
3. Upload the `tar.gz` in the `Restore` section, as if it's a backup.
## How to decompress and install
> Warning: the 'sysupgrade' procedure will reset some settings to their default values. To see the system's changes by looking at the 'bootz' files in `/etc/bootz`.
First, decompress the downloaded file. This file is compressed using `xz`, and it's a tarball.
- If using **Windows**, install [PeaZip](https://www.peazip.org)
- If using **macOS**, install [Keka (beta)](https://beta.keka.io)
- If using **Linux**, **macOS** or other **UNIX/UNIX-like**, it's likely that they have all the tools
A folder will be decompressed. Inside this folder, there are the following subfolders:
- `bin`: this contains the two "flashable" versions of the firmware. One is a `sysupgrade` image that will upgrade from another version or OpenWrt, and the other is a `factory` image that will flash directly from the OEM firmware.
- `info`: this folder contains the manifests, the configuration seed, and the checksums.
- `patches`: it contains all the patches that apply cleanly over the fork point.
### From the OpenWrt firmware or another version of this firmware
Follow the instruction on the OpenWrt wiki page for upgrading using LuCI or CLI:
- [System Upgrade](https://openwrt.org/docs/guide-user/installation/generic.sysupgrade)
### From the Linksys firmware
Follow the instruction on the OpenWrt wiki page for the device:
- [EA6350v3](https://openwrt.org/toh/linksys/linksys_ea6350_v3)
- [EA8300 and MR8300](https://openwrt.org/toh/linksys/linksys_ea8300)
### From the GL.iNet firmware
Follow the instruction on the GL.iNet Docs page for the device:
- [Convexa-B](https://docs.gl-inet.com/en/3/setup/convexa_b/upgrade/#official-openwrtlede-firmware)
- [Convexa-S](https://docs.gl-inet.com/en/3/setup/convexa_s/upgrade/#official-openwrtlede-firmware)
> **CAREFUL**: the instructions for the Convexa-S are incomplete, and following them to flash the device with OpenWrt or this build will hard brick it, requiring hardware re-programming and assistance from the GL.iNet tech support. Follow the instructions from Dongming Han [here](https://forum.gl-inet.com/t/8654/8).
## Features and packages
The binary installable image contains the following packages and features:
- Using the OEM partition as `/overlay` for extra storage (*dual-partition devices only*)
- DNS
- Disabled `dnsmasq` DNS forwarder in favor of `unbound` resolver with TLS
- Configured Unbound as a TLS forwarder for a secure DNS server (currently: Quad9)
- Utilities
- Tools: bash, nano, nologin, sudo
- Performance: haveged, schedutil, compressed-memory
- LuCI
- adblock, advanced-reboot, commands, compressed-memory, dashboard, uhttpd, unbound
- File Systems
- exfat, ext4, f2fs, msdos (FAT16/32)
- Kernel features and modules
- New Linux IOSCHEDs elevators and Governors
- `schedutil` enabled by default for all CPU's
- Fully preemptive @ 100 Hz kernel for more responsiveness
- Patched VLAN to work as expected for all supported IPQ40xx targets
## General notes
All kernel modules for a particular version, among with a wide set of LuCI apps, are automatically uploaded to GitHub, and `opkg` is configured to use them. The other software is available from OpenWrt's snapshots, but the ROM is not configured to use them *by default*. If there is some missing package or kernel module, please open a GitHub issue or send feedback to my email or my OpenWrt forum thread explaining exactly what's missing. It will be added to the next release.
This is a custom configuration optimized for IPQ40xx devices. The purpose of this build is to give the user a sensible selection of software for testing and using OpenWrt without too much extra effort. It's also optimized for lower latency and fixes for many annoyances. This build contains some important changes compared to OpenWrt. It contains some customizations that cannot be found in the official OpenWrt image or the OpenWrt repositories. However, most packages (excluding kernel modules) are 100% compatible.
## Take into consideration
The default IP address is now `192.168.xx.1` and IPv6 is `fd00:192:168:xx::1`, the `xx` means that every supported device has a different subnet IP. The hostname is `Civic`, 'Convexa-B', 'Convexa-S', `Dallas` or `Vitzio`, respectively.
For LuCI Administration WebUI, go to
- DNS: http://192.168.xx.1/cgi-bin/luci/admin/services/unbound
- IPv4: http://192.168.xx.1/cgi-bin/luci/admin
- IPv6: http://[fd00:192:168:xx::1]/cgi-bin/luci/admin
```
Wireless password:
- [Hostname] -> OpenWrt on [Hostname]
Login password:
- admin -> admin
- root -> root
```
> Note: [Hostname] refers to the device's default hostname. Replace that placeholder accordingly. For example, the SSID for Dallas will be `Dallas`, and the password will be `OpenWrt on Dallas`.
Give Me Love 💌
==============
Don't hesitate to give this repository a golden star or forking it. This build is and will be free forever. The only thing that may I ask in exchange is proper feedback.
Downloads
=========
Click the "Assets" button below and download the `.tar.xz` file. If you want to check the hotfix's integrity, here is the SHA256 checksum. Use the `shasum` command or PeaZip/7zip.
**You should only flash the hotfixes file containing the hostname (in lowercase) of your device. If the hotfix file for your device is not present, but there is one called `others`, you should use that file on your device. If there is a file called `common`, you have to flash both common and others.**
```
candela_common.tar.gz: SHA256 fd367548e8d05e3a0661ba404f69ab896716aad049fcb5155f2181b83126bb71
```