libowcapi - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

owcapi - простий 1-дротовий інтерфейс на мові C

СИНТАКСИС

libowcapi бібліотеку, щоб зв’язати її з вашою програмою

Ініціалізація
ssize_t OW_init( пристрій ім'я or Повний параметр рядок )
ssize_t OW_init_args( Int argc, бак ** аргументи )

Повний набір параметрів ініціалізації великий. Вони приблизно відповідають
параметри командного рядка owfs (1) owhttpd (1) та owftpd (1)

отримати дані
Int OW_present( сопзЬ бак * шлях )
Int OW_get( сопзЬ бак * шлях, бак ** буфер, size_t * довжина_буфера )
ssize_t OW_lread( сопзЬ бак * шлях, непідписаний бак * буфер, сопзЬ size_t розмір, сопзЬ
off_t зсув )

Установка дані
ssize_t OW_put( сопзЬ бак * шлях, сопзЬ бак * буфер, size_t * довжина_буфера )
ssize_t OW_lwrite( сопзЬ бак * шлях, сопзЬ непідписаний бак * буфер, сопзЬ size_t розмір,
сопзЬ off_t зсув )

Debug
анулювати OW_set_error_level( сопзЬ бак *парам )
анулювати OW_set_error_print( сопзЬ бак *парам )

близько
анулювати OW_finish( анулювати )

ФУНКЦІЇ

OW_init
OW_init_string пропонує повну гнучкість owfs (1) та owhttpd (1) command line.

Аргументи
Може бути таким простим, як назва пристрою, повна специфікація параметрів. Один або
більше назв пристроїв (включаючи tcp, послідовний порт, USB...) і перемикачі командного рядка. Побачити
owfs (1) для повного синтаксису.

Повернення
0 за успіх. -1 за помилкою і неправильно буде встановлено. OW_finish не потрібно
називається якщо OW_init не вдається.

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_init_args
OW_init_args пропонує повну гнучкість owfs (1) та owhttpd (1) command line.

Аргументи
Одне або кілька назв пристроїв (включаючи tcp, serial, usb...) і перемикачі командного рядка.
Читати owfs (1) для повного синтаксису. На відміну від OW_init_string аргументи в argv/argc
Формат.

Повернення
0 за успіх. -1 за помилкою і неправильно буде встановлено. OW_finish не потрібно
називається якщо OW_init не вдається.

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_present
OW_present використовується для перевірки наявності 1-дротового пристрою.

Аргументи
шлях це шлях до каталогу або файлу (властивості).

Повернення
0 на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_get
OW_get використовується для отримання списків каталогів і вмісту файлів. Результати заносяться в а
динамічно виділений буфер.

Аргументи
шлях це шлях до каталогу або файлу (властивості). *буфер повертає вказівник на
буфер, що містить каталог (розділений комою) або значення. довжина_буфера
повертає довжину значення/рядка в буфера

Повернення
кількість байтів на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

Важливий увагу
буфера виділяється ( з malloc ) за допомогою OW_get але має бути звільнено у вашій програмі.
Читати Танос (3) та безкоштовно (3)

OW_lread
OW_lread використовується для зчитування 1-дротових мікросхем пам'яті. Думайте про це як поєднання lseek та
зчитування Він дозволяє отримати довільний доступ до пам'яті, вказавши розташування та довжину. На відміну від OW_get
каталоги не можуть бути отримані, і буфер повинен бути попередньо виділений, а не виділений
за рутиною. буфера має бути принаймні розмір довжина.

Аргументи
шлях це шлях до файлу (властивості). буфера – це (попередньо виділена) область пам’яті
де буде розміщено значення. розмір довжина запитуваних байтів. зсув is
позицію у файлі, щоб почати читання.

Повернення
кількість байтів на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_put
OW_put це простий спосіб запису на 1-дротні мікросхеми.

Аргументи
шлях це шлях до файлу (властивості). буфера це значення, яке потрібно записати.
довжина_буфера є довжиною значення буфера. Повернення кількість байтів
успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_lwrite
OW_lwrite є супутником OW_lread. Це дозволяє записувати довільні позиції в
1-провідна пам'ять. Думайте про це як поєднання lseek та написати. буфера має бути принаймні
розмір довжина.

Аргументи
шлях це шлях до файлу (властивості). буфера це дані, які потрібно записати. розмір
це довжина байтів, які потрібно записати. зсув - це позиція у файлі для початку
письмова форма.

Повернення
кількість байтів на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_set_error_level
OW_set_error_level встановлює вихід налагодження на певний рівень. 0 за замовчуванням і вище
значення дає більший вихід.
(0=за замовчуванням, 1=err_connect, 2=err_call, 3=err_data, 4=err_detail, 5=err_debug,
6=помилка_за межами)

Аргументи
Титули це рівень. Повинно бути цілим числом.

Повернення
ніхто

Послідовність
Один з ініціалізації функції необхідно викликати перед встановленням рівня, оскільки ініціалізації
за замовчуванням рівень 0.

OW_set_error_print
OW_set_error_print встановлює, куди має бути спрямований вихід налагодження. 0 = змішаний вихід,
1 = системний журнал, 2 = консоль.

Аргументи
Титули це рівень. Повинно бути цілим числом від 0 до 2.

Повернення
ніхто

Послідовність
Один з ініціалізації функції необхідно викликати перед встановленням рівня, оскільки ініціалізації
за замовчуванням 0 (змішаний вихід).

OW_finish
OW_finish очищає OWFS 1-дротовий підпрограм, звільняє пристрої та пам'ять.

Аргументи
Ні.

Повернення
ніхто

Послідовність
OW_finish є необов’язковим, оскільки очищення відбувається автоматично при виході з програми.

ОПИС

1-провідний
1-провід – це протокол підключення та серія пристроїв, розроблених і виготовлених Далласом
Semiconductor, Inc. Шина являє собою схему малопотужного низькошвидкісного роз'єму, де дані
лінія також може забезпечити живлення.

Кожен пристрій має унікальну і незмінну нумерацію під час виготовлення. Є широкі
різноманітні пристрої, включаючи пам'ять, датчики (вологість, температура, напруга, контакт,
струм), перемикачі, таймери та реєстратори даних. Більш складні пристрої (наприклад, термопара
датчики) можна створити з цими основними пристроями. Існують також 1-провідні пристрої, які мають
шифрування включено.

