Skip to content

Commit 6cf2723

Browse files
iMicknliMicknl
authored
Various maintenance updates (package updates, readme updates) (#334)
This pull request includes several updates to improve the development environment, update dependencies, and enhance documentation. The most important changes are listed below: ### Development Environment: * [`.devcontainer/devcontainer.json`](diffhunk://#diff-24ad71c8613ddcf6fd23818cb3bb477a1fb6d83af4550b0bad43099813088686L20-R21): Added the `yzhang.markdown-all-in-one` extension to the VSCode customizations. ### Dependency Updates: * [`.pre-commit-config.yaml`](diffhunk://#diff-63a9c44a44acf85fea213a857769990937107cf072831e1a26808cfde9d096b9L3-R3): Updated the `pre-commit-hooks` repository version from `v4.0.1` to `v4.6.0`. ### Documentation Enhancements: * [`README.md`](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L19-R23): Fixed table formatting and updated comments for several router models. [[1]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L19-R23) [[2]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R38-R39) * [`README.md`](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R163-R168): Added a new section for debugging common issues with a link to advanced instructions.
1 parent d44ab7d commit 6cf2723

File tree

4 files changed

+133
-122
lines changed

4 files changed

+133
-122
lines changed

‎.devcontainer/devcontainer.json‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
// For format details, see https://aka.ms/devcontainer.json. For config options, see the
22
// README at: https://github.com/devcontainers/templates/tree/main/src/python
33
{
4-
"name": "python-sagemcom-api (Python 11)",
4+
"name": "python-sagemcom-api (Python 12)",
55
// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
6-
"image": "mcr.microsoft.com/devcontainers/python:0-3.11",
6+
"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
77
// Features to add to the dev container. More info: https://containers.dev/features.
88
"features": {
99
"ghcr.io/devcontainers/features/github-cli:1": {},
@@ -17,7 +17,8 @@
1717
"customizations": {
1818
"vscode": {
1919
"extensions": [
20-
"ms-python.python"
20+
"ms-python.python",
21+
"yzhang.markdown-all-in-one"
2122
],
2223
"settings": {
2324
"python.defaultInterpreterPath": "./.venv/bin/python"

‎.pre-commit-config.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
repos:
22
- repo: https://github.com/pre-commit/pre-commit-hooks
3-
rev: v4.0.1
3+
rev: v4.6.0
44
hooks:
55
- id: check-json
66
exclude: .devcontainer

‎README.md‎

Lines changed: 31 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -15,29 +15,31 @@ Python 3.9+ required.
1515

1616
The Sagemcom F@st series is used by multiple cable companies, where some cable companies did rebrand the router. Examples are the b-box from Proximus, Home Hub from bell and the Smart Hub from BT.
1717

18-
| Router Model | Provider(s) | Authentication Method | Comments |
19-
| --------------------- | -------------------- | --------------------- | ----------------------------- |
20-
| Sagemcom F@st 3864 | Optus | sha512 | username: guest, password: "" |
21-
| Sagemcom F@st 3865b | Proximus (b-box3) | md5 | |
22-
| Sagemcom F@st 3890V3 | Delta / Zeelandnet | sha512 | |
23-
| Sagemcom F@st 3890V3 | DNA (DNA Mesh Wifi F-3890) | sha512 | "Not allowed to set AdvancedMode parameter on your device", username: admin |
24-
| Sagemcom F@st 3896 | | sha512 | username: admin |
25-
| Sagemcom F@st 4360Air | KPN | md5 | |
26-
| Sagemcom F@st 4353 | Belong Gateway | md5 | username: admin, password: "" |
27-
| Sagemcom F@st 5250 | Bell (Home Hub 2000) | md5 | username: guest, password: "" |
28-
| Sagemcom F@st 5280 | | sha512 | |
29-
| Sagemcom F@st 5290 / FWR226e | Frontier | md5 | username: admin |
30-
| Sagemcom F@st 5359 | KPN (Box 12) | sha512 | username: admin |
31-
| Sagemcom F@st 5364 | BT (Smart Hub) | md5 | username: guest, password: "" |
32-
| SagemCom F@st 5366SD | Eir F3000 | md5 | |
33-
| Sagemcom F@st 5370e | Telia | sha512 | |
34-
| Sagemcom F@st 5380 | TDC | md5 | |
35-
| Sagemcom F@st 5566 | Bell (Home Hub 3000) | md5 | username: guest, password: "" |
36-
| Sagemcom F@st 5688T | Salt (FibreBox_X6) | sha512 | username: admin |
37-
| Sagemcom F@st 5689 | Bell (Home Hub 4000) | md5 | username: admin, password: "" |
38-
| Sagemcom F@st 5655V2 | MásMóvil | md5 | |
39-
| Sagemcom F@st 5657IL | | md5 | |
40-
| Speedport Pro | Telekom | md5 | username: admin |
18+
| Router Model | Provider(s) | Authentication Method | Comments |
19+
| ---------------------------- | -------------------------- | --------------------- | ----------------------------- |
20+
| Sagemcom F@st 3864 | Optus | sha512 | username: guest, password: "" |
21+
| Sagemcom F@st 3865b | Proximus (b-box3) | md5 | |
22+
| Sagemcom F@st 3890V3 | Delta / Zeelandnet | sha512 | |
23+
| Sagemcom F@st 3890V3 | DNA (DNA Mesh Wifi F-3890) | sha512 | username: admin |
24+
| Sagemcom F@st 3896 | | sha512 | username: admin |
25+
| Sagemcom F@st 4360Air | KPN | md5 | |
26+
| Sagemcom F@st 4353 | Belong Gateway | md5 | username: admin, password: "" |
27+
| Sagemcom F@st 5250 | Bell (Home Hub 2000) | md5 | username: guest, password: "" |
28+
| Sagemcom F@st 5280 | | sha512 | |
29+
| Sagemcom F@st 5290 / FWR226e | Frontier | md5 | username: admin |
30+
| Sagemcom F@st 5359 | KPN (Box 12) | sha512 | username: admin |
31+
| Sagemcom F@st 5364 | BT (Smart Hub) | md5 | username: guest, password: "" |
32+
| SagemCom F@st 5366SD | Eir F3000 | md5 | |
33+
| Sagemcom F@st 5370e | Telia | sha512 | |
34+
| Sagemcom F@st 5380 | TDC | md5 | |
35+
| Sagemcom F@st 5566 | Bell (Home Hub 3000) | md5 | username: guest, password: "" |
36+
| Sagemcom F@st 5688T | Salt (FibreBox_X6) | sha512 | username: admin |
37+
| Sagemcom F@st 5689 | Bell (Home Hub 4000) | md5 | username: admin, password: "" |
38+
| Sagemcom F@st 5689E | Bell (Giga Hub) | sha512 | username: admin, password: "" |
39+
| Sagemcom F@st 5690 | Bell (Giga Hub) | sha512 | username: admin, password: "" |
40+
| Sagemcom F@st 5655V2 | MásMóvil | md5 | |
41+
| Sagemcom F@st 5657IL | | md5 | |
42+
| Speedport Pro | Telekom | md5 | username: admin |
4143

4244
> Contributions welcome. If you router model is supported by this package, but not in the list above, please create [an issue](https://github.com/iMicknl/python-sagemcom-api/issues/new) or pull request.
4345
@@ -158,6 +160,12 @@ session = ClientSession(timeout=ClientTimeout(100))
158160
client = SagemcomClient(session=session)
159161
```
160162

163+
### Debugging
164+
165+
- Unable to login (XMO_AUTHENTICATION_ERR)
166+
167+
See [advanced instructions for debugging](docs/debugging.md) common issues.
168+
161169
## Inspired by
162170

163171
- [wuseman/SAGEMCOM-FAST-5370e-TELIA](https://github.com/wuseman/SAGEMCOM-FAST-5370e-TELIA)

0 commit comments

Comments
 (0)