libownet - מקוון בענן

תָכְנִית:

שֵׁם

ownet , (libownet) - ממשק 1 חוט קל בשפה C לפרוטוקול owserver

תַקצִיר

libownet ספרייה כדי לקשר עם התוכנית שלך

ידית
OWNET_HANDLE
טיפול לכל חיבור שרת

אתחול
OWNET_HANDLE OWNET_init( const char * owserver_tcp_address_and_port )
שייך א שרת בעלים (1) כתובת tcp/ip עם ידית אחיזה.

מַדרִיך רישום
int OWNET_dirlist( OWNET_HANDLE owserver_handle , const char * onewire_path , char **
רשימה_מופרדת בפסיקים )
צור רשימה מופרדת בפסיקים של רכיבי ספרייה.

int OWNET_dirprocess( OWNET_HANDLE owserver_handle , const char * onewire_path , לבטל את (*
dirfunc ) (בָּטֵל *, const char *), לבטל את * עבר_על_ערך )
לבטל את dirfunc ( לבטל את * עבר_על_ערך , const char * directory_element )
החל פונקציה dirfunc לכל רכיב ספרייה, יחד עם ערך עבר_על_שרירותי.

לקבל נתונים
int OWNET_read( OWNET_HANDLE owserver_handle , const char * onewire_path , const char **
החזר_מחרוזת )
קרא ערך (בגודל שצוין) ממכשיר בעל חוט אחד.

int OWNET_lread( OWNET_HANDLE owserver_handle , const char * onewire_path , const char **
החזר_מחרוזת , גודל_ט גודל , off_t לקזז )
קרא ערך (בגודל והיסט שצוינו) מהתקן בעל חוט אחד.

int OWNET_present( OWNET_HANDLE owserver_handle , const char * onewire_path )
בדוק אם קיים התקן בעל חוט אחד.

לקבוע נתונים
int OWNET_put( OWNET_HANDLE owserver_handle , const char * onewire_path , const char *
מחרוזת_ערך , גודל_ט גודל )
כתוב ערך (בגודל שצוין) להתקן בעל חוט אחד.

int OWNET_lwrite( OWNET_HANDLE owserver_handle , const char * onewire_path , const char *
מחרוזת_ערך , גודל_ט גודל , off_t לקזז )
כתוב ערך (בגודל מוגדר וקיזוז) להתקן בעל חוט אחד.

סְגוֹר
לבטל את OWNET_close( OWNET_HANDLE owserver_handle )
סגור את החיבור לשרת מסוים.

לבטל את OWNET_closeall( לבטל את )
סגור את כל חיבורי השרת הפתוחים.

לבטל את OWNET_finish( לבטל את )
סגור את כל חיבורי השרת הפתוחים ושחרר את כל הזיכרון.

טֶמפֶּרָטוּרָה סולם
לבטל את OWNET_set_temperature_scale( char סולם_טמפרטורה )
char OWNET_get_temperature_scale( לבטל את )
הגדר ואחזר את סולם הטמפרטורה המשמש עבור כל התקשורת.

מכשיר פוּרמָט
לבטל את OWNET_set_device_format( const char * device_format )
const char * OWNET_get_device_format( לבטל את )
הגדר ואחזר את פורמט המספר הסידורי של התקן בעל חוט אחד המשמש עבור כל התקשורת.

פונקציות

OW_init
מחרוזת OW_init מציעה את הגמישות המלאה של אופס (1) ו owhttpd (1) שורת הפקודה.

טיעונים
יכול להיות פשוט כמו רק שם המכשיר, מפרט פרמטר מלא. אחד או
עוד שמות מכשירים (כולל tcp, טורי, usb...) ומתגי שורת פקודה. לִרְאוֹת
אופס (1) לתחביר מלא.

החזרים
0 להצלחה. -1 על שגיאה ו ארנו ייקבע. OW_finish לא צריך להיות
נקרא אם OW_init נכשל.

רצף
אחד מ init יש לקרוא לפונקציות לפני גישה לאפיק 1-wire.
OW_finish הוא לא חובה.

OW_init_args
OW_init_args מציעה את הגמישות המלאה של אופס (1) ו owhttpd (1) שורת הפקודה.

טיעונים
שם מכשיר אחד או יותר (כולל tcp, טורי, usb...) ומתגי שורת פקודה.
לִרְאוֹת אופס (1) לתחביר מלא. בניגוד מחרוזת OW_init הטיעונים נמצאים ב-argv/argc
פורמט.

החזרים
0 להצלחה. -1 על שגיאה ו ארנו ייקבע. OW_finish לא צריך להיות
נקרא אם OW_init נכשל.

רצף
אחד מ init יש לקרוא לפונקציות לפני גישה לאפיק 1-wire.
OW_finish הוא לא חובה.

OW_קבל
OW_קבל משמש כדי לקבל רשימות ספריות ותוכן קבצים. התוצאות מוכנסות ל-a
מאגר מוקצה דינמית.

טיעונים
נתיב הוא הנתיב לספרייה או לקובץ (מאפיין). *בַּלָם מחזיר מצביע אל
מאגר המכיל את הספרייה (מופרדת בפסיק) או את הערך. buffer_length
מחזירה את אורך הערך/מחרוזת ב חיץ

החזרים
מספר בתים על הצלחה. -1 על שגיאה (ו ארנו מוגדר).

רצף
אחד מ init יש לקרוא לפונקציות לפני גישה לאפיק 1-wire.
OW_finish הוא לא חובה.

חָשׁוּב הערות
חיץ מוקצה (עם malloc) על ידי OW_קבל אבל חייב להיות משוחרר בתוכנית שלך.
לִרְאוֹת malloc (3) ו חופשי (3)

