www.pyramid.tech
FX4
FX4 პროგრამისტის სახელმძღვანელო
დოკუმენტის ID: 2711715845
ვერსია: v3
FX4 პროგრამისტი
დოკუმენტის ID: 2711715845
FX4 – FX4 პროგრამისტის სახელმძღვანელო
დოკუმენტის ID: 2711650310
| ავტორი | მეთიუ ნიკოლსი |
| მფლობელი | პროექტის წამყვანი |
| მიზანი | ახსენით პროგრამირების ცნებები, რომლებიც აუცილებელია API-ს გამოსაყენებლად და პროდუქტის გარე აპლიკაციების საშუალებით გაფართოებისთვის. |
| ფარგლები | FX4 დაკავშირებული პროგრამირების კონცეფციები. |
| განკუთვნილი აუდიტორია | პროგრამული უზრუნველყოფის შემქმნელები დაინტერესებულნი არიან პროდუქტის გამოყენებით. |
| პროცესი | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Process |
| ტრენინგი | ᲐᲠ ᲛᲘᲘᲦᲔᲑᲐ |
ვერსიის კონტროლი
| ვერსია | აღწერა | შენახულია | შენახულია | სტატუსი |
| v3 | დამატებულია მარტივი ზეview და მეტი ყოფილიamples. | მეთიუ ნიკოლსი | 6 წლის 2025 მარტი, საღამოს 10:29 | დამტკიცებულია |
| v2 | დამატებულია ციფრული IO ინტერფეისები და ცნობები IGX-ში. | მეთიუ ნიკოლსი | 3 წლის 2024 მაისი, 7:39 საათი | დამტკიცებულია |
| v1 | პირველადი გამოშვება, ჯერ კიდევ მიმდინარეობს მუშაობა. | მეთიუ ნიკოლსი | 21 თებერვალი, 2024 11:25 | დამტკიცებულია |
დოკუმენტი საკონტროლო არა რეviewed
დოკუმენტის მიმდინარე ვერსია: v.1
არა რეviewდანიშნულები.
1.1 ხელმოწერები
დოკუმენტის უახლესი ვერსიისთვის
პარასკევი, 7 მარტი, 2025, 10:33 UTC
მეთიუ ნიკოლსმა მოაწერა ხელი; მნიშვნელობა: რეview
ცნობები
| დოკუმენტი | დოკუმენტის ID | ავტორი | ვერსია |
| IGX - პროგრამისტის სახელმძღვანელო | 2439249921 | მეთიუ ნიკოლსი | 1 |
FX4 პროგრამირება დასრულდაview
FX4 პროცესორი მუშაობს გარემოზე, სახელწოდებით IGX, რომელიც აგებულია QNX მაღალი საიმედოობის რეალურ დროში ოპერაციულ სისტემაზე BlackBerry (QNX Webსაიტი¹). IGX უზრუნველყოფს მოქნილ და ყოვლისმომცველ აპლიკაციის პროგრამირების ინტერფეისს (API) მომხმარებლებისთვის, რომლებსაც სურთ დაწერონ საკუთარი მასპინძელი კომპიუტერული პროგრამა.
IGX გარემო გაზიარებულია სხვა პირამიდის პროდუქტებში, რაც საშუალებას აძლევს ერთი პროდუქტისთვის შემუშავებული პროგრამული გადაწყვეტილებების ადვილად გადაცემას სხვაზე.
პროგრამისტებს შეუძლიათ მიმართონ IGX-ის სრულ დოკუმენტაციას, რომელიც ხელმისაწვდომია პირამიდაზე webსაიტი: IGX | თანამედროვე მოდულური მართვის სისტემის ჩარჩო ამისთვის Web- ჩართულია აპლიკაციები²
ამ განყოფილებაში მოცემულია API ორი მეთოდის ტესტირების შესავალი: HTTP JSON ფორმატის გამოყენებით და EPICS. სიმარტივისთვის, პითონი (პითონი Webსაიტი³) გამოიყენება როგორც ყოფილიample host კომპიუტერული ენა, რომელიც ხელმისაწვდომი და მარტივი გამოსაყენებელია არაპროფესიონალი პროგრამისტებისთვის.
3.1 Python-ისა და HTTP-ის გამოყენება
როგორც ყოფილიampლე, დავუშვათ, რომ გსურთ გაზომილი დენების ჯამის წაკითხვა პითონის საშუალებით. თქვენ გჭირდებათ URL ამ კონკრეტული IO-სთვის. FX4 web GUI გთავაზობთ ამის პოვნის მარტივ გზას: უბრალოდ დააწკაპუნეთ ველზე მარჯვენა ღილაკით და აირჩიეთ 'HTTP-ის კოპირება URLსტრიქონის კოპირება ბუფერში.
ახლა თქვენ შეგიძლიათ გამოიყენოთ Python მომხმარებლის პროგრამულ უზრუნველყოფასთან დაკავშირების შესამოწმებლად HTTP და JSON-ის საშუალებით. შეიძლება დაგჭირდეთ მოთხოვნების და json ბიბლიოთეკების იმპორტი HTTP მოთხოვნებისა და მონაცემთა ანალიზისთვის.
1 მარტივი Python HTTP მაგample
3.2 EPICS-ის გამოყენება
FX4-ის დაკავშირების პროცესი EPICS-ის (ექსპერიმენტული ფიზიკის და სამრეწველო კონტროლის სისტემის) მეშვეობით მსგავსია. EPICS არის პროგრამული ინსტრუმენტებისა და აპლიკაციების ერთობლიობა, რომელიც გამოიყენება განაწილებული კონტროლის სისტემების შემუშავებისა და დანერგვისთვის, რომელიც ფართოდ გამოიყენება სამეცნიერო დაწესებულებებში.
- მიიღეთ EPICS პროცესის ცვლადის (PV) სახელი სასურველი IO-სთვის.
- შემოიტანეთ EPICS ბიბლიოთეკა და წაიკითხეთ მნიშვნელობა.
2 მიიღეთ EPICS PV სახელი
3 მარტივი პითონის EPICS მაგample
გარდა ამისა, Pyramid-მა შექმნა პროგრამა (EPICS დაკავშირება⁴) რომელიც საშუალებას გაძლევთ აკონტროლოთ EPICS პროცესის ცვლადები რეალურ დროში. ეს ინსტრუმენტი სასარგებლოა იმის დასადასტურებლად, არის თუ არა EPICS PV სახელი სწორი და FX4 სწორად ემსახურება PV-ს თქვენს ქსელში.
4 PTC EPICS დაკავშირება
FX4 პროგრამირების API
ამ სახელმძღვანელოში აღწერილი ცნებები და მეთოდები ეფუძნება IGX - პროგრამისტის სახელმძღვანელოში დადგენილ კონცეფციებს. გთხოვთ იხილოთ ეს დოკუმენტი ახსნა-განმარტებისთვის და მაგampიმის შესახებ, თუ როგორ მუშაობს ძირითადი IGX პროგრამირება და ინტერფეისები. ეს სახელმძღვანელო მოიცავს მხოლოდ მოწყობილობის სპეციფიკურ IO-ს და ფუნქციებს, რომლებიც უნიკალურია FX4-ისთვის.
4.1 ანალოგური შეყვანა IO
ეს IO ეხება FX4-ის ანალოგური დენის შეყვანის მონაცემების კონფიგურაციას და შეგროვებას. არხის შეყვანის ერთეულები ეფუძნება მომხმარებლის კონფიგურირებად პარამეტრს სახელწოდებით „Sample Units”, მოქმედი ვარიანტები მოიცავს pA, nA, uA, mA და A.
ოთხივე არხი იყენებს ერთსა და იმავე ინტერფეისს IO და დამოუკიდებლად კონტროლდება. შეცვალეთ channel_x შესაბამისად channel_4-ით, channel_1-ით, channel_2-ით ან channel_3-ით.
| IO ბილიკი | აღწერა |
| /fx4/adc/channel_x | READONLY NUMBER გაზომილი მიმდინარე შეყვანა. |
| /fx4/adc/channel_x/scalar | NUMBER არხზე გამოყენებული მარტივი ერთეულის სკალარი, ნაგულისხმევად 1. |
| /fx4/adc/channel_x/zero_offset | NUMBER მიმდინარე ოფსეტი nA-ში არხისთვის. |
შემდეგი IO არ არის დამოუკიდებელი არხი და გამოიყენება ყველა არხზე ერთდროულად.
| IO ბილიკი | აღწერა |
| /fx4/channel_sum | READONLY NUMBER მიმდინარე შეყვანის არხების ჯამი. |
| /fx4/adc_unit | STRING ადგენს მომხმარებლის მიმდინარე ერთეულებს თითოეული არხისთვის და ჯამისთვის. ვარიანტები: "პა", "ნა", "უა", "მა", "ა" |
| /fx4/დიაპაზონი | STRING ადგენს მიმდინარე შეყვანის დიაპაზონს. იხილეთ GUI, თუ როგორ შეესაბამება თითოეული დიაპაზონის კოდი მაქსიმალური მიმდინარე შეყვანის ლიმიტებს და BW. პარამეტრები: "0", "1", "2", "3", "4", "5", "6", "7" |
| /fx4/adc/sample_სიხშირე | NUMBER სიხშირე ჰც-ში, რომელიც sample მონაცემები იქნება საშუალოდ. ეს აკონტროლებს სიგნალის ხმაურს და მონაცემთა სიჩქარეს ყველა არხისთვის. |
| /fx4/adc/conversion_frequency | NUMBER სიხშირე ჰც-ში, რომელზეც ADC გარდაქმნის ანალოგს ციფრულ მნიშვნელობებად. ნაგულისხმევად, ეს არის 100 kHz და თქვენ მხოლოდ იშვიათად დაგჭირდებათ ამ მნიშვნელობის შეცვლა. |
| /fx4/adc/offset_correction | READONLY NUMBER არხის მიმდინარე ოფსეტების ჯამი. |
4.2 ანალოგური გამომავალი IO
ეს IO ეხება FX4-ის ზოგადი დანიშნულების ანალოგური გამოსასვლელების კონფიგურაციას, რომლებიც გვხვდება წინა პანელზე ანალოგური შეყვანის ქვეშ. ოთხივე არხი იყენებს ერთსა და იმავე ინტერფეისს IO და დამოუკიდებლად კონტროლდება. შეცვალეთ channel_x შესაბამისად channel_4-ით, channel_1-ით, channel_2-ით ან channel_3-ით.
| IO ბილიკი | აღწერა |
| /fx4/dac /channel_x | NUMBER ბრძანება ტtage გამომავალი. ეს მნიშვნელობა შეიძლება ჩაიწეროს მხოლოდ მაშინ, როდესაც გამომავალი რეჟიმი დაყენებულია ხელით. |
| /fx4/dac/channel_x/readback | READONLY NUMBER გაზომილი ტომიtage გამომავალი. ეს ყველაზე სასარგებლოა გამოხატვის გამომავალი რეჟიმის გამოყენებისას. |
| /fx4/dac/channel_x/output_mode | STRING აყენებს არხისთვის გამომავალი რეჟიმს. ოფციები: „სახელმძღვანელო“, „გამოხატვა“, „პროცესის_კონტროლი“ |
| /fx4/dac/channel _ x/slew_control_enable | BOOL რთავს ან გამორთავს დარტყმის სიჩქარის შეზღუდვას. |
| /fx4/dac/channel_ x/slew_rate | NUMBER გადახრის სიხშირე V/s-ში არხისთვის. |
| /fx4/dac/channel_x/upper_limit | NUMBER მაქსიმალური დასაშვები ბრძანება voltagე არხისთვის. ვრცელდება ყველა ოპერაციის რეჟიმზე. |
| /fx4/dac/არხი _ x/ქვედა_ლიმიტი | NUMBER მინიმალური დაშვებული ბრძანება voltagე არხისთვის. ვრცელდება ყველა ოპერაციის რეჟიმზე. |
| /fx4/dac/channel _ x/ გამომავალი _ გამოხატულება | STRING აყენებს გამოხატვის სტრიქონს, რომელსაც არხი იყენებს, როდესაც ის არის გამოხატვის გამომავალი რეჟიმში. |
| /fx4/dac/channel _ x/reset_button | BUTTON აღადგენს ბრძანებას voltage 0-მდე. |
4.3 ციფრული შეყვანა და გამომავალი
ეს IO დაკავშირებულია FX4-ზე ნაპოვნი სხვადასხვა ზოგადი დანიშნულების ციფრული შეყვანისა და გამოსავლების კონტროლთან.
| IO ბილიკი | აღწერა |
| /fx4/fr1 | READONLY BOOL ბოჭკოვანი მიმღები 1. |
| /fx4/ft1 | BOOL ბოჭკოვანი გადამცემი 1. |
| /fx4/fr2 | READONLY BOOL ბოჭკოვანი მიმღები 2. |
| /fx4/ft2 | BOOL ბოჭკოვანი გადამცემი 2. |
| /fx4/fr3 | READONLY BOOL ბოჭკოვანი მიმღები 3. |
| /fx4/ft3 | BOOL ბოჭკოვანი გადამცემი 3. |
| /fx4/digital_expansion/d1 | BOOL D1 ორმხრივი ციფრული გაფართოების IO. |
| /fx4/digital_expansion/d2 | BOOL D2 ორმხრივი ციფრული გაფართოების IO. |
| /fx4/digital_expansion/d3 | BOOL D3 ორმხრივი ციფრული გაფართოების IO. |
| /fx4/digital_expansion/d4 | BOOL D4 ორმხრივი ციფრული გაფართოების IO. |
4.3.1 ციფრული IO კონფიგურაცია
ყველა ციფრულ მოწყობილობას აქვს ბავშვის IO მათი ქცევის კონფიგურაციისთვის, ოპერაციული რეჟიმის ჩათვლით, რომელიც აკონტროლებს როგორ იმუშავებს ეს ციფრული. თითოეულ ციფრულს ექნება ხელმისაწვდომი ვარიანტების განსხვავებული ნაკრები. იხილეთ GUI დეტალებისთვის, თუ რა ვარიანტებია ხელმისაწვდომი რომელი IO-სთვის.
| ბავშვის IO გზა | აღწერა |
| …/რეჟიმი | STRING ოპერაციული რეჟიმი ციფრულისთვის. ოფციები: „შეყვანა“, „გამომავალი“, „pwm“, „ტაიმერი“, „კოდერი“, „ჩაღება“, „uart_rx“, „uart_tx“, „can_rx“, „can_tx“, „pru_input“ ან „pru_output“ |
| …/პროცესის_სიგნალი | STRING პროცესის კონტროლის სიგნალის სახელი, თუ არსებობს. |
| …/pull_mode | STRING აწევის/ჩამოწევის რეჟიმი ციფრული შეყვანისთვის. პარამეტრები: "ზემოთ", "ქვემოთ" ან "გამორთვა" |
4.4 სარელეო კონტროლი
ორივე რელე დამოუკიდებლად კონტროლდება და იზიარებს იგივე ტიპის ინტერფეისს. შეცვალეთ relay_x შესაბამისად relay_a ან relay_b.
| IO ბილიკი | აღწერა |
| /fx4/რელე _ x/ნებართვა / მომხმარებელი _ ბრძანება | BOOL ბრძანებს რელეს გახსნას ან დახურვას. ჭეშმარიტი ბრძანება შეეცდება დახუროს რელე, თუ ჩაკეტვა მინიჭებულია, და false ბრძანება ყოველთვის გახსნის რელეს. |
| /fx4/რელე _ x/მდგომარეობა | READONLY STRING რელეს მიმდინარე მდგომარეობა. ჩაკეტილი რელეები ღიაა, მაგრამ არ შეიძლება დაიხუროს ჩაკეტვის გამო. მდგომარეობები: "გახსნილი", "დახურული" ან "ჩაკეტილი" |
| /fx4/რელე _ x/ავტომატურად _ დახურვა | BOOL როდესაც დაყენებულია true-ზე, რელე ავტომატურად დაიხურება, როდესაც ჩაკეტვის მინიჭება მოხდება. ნაგულისხმევად ყალბი. |
| /fx4/რელე _ x/ ციკლი _ დათვლა | READONLY NUMBER სარელეო ციკლების რაოდენობა ბოლო გადატვირთვის შემდეგ. სასარგებლოა სარელეო სიცოცხლის ხანგრძლივობის თვალყურის დევნებისთვის. |
4.5 მაღალი ტომიtage მოდული
იხილეთ IGX - პროგრამისტის სახელმძღვანელო დეტალებისთვის FX4 მაღალი მოცულობის შესახებtagე ინტერფეისი. კომპონენტის მშობელი გზაა /fx4/high_votlage.
4.6 დოზის კონტროლერი
იხილეთ IGX - პროგრამისტის სახელმძღვანელო დეტალებისთვის FX4 დოზის კონტროლერის ინტერფეისის შესახებ. კომპონენტის მშობელი გზაა /fx4/dose_controller.
FX4 Python Examples
5.1 მონაცემთა ლოგერი HTTP-ის გამოყენებით
ეს ყოფილიample გვიჩვენებს, თუ როგორ უნდა აღბეჭდოთ რამდენიმე წაკითხვა და შეინახოთ ისინი CSV-ში file. წაკითხვებს შორის დიდი დაყოვნების არჩევით, შეგიძლიათ შეასრულოთ გრძელვადიანი მონაცემების აღრიცხვა, მაშინაც კი, თუ FX4 sampლინგის მაჩვენებელი უფრო მაღალია. ეს საშუალებას გაძლევთ განუწყვეტლივ შეაგროვოთ და შეინახოთ გაზომვები დიდი ხნის განმავლობაში სისტემის გადატვირთვის გარეშე, იმის უზრუნველსაყოფად, რომ მონაცემები აღირიცხება თქვენი ანალიზისთვის შესაფერისი ინტერვალებით. წაკითხვებს შორის შეფერხება ხელს უწყობს მონაცემების აღრიცხვის ტემპის რეგულირებას, რაც შესაძლებელს ხდის ეფექტურ შენახვას და ამცირებს მონაცემთა წერტილების გამოტოვების რისკს, ხოლო მაღალი სიჩქარით სარგებლობისას.ampling რეალურ დროში გაზომვისთვის.
5.2 მარტივი Python GUI
მეორე ყოფილიample იყენებს Tkinter GUI ინსტრუმენტს, რომელიც შექმნილია პითონისთვის, გაზომილი დენების ჩვენების შესაქმნელად. ეს ინტერფეისი საშუალებას გაძლევთ წარმოიდგინოთ მიმდინარე წაკითხვები მოსახერხებელი გრაფიკული ფორმატით. ეკრანის ზომა შეიძლება შეიცვალოს ისე, რომ ის საკმარისად დიდი იყოს ოთახიდან წასაკითხად, რაც მას იდეალურს ხდის სცენარებისთვის, სადაც რეალურ დროში მონიტორინგია საჭირო დიდ სივრცეებში. Tkinter გთავაზობთ მარტივ გზას ინტერაქტიული ინტერფეისების შესაქმნელად და მისი FX4-თან ინტეგრაციით, შეგიძლიათ სწრაფად შექმნათ გაზომილი დენების ვიზუალური ჩვენება, რომელიც შეიძლება მორგებული იყოს თქვენს კონკრეტულ საჭიროებებზე.
5.3 მარტივი Webსოკეტები მაგample
ეს ყოფილიampლე გვიჩვენებს Webსოკეტების ინტერფეისი, რომელიც სასურველი მეთოდია FX4-დან მონაცემების წასაკითხად, როდესაც საჭიროა მაქსიმალური გამტარობა. Webსოკეტები უზრუნველყოფენ რეალურ დროში, სრული დუპლექსის საკომუნიკაციო არხს, რაც საშუალებას იძლევა მონაცემთა უფრო სწრაფი და ეფექტური გადაცემა სხვა მეთოდებთან შედარებით.
ყოფილმაampლე კითხულობს სamples, იუწყება საშუალო დრო წამშიample და მაქსიმალური შეყოვნება და ინახავს მონაცემებს CSV-ში file შემდგომი ანალიზისთვის. ეს კონფიგურაცია იძლევა რეალურ დროში ეფექტურ მონიტორინგს და მონაცემთა ადვილად შენახვას შემდგომი დამუშავებისთვის.
სპეციფიკური შესრულება, რომლის მიღწევაც შესაძლებელია Webსოკეტები დამოკიდებულია თქვენი Ethernet ინტერფეისის საიმედოობაზე და თქვენი განაცხადის შედარებით პრიორიტეტზე. ოპტიმალური შედეგებისთვის, დარწმუნდით, რომ თქვენი ქსელი სტაბილურია და FX4-ის მონაცემთა გადაცემას პრიორიტეტული აქვს საჭიროების შემთხვევაში.
ვერსია: v3
FX4 Python Exampნომერი: 21
დოკუმენტები / რესურსები
 |
PYRAMID FX4 პროგრამისტი [pdf] ინსტრუქციის სახელმძღვანელო FX4 პროგრამისტი, FX4, პროგრამისტი |