Lightweight Python 3.5+ async library to control Nextion displays.
pip install nextion
import asyncio
import logging
import random
from nextion import Nextion, EventType
def event_handler(type_, data):
if type_ == EventType.STARTUP:
print('We have booted up!')
logging.info('Event %s data: %s', type, str(data))
async def run():
client = Nextion('/dev/ttyS1', 9600, event_handler)
await client.connect()
# await client.sleep()
# await client.wakeup()
# await client.command('sendxy=0')
print(await client.get('sleep'))
print(await client.get('field1.txt'))
await client.set('field1.txt', "%.1f" % (random.randint(0, 1000) / 10))
await client.set('field2.txt', "%.1f" % (random.randint(0, 1000) / 10))
await client.set('field3.txt', random.randint(0, 100))
print('finished')
if __name__ == '__main__':
logging.basicConfig(
format='%(asctime)s - %(levelname)s - %(message)s',
level=logging.DEBUG,
handlers=[
logging.StreamHandler()
])
loop = asyncio.get_event_loop()
asyncio.ensure_future(run())
loop.run_forever()url: str # serial dev
baudrate: int # baud rate
event_handler: typing.Callable[[EventType, any], None] # Event handler function
loop=asyncio.get_event_loop() # your own event loop
reconnect_attempts: int = 3 # how many times to try to retry command in case of failure
encoding: str = 'ascii' # Nextion encoding
You can update encoding on fly (This changes encoding of serial communication only):
client.encoding = 'latin-1'
Get current set encoding (Not fetched from the device)
print(client.encoding)
event_handler method in the example above will be called on every event comming from the display.
| EventType | Data | Data attributes |
|---|---|---|
| TOUCH | TouchDataPayload | page_id, component_id, touch_event |
| TOUCH_COORDINATE | TouchCoordinateDataPayload | x, y, touch_event |
| TOUCH_IN_SLEEP | TouchCoordinateDataPayload | x, y, touch_event |
| AUTO_SLEEP | None | - |
| AUTO_WAKE | None | - |
| STARTUP | None | - |
| SD_CARD_UPGRADE | None | - |
For some components in the Nextion Editor you need to check Send Component ID for required event.
If you installed the library you should have nextion-fw-upload command in your PATH.
nextion-fw-upload -hOtherwise use next command in the root of the project:
python -m nextion.console_scripts.upload_firmware -hUsage (check with option -h)
usage: nextion-fw-upload [-h]
[-b {2400,4800,9600,19200,38400,57600,115200,230400}]
[-ub {2400,4800,9600,19200,38400,57600,115200,230400}]
[-v]
device file
positional arguments:
device device serial port
file firmware file *.tft
optional arguments:
-h, --help show this help message and exit
-b {2400,4800,9600,19200,38400,57600,115200,230400}, --baud {2400,4800,9600,19200,38400,57600,115200,230400}
baud rate
-ub {2400,4800,9600,19200,38400,57600,115200,230400}, --upload_baud {2400,4800,9600,19200,38400,57600,115200,230400}
upload baud rate
-v, --verbose output debug messages
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent