CSpyridakis / Arduino-workshop

Arduino-workshop

Το συγκεκριμένο repository είναι μέρος του εισαγωγικού στον κόσμο του arduino, workshop με τίτλο 'Arduino 2 Inspire', το οποίο διοργάνωσε το παράρτημα του Student Branch της IEEE του Πολυτεχνείου Κρήτης τον Απρίλιο του 2019 και είχα την τιμή να είμαι εισηγητής σε αυτό.

---

Για να τρέξουν οι κώδικες χρειάζεται να έχουμε την τελευταία έκδοση του arduino (1.8.9 ή νεότερη) όπως επίσης την python2.7 με την πιο πρόσφατη έκδοση του pip2 (προτεινόμενη 8.1.1 ή νεότερη)

Εγκατάσταση

Για windows:

Arduino

Κατεβάστε την τελευταία έκδοση του Arduino IDE από εδώ: https://downloads.arduino.cc/arduino-1.8.9-windows.exe

Python

Ένας εύκολος τρόπος να έχετε όλα όσα χρειάζονται είναι να κατεβάσετε την τελευταία έκδοση του Anaconda από εδώ: https://repo.anaconda.com/archive/Anaconda2-2019.03-Windows-x86_64.exe

Για Linux:

Arduino

Κατεβάστε το Arduino IDE από το official site.

Python

Σιγουρευτείτε ότι το σύστημα σας τρέχει python2.7 και την πιο πρόσφατη έκδοση του pip αλλιώς προσπαθήστε να τα εγκαταστήσετε μέσω κάποιου package manager.

Πώς ξέρω ότι είμαι έτοιμος;

Μαζί σας δίνετε το python script runme.py. Μόλις εγκαταστήσετε τα παραπάνω τρέξτε το εξής σε κάποιο terminal ή από το Anaconda Prompt.

Windows

Ανοίξτε το Anaconda Prompt και με την χρήση των εντολών dir και cd μεταφερθείτε στο folder που υπάρχουν οι κώδικες και τρέξτε την παρακάτω εντολή.

C:\Users\CS\Desktop\Arduino > python runme.py -p 1 

Αν δεν υπάρχουν τα απαραίτητα πακέτα, σε περίπτωση που έχετε την τελευταία Python και pip θα εγκατασταθούν αυτόματα τα απαραίτητα dependencies και στην συνέχεια θα πρέπει να εμφανίζεται το παρακάτω μήνυμα:

My platform: Windows
Connecting to: COM1
USB is not connected
USB is not connected
USB is not connected
...

Linux

Μέσω του terminal μεταφερθείτε στο folder path του project και τρέξτε την παρακάτω εντολή

$ python runme.py -p 1

ΣΗΜΕΙΩΣΗ: Ισως χρειαστεί να τρέξει με sudo

Αν δεν υπάρχουν τα απαραίτητα πακέτα, σε περίπτωση που έχετε την τελευταία Python και pip θα πρέπει να εγκατασταθούν αυτόματα τα απαραίτητα dependencies και στην συνέχεια θα πρέπει να εμφανίζεται το παρακάτω μήνυμα

My platform: Linux
Connecting to: /dev/ttyUSB1
USB is not connected
USB is not connected
USB is not connected
...

Troubleshooting

Αν για κάποιο λόγο (αφορά τους χρήστες του Linux, στα Windows με το Anaconda δεν θα έχετε λογικά πρόβλημα) δεν μπορούν να εγκατασταθούν αυτόματα τα πακέτα και σας πετάξει το παρακάτω error message:

...
Please try to install psutil and pyserial manually

Δοκιμάστε να εγκαταστήσετε μόνοι σας μέσω του pip2 τα παρακάτω dependencies και ξανα δοκιμάστε να τρέξετε το script.

psutil
pyserial

Επιπλέον

Τόσο στο Anaconda Prompt στα windows όσο και στο terminal σε linux μπορείτε να τρέξετε το script δίνοντας του το όρισμα -h ώστε να δείτε πως μπορείτε να το χρησιμοποιήσετε

e.q.

$ python runme.py -h

Τέλος αν θέλετε να δείτε την μορφή του πακέτου σε κάθε αποστολή μπορείτε να δώσετε και το όρισμα -D ώστε να εμφανιστεί e.q.

>  python runme.py COM1 -D