]> sigrok.org Git - libsigrok.git/blame - src/hardware/beaglelogic/beaglelogic.h
beaglelogic: Split beaglelogic code into .h and .c file
[libsigrok.git] / src / hardware / beaglelogic / beaglelogic.h
CommitLineData
ad9dbc1c
KA
1/*
2 * This file is part of the libsigrok project.
3 *
4 * Copyright (C) 2014 Kumar Abhishek <abhishek@theembeddedkitchen.net>
5 *
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 */
19
20#ifndef BEAGLELOGIC_H_
21#define BEAGLELOGIC_H_
22
23#include <fcntl.h>
ad9dbc1c
KA
24#include <sys/mman.h>
25#include <sys/types.h>
26#include <sys/errno.h>
27#include <sys/ioctl.h>
ad9dbc1c 28#include <stdlib.h>
ad9dbc1c
KA
29#include <unistd.h>
30
31/* BeagleLogic device node name */
32#define BEAGLELOGIC_DEV_NODE "/dev/beaglelogic"
83bf4762 33#define BEAGLELOGIC_SYSFS_ATTR(a) "/sys/devices/virtual/misc/beaglelogic/" #a
ad9dbc1c
KA
34
35/* Reproduced verbatim from beaglelogic.h in the kernel tree until the kernel
36 * module hits the mainline. Contains the ABI, so DO NOT TOUCH this section */
37
38/* ioctl calls that can be issued on /dev/beaglelogic */
39#define IOCTL_BL_GET_VERSION _IOR('k', 0x20, uint32_t)
40
41#define IOCTL_BL_GET_SAMPLE_RATE _IOR('k', 0x21, uint32_t)
42#define IOCTL_BL_SET_SAMPLE_RATE _IOW('k', 0x21, uint32_t)
43
44#define IOCTL_BL_GET_SAMPLE_UNIT _IOR('k', 0x22, uint32_t)
45#define IOCTL_BL_SET_SAMPLE_UNIT _IOW('k', 0x22, uint32_t)
46
47#define IOCTL_BL_GET_TRIGGER_FLAGS _IOR('k', 0x23, uint32_t)
48#define IOCTL_BL_SET_TRIGGER_FLAGS _IOW('k', 0x23, uint32_t)
49
50#define IOCTL_BL_CACHE_INVALIDATE _IO('k', 0x25)
51
52#define IOCTL_BL_GET_BUFFER_SIZE _IOR('k', 0x26, uint32_t)
53#define IOCTL_BL_SET_BUFFER_SIZE _IOW('k', 0x26, uint32_t)
54
55#define IOCTL_BL_GET_BUFUNIT_SIZE _IOR('k', 0x27, uint32_t)
56
57#define IOCTL_BL_FILL_TEST_PATTERN _IO('k', 0x28)
58
59#define IOCTL_BL_START _IO('k', 0x29)
60#define IOCTL_BL_STOP _IO('k', 0x2A)
61
62/* Possible States of BeagleLogic */
63enum beaglelogic_states {
64 STATE_BL_DISABLED, /* Powered off (at module start) */
65 STATE_BL_INITIALIZED, /* Powered on */
66 STATE_BL_MEMALLOCD, /* Buffers allocated */
67 STATE_BL_ARMED, /* All Buffers DMA-mapped and configuration done */
68 STATE_BL_RUNNING, /* Data being captured */
69 STATE_BL_REQUEST_STOP, /* Stop requested */
70 STATE_BL_ERROR /* Buffer overrun */
71};
72
73/* Setting attributes */
74enum beaglelogic_triggerflags {
75 BL_TRIGGERFLAGS_ONESHOT = 0,
76 BL_TRIGGERFLAGS_CONTINUOUS
77};
78
79/* Possible sample unit / formats */
80enum beaglelogic_sampleunit {
81 BL_SAMPLEUNIT_16_BITS = 0,
82 BL_SAMPLEUNIT_8_BITS
83};
84/* END beaglelogic.h */
85
86/* For all the functions below:
87 * Parameters:
88 * devc : Device context structure to operate on
89 * Returns:
90 * SR_OK or SR_ERR
91 */
92
93SR_PRIV int beaglelogic_open_nonblock(struct dev_context *devc);
94SR_PRIV int beaglelogic_close(struct dev_context *devc);
95
96SR_PRIV int beaglelogic_get_buffersize(struct dev_context *devc);
97SR_PRIV int beaglelogic_set_buffersize(struct dev_context *devc);
98
99SR_PRIV int beaglelogic_get_samplerate(struct dev_context *devc);
100SR_PRIV int beaglelogic_set_samplerate(struct dev_context *devc);
101
102SR_PRIV int beaglelogic_get_sampleunit(struct dev_context *devc);
103SR_PRIV int beaglelogic_set_sampleunit(struct dev_context *devc);
104
105SR_PRIV int beaglelogic_get_triggerflags(struct dev_context *devc);
106SR_PRIV int beaglelogic_set_triggerflags(struct dev_context *devc);
107
108/* Start and stop the capture operation */
109SR_PRIV int beaglelogic_start(struct dev_context *devc);
110SR_PRIV int beaglelogic_stop(struct dev_context *devc);
111
112/* Get the last error size */
113SR_PRIV int beaglelogic_getlasterror(struct dev_context *devc);
114
115/* Gets the unit size of the capture buffer (usually 4 or 8 MB) */
116SR_PRIV int beaglelogic_get_bufunitsize(struct dev_context *devc);
117
118SR_PRIV int beaglelogic_mmap(struct dev_context *devc);
119SR_PRIV int beaglelogic_munmap(struct dev_context *devc);
120
db24496a 121#endif