meshtastic/docs/software/python/using_library.mdx

88 lines
2.8 KiB
Plaintext
Raw Normal View History

2021-04-28 14:38:14 -07:00
---
id: python-using-library
title: using the Meshtastic-python library
sidebar_label: Using the meshtastic Python library
2021-04-28 14:38:14 -07:00
---
An example using Python 3 code to send a message to the mesh, get and set a radio configuration preference:
2022-03-08 23:51:46 -08:00
2021-04-28 14:38:14 -07:00
```python
import meshtastic
2021-12-22 15:58:04 -08:00
import meshtastic.serial_interface
# By default will try to find a meshtastic device,
# otherwise provide a device path like /dev/ttyUSB0
2021-12-22 15:58:04 -08:00
interface = meshtastic.serial_interface.SerialInterface()
# or something like this
# interface = meshtastic.serial_interface.SerialInterface(devPath='/dev/cu.usbmodem53230050571')
2021-12-22 15:58:04 -08:00
# or sendData to send binary data, see documentations for other options.
interface.sendText("hello mesh")
ourNode = interface.getNode('^local')
print(f'Our node preferences:{ourNode.radioConfig.preferences}')
# update a value
print('Changing a preference...')
ourNode.radioConfig.preferences.gps_update_interval = 60
print(f'Our node preferences now:{ourNode.radioConfig.preferences}')
ourNode.writeConfig()
2021-04-28 14:38:14 -07:00
interface.close()
```
2021-11-22 19:24:18 -08:00
Another example using Python 3 code to send a message to the mesh when WiFi is enabled:
2022-03-08 23:51:46 -08:00
2021-11-22 19:24:18 -08:00
```python
import time
import meshtastic
2021-12-21 11:25:57 -08:00
import meshtastic.tcp_interface
2021-11-22 19:24:18 -08:00
from pubsub import pub
def onReceive(packet, interface): # called when a packet arrives
print(f"Received: {packet}")
def onConnection(interface, topic=pub.AUTO_TOPIC): # called when we (re)connect to the radio
# defaults to broadcast, specify a destination ID if you wish
interface.sendText("hello mesh")
pub.subscribe(onReceive, "meshtastic.receive")
pub.subscribe(onConnection, "meshtastic.connection.established")
2021-12-21 11:25:57 -08:00
interface = meshtastic.tcp_interface.TCPInterface(hostname='192.168.68.74')
2021-11-22 19:24:18 -08:00
while True:
time.sleep(1000)
interface.close()
```
Note: Be sure to change the IP address in the code above to a valid IP address for your setup.
2021-11-22 19:24:18 -08:00
You can get and update settings like this:
2022-03-08 23:51:46 -08:00
```python
import meshtastic
2021-12-21 11:25:57 -08:00
import meshtastic.serial_interface
interface = meshtastic.serial_interface.SerialInterface()
ourNode = interface.getNode('^local')
print(ourNode.radioConfig.preferences)
ourNode.radioConfig.preferences.gps_update_interval = 60
print(ourNode.radioConfig.preferences)
ourNode.writeConfig()
interface.close()
```
For the rough notes/implementation plan see [TODO](https://github.com/meshtastic/Meshtastic-python/blob/master/TODO). See the API for full details of how to use the library.
2021-04-28 14:38:14 -07:00
## A note to developers of this lib
2022-03-08 23:51:46 -08:00
We use the visual-studio-code default python formatting conventions (autopep8). So if you use that IDE you should be able to use "Format Document" and not generate unrelated diffs. If you use some other editor, please don't change formatting on lines you haven't changed.
2021-04-28 14:38:14 -07:00
If you need to build a new release you'll need:
2022-03-08 23:51:46 -08:00
```shell title="Command"
2021-04-28 14:38:14 -07:00
apt install pandoc
sudo pip3 install markdown pandoc webencodings pyparsing twine autopep8
2021-11-22 19:24:18 -08:00
```