OW_lread
OW_lread משמש לקריאת שבבי זיכרון 1-wire. תחשוב על זה כשילוב של מבקש ו
לקרוא הוא מאפשר גישה אקראית לזיכרון, תוך ציון מיקום ואורך. בניגוד OW_קבל
לא ניתן להשיג ספריות ויש להקצות מראש את המאגר במקום להקצות
לפי השגרה. חיץ חייב להיות לפחות גודל אורך.

טיעונים
נתיב הוא הנתיב לקובץ (הנכס). חיץ הוא אזור הזיכרון (המוקץ מראש).
היכן ימוקם הערך. גודל הוא אורך הבתים המבוקש. לקזז is
המיקום בקובץ כדי להתחיל לקרוא.

החזרים
מספר בתים על הצלחה. -1 על שגיאה (ו ארנו מוגדר).

רצף
אחד מ init יש לקרוא לפונקציות לפני גישה לאפיק 1-wire.
OW_finish הוא לא חובה.

OW_put
OW_put היא דרך קלה לכתוב לשבבי 1-wire.

טיעונים
נתיב הוא הנתיב לקובץ (הנכס). חיץ הוא הערך שיש לכתוב.
buffer_length הוא אורך הערך מאגר. החזרים מספר בתים פועל
הַצלָחָה. -1 על שגיאה (ו ארנו מוגדר).

רצף
אחד מ init יש לקרוא לפונקציות לפני גישה לאפיק 1-wire.
OW_finish הוא לא חובה.

OW_lwrite
OW_lwrite הוא בן לוויה של OW_lread. זה מאפשר כתיבה לעמדות שרירותיות ב
זיכרון 1 חוט. תחשוב על זה כשילוב של מבקש ו לכתוב. חיץ חייב להיות לפחות
גודל אורך.

טיעונים
נתיב הוא הנתיב לקובץ (הנכס). חיץ הוא הנתונים שיש לכתוב. גודל
הוא אורך הבתים שיש לכתוב. לקזז הוא המיקום בקובץ להתחיל
בכתב.

החזרים
מספר בתים על הצלחה. -1 על שגיאה (ו ארנו מוגדר).

רצף
אחד מ init יש לקרוא לפונקציות לפני גישה לאפיק 1-wire.
OW_finish הוא לא חובה.

OW_finish
OW_finish מנקה את OWFS שגרות 1 חוט, משחרר מכשירים וזיכרון.

טיעונים
אין.

החזרים
ללא חתימה

רצף
OW_finish הוא אופציונלי מכיוון שהניקוי הוא אוטומטי ביציאה מהתוכנית.

תיאור

1-חוט
חוט 1 הוא פרוטוקול חיווט וסדרת מכשירים שתוכננו ויוצרו על ידי דאלאס
Semiconductor, Inc. האוטובוס הוא תוכנית מחברים נמוכה במהירות נמוכה שבה הנתונים
קו יכול גם לספק כוח.

כל מכשיר ממוספר באופן ייחודי וללא שינוי במהלך הייצור. יש רחב
מגוון מכשירים, כולל זיכרון, חיישנים (לחות, טמפרטורה, מתח, מגע,
זרם), מתגים, טיימרים ואוגרי נתונים. מכשירים מורכבים יותר (כמו צמד תרמי
חיישנים) ניתן לבנות עם מכשירים בסיסיים אלה. ישנם גם התקני 1-wire שיש
הצפנה כלולה.

ערכת 1-wire משתמשת בסינגל אוטובוס אב ורבים עבדים על אותו חוט. האוטובוס
המאסטר יוזם את כל התקשורת. ניתן לגלות את העבדים בנפרד ו
פונים באמצעות המזהה הייחודי שלהם.

מאסטרים לאוטובוס מגיעים במגוון תצורות כולל טוריות, מקבילות, i2c, רשת
או מתאמי USB.

OWFS עיצוב
OWFS היא חבילת תוכניות שנועדה להפוך את האפיק 1-wire והמכשירים שלו בקלות
נגיש. העיקרון הבסיסי הוא יצירת מערכת קבצים וירטואלית, עם המזהה הייחודי
להיות הספרייה, והמאפיינים האישיים של המכשיר מיוצגים כפשוטים
קבצים שניתן לקרוא ולכתוב.

הפרטים של עיצוב העבד או המאסטר הבודדים מוסתרים מאחורי ממשק עקבי.
המטרה היא לספק סט קל של כלים עבור מעצב תוכנה ליצירת ניטור
או שליטה ביישומים. יש כמה שיפורים בביצועים ביישום,
כולל אחסון נתונים במטמון, גישה מקבילה למאסטרים של אוטובוס, וצבירה של מכשיר
תִקשׁוֹרֶת. עדיין המטרה הבסיסית הייתה קלות שימוש, גמישות ו
נכונות ולא מהירות.

libowcapi
libowcapi (1) הוא אנקפסולציה של המלא ליבו ספרייה עבור תוכניות C.

libowcapi (1) מאפשר שימוש בתוכנת C OWFS עקרונות (סכימת שמות עקבית,
מספר מתאמים, התקנים ותאימות) ישירות מתוכנית C. יש
מודולים אנלוגיים לשפות תכנות אחרות:

C libowcapi

פרל אופרל

php אוףפ

פִּיתוֹן אופיתון

TCL owtcl

דוגמא

/* רישום ספריות פשוט -- אין שגיאות בבדיקת */
#לִכלוֹל
char * buf;
size_t s;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s) ;
printf("ספרייה %s0,buf);
חינם (buff);
OWNET_finish() ;

השתמש ב-libownet באינטרנט באמצעות שירותי onworks.net