owcapi - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

owcapi - ງ່າຍ​ໃນ​ການ​ໂຕ້​ຕອບ 1 ສາຍ​ພາ​ສາ C​

ສະຫຼຸບສັງລວມ

libowcapi ຫ້ອງສະຫມຸດເພື່ອເຊື່ອມຕໍ່ກັບໂຄງການຂອງທ່ານ

ການລິເລີ່ມ
ssize_t OW_init( ອຸປະກອນ ຊື່ or ຢ່າງເຕັມທີ່ ພາລາມິເຕີ string )
ssize_t OW_init_args( int ໂຕ້ຖຽງ, char ** ໂຕ້ຖຽງ )

ຊຸດເຕັມຂອງທາງເລືອກໃນການເລີ່ມຕົ້ນແມ່ນກວ້າງຂວາງ. ພວກ​ເຂົາ​ເຈົ້າ​ກ່ຽວ​ກັບ​ການ​ປະ​ມານ​
ຕົວເລືອກແຖວຄໍາສັ່ງຂອງ owfs (1​) owhttpd (1​) ແລະ owftpd (1​)

ໄດ້ຮັບ ຂໍ້ມູນ
int OW_present( const char * ເສັ້ນທາງ )
int OW_get( const char * ເສັ້ນທາງ, char ** ບັຟເຟີ, ຂະ ໜາດ * buffer_length )
ssize_t OW_lread( const char * ເສັ້ນທາງ, ລົງນາມ char * ບັຟເຟີ, const ຂະ ໜາດ ຂະ ໜາດ, const
off_t ຊົດເຊີຍ )

ທີ່ກໍານົດໄວ້ ຂໍ້ມູນ
ssize_t OW_put( const char * ເສັ້ນທາງ, const char * ບັຟເຟີ, ຂະ ໜາດ * buffer_length )
ssize_t OW_lwrite( const char * ເສັ້ນທາງ, const ລົງນາມ char * ບັຟເຟີ, const ຂະ ໜາດ ຂະ ໜາດ,
const off_t ຊົດເຊີຍ )

Debug
void OW_set_error_level( const char *ພາຣາມ )
void OW_set_error_print( const char *ພາຣາມ )

ປິດ
void OW_finish( void )

FUNCTIONS

OW_init
OW_init_string ສະຫນອງຄວາມຍືດຫຍຸ່ນຢ່າງເຕັມທີ່ຂອງ owfs (1​) ແລະ owhttpd (1​) ບັນທັດຄໍາສັ່ງ.

Arguments
ສາມາດງ່າຍດາຍຄືກັບຊື່ອຸປະກອນ, ສະເພາະພາລາມິເຕີເຕັມ. ຫນຶ່ງຫຼື
ຊື່ອຸປະກອນເພີ່ມເຕີມ (ລວມທັງ tcp, serial, usb...) ແລະການປ່ຽນສາຍຄຳສັ່ງ. ເບິ່ງ
owfs (1​) ສໍາລັບ syntax ເຕັມ.

ຜົນຕອບແທນ
0 ສໍາລັບຄວາມສໍາເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ​ແລະ​ ຜິດພາດ ຈະໄດ້ຮັບການກໍານົດໄວ້. OW_finish ບໍ່ ຈຳ ເປັນຕ້ອງເປັນ
ເອີ້ນວ່າຖ້າ OW_init ລົ້ມເຫລວ.

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

OW_init_args
OW_init_args ສະຫນອງຄວາມຍືດຫຍຸ່ນຢ່າງເຕັມທີ່ຂອງ owfs (1​) ແລະ owhttpd (1​) ບັນທັດຄໍາສັ່ງ.

Arguments
ນຶ່ງ ຫຼືຫຼາຍຊື່ອຸປະກອນ (ລວມທັງ tcp, serial, usb...) ແລະປຸ່ມສະຫຼັບແຖວຄຳສັ່ງ.
ເບິ່ງ owfs (1​) ສໍາລັບ syntax ເຕັມ. ບໍ່​ມັກ OW_init_string ການໂຕ້ຖຽງແມ່ນຢູ່ໃນ argv/argc
ຮູບແບບ.