У 1-провідній схемі використовується одинарний автобус майстер і множинні раби на тому ж дроті. Автобус
майстер ініціює всі комунікації. Рабів можна окремо виявити і
адресовані за допомогою їх унікального ідентифікатора.

Ведучі шини бувають різних конфігурацій, включаючи послідовні, паралельні, i2c, мережні
або USB адаптери.

OWFS дизайн
OWFS — це набір програм, призначених для легкого створення 1-провідної шини та її пристроїв
доступний. Основним принципом є створення віртуальної файлової системи з унікальним ідентифікатором
будучи каталогом, а окремі властивості пристрою представлені як прості
файли, які можна читати та записувати.

Деталі індивідуального підпорядкованого або головного дизайну приховані за послідовним інтерфейсом.
Мета — надати розробнику програмного забезпечення простий набір інструментів для створення моніторингу
або контрольні програми. Є деякі покращення продуктивності в реалізації,
включаючи кешування даних, паралельний доступ до головних пристроїв шини та агрегацію пристрою
спілкування. Основною метою є простота використання, гнучкість і
правильність, а не швидкість.

libowcapi
libowcapi (1) є інкапсуляцією повного libow бібліотека для програм на Сі.

libowcapi (1) дозволяє використовувати програму C OWFS принципи (послідовна схема найменування,
кілька адаптерів, пристроїв та сумісності) безпосередньо з програми на C. Існує
аналогічні модулі для інших мов програмування:

C libowcapi

Perl owperl

PHP owphp

пітон owpython

TCL owtcl

приклад

/* Простий список каталогів - без перевірки помилок */
#включати
unsigned char * buf;
size_t s ;
OW_init("/dev/ttyS0");
OW_set_error_print("2");
OW_set_error_level("6");
OW_get("/",&buf,&s) ;
printf("Каталог %s0,buf);
вільний (buf);
OW_finish() ;

Використовуйте libowcapi онлайн за допомогою служб onworks.net