espnetlink-fw

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #android #machine-learning #rust #docker #macos #nodejs #windows #awesome-list #security #mcp

(★ 14)

No description available.

espnetlink-fw Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ESPNetLink

## Table of Contents

1. [Flashing the Firmware](#1-flashing-the-firmware)
   - 1.1 [Requirements](#11-requirements)
   - 1.2 [Flashing with esptool-js (Web Browser)](#12-flashing-with-esptool-js-web-browser)
   - 1.3 [Flashing with esptool (Command Line)](#13-flashing-with-esptool-command-line)
2. [CLI Command Reference](#2-cli-command-reference)
   - 2.1 [General](#21-general)
   - 2.2 [System](#22-system)
   - 2.3 [Network](#23-network)
   - 2.4 [LTE](#24-lte)
   - 2.5 [GPS](#25-gps)
   - 2.6 [AGNSS](#26-agnss)
   - 2.7 [Power / Sleep](#27-power--sleep)

---

## 1. Flashing the Firmware

### 1.1 Requirements

Download the latest release files from the [Releases](../../releases) page. You will need these four files:

| File | Flash Address |
|------|--------------|
| `bootloader.bin` | `0x0` |
| `partition-table.bin` | `0x8000` |
| `ota_data_initial.bin` | `0x29000` |
| `espnetlink-fw_vXXX.bin` | `0x30000` |

### 1.2 Flashing with esptool-js (Web Browser)

1. Open [https://espressif.github.io/esptool-js/](https://espressif.github.io/esptool-js/) in a Chrome-based browser.
2. Set **Baudrate** to `460800`.
3. Click **Connect** and select your ESP32-S3 COM port.
4. Under **Flash Address**, add each file with its corresponding address:

| Flash Address | File |
   |--------------|------|
   | `0x0` | `bootloader.bin` |
   | `0x8000` | `partition-table.bin` |
   | `0x29000` | `ota_data_initial.bin` |
   | `0x30000` | `espnetlink-fw_vXXX.bin` |

5. Click **Program** and wait for flashing to complete.
6. Reset the device when prompted.

### 1.3 Flashing with esptool (Command Line)

```bash
python esptool.py -p <PORT> -b 460800 \
  --before default_reset --after hard_reset \
  --chip esp32s3 write_flash \
  --flash_mode dio --flash_freq 80m --flash_size detect \
  0x0      bootloader/bootloader.bin \
  0x8000   partition_table/partition-table.bin \
  0x29000  ota_data_initial.bin \
  0x30000  espnetlink-fw_vXXX.bin
```

Replace `<PORT>` with your serial port (e.g., `COM10` on Windows, `/dev/ttyUSB0` on Linux).

---

## 2. CLI Command Reference

The device exposes a USB CDC-ACM serial console. Connect at any baud rate and type commands.

### 2.1 General

| Command | Description |
|---------|-------------|
| `ver` | Print firmware version and ESP-IDF version |
| `echo 0\|1` | Get or set device-side input echo |
| `debug 0\|1` | Get or set global log output (0 = off, 1 = debug) |

### 2.2 System

```
system -v                  Print firmware version string
system -i                  Print chip model, CPU cores, free heap, MAC address
system -s <unix_timestamp> Set system time (UTC); also triggers AGNSS time injection
reboot                     Cleanly stop LTE/PPP stack then reboot
```

### 2.3 Network

```
ping [ip] [-c count] [-i interval_ms]
    ICMP ping an IP address.
    Default target: 8.8.8.8, count: 4, interval: 1000 ms

speedtest [-d] [-u] [-b <bytes>]
    LTE throughput test via Cloudflare (speed.cloudflare.com).
    (no flags)  download + upload
    -d          download only
    -u          upload only
    -b <n>      bytes to download (default 102400); upload uses half
```

### 2.4 LTE

```
lte -s   Full modem status
lte -r   Signal quality (RSSI / BER)
lte -n   Network attachment state
lte -p   PPP connection status
lte -o   Operator name
lte -i   Current IP address
lte -q   Radio quality + PSM / eDRX power-saving state
lte -j   All parameters as JSON
```

### 2.5 GPS

```
gps -p [-j]    Print current fix (add -j for JSON output)
gps -s         Stream raw NMEA sentences to the console
gps -t [0|1]   Enable (1) or disable (0) NMEA passthrough mode
gps -c         Check GPS UART health
```

### 2.6 AGNSS

Assisted GNSS speeds up time-to-first-fix by injecting cached time and position into the GPS module.

```
agnss -s             Show AGNSS enabled state, injection status, and cached position
agnss -v             Save current EASY navigation data to NVS
agnss -e             Enable AGNSS (takes effect on next boot)
agnss -d             Disable AGNSS (takes effect on next boot)
agnss -i             Get current cache interval (seconds)
agnss -i <seconds>   Set cache interval (minimum 10 s)
```

### 2.7 Power / Sleep

```
sleep 1              Light sleep: power off GPS and LTE, keep USB active.
                     Resume with the 'wake' command.

sleep 2 [secs]       Deep sleep: power off everything including USB.
                     Wake on timer (if seconds given) or reset button.

sleep 3              Deep sleep: USB mux off, wake on WAKE_GPIO pin (active-low).

sleep 4 [thresh]     Deep sleep: wake on IMU motion (Wake-on-Motion).
                     thresh = acceleration threshold in mg, 1–255 (default 50).

wake                 Wake from sleep mode 1 (reboots to re-initialise peripherals).
```

espnetlink-fw

espnetlink-fw Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

espnetlink-fw

espnetlink-fw Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README