Package: dweet2ser
dweet2serA serial <-> dweet.io interfacedweet2ser allows for the two-way exchange of data between serial devices and computers over the internet,
using the freedweet.ioAPI as an intermediary.
This is particularly useful for connecting to faraway devices that aren't on the same LAN.
dweet2ser allows for connecting an arbitrary number of devices to an arbitrary number of computers.dweet2ser works for connecting remotely to things like weather stations, sensors, or other devices that send
simple data intermittently. It is not going to work for things like modems or printers, due to the limitations of
dweet.io among other things.InstallationPython environmentpip install dweet2serWindows executableIf you don't have or don't wish to use a Python environment, a Windows executable version is available on the source
repository on GitHub.Get the sourceThe source code is always available athttps://github.com/zhenry9/dweet2ser.ConfigurationModifyconfig.inito suit your needs, or configure interactively using the prompts in the software. Some example
configurations can be seen in the example-configs directory in the project repository.Usagedweet2ser borrows terminology from the original RS232 protocol. "DCE" stands for Data Circuit-terminating Equipment. These
are the serial devices themselves, such as sensors or synchronized timers. "DTE" stands for Data Terminal Equipment.
These are the computers, or software instances that the DCE devices connect to. dweet2ser facilitates the connection of
DCE devices to DTE devices using dweet.io and local serial ports. Every message received from a DCE device is written to
every DTE device, and every message received from a DTE device is written to every DCE device. dweet2ser allows for
connecting an arbitrary number of devices, either local or remote. In this way it is possible to connect one DCE device
to many computers, or many DCE devices to one serial port.dweet2ser needs to be running and individually configured on all DTE and DCE devices that are part of the connection.Defaultdweet2serThis starts dweet2ser with a web interface onlocalhost:5000.
If dweet2ser is run without command line options, it will attempt to load devices from the default config file. This
will be '~/.config/dweet2ser/config.ini', or '/etc/dweet2ser/config.ini' if run as superuser.
If you are running dweet2ser for the first time or with an empty config file, no devices will be loaded. You can add
devices interactively using the web interface.CLIdweet2ser --nowebuiThis will load dweet2ser with a command line interface only, whithout the web interface.
Configuration can be done interactively from the command line.Emptydweet2ser --emptyThis will ignore the default config file and start dweet2ser without any devices loaded. This is useful for fixing bad
config files, or creating new ones from scratch.From filedweet2ser --file FILENAMEThis will attempt to start dweet2ser by loading the devices specified in an arbitrary config file at FILENAME.Overridedweet2ser --override MODE PORT THING_NAMEThis allows dweet2ser to be configured for a simple connection directly from the command line. MODE is the type of device
connected to the local serial port PORT, either DCE or DTE. THING_NAME is the dweet.io name of the device on the other
side of the connection. For example, to set up a connection to a DCE device connected to a Raspberry Pi:dweet2ser --override DCE /dev/ttyUSB0 dweet2ser_defaultThis starts dweet2ser listening for messages from a DCE device on Linux port '/dev/ttyUSB0'. Any messages it receives will
be sent to dweet.io using the thing name 'dweet2ser_default'. It will also listen for incoming messages from
'dweet2ser_default', and write them to the serial port.To set up the same connection on the DTE side:dweet2ser --override DTE COM20 dweet2ser_defaultThis will listen for dweet.io messages from 'dweet2ser_default' and write them to the Windows port 'COM20'. It will also
send any messages received from 'COM20' to dweet.io using the name 'dweet2ser_default'.Display help pagedweet2ser --helpThis prints out the help page for command line options.Virtual COM portsOn the computer (DTE) side of the connection you'll need to set up a virtual null modem to allow dweet2ser to
communicate with the target software. This is just a pair of com ports connected to each other. dweet2ser connects to
one port, and your software application connects to the other.On Windows this can be accomplished withcom0com.In the above example, we could use com0com to create a virtual null modem with ports COM20 and COM21.
dweet2ser would connect to COM20, and the PC software to COM21.Licensing and CopyrightGNU GPL v3 License
Copyright (c) Zach Henry.