Εισαγωγή

Python is commonly used for software development, task automation, data analysis, etc. Since it is relatively easy to learn its popularity is increasing.
Αυτή η τεχνική σημείωση δείχνει τρόπους με τους οποίους μπορεί να χρησιμοποιηθεί ο προγραμματισμός Python από προϊόντα FTDI που βασίζονται στο πρότυπο του FTDI Πρόγραμμα οδήγησης VCP or Πρόγραμμα οδήγησης D2xx.
Υπάρχουν επίσης πολλές βιβλιοθήκες python τρίτων που εμφανίζονται και αυτές παρατίθενται επίσης εδώ.
Η υποστήριξη Python είναι επίσης διαθέσιμη για IC FT600/1 που χρησιμοποιούν το πρόγραμμα οδήγησης D3xx αλλά δεν καλύπτεται σε αυτό το έγγραφο. Ανατρέξτε στις σελίδες προϊόντων για αυτά τα IC για περισσότερες πληροφορίες.

Τι είναι ο προγραμματισμός Python;

Η Python γίνεται μια πολύ δημοφιλής γλώσσα προγραμματισμού.
Μπορεί να χρησιμοποιηθεί για γρήγορη δημιουργία πρωτοτύπων ή για ανάπτυξη λογισμικού έτοιμου για παραγωγή.
Λειτουργεί σε διαφορετικές πλατφόρμες (π.χ. Windows, MacOS, Linux κ.λπ.) και έχει μια απλή σύνταξη όπως η αγγλική γλώσσα. Αυτή η σύνταξη επιτρέπει στους προγραμματιστές να γράφουν προγράμματα με λιγότερες γραμμές από ορισμένες άλλες γλώσσες προγραμματισμού.
Η Python εκτελείται σε ένα σύστημα διερμηνέα, που σημαίνει ότι ο κώδικας μπορεί να εκτελεστεί αμέσως μόλις γραφτεί, πράγμα που σημαίνει ότι η δημιουργία πρωτοτύπων μπορεί να είναι πολύ γρήγορη.
Υπάρχουν πολλοί διαθέσιμοι πόροι στο διαδίκτυο για την Python με αυτόν να είναι ο κύριος webτοποθεσία: https://www.python.org/

Υποστήριξη προγράμματος οδήγησης Python

Αυτή η ενότητα περιγράφει λεπτομερώς τον τρόπο χρήσης του προγράμματος οδήγησης VCP και D2xx του FTDI με προγραμματισμό Python.

VCP

Αυτή η ενότητα έχει ένα απλό π.χampΓια να ανοίξετε μια θύρα COM χρησιμοποιώντας το πρόγραμμα οδήγησης VCP, εμφανίστε τη θύρα COM που είναι ανοιχτή στην οθόνη και, στη συνέχεια, στείλτε και λάβετε μερικούς χαρακτήρες στην ανοιχτή θύρα και εμφανίστε αυτούς στην οθόνη. Η έξοδος από τον κώδικα φαίνεται παρακάτω. Λάβετε υπόψη ότι για την απλή δοκιμή χρησιμοποιήθηκε ένα καλώδιο FTDI με βρόχο TX σε RX.

Η λίστα κωδικών βρίσκεται στο Παράρτημα Γ – Serialtest.py.
Για να εκτελέσετε αυτόν τον κώδικα, θα χρειαστεί να εγκαταστήσετε τη βιβλιοθήκη pyserial. Μπορείτε να το κάνετε αυτό εκτελώντας την ακόλουθη εντολή στο τερματικό σας:
pip εγκατάσταση pyserial
Μόλις εγκατασταθεί η βιβλιοθήκη pyserial, μπορείτε να εκτελέσετε τον κώδικα αποθηκεύοντάς τον ως .py file και μετά εκτελείτε την ακόλουθη εντολή στο τερματικό σας:
σας_fileόνομα.py

D2xx

Αυτή η ενότητα έχει δύο απλές π.χamples που χρησιμοποιούν βασικά API D2xx.

• Λάβετε τον αριθμό θύρας COM
•  Λήψη λεπτομερειών πληροφοριών συσκευής

