PX4 Firmware
PX4 Autopilot Software http://px4.io
mavlink_shell.h
Go to the documentation of this file.
1 /****************************************************************************
2  *
3  * Copyright (c) 2016 PX4 Development Team. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * 1. Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in
13  * the documentation and/or other materials provided with the
14  * distribution.
15  * 3. Neither the name PX4 nor the names of its contributors may be
16  * used to endorse or promote products derived from this software
17  * without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
23  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
25  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
26  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
29  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  *
32  ****************************************************************************/
33 
34 /**
35  * @file mavlink_shell.h
36  * A shell to be used via MAVLink
37  *
38  * @author Beat Küng <beat-kueng@gmx.net>
39  */
40 
41 
42 #include <stddef.h>
43 #include <stdint.h>
44 #include <px4_platform_common/tasks.h>
45 
46 #pragma once
47 
49 {
50 public:
51  MavlinkShell() = default;
52 
53  ~MavlinkShell();
54 
55  /**
56  * Start the mavlink shell.
57  *
58  * @return 0 on success.
59  */
60  int start();
61 
62  /**
63  * Write to the shell
64  * @return number of written bytes
65  */
66  size_t write(uint8_t *buffer, size_t len);
67 
68  /**
69  * Read from the shell. This is blocking, if 0 bytes are available, this will block.
70  * @param len buffer length
71  * @return number of bytes read.
72  */
73  size_t read(uint8_t *buffer, size_t len);
74 
75  /**
76  * Get the number of bytes that can be read.
77  */
78  size_t available();
79 
80 private:
81 
82  int _to_shell_fd = -1; /** fd to write to the shell */
83  int _from_shell_fd = -1; /** fd to read from the shell */
84  int _shell_fds[2] = { -1, -1}; /** stdin & out used by the shell */
85  px4_task_t _task;
86 
87  static int shell_start_thread(int argc, char *argv[]);
88 
89  /* do not allow copying this class */
90  MavlinkShell(const MavlinkShell &) = delete;
91  MavlinkShell operator=(const MavlinkShell &) = delete;
92 };