www.pyramid.tech
FX4
FX4 פּראָגראַמיסט מאַנואַל
דאָקומענט שייַן: 2711715845
ווערסיע: v3

FX4 פּראָגראַמיסט

דאָקומענט שייַן: 2711715845
FX4 – FX4 פּראָגראַמירער מאַנואַל

דאָקומענט ID: 2711650310

מחבר	מתיא ניקולס
באַזיצער	פּראָיעקט פירן
ציל	דערקלערן די פּראָגראַממינג קאַנסעפּס נייטיק צו נוצן די API און פאַרברייטערן די פּראָדוקט דורך פונדרויסנדיק אַפּלאַקיישאַנז.
פאַרנעם	FX4 פֿאַרבונדענע פּראָגראַממינג קאַנסעפּס.
בדעה וילעם	ווייכווארג דעוועלאָפּערס אינטערעסירט אין ניצן דעם פּראָדוקט.
פּראָצעס	https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&טיטל=סטאַנדאַרט%20מאַנואַל%20שאַפֿונג%20פּראָצעס
טראַינינג	נישט אָנווענדלעך

ווערסיע קאָנטראָל

ווערסיע	באַשרייַבונג	געראַטעוועט דורך	געראטעוועט אויף	סטאַטוס
v3	צוגעגעבן אַ פּשוט איבערview און מער עקסamples.	מתיא ניקולס	מערץ 6, 2025 10:29 PM	באוויליקט
v2	צוגעלייגט דיגיטאַל IO ינטערפייסיז און באַווייַזן צוריק צו IGX.	מתיא ניקולס	מאי 3, 2024 7:39 PM	באוויליקט
v1	ערשט מעלדונג, נאָך אַ אַרבעט אין פּראָגרעס.	מתיא ניקולס	21 פעברואר 2024 11:25	באוויליקט

דאָקומענט קאָנטראָל נישט ריviewed
איצטיקע דאָקומענט ווערסיע: v.1
ניין ריviewערס אַסיינד.

1.1 סיגנאַטשערז
פֿאַר די לעצטע דאָקומענט ווערסיע
פרייטאג, 7טן מערץ, 2025, 10:33 ביינאכט UTC
מתיא ניקאלס האט אונטערגעשריבן ; טייַטש: רעview

רעפערענצן

דאָקומענט	דאָקומענט שייַן	מחבר	ווערסיע
IGX - פּראָגראַממער מאַנואַל	2439249921	מתיא ניקולס	1

FX4 פּראָגראַממינג איבערview

דער FX4 פּראַסעסער לויפט אויף אַן סביבה גערופן IGX, וואָס איז געבויט אויף די QNX הויך-פאַרלעסלעכקייט רעאַל-טיים אָפּערייטינג סיסטעם פון BlackBerry (QNX Webפּלאַץ¹). IGX גיט א פלעקסיבלע און פולשטענדיגע אפליקאציע פראגראמירן אינטערפייס (API) פאר באנוצער וואס ווילן שרייבן זייער אייגענע קאמפיוטער ווייכווארג.
די IGX סוויווע איז שערד צווישן אנדערע פּיראַמיד פּראָדוקטן, אַלאַוינג ווייכווארג סאַלושאַנז דעוועלאָפּעד פֿאַר איין פּראָדוקט צו זיין לייכט טראַנספערד צו אנדערע.
פּראָגראַממערס קענען אָפּשיקן צו די גאַנץ דאַקיומענטיישאַן פֿאַר IGX בנימצא אויף די פּיראַמיד webפּלאַץ אין: IGX | מאָדערנע מאָדולאַר קאָנטראָל סיסטעם פריימווערק פֿאַר Web-אַקטיווירטע אַפּליקאַציעס²

די סעקציע גיט אן הקדמה צו טעסטן צוויי פון די API מעטאדן: HTTP ניצנדיק JSON פֿאָרמאַט און EPICS. פֿאַר פּשוטקייט, פּיטהאָן (פּיטהאָן Webפּלאַץ³) ווערט גענוצט ווי אַן עקס.ampדער באַלעבאָס קאָמפּיוטער שפּראַך, וואָס איז צוטריטלעך און גרינג צו נוצן פֿאַר ניט-פאַכמאַן פּראָוגראַמערז.

3.1 ניצן פּיטהאָן און הטטפּ
ווי אַן עקסampליי, יבערנעמען איר ווילן צו לייענען די סאַכאַקל פון די געמאסטן קעראַנץ מיט פּיטהאָן. איר דאַרפֿן די URL פֿאַר דעם באַזונדער IO. די FX4 web GUI גיט אַן גרינג וועג צו געפֿינען דעם: פשוט רעכט גיט אין די פעלד און סעלעקטירן 'קאָפּי הטטפּ URL' צו נאָכמאַכן די שטריקל צו די קליפּבאָרד.

איצט איר קענען נוצן Python צו פּרובירן קאַנעקטיוויטי צו באַניצער ווייכווארג דורך HTTP און JSON. איר קען דאַרפֿן צו אַרייַנפיר די ריקוועס און דזשסאָן לייברעריז צו שעפּן די הטטפּ ריקוועס און דאַטן פּאַרסינג.

1 פּשוט פּיטהאָן הטטפּ עקסample

3.2 ניצן EPICS
דער פּראָצעס פֿאַר קאַנעקטינג די FX4 דורך EPICS (עקספּערימענטאַל פיזיק און ינדוסטריאַל קאָנטראָל סיסטעם) איז ענלעך. EPICS איז אַ סכום פון ווייכווארג מכשירים און אַפּלאַקיישאַנז געניצט צו אַנטוויקלען און ינסטרומענט פונאנדערגעטיילט קאָנטראָל סיסטעמען, וויידלי געניצט אין וויסנשאפטלעכע פאַסילאַטיז.

1. https://blackberry.qnx.com/en
2. https://pyramid.tech/products/igx
3. https://www.python.org/

1. באַקומען דעם EPICS פּראָצעס וועריאַבל (PV) נאָמען פֿאַר די געוואונטשענע IO.
2. אימפארטיר די EPICS ביבליאטעק און לייען דעם ווערט.

2 באַקומען EPICS PV נאָמען3 פּשוט פּיטהאָן עפּיקס עקסample

דערצו, האט פּיראַמיד באשאפן א נוצבאַר (עפּיקס קאָנעקט⁴) וואָס ערלויבט אײַך צו מאָניטאָרירן EPICS פּראָצעס וועריאַבאַלן אין פאַקטישער צײַט. דאָס געצייַג איז נוצלעך צו באַשטעטיקן צי דער EPICS PV נאָמען איז ריכטיק און צי די FX4 סערווירט די PV ריכטיק אויף אײַער נעץ.

4 PTC EPICS קאָננעקט

FX4 פּראָגראַממינג API

די קאַנסעפּס און מעטהאָדס דיסקרייבד אין דעם מאַנואַל בויען אויף די קאַנסעפּס געגרינדעט אין די IGX - פּראָגראַממער מאַנואַל. ביטע זען דעם דאָקומענט פֿאַר דערקלערונג און עקסampלייענען וועגן ווי יקערדיק IGX פּראָגראַממינג און ינטערפייסיז אַרבעט. דער מאַנואַל וועט בלויז דעקן די מיטל-ספּעציפיש יאָ און פאַנגקשאַנאַליטי וואָס איז יינציק צו די FX4.

4.1 אַנאַלאָג ינפּוט יאָ
די IO פאַרבינדן צו קאַנפיגיערינג און קאַלעקטינג דאַטן אויף די אַנאַלאָג קראַנט ינפּוץ פון די FX4. די וניץ פון די קאַנאַל ינפּוץ זענען באזירט אויף די באַניצער קאַנפיגיעראַבאַל באַשטעטיקן גערופֿן "Sampדי וניץ", גילטיק אָפּציעס אַרייַננעמען pA, nA, uA, mA און A.
אַלע 4 טשאַנאַלז נוצן די זעלבע צובינד IO און זענען ינדיפּענדאַנטלי קאַנטראָולד. ריספּעקטיוולי פאַרבייַטן קאַנאַל_קס מיט קאַנאַל_1, קאַנאַל_2, קאַנאַל_3 אָדער קאַנאַל_4.

IO פּאַט	באַשרייַבונג
/fx4/adc/channel_x	נאָר לייענען נומער געמאָסטן קראַנט אַרייַנשרייַב.
/fx4/adc/channel_x/scalar	נומער א פשוטער איינהייטלאָזער סקאַלאַר געווענדט צום קאַנאַל, 1 דורך פעליקייט.
/fx4/adc/channel_x/zero_offset	נומער קראַנט אָפסעט אין nA פֿאַר דעם קאַנאַל.

די פאלגענדע IO זענען נישט קאַנאַל פרייַ און זענען געווענדט צו אַלע טשאַנאַלז סיימאַלטייניאַסלי.

IO פּאַט	באַשרייַבונג
/fx4/channel_sum	נאָר לייענען נומער סומע פון ​​די איצטיקע אַרייַנגאַנג קאַנאַלן.
/fx4/adc_unit	STRING שטעלט די איצטיקע באַניצער איינהייטן פֿאַר יעדן קאַנאַל און סומע. אָפּציעס: "פּאַ", "נאַ", "ואַ", "מאַ", "אַ"
/fx4/range	STRING שטעלט דעם איצטיקן אינפוט ראַנג. זעט די GUI פאר ווי יעדער ראַנג קאָד קאָרעספּאָנדירט צו די מאַקסימום איצטיקע אינפוט לימיטן און BW. אָפּציעס: "0", "1", "2", "3", "4", "5", "6", "7"
/fx4/adc/sample_frequency	נומער די פרעקווענץ אין הערץ וואָסampדי דאַטן וועט זיין אַוורידזשד צו. דעם קאָנטראָלס די סיגנאַל-צו-ראַש און דאַטן קורס פֿאַר אַלע טשאַנאַלז.
/fx4/adc/conversion_frequency	נומער די פרעקווענץ אין הערץ ביי וועלכער דער ADC וועט פארוואנדלען אנאלאג צו דיגיטאלע ווערטן. דורך דיפאלט, דאס איז 100kHz, און איר וועט נאר זעלטן דארפן ענדערן דעם ווערט.
/fx4/adc/offset_correction	נאָר לייענען נומער סומע פון ​​אַלע קאַנאַל ס קראַנט אָפסעטן.

4.2 אַנאַלאָג רעזולטאַט יאָ
די IO פאַרבינדן צו די קאַנפיגיעריישאַן פון די אַלגעמיינע אַנאַלאָג אַוטפּוץ פון די FX4 געפֿונען אונטער די אַנאַלאָג ינפּוץ אויף די פראָנט טאַפליע. אַלע 4 טשאַנאַלז נוצן די זעלבע צובינד IO און זענען ינדיפּענדאַנטלי קאַנטראָולד. ריספּעקטיוולי ריפּלייסט קאַנאַל_קס מיט קאַנאַל_1, קאַנאַל_2, קאַנאַל_3 אָדער קאַנאַל_4.

IO פּאַט	באַשרייַבונג
/fx4/dac /channel_x	נומער באַפֿעל באַנדtage רעזולטאַט. דעם ווערט קענען זיין געשריבן בלויז ווען רעזולטאַט מאָדע איז באַשטימט צו מאַנואַל.
/fx4/dac/channel_x/readback	נאָר לייענען נומער געמאָסטן באַנדtage רעזולטאַט. דאָס איז מערסט נוצלעך ווען מען ניצט אויסדריק אַרויסגאַנג מאָדע.
/fx4/dac/channel_x/output_mode	STRING שטעלט איין דעם אויסגאַנג מאָדע פֿאַר דעם קאַנאַל. אָפּציעס: "מאַנואַל", "אויסדרוק", "פּראָצעס_קאָנטראָל"
/fx4/dac/קאַנאַל _ x/slew_control_enable	BOOL אַקטיוויזירט אָדער דיאַקטיוויזירט סלעו ראַטע לימיטינג.
/fx4/dac/קאַנאַל_ x/שלע_רייט	נומער סלעו רעיט אין וולט/ס פארן קאנאל.
/fx4/dac/channel_x/upper_limit	נומער די מאַקסימום ערלויבטע באַפֿעל באַנדtagE פֿאַר דעם קאַנאַל. אַפּלייז צו אַלע אָפּעראַציע מאָדעס.
/fx4/dac/קאַנאַל _ x/נידעריקער_לימיט	נומער די מינימום ערלויבטע באַפֿעל באַנדtagE פֿאַר דעם קאַנאַל. אַפּלייז צו אַלע אָפּעראַציע מאָדעס.
/fx4/dac/קאַנאַל _ x/ אַרויסגאַנג _ אויסדרוק	STRING שטעלט איין די אויסדריק סטרינג וואס ווערט גענוצט דורך דעם קאנאל ווען ער איז אין די אויסדריק ארויסגאנג מאָדע.
/fx4/dac/קאַנאַל _ x/reset_button	קנעפּל שטעלט צוריק דעם באַפֿעל באַנדtagE צו 0.

4.3 דיגיטאַל ינפּוט און אַוטפּוץ
די IO פאַרבינדן צו קאַנטראָולינג די פאַרשידן דיגיטאַל ינפּוץ און אַוטפּוץ פֿאַר אַלגעמיין ציל אויף די FX4.