Ανατρέξτε στο Οδηγός προγραμματιστή D2XX για περισσότερες πληροφορίες σχετικά με αυτά τα API.

Λάβετε τον αριθμό θύρας COM

Αυτό το απλό π.χample φορτώνει τη βιβλιοθήκη d2xx, ανοίγει την πρώτη συσκευή FTDI που βρέθηκε, βρίσκει τη θύρα COM
αριθμός χρησιμοποιώντας το FT_GetComPortNumber και στη συνέχεια τον κλείνει.
Η λίστα κωδικών βρίσκεται στο Παράρτημα Δ– GetComPortNumber.py.
Όταν εκτελείται η έξοδος μοιάζει με αυτό:

Λήψη λεπτομερειών πληροφοριών συσκευής
Αυτό το απλό π.χampΤο le φορτώνει τη βιβλιοθήκη d2xx και χρησιμοποιεί το FT_Create Device Info List και το FT_Get Device Info Detail για να λάβει τα στοιχεία της συσκευής FTDI και να τα εμφανίσει.
Η λίστα κωδικών βρίσκεται στο Παράρτημα E – GetDeviceInfoDetail.py.
Όταν εκτελείται η έξοδος μοιάζει με αυτό:

Τρίτο μέρος Python Examples

Υπάρχουν πολλές βιβλιοθήκες τρίτων και π.χampΤα όσα εμφανίζονται καθώς η δημοτικότητα της γλώσσας προγραμματισμού επεκτείνεται, μερικά παρατίθενται εδώ, αλλά μπορεί να βρεθούν περισσότερα.

PyUSB

Το PyUSB παρέχει εύκολη πρόσβαση στο σύστημα Universal Serial Bus (USB) του κεντρικού υπολογιστή για Python 3.
Το PyUSB είναι μια πλούσια σε API, ουδέτερη μονάδα υποστήριξης Python USB εύκολη στη χρήση. https://pyusb.github.io/pyusb/

pylibftdi

Σημειώστε ότι αυτό χρησιμοποιεί libftdi το οποίο δεν είναι πρόγραμμα οδήγησης που υποστηρίζεται FTDI, ωστόσο μπορεί να χρησιμοποιηθεί για τον έλεγχο συσκευών FTDI.
Το pylibftdi είναι μια ελάχιστη διεπαφή Pythonic για συσκευές FTDI. https://pypi.org/project/pylibftdi/

PyFtdi

Το PyFtdi στοχεύει στην παροχή ενός προγράμματος οδήγησης χώρου χρήστη για δημοφιλείς συσκευές FTDI, που υλοποιείται σε καθαρή γλώσσα Python.
https://pypi.org/project/pyftdi/

Adafruit

Η Adafruit δημιούργησε έναν οδηγό για να δείξει πώς να χρησιμοποιήσετε ένα FT232H για να συνδεθείτε με αισθητήρες I2C και SPI και με σπασίματα από τον επιτραπέζιο υπολογιστή σας με Windows, Mac OSX ή Linux.
https://learn.adafruit.com/circuitpython-on-any-computer-with-ft232h

ftdi-python

Αυτό το πρώηνampΤο le παρουσιάζει μια βήμα προς βήμα προσέγγιση για την οδήγηση IC FTDI από την Python για να μάθετε για τη λειτουργικότητά τους.
https://iosoft.blog/ftdi-python/

ftd2xx ctypes Περιτύλιγμα

Το ftd2xx είναι ένα απλό περιτύλιγμα python γύρω από το D2XX DLL από το FTDI χρησιμοποιώντας ctypes. https://pypi.org/project/ftd2xx/

python-ft4222

Αυτό το πρώηνampΤο le παρέχει σύνδεση python στο LibFT4222 που πρέπει να χρησιμοποιηθεί με το IC FT4222H και παρέχει ένα παρόμοιο API με το LibFT4222. https://pypi.org/project/ft4222/

Σύναψη

Αυτή η τεχνική σημείωση δείχνει πώς να χρησιμοποιείτε τον προγραμματισμό Python με προϊόντα FTDI με το πρόγραμμα οδήγησης VCP και D2xx και έχει παραθέσει ορισμένες πρώην τρίτωνamples.

Στοιχεία Επικοινωνίας

Κεντρικά Γραφεία – Γλασκώβη, Ηνωμένο Βασίλειο
Future Technology Devices International Limited (Ηνωμένο Βασίλειο)
Μονάδα 1, 2 Seaward Place, Centurion Business Park Glasgow G41 1HH Ηνωμένο Βασίλειο
Τηλ: +44 (0) 141 429 2777
Φαξ: +44 (0) 141 429 2758

E-mail (Πωλήσεις) sales1@ftdichip.com
E-mail (Υποστήριξη) support1@ftdichip.com
E-mail (Γενικές ερωτήσεις) admin1@ftdichip.com

Υποκατάστημα – Ταϊπέι, Ταϊβάν

Future Technology Devices International Limited (Ταϊβάν)
2F, Νο. 516, Sec. 1, NeiHu Road
Ταϊπέι 114
Ταϊβάν, ROC
Τηλ: +886 (0) 2 8797 1330
Φαξ: +886 (0) 2 8751 9737

E-mail (Πωλήσεις) tw.sales1@ftdichip.com
E-mail (Υποστήριξη) tw.support1@ftdichip.com
E-mail (Γενικές ερωτήσεις) tw.admin1@ftdichip.com

Υποκατάστημα – Tigard, Όρεγκον, ΗΠΑ
Future Technology Devices International Limited (ΗΠΑ)
7130 SW Fir Loop
Tigard, OR 97223-8160
ΗΠΑ
Τηλ: +1 (503) 547 0988
Φαξ: +1 (503) 547 098

E-mail (Πωλήσεις) us.sales@ftdichip.com
E-mail (Υποστήριξη) us.support@ftdichip.com
E-mail (Γενικές ερωτήσεις) us.admin@ftdichip.com

Υποκατάστημα – Σαγκάη, Κίνα

Future Technology Devices International Limited (Κίνα)
Room 1103, No. 666 West Huaihai Road, Shanghai, 200052 China
Τηλ: +86 (21) 62351596
Φαξ: +86 (21) 62351595
E-mail (Πωλήσεις) cn.sales@ftdichip.com
E-mail (Υποστήριξη) cn.support@ftdichip.com
E-mail (Γενικές ερωτήσεις) cn.admin@ftdichip.c

Web Τοποθεσία http://ftdichip.com

Διανομέας και Αντιπρόσωποι Πωλήσεων
Επισκεφτείτε τη σελίδα του Δικτύου Πωλήσεων της FTDI Web τοποθεσία για τα στοιχεία επικοινωνίας των διανομέων μας και των αντιπροσώπων πωλήσεων στη χώρα σας.

Οι κατασκευαστές και οι σχεδιαστές συστημάτων και εξοπλισμού είναι υπεύθυνοι να διασφαλίζουν ότι τα συστήματά τους και οποιεσδήποτε συσκευές Future Technology Devices International Ltd (FTDI) που είναι ενσωματωμένες στα συστήματά τους, πληρούν όλες τις ισχύουσες απαιτήσεις ασφάλειας, ρυθμιστικών και επιδόσεων σε επίπεδο συστήματος. Όλες οι πληροφορίες που σχετίζονται με την εφαρμογή σε αυτό το έγγραφο (συμπεριλαμβανομένων των περιγραφών εφαρμογών, των προτεινόμενων συσκευών FTDI και άλλων υλικών) παρέχονται μόνο για αναφορά. Ενώ η FTDI φρόντισε να διασφαλίσει ότι είναι ακριβείς, αυτές οι πληροφορίες υπόκεινται σε επιβεβαίωση από τον πελάτη και η FTDI αποποιείται κάθε ευθύνη για σχέδια συστημάτων και για οποιαδήποτε βοήθεια για εφαρμογές παρέχεται από την FTDI. Η χρήση των συσκευών FTDI σε εφαρμογές υποστήριξης ζωής ή/και ασφάλειας είναι εξ ολοκλήρου με κίνδυνο του χρήστη και ο χρήστης συμφωνεί να υπερασπιστεί, να αποζημιώσει και να κρατήσει αβλαβή FTDI από οποιαδήποτε ζημιά, αξιώσεις, κοστούμια ή έξοδα που προκύπτουν από τέτοια χρήση. Αυτό το έγγραφο υπόκειται σε αλλαγές χωρίς προειδοποίηση. Η δημοσίευση αυτού του εγγράφου δεν συνεπάγεται ελευθερία χρήσης διπλωμάτων ευρεσιτεχνίας ή άλλων δικαιωμάτων πνευματικής ιδιοκτησίας. Ούτε το σύνολο ούτε μέρος των πληροφοριών που περιέχονται ή το προϊόν που περιγράφεται σε αυτό το έγγραφο δεν επιτρέπεται να προσαρμοστεί ή να αναπαραχθεί σε οποιαδήποτε υλική ή ηλεκτρονική μορφή χωρίς την προηγούμενη γραπτή συγκατάθεση του κατόχου των πνευματικών δικαιωμάτων. Future Technology Devices International Ltd, Unit 1, 2 Seaward Place, Centurion Business Park, Glasgow G41 1HH, Ηνωμένο Βασίλειο. Εγγεγραμμένος αριθμός εταιρείας στη Σκωτία: SC136640.

Παράρτημα Α – Παραπομπές

Παραπομπές εγγράφων

Πρόγραμμα οδήγησης D2xx
Πρόγραμμα οδήγησης VCP
https://www.python.org/
Οδηγός προγραμματιστή D2XX
https://pyusb.github.io/pyusb/
https://pypi.org/project/pylibftdi/
https://pypi.org/project/pyftdi/
https://learn.adafruit.com/circuitpython-on-any-computer-with-ft232h
https://iosoft.blog/ftdi-python/
https://pypi.org/project/ftd2xx/
https://pypi.org/project/ft4222/
libftdi

Ακρωνύμια και συντομογραφίες

Παράρτημα Β – Κατάλογος πινάκων και σχημάτων

Λίστα πινάκων

N/A

Κατάλογος Φιγούρων

Εικόνα 1 – Λογότυπο Python…………………………………………………………………………………………….. 5

Παράρτημα Γ – Serialtest.py

εισαγωγή σειριακό
χρόνος εισαγωγής
# Ορίστε τον αριθμό θύρας COM
portName = 'COM7'
# Ρυθμίστε τον ρυθμό baud
BaudRate = 115200
# Ανοίξτε τη σειριακή θύρα
δοκιμή:
ser = serial.Serial(portName, baudRate)
print('Opened port COM: ' + portName)
εκτός:
εκτύπωση ("Παρουσιάστηκε εξαίρεση")

# Στείλτε "Hello" για να ξεκινήσει το πρόγραμμα
ser.write(b'Hello')
time.sleep (1)
# Διαβάστε τη γραμμή
read_data = ser.read(5)
print("Ληφθέντα δεδομένα: " + str(read_data))
# Κλείστε τη σειριακή θύρα
σερ.κλείνω

Παράρτημα Δ– GetComPortNumber.py

#!/usr/bin/env python
εισαγωγή os
Εισαγωγή συστήματος
ctypes εισαγωγής
################################################################## ######################
# Ορισμοί D2XX
def check(f):
αν f != 0:
ονόματα = [
"FT_OK",
"FT_INVALID_HANDLE",
"FT_DEVICE_NOT_FOUND",
"FT_DEVICE_NOT_OPENED",
"FT_IO_ERROR",
"FT_INSUFFICIENT_RESOURCES",
"FT_INVALID_PARAMETER",
"FT_INVALID_BAUD_RATE",
"FT_DEVICE_NOT_OPENED_FOR_ERASE",
"FT_DEVICE_NOT_OPENED_FOR_WRITE",
"FT_FAILED_TO_WRITE_DEVICE",
"FT_EEPROM_READ_FAILED",
"FT_EEPROM_WRITE_FAILED",
"FT_EEPROM_ERASE_FAILED",
"FT_EEPROM_NOT_PRESENT",
"FT_EEPROM_NOT_PROGRAMMED",
"FT_INVALID_ARGS",
"FT_NOT_SUPPORTED",
"FT_OTHER_ERROR"] αύξηση IOError("Σφάλμα: (κατάσταση %d: %s)" % (f, ονόματα[f]))
################################################################## ######################
# Κύριο Πρόγραμμα
#
# Εφαρμόζει το απλό GetComPortNumber π.χample από τον οδηγό προγραμματιστών D2XX.

κλάση D2XXTest(αντικείμενο):
def __init __ (αυτο):
#Φόρτωση δυαδικών προγραμμάτων οδήγησης
if sys.platform.startswith('linux'):
self.d2xx = ctypes.cdll.LoadLibrary("libftd2xx.so")
elif sys.platform.startswith('darwin'):
self.d2xx = ctypes.cdll.LoadLibrary("libftd2xx.1.1.0.dylib")
αλλού:
self.d2xx = ctypes.windll.LoadLibrary("ftd2xx")
εκτύπωση "Η βιβλιοθήκη D2XX φορτώθηκε ΟΚ"
αποτύπωμα
sys.stdout.flush()
self.getCom()
def getCom(self):
#create μεταβλητή FT Handle
self.ftHandle = ctypes.c_void_p()
#Ανοίξτε την πρώτη συσκευή στο σύστημα
check(self.d2xx.FT_Open(0, ctypes.byref(self.ftHandle)))
Μεταβλητή αριθμός θύρας #com
lComPortNumber = ctypes.c_long()
#ανάκτηση com # με FT_GetComPortNumber
check(self.d2xx.FT_GetComPortNumber(self.ftHandle,
ctypes.byref(lComPortNumber)))
εάν lComPortNumber.value == -1:
εκτύπωση "Δεν έχει εκχωρηθεί θύρα επικοινωνίας"
αλλού:
εκτύπωση "Com Port Number: %d" % (lComPortNumber.value)
#call FT_Close για να κλείσει η σύνδεση
check(self.d2xx.FT_Close(self.ftHandle))
αν __όνομα__ == '__κύριος__':
εκτύπωση "===== Python D2XX Get Com Port ====="
αποτύπωμα
app = D2XXTest()

Παράρτημα E – GetDeviceInfoDetail.py

#!/usr/bin/env python
εισαγωγή os
Εισαγωγή συστήματος
ctypes εισαγωγής
################################################################## ######################
# Ορισμοί D2XX
def check(f):
αν f != 0:
ονόματα = [
"FT_OK",
"FT_INVALID_HANDLE",
"FT_DEVICE_NOT_FOUND",
"FT_DEVICE_NOT_OPENED",
"FT_IO_ERROR",
"FT_INSUFFICIENT_RESOURCES",
"FT_INVALID_PARAMETER",
"FT_INVALID_BAUD_RATE",
"FT_DEVICE_NOT_OPENED_FOR_ERASE",
"FT_DEVICE_NOT_OPENED_FOR_WRITE",
"FT_FAILED_TO_WRITE_DEVICE",
"FT_EEPROM_READ_FAILED",
"FT_EEPROM_WRITE_FAILED",
"FT_EEPROM_ERASE_FAILED",
"FT_EEPROM_NOT_PRESENT",
"FT_EEPROM_NOT_PROGRAMMED",
"FT_INVALID_ARGS",
"FT_NOT_SUPPORTED",
"FT_OTHER_ERROR"] αύξηση IOError("Σφάλμα: (κατάσταση %d: %s)" % (f, ονόματα[f]))
################################################################## ######################
# Κύριο Πρόγραμμα

