halsampler(1) Manual Page

halsampler [options]

sampler(9) and halsampler are used together to sample HAL data in real time and store it in a file. sampler is a realtime HAL component that exports HAL pins and creates a FIFO in shared memory. It then begins sampling data from the HAL and storing it to the FIFO. halsampler is a non-realtime program that copies data from the FIFO to stdout, where it can be redirected to a file or piped to some other program.

Спочатку потрібно створити FIFO, завантаживши sampler(9) за допомогою halcmd loadrt або команди loadrt у HAL-файлі. Потім можна викликати halsampler, щоб розпочати вивід даних з FIFO на стандартний вивід.

Дані друкуються по одному рядку на зразок. Якщо було вказано -t, спочатку друкується номер зразка. Далі йдуть дані в тому порядку, в якому були визначені контакти в конфігураційному рядку. Наприклад, якщо конфігураційний рядок sampler був "ffbs", то типовий рядок виводу (без -t) виглядатиме так:

123.55 33.4 0 -12

halsampler prints data as fast as possible until the FIFO is empty, then it retries at regular intervals, until it is either killed or has printed COUNT samples as requested by -n. Usually, but not always, data printed by halsampler will be redirected to a file or piped to some other program.

Розмір FIFO слід вибирати таким чином, щоб він міг вмістити зразки, зібрані під час будь-яких короткочасних перебоїв у потоці даних, таких як пошук на диску, прокрутка терміналу або обмеження обробки наступної програми в конвеєрі. Якщо FIFO заповнюється і sampler змушений перезаписувати старі дані, halsampler виведе на окремому рядку слово «overrun», щоб позначити кожну прогалину в зразках даних. Якщо було вказано -t, пропуски в послідовних номерах зразків у першому стовпці можна використовувати для точного визначення кількості втрачених зразків.

Формат даних для виводу halsampler є таким самим, як і для вводу halstreamer(1), тому «хвильові форми», захоплені за допомогою halsampler, можна відтворити за допомогою halstreamer. У цьому випадку не слід використовувати опцію -t.

Якщо під час ініціалізації виникає проблема, halsampler виводить повідомлення на stderr та повертає невдачу.

Після виведення COUNT зразків (якщо було вказано -n) програма завершить роботу і поверне успішний результат. Якщо програма буде завершена до виведення вказаної кількості зразків, вона поверне невдалий результат. Це означає, що якщо -n не вказано, програма завжди повертатиме невдалий результат при завершенні.

sampler(9), streamer(9), halstreamer(1)

Оригінальна версія від Джона Касуніча, як частина проєкту LinuxCNC. Покращення від кількох інших членів команди розробників LinuxCNC.

Повідомляйте про помилки за адресою https://github.com/LinuxCNC/linuxcnc/issues.

Авторське право © 2006 Джон Касуніч.

Це безкоштовне програмне забезпечення; дивіться вихідний код для умов копіювання. НЕМАЄ ЖОДНИХ гарантій; навіть щодо ТОВАРНОЇ ПРИДАТНОСТІ або ПРИДАТНОСТІ ДЛЯ ПЕВНОЇ МЕТИ.