mraa.c added internal helper functions to support globbing and link analysis
[contrib/mraa.git] / include / mraa_internal.h
1 /*
2  * Author: Thomas Ingleby <thomas.c.ingleby@intel.com>
3  * Copyright (c) 2014 Intel Corporation.
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining
6  * a copy of this software and associated documentation files (the
7  * "Software"), to deal in the Software without restriction, including
8  * without limitation the rights to use, copy, modify, merge, publish,
9  * distribute, sublicense, and/or sell copies of the Software, and to
10  * permit persons to whom the Software is furnished to do so, subject to
11  * the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be
14  * included in all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23  */
24
25 #pragma once
26
27 #ifdef __cplusplus
28 extern "C" {
29 #endif
30
31 #include <syslog.h>
32
33 #include "common.h"
34 #include "mraa_internal_types.h"
35 #include "mraa_adv_func.h"
36
37 extern mraa_adv_func_t* advance_func;
38 extern mraa_board_t* plat;
39
40 /**
41  * Takes in pin information and sets up the multiplexors.
42  *
43  * @param meta
44  * @return mraa result type indicating success of actions.
45  */
46 mraa_result_t mraa_setup_mux_mapped(mraa_pin_t meta);
47
48 /**
49  * runtime detect running x86 platform
50  *
51  * @return mraa_platform_t of the init'ed platform
52  */
53 mraa_platform_t mraa_x86_platform();
54
55 /**
56  * runtime detect running arm platforms
57  *
58  * @return mraa_platform_t of the init'ed platform
59  */
60 mraa_platform_t mraa_arm_platform();
61
62 /**
63 * helper function to check if file exists
64 *
65 * @param filename to check
66 * @return mraa_boolean_t boolean result.
67 */
68 mraa_boolean_t mraa_file_exist(char *filename);
69
70 /**
71 * helper function to unglob filenames
72 *
73 * @param filename to unglob
74 * @return char * with the existing filename matching the pattern of input. NULL if there is no match. Caller must free result
75 */
76 char * mraa_file_unglob(char *filename);
77
78 /**
79 * helper function to find out if file that is targeted by a softlink (partially) matches the given name
80 *
81 * @param filename of the softlink
82 * @param (partial) filename that is matched with the filename of the link-targeted file
83 * @return mraa_boolean_t true when targetname (partially) matches
84 */
85 mraa_boolean_t mraa_link_targets(char *filename,char *targetname);
86
87 #ifdef __cplusplus
88 }
89 #endif