From a9202e34181f335246871f80390575a22bcec0fe Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Mon, 17 Feb 2025 09:05:20 -0700 Subject: [PATCH] Introduce meshtasticd logo as "header". (#1717) * add images * add readme with section 7e restrictions * update linux native to use image as header --- .../linux-native-hardware.mdx | 67 ++++++++++++------- .../Meshtasticd-Terminal-Long_Dark.svg | 1 + .../Meshtasticd-Terminal-Long_Light.svg | 1 + .../meshtasticd/Meshtasticd-Tux-Penguin.svg | 1 + static/img/meshtasticd/README.md | 9 +++ 5 files changed, 54 insertions(+), 25 deletions(-) create mode 100644 static/img/meshtasticd/Meshtasticd-Terminal-Long_Dark.svg create mode 100644 static/img/meshtasticd/Meshtasticd-Terminal-Long_Light.svg create mode 100644 static/img/meshtasticd/Meshtasticd-Tux-Penguin.svg create mode 100644 static/img/meshtasticd/README.md diff --git a/docs/hardware/devices/linux-native-hardware/linux-native-hardware.mdx b/docs/hardware/devices/linux-native-hardware/linux-native-hardware.mdx index 1fed8666..93abaa6f 100644 --- a/docs/hardware/devices/linux-native-hardware/linux-native-hardware.mdx +++ b/docs/hardware/devices/linux-native-hardware/linux-native-hardware.mdx @@ -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"; + + + Meshtasticd Terminal Dark + + + Meshtasticd Terminal 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
Create the systemd service (only for manual installs) - 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 - ```
Enable the service to start on boot: diff --git a/static/img/meshtasticd/Meshtasticd-Terminal-Long_Dark.svg b/static/img/meshtasticd/Meshtasticd-Terminal-Long_Dark.svg new file mode 100644 index 00000000..8f9fe48e --- /dev/null +++ b/static/img/meshtasticd/Meshtasticd-Terminal-Long_Dark.svg @@ -0,0 +1 @@ +Meshtasticd Terminal Long DarkMeshtastic LLCCopyright © 2025 Meshtastic. All rights reserved.https://github.com/meshtastic/meshtastic/tree/master/docs/hardware/devices/linux-native-hardware/README.md \ No newline at end of file diff --git a/static/img/meshtasticd/Meshtasticd-Terminal-Long_Light.svg b/static/img/meshtasticd/Meshtasticd-Terminal-Long_Light.svg new file mode 100644 index 00000000..af89a677 --- /dev/null +++ b/static/img/meshtasticd/Meshtasticd-Terminal-Long_Light.svg @@ -0,0 +1 @@ +Meshtasticd Terminal Long LightMeshtastic LLCCopyright © 2025 Meshtastic. All rights reserved.https://github.com/meshtastic/meshtastic/tree/master/docs/hardware/devices/linux-native-hardware/README.md \ No newline at end of file diff --git a/static/img/meshtasticd/Meshtasticd-Tux-Penguin.svg b/static/img/meshtasticd/Meshtasticd-Tux-Penguin.svg new file mode 100644 index 00000000..c902fb50 --- /dev/null +++ b/static/img/meshtasticd/Meshtasticd-Tux-Penguin.svg @@ -0,0 +1 @@ +Meshtasticd Tux PenguinMeshtastic LLCOriginal Tux created by Larry Ewing (lewing@isc.tamu.edu) using GIMP (https://www.gimp.org)Copyright © 2025 Meshtastic. All rights reserved.https://github.com/meshtastic/meshtastic/tree/master/docs/hardware/devices/linux-native-hardware/README.md \ No newline at end of file diff --git a/static/img/meshtasticd/README.md b/static/img/meshtasticd/README.md new file mode 100644 index 00000000..857bddee --- /dev/null +++ b/static/img/meshtasticd/README.md @@ -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.