ຜົນຕອບແທນ
0 ສໍາລັບຄວາມສໍາເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ​ແລະ​ ຜິດພາດ ຈະໄດ້ຮັບການກໍານົດໄວ້. OW_finish ບໍ່ ຈຳ ເປັນຕ້ອງເປັນ
ເອີ້ນວ່າຖ້າ OW_init ລົ້ມເຫລວ.

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

OW_ປະຈຸບັນ
OW_ປະຈຸບັນ ຖືກນໍາໃຊ້ເພື່ອກວດກາເບິ່ງການປະກົດຕົວຂອງອຸປະກອນ 1 ສາຍ.

Arguments
ເສັ້ນທາງ ແມ່ນເສັ້ນທາງໄປຫາໄດເລກະທໍລີຫຼືໄຟລ໌ (ຊັບສິນ).

ຜົນຕອບແທນ
0 ກ່ຽວກັບຄວາມສໍາເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ (ແລະ​ ຜິດພາດ ຖືກກໍານົດໄວ້).

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

OW_get
OW_get ຖືກນໍາໃຊ້ເພື່ອເອົາລາຍຊື່ໄດເລກະທໍລີແລະເນື້ອຫາໄຟລ໌. ຜົນໄດ້ຮັບແມ່ນໃສ່ໃນ a
buffer ຈັດສັນແບບໄດນາມິກ.

Arguments
ເສັ້ນທາງ ແມ່ນເສັ້ນທາງໄປຫາໄດເລກະທໍລີຫຼືໄຟລ໌ (ຊັບສິນ). * ບັຟເຟີ ຕອບຕົວຊີ້ໄປຫາ
buffer ທີ່ປະກອບດ້ວຍໄດເລກະທໍລີ (ເຄື່ອງໝາຍຈຸດທີ່ແຍກອອກ) ຫຼືຄ່າ. buffer_length
ຕອບຄ່າຄວາມຍາວຂອງຄ່າ/string in buffer

ຜົນຕອບແທນ
ຈໍານວນໄບຕ໌ຕໍ່ຄວາມສໍາເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ (ແລະ​ ຜິດພາດ ຖືກກໍານົດໄວ້).

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

ທີ່ສໍາຄັນ ຫມາຍ​ເຫດ​
buffer ຖືກຈັດສັນ (ກັບ malloc) ໂດຍ OW_get ແຕ່ຕ້ອງໄດ້ຮັບການປົດປ່ອຍຢູ່ໃນໂຄງການຂອງທ່ານ.
ເບິ່ງ ສູນການຄ້າ (3​) ແລະ ຟຣີ (3​)

OW_lread
OW_lread ຖືກນໍາໃຊ້ເພື່ອອ່ານຊິບຫນ່ວຍຄວາມຈໍາ 1 ສາຍ. ຄິດວ່າມັນເປັນການປະສົມປະສານຂອງ ຊອກຫາ ແລະ
ອ່ານ ມັນອະນຸຍາດໃຫ້ເຂົ້າເຖິງຄວາມຊົງຈໍາແບບສຸ່ມ, ການລະບຸສະຖານທີ່ແລະຄວາມຍາວ. ບໍ່​ມັກ OW_get
ບໍ່ສາມາດຮັບໄດເລກະທໍລີໄດ້ ແລະ buffer ຕ້ອງໄດ້ຮັບການຈັດສັນລ່ວງໜ້າແທນທີ່ຈະຈັດສັນ
ໂດຍປົກກະຕິ. buffer ຕ້ອງເປັນຢ່າງ ໜ້ອຍ ຂະຫນາດ ຄວາມຍາວ.

Arguments
ເສັ້ນທາງ ແມ່ນເສັ້ນທາງໄປຫາໄຟລ໌ (ຊັບສິນ). buffer ແມ່ນພື້ນທີ່ຄວາມຊົງຈຳ (ທີ່ຈັດສັນໄວ້ລ່ວງໜ້າ).
ບ່ອນທີ່ມູນຄ່າຈະຖືກວາງໄວ້. ຂະຫນາດ ແມ່ນຄວາມຍາວຂອງ bytes ທີ່ຮ້ອງຂໍ. ຊົດເຊີຍ is
ຕໍາແຫນ່ງໃນໄຟລ໌ເພື່ອເລີ່ມຕົ້ນການອ່ານ.

ຜົນຕອບແທນ
ຈໍານວນໄບຕ໌ຕໍ່ຄວາມສໍາເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ (ແລະ​ ຜິດພາດ ຖືກກໍານົດໄວ້).

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

OW_put
OW_put ເປັນວິທີທີ່ງ່າຍທີ່ຈະຂຽນໃສ່ຊິບ 1 ສາຍ.

Arguments
ເສັ້ນທາງ ແມ່ນເສັ້ນທາງໄປຫາໄຟລ໌ (ຊັບສິນ). buffer ແມ່ນຄ່າທີ່ຈະຂຽນ.
buffer_length ແມ່ນຄວາມຍາວຂອງມູນຄ່າ buffer ຜົນຕອບແທນ ຈໍານວນຂອງ bytes ສຸດ
ຄວາມ​ສໍາ​ເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ (ແລະ​ ຜິດພາດ ຖືກກໍານົດໄວ້).

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

OW_lwrite
OW_lwrite ເປັນເພື່ອນຂອງ OW_lread. ມັນອະນຸຍາດໃຫ້ຂຽນໄປຫາຕໍາແຫນ່ງທີ່ມັກໃນ
ໜ່ວຍຄວາມຈຳ 1 ສາຍ. ຄິດວ່າມັນເປັນການປະສົມປະສານຂອງ ຊອກຫາ ແລະ ຂຽນ buffer ຕ້ອງເປັນຢ່າງ ໜ້ອຍ
ຂະຫນາດ ຄວາມຍາວ.

Arguments
ເສັ້ນທາງ ແມ່ນເສັ້ນທາງໄປຫາໄຟລ໌ (ຊັບສິນ). buffer ແມ່ນ​ຂໍ້​ມູນ​ທີ່​ຈະ​ຂຽນ​. ຂະຫນາດ
ແມ່ນຄວາມຍາວຂອງ bytes ທີ່ຈະຂຽນ. ຊົດເຊີຍ ແມ່ນຕໍາແຫນ່ງໃນໄຟລ໌ທີ່ຈະເລີ່ມຕົ້ນ
ການ​ຂຽນ.

ຜົນຕອບແທນ
ຈໍານວນໄບຕ໌ຕໍ່ຄວາມສໍາເລັດ. -1 ໃນ​ຄວາມ​ຜິດ​ພາດ (ແລະ​ ຜິດພາດ ຖືກກໍານົດໄວ້).

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຟັງຊັນຕ້ອງຖືກເອີ້ນກ່ອນທີ່ຈະເຂົ້າເຖິງລົດເມ 1 ສາຍ.
OW_finish ແມ່ນທາງເລືອກ.

OW_set_error_level
OW_set_error_level ກໍານົດຜົນດີບັ໊ກໃຫ້ຢູ່ໃນລະດັບທີ່ແນ່ນອນ. 0 ແມ່ນຄ່າເລີ່ມຕົ້ນ, ແລະສູງກວ່າ
ມູນຄ່າເຮັດໃຫ້ຜົນຜະລິດຫຼາຍ.
(0=default, 1=err_connect, 2=err_call, 3=err_data, 4=err_detail, 5=err_debug,
6=err_beyond)

Arguments
params ແມ່ນລະດັບ. ຄວນເປັນຈຳນວນເຕັມ.

ຜົນຕອບແທນ
ບໍ່ມີ

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຫນ້າທີ່ຕ້ອງໄດ້ຮັບການເອີ້ນກ່ອນທີ່ຈະກໍານົດລະດັບ, ນັບຕັ້ງແຕ່ ໃນ​ມັນ
ເລີ່ມຕົ້ນເປັນລະດັບ 0.