IO פּאַט	באַשרייַבונג
/fx4/fr1	נאָר לייענען BOOL פיבער ופנעמער 1.
/fx4/ft1	BOOL פיבער טראַנסמיטער 1.
/fx4/fr2	נאָר לייענען BOOL פיבער ופנעמער 2.
/fx4/ft2	BOOL פיבער טראַנסמיטער 2.
/fx4/fr3	נאָר לייענען 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 דיגיטאַל יאָ קאַנפיגיעריישאַן
אַלע דיגיטאַלס ​​האָבן קינד יאָ פֿאַר קאַנפיגיערינג זייער נאַטור, אַרייַנגערעכנט אַן אָפּערייטינג מאָדע וואָס קאָנטראָלס ווי די דיגיטאַל וועט אַרבעטן. יעדער דיגיטאַל וועט האָבן אַ אַנדערש גאַנג פון בנימצא אָפּציעס. זען די GUI פֿאַר דעטאַילס וועגן וואָס אָפּציעס זענען בנימצא פֿאַר וואָס IO.

קינד יאָ פּאַט	באַשרייַבונג
…/מאָדע	STRING אָפּעראַציע מאָדע פֿאַר די דיגיטאַל. אָפּציעס: "אינפּוט", "אויסגאַנג", "פּום", "טיימער", "ענקאָדער", "קאַפּטשער", "uart_rx", "uart_tx", "קען_rx", "קען_tx", "פּרו_אינפּוט", אדער "פּרו_אויסגאַנג"
…/proces_signal	STRING דער נאָמען פֿון דעם פּראָצעס קאָנטראָל סיגנאַל, אויב עס איז פֿאַראַן איינער.
…/pull_mode	STRING ציען אַרויף/אַראָפּ מאָדע פֿאַר אַ דיגיטאַל אַרייַנגאַנג. אָפּציעס: "אַרויף", "אַראָפּ", אָדער "דיאַקטיווירן"

4.4 רעלע קאָנטראָל
ביידע רילייז זענען ינדיפּענדאַנטלי קאַנטראָולד און טיילן די זעלבע טיפּ פון צובינד. פאַרבייַטן relay_x מיט relay_a אָדער relay_b ריספּעקטיוולי.

IO פּאַט	באַשרייַבונג
/fx4/relay _ x/permit / באַניצער _ באַפֿעל	BOOL באַפֿעלט דעם רעליי צו עפֿענען אָדער צו פֿאַרמאַכן. אַן אמת באַפֿעל וועט פּרובירן צו פֿאַרמאַכן דעם רעליי אויב די פֿאַרשליסונגען ווערן געגעבן, און אַ פֿאַלשער באַפֿעל וועט שטענדיק עפֿענען דעם רעליי.
/fx4/רעליי _ x/שטאַט	נאָר לייענען סטרינג דער איצטיקער צושטאַנד פֿון דעם רעליי. פארשלאסענע רעלייז זענען אפן אבער קענען נישט פארמאכט ווערן צוליב אן אינטערלאק. שטאַטן: "געעפֿנט", "פארמאכט", אָדער "פארשפארט"
/fx4/רעליי _ x/אויטאמאטיש _ שליסן	BOOL ווען געשטעלט צו אמת, וועט די רעליי זיך אויטאמאטיש פארמאכן ווען די אינטערלאקס ווערן געגעבן. פאלש דורך דיפאלט.
/fx4/רעליי _ x/ ציקל _ צייל	נאָר לייענען נומער די נומער פון רעליי ציקלען זינט די לעצטע ריסעט. נוצלעך פֿאַר טראַקינג רעליי לעבן.

4.5 הויך וואָלtagE מאָדולע
זען די IGX - פּראָגראַמיסט מאַנואַל פֿאַר דעטאַילס וועגן די FX4 הויך וואָלtagE צובינד. דער קאָמפּאָנענט פאָטער דרך איז /fx4/high_votlage.

4.6 דאָזע קאָנטראָללער
זען די IGX - פּראָגראַממער מאַנואַל פֿאַר דעטאַילס וועגן די FX4 דאָזע קאָנטראָללער צובינד. דער קאָמפּאָנענט פאָטער דרך איז /fx4/dose_controller.

FX4 פּיטהאָן עקסamples

