| Name | extremeflash JSON |
| Version |
0.3.1
JSON |
| download |
| home_page | |
| Summary | |
| upload_time | 2023-12-17 15:21:38 |
| maintainer | |
| docs_url | None |
| author | Grische |
| requires_python | >=3.10,<4.0 |
| license | GPL-3.0-only |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Extreme Flash
This tool allows flashing Enterasys / Extreme Networks access points fully automatically, using OpenWRT's initramfs image.
## Installation
Install the tool:
```commandline
pipx install extremeflash
```
or
```commandline
pip install extremeflash
```
## Usage
### Prerequisites
1. connect a USB serial device to the local machine and to the serial port of the Enterasys AP
2. identify the IP configured on the local machine that will be used to connect to the Enterasys AP
3. download an OpenWRT initramfs-kernel image, e.g. [for the WS-AP3710i](https://openwrt.org/toh/enterasys/ws-ap3710i#installation)
4. download an OpenWRT-based squashfs-sysupgrade, e.g. [for the WS-AP3710i](https://openwrt.org/toh/enterasys/ws-ap3710i#installation)
**Note**: While it is generally recommended to use the same version for initramfs-kernel and squashfs-sysupgrade, the process
can work with different versions. This is especially important if a downstream OpenWRT firmware (e.g. Gluon) with a different
version should be installed on the router.
### Run the tool
1. Make sure that the serial cable is connected to the access point, but it is not powered on yet
1. Run the tool
* let it autodetect the serial port:
```commandline
extremeflash --local-ip 192.168.1.70/24 \
--model AP3710 \
-i ~/Downloads/openwrt-23.05.0-mpc85xx-p1020-enterasys_ws-ap3710i-initramfs-kernel.bin \
-j ~/Downloads/openwrt-22.03.3-mpc85xx-p1020-enterasys_ws-ap3710i-squashfs-sysupgrade.bin
```
* or manually specify the serial port:
```commandline
extremeflash --port /dev/ttyUSB0 --local-ip 192.168.1.70/24 \
--model AP3710 \
-i ~/Downloads/openwrt-23.05.0-mpc85xx-p1020-enterasys_ws-ap3710i-initramfs-kernel.bin \
-j ~/Downloads/openwrt-22.03.3-mpc85xx-p1020-enterasys_ws-ap3710i-squashfs-sysupgrade.bin
```
* For more information run:
```commandline
extremeflash --help
```
1. Power the access point and connect the LAN cable to power the AP.\
**Note**: for APs with two or more LAN ports, make sure the local machine is connected to port 2, not port 1.
1. The tool will flash the access point automatically. When it finishes, the access point
can be reached via `192.168.1.1` (OpenWRT's default IP).
## Contributing
### Install dependencies
If the dependencies are not already installed, run `poetry install` followed by a `poetry shell` to get an environment with all necessary dependencies.
### Running modified code
After modifying the code, run the tool by executing `python -m extremeflash` inside the repository's folder. For example:
```commandline
python3 -m extremeflash --help
```
Raw data
{
"_id": null,
"home_page": "",
"name": "extremeflash",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Grische",
"author_email": "2787581+grische@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/1d/e3/0f1243f9b27908e932fede62a6391adf4e03541e72295e11fc37fa71d7ec/extremeflash-0.3.1.tar.gz",
"platform": null,
"description": "# Extreme Flash\n\nThis tool allows flashing Enterasys / Extreme Networks access points fully automatically, using OpenWRT's initramfs image.\n\n## Installation\n\nInstall the tool:\n\n```commandline\npipx install extremeflash\n```\n\nor\n\n```commandline\npip install extremeflash\n```\n\n## Usage\n\n### Prerequisites\n\n1. connect a USB serial device to the local machine and to the serial port of the Enterasys AP\n2. identify the IP configured on the local machine that will be used to connect to the Enterasys AP\n3. download an OpenWRT initramfs-kernel image, e.g. [for the WS-AP3710i](https://openwrt.org/toh/enterasys/ws-ap3710i#installation)\n4. download an OpenWRT-based squashfs-sysupgrade, e.g. [for the WS-AP3710i](https://openwrt.org/toh/enterasys/ws-ap3710i#installation)\n\n**Note**: While it is generally recommended to use the same version for initramfs-kernel and squashfs-sysupgrade, the process\ncan work with different versions. This is especially important if a downstream OpenWRT firmware (e.g. Gluon) with a different\nversion should be installed on the router.\n\n### Run the tool\n\n1. Make sure that the serial cable is connected to the access point, but it is not powered on yet\n\n1. Run the tool\n * let it autodetect the serial port:\n\n ```commandline\n extremeflash --local-ip 192.168.1.70/24 \\\n --model AP3710 \\\n -i ~/Downloads/openwrt-23.05.0-mpc85xx-p1020-enterasys_ws-ap3710i-initramfs-kernel.bin \\\n -j ~/Downloads/openwrt-22.03.3-mpc85xx-p1020-enterasys_ws-ap3710i-squashfs-sysupgrade.bin\n ```\n\n * or manually specify the serial port:\n\n ```commandline\n extremeflash --port /dev/ttyUSB0 --local-ip 192.168.1.70/24 \\\n --model AP3710 \\\n -i ~/Downloads/openwrt-23.05.0-mpc85xx-p1020-enterasys_ws-ap3710i-initramfs-kernel.bin \\\n -j ~/Downloads/openwrt-22.03.3-mpc85xx-p1020-enterasys_ws-ap3710i-squashfs-sysupgrade.bin\n ```\n\n * For more information run:\n\n ```commandline\n extremeflash --help\n ```\n\n1. Power the access point and connect the LAN cable to power the AP.\\\n **Note**: for APs with two or more LAN ports, make sure the local machine is connected to port 2, not port 1.\n\n1. The tool will flash the access point automatically. When it finishes, the access point\n can be reached via `192.168.1.1` (OpenWRT's default IP).\n\n## Contributing\n\n### Install dependencies\n\nIf the dependencies are not already installed, run `poetry install` followed by a `poetry shell` to get an environment with all necessary dependencies.\n\n### Running modified code\n\nAfter modifying the code, run the tool by executing `python -m extremeflash` inside the repository's folder. For example:\n\n```commandline\npython3 -m extremeflash --help\n```\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "",
"version": "0.3.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "78fc366245fbaeac39426d1e7057f6f3b8bbc3c35a111decea39460d2a4cadc5",
"md5": "a759f31e895bf1a41d36ccb1ffcf6fe1",
"sha256": "9c59093290d3fd4ffa182c3ede7e5d9bbe7429df7fb0d58a8e09750507a786ec"
},
"downloads": -1,
"filename": "extremeflash-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a759f31e895bf1a41d36ccb1ffcf6fe1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 29325,
"upload_time": "2023-12-17T15:21:36",
"upload_time_iso_8601": "2023-12-17T15:21:36.441518Z",
"url": "https://files.pythonhosted.org/packages/78/fc/366245fbaeac39426d1e7057f6f3b8bbc3c35a111decea39460d2a4cadc5/extremeflash-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1de30f1243f9b27908e932fede62a6391adf4e03541e72295e11fc37fa71d7ec",
"md5": "dd4f4f379637abbfa1928684920f084e",
"sha256": "badac7e8f5894e3e1a788a88742c19ad65c9367d7c059c685e40572131a051ac"
},
"downloads": -1,
"filename": "extremeflash-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "dd4f4f379637abbfa1928684920f084e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 22950,
"upload_time": "2023-12-17T15:21:38",
"upload_time_iso_8601": "2023-12-17T15:21:38.012419Z",
"url": "https://files.pythonhosted.org/packages/1d/e3/0f1243f9b27908e932fede62a6391adf4e03541e72295e11fc37fa71d7ec/extremeflash-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-17 15:21:38",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "extremeflash"
}
