mirror of
https://github.com/meshtastic/meshtastic.git
synced 2025-02-21 03:25:51 -08:00
Introduce meshtasticd logo as "header". (#1717)
* add images * add readme with section 7e restrictions * update linux native to use image as header
This commit is contained in:
rcarteraz
GitHub
parent
8eed247f4f
commit
a9202e3418
|
|
@ -1,12 +1,27 @@
|
|||
---
|
||||
id: linux-native-hardware
|
||||
title: Meshtastic on Linux-Native Devices
|
||||
hide_title: true
|
||||
sidebar_label: Linux Native Devices
|
||||
sidebar_position: 11
|
||||
description: Set up and configure Meshtastic on Linux-native devices using the meshtasticd binary.
|
||||
---
|
||||
|
||||
import LinuxInstall from "@site/docs/blocks/_linux-install.mdx";
|
||||
import { Dark, Light } from "/src/components/ColorMode";
|
||||
|
||||
<Dark>
|
||||
<img
|
||||
src="/img/meshtasticd/Meshtasticd-Terminal-Long_Dark.svg"
|
||||
alt="Meshtasticd Terminal Dark"
|
||||
/>
|
||||
</Dark>
|
||||
<Light>
|
||||
<img
|
||||
src="/img/meshtasticd/Meshtasticd-Terminal-Long_Light.svg"
|
||||
alt="Meshtasticd Terminal Light"
|
||||
/>
|
||||
</Light>
|
||||
|
||||
This page outlines the setup of Meshtastic on Linux-native devices, utilizing portduino to run the Meshtastic firmware under Linux.
|
||||
|
||||
|
|
@ -31,6 +46,7 @@ Before proceeding with the setup, ensure the device meets the following requirem
|
|||
### Hardware Compatibility
|
||||
|
||||
:::caution Warning
|
||||
|
||||
- **UART** HATs and SX1302/SX1303 chip-based HATs are not supported. Only hats that use a SPI radio can work with Meshtastic.
|
||||
- The Waveshare SX1262 LoRaWAN Hat for Raspberry Pi is not recommended for deployment. It has known hardware limitations that may affect longer messages. If you must use it, please use the **CLIENT_MUTE** role to avoid rebroadcasting.
|
||||
- The Pine64 Pinedio is also not recommended for deployment, as it suffers from similar hardware limitations as the Waveshare SX1262 LoRaWAN Hat.
|
||||
|
|
@ -183,40 +199,41 @@ To configure the device to start and stop meshtasticd as as service using system
|
|||
<details>
|
||||
<summary>Create the systemd service (only for manual installs)</summary>
|
||||
|
||||
The `meshtasticd` systemd service is automatically installed when using the official Meshtastic packages.
|
||||
These instructions are only needed when installing manually.
|
||||
The `meshtasticd` systemd service is automatically installed when using the official Meshtastic packages.
|
||||
These instructions are only needed when installing manually.
|
||||
|
||||
Create the service unit file:
|
||||
Create the service unit file:
|
||||
|
||||
Create a new file in the /etc/systemd/system/ directory with a name like meshtasticd.service.
|
||||
Create a new file in the /etc/systemd/system/ directory with a name like meshtasticd.service.
|
||||
|
||||
```shell
|
||||
sudo nano /etc/systemd/system/meshtasticd.service
|
||||
```
|
||||
```shell
|
||||
sudo nano /etc/systemd/system/meshtasticd.service
|
||||
```
|
||||
|
||||
Add the following content to the file:
|
||||
Add the following content to the file:
|
||||
|
||||
```plaintext
|
||||
[Unit]
|
||||
Description=Meshtastic Daemon
|
||||
After=network.target
|
||||
```plaintext
|
||||
[Unit]
|
||||
Description=Meshtastic Daemon
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
ExecStart=/usr/sbin/meshtasticd
|
||||
Restart=always
|
||||
User=root
|
||||
Group=root
|
||||
Type=simple
|
||||
[Service]
|
||||
ExecStart=/usr/sbin/meshtasticd
|
||||
Restart=always
|
||||
User=root
|
||||
Group=root
|
||||
Type=simple
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
Reload systemd to recognize the new service:
|
||||
Reload systemd to recognize the new service:
|
||||
|
||||
```shell
|
||||
sudo systemctl daemon-reload
|
||||
```
|
||||
|
||||
```shell
|
||||
sudo systemctl daemon-reload
|
||||
```
|
||||
</details>
|
||||
|
||||
Enable the service to start on boot:
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 5.8 KiB |
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" id="Layer_1" data-name="Layer 1" viewBox="0 0 1000 152.05"><defs><style>.cls-1{fill:#2c2d3c;stroke-width:0}</style></defs><metadata><rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description><dc:title>Meshtasticd Terminal Long Light</dc:title><dc:creator>Meshtastic LLC</dc:creator><dc:rights>Copyright © 2025 Meshtastic. All rights reserved.</dc:rights><dc:source>https://github.com/meshtastic/meshtastic/tree/master/docs/hardware/devices/linux-native-hardware/README.md</dc:source></rdf:Description></rdf:RDF></metadata><path d="M21.488 108.854 70.42 36.88l8.526 5.797-48.93 71.972zm662.572-.09 48.313-71.038 8.864 6.029-48.313 71.038zM182.4 115.18V37.32h56.19v9.24H192.7v23.81h42.96v9.13H192.7v26.53h47.62v9.13h-57.93Zm68.66-25.01 9.65-.87c.54 3.91 1.52 7.07 3.25 9.57 1.63 2.5 4.23 4.57 7.81 6.09 3.47 1.52 7.49 2.28 11.93 2.28 3.91 0 7.38-.54 10.31-1.74 3.04-1.2 5.32-2.72 6.73-4.78 1.52-2.07 2.17-4.24 2.17-6.63s-.65-4.57-2.06-6.42-3.8-3.37-7.05-4.57c-2.06-.87-6.62-2.17-13.78-3.81q-10.74-2.61-14.97-4.89c-3.69-1.96-6.51-4.35-8.35-7.29-1.74-2.83-2.71-6.09-2.71-9.68 0-3.91 1.19-7.61 3.36-10.98 2.28-3.37 5.42-5.98 9.76-7.83 4.23-1.74 9-2.61 14.21-2.61 5.75 0 10.85.98 15.3 2.83 4.34 1.85 7.7 4.57 10.09 8.16s3.69 7.72 3.8 12.29l-9.87.76c-.43-5-2.28-8.7-5.32-11.2s-7.59-3.81-13.56-3.81-10.74 1.2-13.56 3.48-4.23 5-4.23 8.26c0 2.83.98 5.11 2.93 6.85 2.06 1.85 7.16 3.7 15.51 5.55 8.35 1.96 14.1 3.59 17.25 5 4.45 2.07 7.81 4.78 9.98 7.94 2.17 3.26 3.25 6.85 3.25 11.09s-1.19 8.05-3.58 11.74c-2.39 3.59-5.75 6.42-10.2 8.48-4.45 2.07-9.44 3.04-14.97 3.04-7.05 0-12.91-.98-17.68-3.04-4.77-2.07-8.46-5.11-11.17-9.24s-4.12-8.81-4.23-14.03Zm76.16 25.01V37.32h10.31v31.97h40.35V37.32h10.31v77.86h-10.31V78.53h-40.35v36.65zm97.75 0V46.57h-25.6v-9.24h61.62v9.24h-25.71v68.62h-10.31Zm-349.05-.8-8.39-5.72 46.84-68.7a5.07 5.07 0 0 1 4.19-2.22c1.68 0 3.24.83 4.19 2.21l46.95 68.59-8.38 5.74-42.75-62.45-42.66 62.55Zm384.14 1.1-8.39-5.72 46.84-68.7a5.07 5.07 0 0 1 4.19-2.22c1.68 0 3.24.83 4.19 2.21l46.95 68.59-8.38 5.74-42.75-62.45-42.65 62.56Zm100.89-25.07 9.65-.87c.54 3.91 1.52 7.07 3.25 9.57 1.63 2.5 4.23 4.57 7.81 6.09 3.47 1.52 7.49 2.28 11.93 2.28 3.91 0 7.38-.54 10.31-1.74 3.04-1.2 5.32-2.72 6.73-4.78 1.52-2.07 2.17-4.24 2.17-6.63s-.65-4.57-2.06-6.42-3.8-3.37-7.05-4.57c-2.06-.87-6.62-2.17-13.78-3.81q-10.74-2.61-14.97-4.89c-3.69-1.96-6.51-4.35-8.35-7.29-1.74-2.83-2.71-6.09-2.71-9.68 0-3.91 1.19-7.61 3.36-10.98 2.28-3.37 5.42-5.98 9.76-7.83 4.23-1.74 9-2.61 14.21-2.61 5.75 0 10.85.98 15.3 2.83 4.34 1.85 7.7 4.57 10.09 8.16s3.69 7.72 3.8 12.29l-9.87.76c-.43-5-2.28-8.7-5.32-11.2s-7.59-3.81-13.56-3.81-10.74 1.2-13.56 3.48-4.23 5-4.23 8.26c0 2.83.98 5.11 2.93 6.85 2.06 1.85 7.16 3.7 15.51 5.55 8.35 1.96 14.1 3.59 17.25 5 4.45 2.07 7.81 4.78 9.98 7.94 2.17 3.26 3.25 6.85 3.25 11.09s-1.19 8.05-3.58 11.74c-2.39 3.59-5.75 6.42-10.2 8.48-4.45 2.07-9.44 3.04-14.97 3.04-7.05 0-12.91-.98-17.68-3.04-4.77-2.07-8.46-5.11-11.17-9.24s-4.12-8.81-4.23-14.03Zm95.57 25.01V46.8h-25.6v-9.24h61.62v9.24h-25.71v68.62zm147.99-27.05 10.31 2.61c-2.17 8.48-6.07 14.9-11.72 19.36-5.53 4.46-12.37 6.63-20.5 6.63s-15.19-1.63-20.39-5.11c-5.21-3.37-9.22-8.37-11.93-14.79-2.82-6.52-4.12-13.48-4.12-20.88 0-8.16 1.52-15.22 4.66-21.2 3.04-6.09 7.49-10.66 13.13-13.81 5.75-3.15 12.04-4.68 18.88-4.68 7.7 0 14.32 1.96 19.53 5.98 5.32 3.91 9 9.46 11.06 16.64l-10.09 2.39c-1.74-5.65-4.45-9.79-7.81-12.29-3.47-2.61-7.7-3.91-12.91-3.91-5.97 0-10.96 1.41-14.97 4.35-4.01 2.83-6.83 6.63-8.46 11.53-1.63 4.78-2.5 9.79-2.5 14.9 0 6.63.98 12.4 2.93 17.4 1.95 4.89 4.88 8.59 9 10.98 4.01 2.5 8.46 3.7 13.13 3.7 5.75 0 10.63-1.63 14.64-5 4.01-3.26 6.73-8.26 8.14-14.79Zm160.03-68.66H853.19c-7.72 0-13.98 6.26-13.98 13.98v84.67c0 7.72 6.26 13.98 13.98 13.98h111.35c7.72 0 13.98-6.26 13.98-13.98V33.69c0-7.72-6.26-13.98-13.98-13.98m2.89 94.73c0 4.47-3.62 8.09-8.09 8.09H858.39c-4.47 0-8.09-3.62-8.09-8.09V37.6c0-4.47 3.62-8.09 8.09-8.09h100.95c4.47 0 8.09 3.62 8.09 8.09z" class="cls-1"/><path d="M905.17 49.03h21.76c3.71 0 7.06.63 10.05 1.88 2.98 1.25 5.53 3 7.64 5.23s3.73 4.87 4.86 7.9c1.13 3.04 1.69 6.36 1.69 9.97s-.56 6.86-1.69 9.9-2.74 5.67-4.82 7.9-4.63 3.98-7.64 5.23-6.37 1.88-10.09 1.88h-21.76V49.01Zm21.53 41.85q3.69 0 6.51-1.32c1.88-.88 3.45-2.07 4.7-3.58s2.21-3.29 2.86-5.34c.65-2.06.98-4.27.98-6.62s-.33-4.58-.98-6.66-1.61-3.89-2.86-5.42-2.82-2.73-4.7-3.61q-2.82-1.32-6.51-1.32h-13.32l.9-.9v35.68l-.9-.9h13.32Zm-60.12-.72 16.18-16.18-16.18-16.18 8.09-8.09 22.5 22.5c.98.98.98 2.56 0 3.53l-22.5 22.5-8.09-8.09Z" class="cls-1"/></svg>
|
||||
|
After Width: | Height: | Size: 4.5 KiB |
1
static/img/meshtasticd/Meshtasticd-Tux-Penguin.svg
Normal file
1
static/img/meshtasticd/Meshtasticd-Tux-Penguin.svg
Normal file
|
|
@ -0,0 +1 @@
|
|||
<svg xmlns="http://www.w3.org/2000/svg" id="Layer_1" data-name="Layer 1" viewBox="0 0 390.7 390.7"><metadata><rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"><rdf:Description><dc:title>Meshtasticd Tux Penguin</dc:title><dc:creator>Meshtastic LLC</dc:creator><dc:contributor>Original Tux created by Larry Ewing (lewing@isc.tamu.edu) using GIMP (https://www.gimp.org)</dc:contributor><dc:rights>Copyright © 2025 Meshtastic. All rights reserved.</dc:rights><dc:source>https://github.com/meshtastic/meshtastic/tree/master/docs/hardware/devices/linux-native-hardware/README.md</dc:source></rdf:Description></rdf:RDF></metadata><defs><style>.cls-1,.cls-3{fill:#2c2d3c;stroke-width:0}.cls-3{fill:#e8c169}</style></defs><path d="m169.606 84.788 26.573-26.573 26.573 26.573-26.573 26.573z" class="cls-3"/><path d="m247.99 83.55-.97 25.21-50.84-47.65-50.84 47.65-.97-25.17a53.26 53.26 0 0 1 15.61-37.68l.06-.06c19.81-19.81 51.86-19.99 71.89-.42a53.3 53.3 0 0 1 16.05 38.12Z" class="cls-1"/><path d="M192.36 314.21 91.8 359.62h206.76z" class="cls-3"/><path d="m93.47 272.46 102.78 87.36 102.65-86.4-51.81-153.57.27 142.36c.05 28.27-22.85 51.22-51.13 51.22-28.26 0-51.16-22.93-51.13-51.19l.17-143.36-51.81 153.57Z" class="cls-1"/><path d="M226.29 160.34H166.9c-2.73 0-4.95 2.22-4.95 4.95v49.49c0 2.73 2.22 4.95 4.95 4.95h59.39c2.73 0 4.95-2.22 4.95-4.95v-49.49c0-2.73-2.22-4.95-4.95-4.95" class="cls-1"/><path d="m169.426 201.662 17.93-26.373 3.126 2.125-17.93 26.373zm19.954 2.048-3.08-2.1 17.16-25.17a1.87 1.87 0 0 1 3.08 0l17.2 25.13-3.07 2.1-15.66-22.88z" style="stroke-width:0;fill:#fff"/></svg>
|
||||
|
After Width: | Height: | Size: 1.6 KiB |
9
static/img/meshtasticd/README.md
Normal file
9
static/img/meshtasticd/README.md
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
# Copyright Notice
|
||||
|
||||
Copyright © 2025 Meshtastic LLC. All Rights Reserved.
|
||||
|
||||
## Restrictions on Asset Usage (GNU GPLv3 Section 7e)
|
||||
|
||||
The images and assets contained in this directory are protected by international copyright laws and treaties.
|
||||
|
||||
As permitted under GPLv3 Section 7(e), unauthorized reproduction, distribution, modification, or use of these assets, in any form—commercial or otherwise—outside of official Meshtastic creative works or by Meshtastic Backers and Partners, is strictly prohibited without prior written consent from Meshtastic LLC.
|
||||
Loading…
Reference in a new issue