5.1 דאַטאַ לאַגער ניצן הטטפּ
דעם עקסampדי דעמאַנסטרייץ ווי צו כאַפּן אַ נומער פון רידינגז און ראַטעווען זיי צו אַ קסוו file. דורך טשוזינג אַ לאַנג פאַרהאַלטן צווישן רידינגז, איר קענען דורכפירן לאַנג-טערמין דאַטן לאָגינג אפילו אויב די FX4 s.ampלינג קורס איז באַשטימט העכער. דאָס אַלאַוז איר צו קאַנטיניואַסלי זאַמלען און קראָם מעזשערמאַנץ איבער עקסטענדעד פּיריאַדז אָן אָוווערוועלמינג די סיסטעם, און ינשורינג אַז דאַטן זענען קאַפּטשערד מיט ינטערוואַלז פּאַסיק פֿאַר דיין אַנאַליסיס. די פאַרהאַלטן צווישן רידינגז העלפּס רעגולירן דעם גאַנג אין וואָס דאַטן זענען לאָגד, אַלאַוינג פֿאַר עפעקטיוו סטאָרידזש און רידוסינג די ריזיקירן פון פעלנדיק דאַטן פונקטן און נאָך נוץ פון הויך-גיכקייַט ס.ampלינג פֿאַר פאַקטיש-צייט מעזשערמאַנץ.

5.2 פּשוט פּיטהאָן גוי
דער צווייטער עקסample ניצט די Tkinter GUI געצייַג, וואָס איז געבויט פֿאַר פּיטהאָן, צו שאַפֿן אַ ווייַז פון די געמאסטן קעראַנץ. דער צובינד אַלאַוז איר צו וויזשוואַלייז די קראַנט רידינגז אין אַ באַניצער-פרייַנדלעך גראַפיק פֿאָרמאַט. די אַרויסווייַזן קענען זיין רעסיזעד צו מאַכן עס גרויס גענוג צו לייענען פֿון אַריבער אַ פּלאַץ, וואָס איז ידעאַל פֿאַר סינעריאָוז ווו פאַקטיש-צייט מאָניטאָרינג איז דארף אין גרעסערע ספּייסאַז. Tkinter גיט אַן גרינג וועג צו שאַפֿן ינטעראַקטיוו ינטערפייסיז, און דורך ינטאַגרייטינג עס מיט די FX4, איר קענען געשווינד בויען אַ וויזשאַוואַל ווייַז פון די געמאסטן קעראַנץ וואָס קענען זיין קאַסטאַמייזד צו פּאַסיק דיין ספּעציפיש באדערפענישן.

5.3 פּשוט Webסאָקקעץ עקסample
דעם עקסampלאַ דעמאַנסטרייץ די Webסאָקקעץ צובינד, וואָס איז די בילכער אופֿן פֿאַר לייענען דאַטן פֿון די FX4 ווען מאַקסימום באַנדווידט איז פארלאנגט. Webסאָקקעץ צושטעלן אַ פאַקטיש-צייט, פול-דופּלעקס קאָמוניקאַציע קאַנאַל, אַלאַוינג פאַסטער און מער עפעקטיוו דאַטן אַריבערפירן קאַמפּערד מיט אנדערע מעטהאָדס.
די עקסample לייענט אַ סעריע פון ​​סampליי, ריפּאָרץ די דורכשניטלעך צייט פּער סampאון מאַקסימום לייטאַנסי, און סאַוועס די דאַטן צו אַ קסוו file פֿאַר שפּעטער אַנאַליסיס. דעם סעטאַפּ אַלאַוז פֿאַר עפעקטיוו פאַקטיש-צייט מאָניטאָרינג און גרינג דאַטן סטאָרידזש פֿאַר פּאָסטן-פּראַסעסינג.
די ספּעציפיש פאָרשטעלונג וואָס קענען זיין אַטשיווד מיט Webסאָקקעץ דעפּענדס אויף די רילייאַבילאַטי פון דיין עטהערנעט צובינד און די קאָרעוו בילכערקייַט פון דיין אַפּלאַקיישאַן. פֿאַר אָפּטימאַל רעזולטאַטן, ענשור אַז דיין נעץ איז סטאַביל און אַז די FX4 ס דאַטן טראַנסמיסיע איז פּרייאָראַטייזד אויב נייטיק.

ווערסיע: v3
FX4 פּיטהאָן עקסampליי: 21

דאָקומענטן / רעסאָורסעס

פּיראַמיד פקס4 פּראָגראַמיסט [pdf] אינסטרוקציע מאַנואַל FX4 פּראָגראַמיסט, FX4, פּראָגראַמיסט

רעפערענצן

• באַניצער מאַנואַל