###***** ίσως προσθέσει boolens για το λειτουργικό σύστημα, ώστε όταν προσπαθείτε να ανοίξετε μια συσκευή, μπορείτε να το κάνετε σωστά για το σωστό λειτουργικό σύστημα. Το Linux δεν μπορεί να χρησιμοποιήσει ευρετήρια για να ανοίξει (;) έλεγχος ex linuxamples ίσως;
κλάση D2XXTest(αντικείμενο):
def __init __ (αυτο):
#Φόρτωση δυαδικών προγραμμάτων οδήγησης
if sys.platform.startswith('linux'):
self.d2xx = ctypes.cdll.LoadLibrary("libftd2xx.so")
elif sys.platform.startswith('darwin'):
self.d2xx = ctypes.cdll.LoadLibrary("libftd2xx.1.1.0.dylib")
αλλού:
self.d2xx = ctypes.windll.LoadLibrary("ftd2xx")
εκτύπωση "Η βιβλιοθήκη D2XX φορτώθηκε ΟΚ\n"
sys.stdout.flush()
#καλέστε πρώηνample λειτουργία
self.getDevInfoList()
def getDevInfoList(self):
#declare μεταβλητές που απαιτούνται στη συνάρτηση
numDevs = ctypes.c_long()
check(self.d2xx.FT_CreateDeviceInfoList(ctypes.byref(numDevs)))
εκτύπωση "Αριθμός συσκευών είναι: %d" % (numDevs.value)
# εάν υπάρχει τουλάχιστον μία συνδεδεμένη συσκευή
αν numDevs.value > 0:
#αποκτήστε πληροφορίες συσκευής για όλες τις συσκευές στο σύστημα
για i στην περιοχή (numDevs.value):
#create μεταβλητή FT Handle
ftHandleTemp = ctypes.c_long()
Flags = ctypes.c_long()
Αναγνωριστικό = ctypes.c_long()
Τύπος = ctypes.c_long()
LocId = ctypes.c_long()
SerialNumber = ctypes.create_string_buffer(16)
Περιγραφή = ctypes.create_string_buffer(64)

#call GetDeviceInfoDetail λειτουργία για να αποκτήσετε συσκευή

καθέκαστα
check(self.d2xx.FT_GetDeviceInfoDetail(i,
ctypes.byref(Flags),ctypes.byref(Type), ctypes.byref(ID), ctypes.byref(LocId),
ctypes.byref(SerialNumber), ctypes.byref(Description), ctypes.byref(ftHandleTemp)))
#εκτυπώστε τα στοιχεία της συσκευής
self.printDetails(i,Flags.value, Type.value, ID.value,
LocId.value, SerialNumber.value, Description.value, ftHandleTemp.value)
αλλού:
#αν δεν υπάρχουν συσκευές βγείτε από το πρόγραμμα
sys.exit()
def printDetails(self,dev,flags,ty,i_d,locid,serial,desc,handle):
εκτύπωση "Dev: %d" % (dev)
εκτύπωση "Σημαίες=0x%x" % (σημαίες)
εκτύπωση ” Type=0x%x” % (ty)
εκτύπωση ” ID=0x%x” % (i_d)
εκτύπωση ” LocId=0x%x” % (locid)
εκτύπωση "SerialNumber=%s" % (σειριακή)
εκτύπωση ” Περιγραφή=%s” % (περιγραφή)
εκτύπωση ” ftHandle=0x%s” % (λαβή)
αν __όνομα__ == '__κύριος__':
εκτύπωση "===== Python D2XX Λήψη λεπτομερειών πληροφοριών συσκευής =====\n"
app = D2XXTest()

Παράρτημα ΣΤ – Ιστορικό αναθεωρήσεων

Τίτλος εγγράφου: TN_187 Υποστήριξη Python για προϊόντα FTDI
Αριθμός αναφοράς εγγράφου: FT_001561
Αριθμός εκκαθάρισης: FTDI#590
Σελίδα προϊόντος: https://ftdichip.com/product-category/products/ic/
Σχόλια για το έγγραφο: Αποστολή σχολίων

ΕΞΥΠΗΡΕΤΗΣΕΙΣ ΠΕΛΑΤΩΝ

Σελίδα προϊόντος
Ανατροφοδότηση εγγράφου
Πνευματικά δικαιώματα © Future Technology Devices International Limited Future Technology Devices International Limited (FTDI) Unit 1, 2 Seaward Place, Glasgow G41 1HH, Ηνωμένο Βασίλειο
Τηλ.: +44 (0) 141 429 2777 Φαξ: + 44 (0) 141 429 2758
Web Τοποθεσία: http://ftdichip.com
Πνευματικά δικαιώματα © Future Technology Devices International Limited