Skip to main content

MK312 Communication Wrapper.

Project description

MK312 Communication Wrapper

Introduction

This is an communication wrapper for the MK-312BT Estim Box. It uses pyserial for the RS232 communication. Primary I wrote it for my own purposes. It should be the base for a remote controlling tool and an abstraction layer for a Rest API too. If you like to do a test, it would be great :) I love to get a feedback from you.

Firmware

I test the examples with the firmware from: https://github.com/buttshock/mk312-bt/tree/master/firmware/Custom%20Boot%20Message%20f005-MK312-BT. Please note that I have some trouble with the fuse bits. Therefore I was using: L: 0xFF / H: 0xD9 which worked perfectly for me.

Connection

The communication with the MK-312 device is working via an RS232 interface -> LINK connector. I'm not glad about the phone jack because you can shorten the connectors while plugging in the interface cable. So I suggest to do the connection if the device is switched off. Maybe someone will giving the board an sub-d connector in further hardware versions. Or even better a real ethernet connection with a socket communication :)

Phone Jack RS232 Sub-D
Tip RxD Pin 2
Ring TxD Pin 3
Sleeve Gnd Pin 5

The soldering of the phone jack is a little tricky. Maybe that is the reason for the high price of the cable...

Settings

The RS232 interface is working with 8 Bytes / None Parity / 1 Stop Bit and a baudrate of 19200. Actually the communication wrapper is using 19200. You can switch the baudrate by yourself if you set the necessary UART registers. I did not a test with other baudrates than 19200.

Examples

Please check the examples dir. I wrote some basic tests which should work.

Handshaking

I completly rewrote the handshaking part. You can do it in a way I already showed in the examples:

et312 = mk312.MK312CommunicationWrapper()
et312.handshake()

# Do the stuff you like to do with your box
# ...
# ...

# Reset key and close the interface
et312.close()

If there is an interrupt of the script before you reset the key, you will getting problems with a reconnect. Actually it should be no problem at all to reconnect.

When nothing helps you can switch off the box and switch it on again. Because of the high amount of capacitors the RAM of the AVR is bufferd very long - so it take some time to wait until a reconnection is possible. I have no battery on my MK-312 therefore I can only plug off the power supply. A better way will be unloading the capacitors if switching the box off...this remains in an hardware redesign too.

Logging

For debugging reason I designed the wrapper in a way that he talks a very lot. If you don't like it when you are using an own logger than please change the logging level to info. The logger of the wrapper is talking at the debug level.

License

Please read the LICENSE file. Especially: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY --> It is your turn to use the communication wrapper!

Thanks to...

My work is based on these two repos:

Without the preliminary work of the protocol description and the handshaking it would be much harder for me.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mk312-0.4.3.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

mk312-0.4.3-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file mk312-0.4.3.tar.gz.

File metadata

  • Download URL: mk312-0.4.3.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for mk312-0.4.3.tar.gz
Algorithm Hash digest
SHA256 0bcbcdd7c8181b1db78b1dbcf8e3d387763e97d743e3a5145d937024af283ab4
MD5 2a8a18c2210ecd3bb979599244760d20
BLAKE2b-256 8a521ae4b367684c862961aff9b540a7148308edae58e323b721f938c20d68cb

See more details on using hashes here.

File details

Details for the file mk312-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: mk312-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 10.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for mk312-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 e3e9dd5c1575889104e5695af2ab088e19369d7d51196278fc5ab79cdf23f510
MD5 7c421d7f23b93c221e591822b63d6572
BLAKE2b-256 4ce70c8d3da8cbac821f439c2b7d9819380e7f0ad41a5d485dd972c373c45e47

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page