OW_set_error_print
OW_set_error_print ກໍານົດບ່ອນທີ່ຜົນດີບັ໊ກຄວນຈະຖືກນໍາໄປ. 0=ຜົນ​ຜະ​ລິດ​ປະ​ສົມ​,
1=syslog, 2=ຄອນໂຊ.

Arguments
params ແມ່ນລະດັບ. ຄວນເປັນຈຳນວນເຕັມລະຫວ່າງ 0 ຫາ 2.

ຜົນຕອບແທນ
ບໍ່ມີ

ລໍາດັບ
ຫນຶ່ງ​ໃນ ໃນ​ມັນ ຫນ້າທີ່ຕ້ອງໄດ້ຮັບການເອີ້ນກ່ອນທີ່ຈະກໍານົດລະດັບ, ນັບຕັ້ງແຕ່ ໃນ​ມັນ
ຄ່າເລີ່ມຕົ້ນເປັນ 0 (ຜົນຜະສົມຜະສານ).

OW_finish
OW_finish ທໍາ​ຄວາມ​ສະ​ອາດ​ OWFS 1-wire routines, ປ່ອຍອຸປະກອນແລະຫນ່ວຍຄວາມຈໍາ.

Arguments
ບໍ່ມີ.

ຜົນຕອບແທນ
ບໍ່ມີ

ລໍາດັບ
OW_finish ເປັນທາງເລືອກນັບຕັ້ງແຕ່ການທໍາຄວາມສະອາດແມ່ນອັດຕະໂນມັດໃນເວລາອອກຈາກໂຄງການ.

ລາຍລະອຽດ

1- ລວດ
1- ລວດ ເປັນໂປໂຕຄອນສາຍໄຟ ແລະຊຸດອຸປະກອນທີ່ອອກແບບ ແລະຜະລິດໂດຍ Dallas
Semiconductor, Inc. ລົດເມແມ່ນໂຄງການເຊື່ອມຕໍ່ຕ່ໍາພະລັງງານຕ່ໍາທີ່ມີຂໍ້ມູນ
ສາຍຍັງສາມາດສະຫນອງພະລັງງານ.

ອຸປະກອນແຕ່ລະແມ່ນເປັນເອກະລັກແລະບໍ່ປ່ຽນແປງຕົວເລກໃນລະຫວ່າງການຜະລິດ. ມີກວ້າງ
ອຸປະກອນຕ່າງໆ, ລວມທັງຫນ່ວຍຄວາມຈໍາ, ເຊັນເຊີ (ຄວາມຊຸ່ມຊື່ນ, ອຸນຫະພູມ, ແຮງດັນ, ຕິດຕໍ່,
ປັດຈຸບັນ), ສະວິດ, ເຄື່ອງຈັບເວລາ ແລະເຄື່ອງບັນທຶກຂໍ້ມູນ. ອຸ​ປະ​ກອນ​ສະ​ລັບ​ສັບ​ຊ້ອນ​ຫຼາຍ (ເຊັ່ນ​: thermocouple​
sensors) ສາມາດສ້າງຂຶ້ນດ້ວຍອຸປະກອນພື້ນຖານເຫຼົ່ານີ້. ຍັງມີອຸປະກອນ 1 ສາຍທີ່ມີ
ການເຂົ້າລະຫັດລວມ.

ໂຄງການ 1 ສາຍໃຊ້ສາຍດຽວ ລົດເມ ຕົ້ນສະບັບ ແລະຫຼາຍ ຂ້າທາດ ຢູ່ໃນສາຍດຽວກັນ. ລົດເມ
ແມ່ບົດລິເລີ່ມການສື່ສານທັງຫມົດ. ສໍາລອງສາມາດໄດ້ຮັບການຄົ້ນພົບສ່ວນບຸກຄົນແລະ
ແກ້ໄຂໂດຍໃຊ້ ID ເປັນເອກະລັກຂອງເຂົາເຈົ້າ.

