Mercurial > hg > beaglert

annotate include/prussdrv.h @ 0:8a575ba3ab52

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial commit.
author andrewm
date Fri, 31 Oct 2014 19:10:17 +0100
parents
children 901d205d1a3c
rev   line source
andrewm@0 1 /*
andrewm@0 2 * prussdrv.h
andrewm@0 3 *
andrewm@0 4 * Describes PRUSS userspace driver for Industrial Communications
andrewm@0 5 *
andrewm@0 6 * Copyright (C) 2010 Texas Instruments Incorporated - http://www.ti.com/
andrewm@0 7 *
andrewm@0 8 *
andrewm@0 9 * Redistribution and use in source and binary forms, with or without
andrewm@0 10 * modification, are permitted provided that the following conditions
andrewm@0 11 * are met:
andrewm@0 12 *
andrewm@0 13 * Redistributions of source code must retain the above copyright
andrewm@0 14 * notice, this list of conditions and the following disclaimer.
andrewm@0 15 *
andrewm@0 16 * Redistributions in binary form must reproduce the above copyright
andrewm@0 17 * notice, this list of conditions and the following disclaimer in the
andrewm@0 18 * documentation and/or other materials provided with the
andrewm@0 19 * distribution.
andrewm@0 20 *
andrewm@0 21 * Neither the name of Texas Instruments Incorporated nor the names of
andrewm@0 22 * its contributors may be used to endorse or promote products derived
andrewm@0 23 * from this software without specific prior written permission.
andrewm@0 24 *
andrewm@0 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
andrewm@0 26 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
andrewm@0 27 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
andrewm@0 28 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
andrewm@0 29 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
andrewm@0 30 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
andrewm@0 31 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
andrewm@0 32 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
andrewm@0 33 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
andrewm@0 34 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
andrewm@0 35 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
andrewm@0 36 *
andrewm@0 37 */
andrewm@0 38
andrewm@0 39 /*
andrewm@0 40 * ============================================================================
andrewm@0 41 * Copyright (c) Texas Instruments Inc 2010-11
andrewm@0 42 *
andrewm@0 43 * Use of this software is controlled by the terms and conditions found in the
andrewm@0 44 * license agreement under which this software has been supplied or provided.
andrewm@0 45 * ============================================================================
andrewm@0 46 */
andrewm@0 47
andrewm@0 48 #ifndef _PRUSSDRV_H
andrewm@0 49 #define _PRUSSDRV_H
andrewm@0 50
andrewm@0 51 #include <sys/types.h>
andrewm@0 52 #include <pthread.h>
andrewm@0 53
andrewm@0 54 #if defined (__cplusplus)
andrewm@0 55 extern "C" {
andrewm@0 56 #endif
andrewm@0 57
andrewm@0 58 #define NUM_PRU_HOSTIRQS 8
andrewm@0 59 #define NUM_PRU_HOSTS 10
andrewm@0 60 #define NUM_PRU_CHANNELS 10
andrewm@0 61 #define NUM_PRU_SYS_EVTS 64
andrewm@0 62
andrewm@0 63 #define PRUSS0_PRU0_DATARAM 0
andrewm@0 64 #define PRUSS0_PRU1_DATARAM 1
andrewm@0 65 #define PRUSS0_PRU0_IRAM 2
andrewm@0 66 #define PRUSS0_PRU1_IRAM 3
andrewm@0 67
andrewm@0 68 //Available in AM33xx series - begin
andrewm@0 69 #define PRUSS0_SHARED_DATARAM 4
andrewm@0 70 #define PRUSS0_CFG 5
andrewm@0 71 #define PRUSS0_UART 6
andrewm@0 72 #define PRUSS0_IEP 7
andrewm@0 73 #define PRUSS0_ECAP 8
andrewm@0 74 #define PRUSS0_MII_RT 9
andrewm@0 75 #define PRUSS0_MDIO 10
andrewm@0 76 //Available in AM33xx series - end
andrewm@0 77
andrewm@0 78 #define PRU_EVTOUT_0 0
andrewm@0 79 #define PRU_EVTOUT_1 1
andrewm@0 80 #define PRU_EVTOUT_2 2
andrewm@0 81 #define PRU_EVTOUT_3 3
andrewm@0 82 #define PRU_EVTOUT_4 4
andrewm@0 83 #define PRU_EVTOUT_5 5
andrewm@0 84 #define PRU_EVTOUT_6 6
andrewm@0 85 #define PRU_EVTOUT_7 7
andrewm@0 86
andrewm@0 87 typedef void *(*prussdrv_function_handler) (void *);
andrewm@0 88 typedef struct __sysevt_to_channel_map {
andrewm@0 89 short sysevt;
andrewm@0 90 short channel;
andrewm@0 91 } tsysevt_to_channel_map;
andrewm@0 92 typedef struct __channel_to_host_map {
andrewm@0 93 short channel;
andrewm@0 94 short host;
andrewm@0 95 } tchannel_to_host_map;
andrewm@0 96 typedef struct __pruss_intc_initdata {
andrewm@0 97 //Enabled SYSEVTs - Range:0..63
andrewm@0 98 //{-1} indicates end of list
andrewm@0 99 char sysevts_enabled[NUM_PRU_SYS_EVTS];
andrewm@0 100 //SysEvt to Channel map. SYSEVTs - Range:0..63 Channels -Range: 0..9
andrewm@0 101 //{-1, -1} indicates end of list
andrewm@0 102 tsysevt_to_channel_map sysevt_to_channel_map[NUM_PRU_SYS_EVTS];
andrewm@0 103 //Channel to Host map.Channels -Range: 0..9 HOSTs - Range:0..9
andrewm@0 104 //{-1, -1} indicates end of list
andrewm@0 105 tchannel_to_host_map channel_to_host_map[NUM_PRU_CHANNELS];
andrewm@0 106 //10-bit mask - Enable Host0-Host9 {Host0/1:PRU0/1, Host2..9 : PRUEVT_OUT0..7)
andrewm@0 107 unsigned int host_enable_bitmask;
andrewm@0 108 } tpruss_intc_initdata;
andrewm@0 109
andrewm@0 110 int prussdrv_init(void);
andrewm@0 111
andrewm@0 112 int prussdrv_open(unsigned int pru_evtout_num);
andrewm@0 113
andrewm@0 114 int prussdrv_pru_reset(unsigned int prunum);
andrewm@0 115
andrewm@0 116 int prussdrv_pru_disable(unsigned int prunum);
andrewm@0 117
andrewm@0 118 int prussdrv_pru_enable(unsigned int prunum);
andrewm@0 119
andrewm@0 120 int prussdrv_pru_write_memory(unsigned int pru_ram_id,
andrewm@0 121 unsigned int wordoffset,
andrewm@0 122 unsigned int *memarea,
andrewm@0 123 unsigned int bytelength);
andrewm@0 124
andrewm@0 125 int prussdrv_pruintc_init(tpruss_intc_initdata * prussintc_init_data);
andrewm@0 126
andrewm@0 127 int prussdrv_map_l3mem(void **address);
andrewm@0 128
andrewm@0 129 int prussdrv_map_extmem(void **address);
andrewm@0 130
andrewm@0 131 int prussdrv_map_prumem(unsigned int pru_ram_id, void **address);
andrewm@0 132
andrewm@0 133 int prussdrv_map_peripheral_io(unsigned int per_id, void **address);
andrewm@0 134
andrewm@0 135 unsigned int prussdrv_get_phys_addr(void *address);
andrewm@0 136
andrewm@0 137 void *prussdrv_get_virt_addr(unsigned int phyaddr);
andrewm@0 138
andrewm@0 139 int prussdrv_pru_wait_event(unsigned int pru_evtout_num);
andrewm@0 140
andrewm@0 141 int prussdrv_pru_send_event(unsigned int eventnum);
andrewm@0 142
andrewm@0 143 int prussdrv_pru_clear_event(unsigned int eventnum);
andrewm@0 144
andrewm@0 145 int prussdrv_pru_send_wait_clear_event(unsigned int send_eventnum,
andrewm@0 146 unsigned int pru_evtout_num,
andrewm@0 147 unsigned int ack_eventnum);
andrewm@0 148
andrewm@0 149 int prussdrv_exit(void);
andrewm@0 150
andrewm@0 151 int prussdrv_exec_program(int prunum, char *filename);
andrewm@0 152
andrewm@0 153 int prussdrv_start_irqthread(unsigned int pru_evtout_num, int priority,
andrewm@0 154 prussdrv_function_handler irqhandler);
andrewm@0 155
andrewm@0 156
andrewm@0 157 #if defined (__cplusplus)
andrewm@0 158 }
andrewm@0 159 #endif
andrewm@0 160 #endif