ແມ່ບົດລົດເມມາໃນຫຼາຍໆການຕັ້ງຄ່າລວມທັງ serial, ຂະຫນານ, i2c, ເຄືອຂ່າຍ
ຫຼືອະແດບເຕີ USB.

OWFS ການອອກແບບ
OWFS ເປັນຊຸດໂປຣແກມທີ່ອອກແບບມາເພື່ອເຮັດໃຫ້ລົດເມ 1 ສາຍ ແລະອຸປະກອນຂອງມັນໄດ້ຢ່າງງ່າຍດາຍ
ເຂົ້າເຖິງໄດ້. ຫຼັກການພື້ນຖານແມ່ນການສ້າງລະບົບໄຟລ໌ virtual, ທີ່ມີ ID ເປັນເອກະລັກ
ເປັນໄດເລກະທໍລີ, ແລະຄຸນສົມບັດສ່ວນບຸກຄົນຂອງອຸປະກອນແມ່ນເປັນຕົວແທນງ່າຍດາຍ
ໄຟລ໌ທີ່ສາມາດອ່ານແລະຂຽນໄດ້.

ລາຍ​ລະ​ອຽດ​ຂອງ​ສໍາ​ລອງ​ສ່ວນ​ບຸກ​ຄົນ​ຫຼື​ການ​ອອກ​ແບບ​ແມ່​ບົດ​ແມ່ນ​ເຊື່ອງ​ໄວ້​ທາງ​ຫລັງ​ຂອງ​ການ​ໂຕ້​ຕອບ​ທີ່​ສອດ​ຄ້ອງ​ກັນ​.
ເປົ້າຫມາຍແມ່ນເພື່ອສະຫນອງຊຸດເຄື່ອງມືທີ່ງ່າຍສໍາລັບຜູ້ອອກແບບຊອບແວເພື່ອສ້າງການຕິດຕາມ
ຫຼືການຄວບຄຸມຄໍາຮ້ອງສະຫມັກ. ມີ​ບາງ​ປະ​ສິດ​ທິ​ຜົນ​ໃນ​ການ​ປະ​ຕິ​ບັດ​,
ລວມທັງການເກັບຂໍ້ມູນ, ການເຂົ້າເຖິງຂະຫນານກັບແມ່ບົດລົດເມ, ແລະການລວບລວມອຸປະກອນ
ການສື່ສານ. ຍັງ​ເປົ້າ​ຫມາຍ​ພື້ນ​ຖານ​ແມ່ນ​ຄວາມ​ງ່າຍ​ຂອງ​ການ​ນໍາ​ໃຊ້​, ຢືດ​ຢຸ່ນ​ແລະ​
ຄວາມ​ຖືກ​ຕ້ອງ​ຫຼາຍ​ກ​່​ວາ​ຄວາມ​ໄວ​.

libowcapi
libowcapi (1​) ແມ່ນ encapsulation ຂອງອັນເຕັມທີ່ libow ຫ້ອງສະຫມຸດສໍາລັບໂຄງການ C.

libowcapi (1​) ອະນຸຍາດໃຫ້ໃຊ້ໂຄງການ C OWFS ຫຼັກ​ການ (ໂຄງ​ການ​ຕັ້ງ​ຊື່​ສອດ​ຄ່ອງ​,
ອະແດບເຕີຫຼາຍອັນ, ອຸປະກອນ, ແລະຄວາມເຂົ້າກັນໄດ້) ໂດຍກົງຈາກໂຄງການ C. ມີ
ໂມດູນປຽບທຽບສໍາລັບພາສາການຂຽນໂປຼແກຼມອື່ນໆ:

C libowcapi

perl ນົກແກ້ວ

php owphp

python owpython

tcl owtcl

EXAMPLE

/* ລາຍຊື່ໄດເລກະທໍລີງ່າຍດາຍ - ບໍ່ມີຂໍ້ຜິດພາດໃນການກວດສອບ */
#ລວມທັງ
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();

ໃຊ້ owcapi ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net