root/trunk/libffado/src/libieee1394/ieee1394service.h

Revision 909, 10.2 kB (checked in by ppalmers, 16 years ago)

fix port out of range bug

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1 /*
2  * Copyright (C) 2005-2008 by Daniel Wagner
3  * Copyright (C) 2005-2008 by Pieter Palmers
4  *
5  * This file is part of FFADO
6  * FFADO = Free Firewire (pro-)audio drivers for linux
7  *
8  * FFADO is based upon FreeBoB
9  *
10  * This program is free software: you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation, either version 2 of the License, or
13  * (at your option) version 3 of the License.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
22  *
23  */
24
25 #ifndef FFADO_IEEE1394SERVICE_H
26 #define FFADO_IEEE1394SERVICE_H
27
28 #include "fbtypes.h"
29 #include "threads.h"
30
31 #include "debugmodule/debugmodule.h"
32
33 #include "IEC61883.h"
34
35 #include <libraw1394/raw1394.h>
36 #include <pthread.h>
37
38 #include <vector>
39 #include <string>
40
41 class ARMHandler;
42 class IsoHandlerManager;
43 class CycleTimerHelper;
44
45 namespace Util {
46     class TimeSource;
47 }
48
49 class Ieee1394Service : public IEC61883 {
50 public:
51     Ieee1394Service();
52     Ieee1394Service(bool rt, int prio);
53     ~Ieee1394Service();
54
55     bool initialize( int port );
56     bool setThreadParameters(bool rt, int priority);
57    /**
58     * @brief get number of ports (firewire adapters) in this machine
59     *
60     * @return the number of ports
61     */
62     static int detectNbPorts();
63
64    /**
65     * @brief get port (adapter) id
66     *
67     * @return get port (adapter) id
68     */
69     int getPort()
70         { return m_port; }
71
72    /**
73     * @brief get port (adapter) name
74     *
75     * @return get port (adapter) name
76     */
77     std::string getPortName()
78         { return m_portName; };
79
80    /**
81     * @brief get number of nodes on the bus
82     *
83     * Since the root node always has
84     * the highest node ID, this number can be used to determine that ID (it's
85     * LOCAL_BUS|(count-1)).
86     *
87     * @return the number of nodes on the bus to which the port is connected.
88     * This value can change with every bus reset.
89     */
90     int getNodeCount();
91
92    /**
93     * @brief get the node id of the local node
94     *
95     * @note does not include the bus part (0xFFC0)
96     *
97     * @return the node id of the local node
98     * This value can change with every bus reset.
99     */
100     nodeid_t getLocalNodeId();
101
102     /**
103      * @brief get the most recent cycle timer value (in ticks)
104      *
105      * @note Uses the most appropriate method for getting the cycle timer
106      *       which is not necessarily a direct read (could be DLL)
107      */
108     uint32_t getCycleTimerTicks();
109
110     /**
111      * @brief get the most recent cycle timer value (in CTR format)
112      *
113      * @note Uses the most appropriate method for getting the cycle timer
114      *       which is not necessarily a direct read (could be DLL)
115      */
116     uint32_t getCycleTimer();
117
118     /**
119      * @brief get the cycle timer value for a specific time instant (in ticks)
120      *
121      * @note Uses the most appropriate method for getting the cycle timer
122      *       which is not necessarily a direct read (could be DLL)
123      */
124     uint32_t getCycleTimerTicks(uint64_t t);
125
126     /**
127      * @brief get the cycle timer value for a specific time instant (in CTR format)
128      *
129      * @note Uses the most appropriate method for getting the cycle timer
130      *       which is not necessarily a direct read (could be DLL)
131      */
132     uint32_t getCycleTimer(uint64_t t);
133
134     /**
135      * @brief read the cycle timer value from the controller (in CTR format)
136      *
137      * @note Uses a direct method to read the value from the controller
138      * @return true if successful
139      */
140     bool readCycleTimerReg(uint32_t *cycle_timer, uint64_t *local_time);
141
142     /**
143      * @brief provide the current system time
144      * @return
145      */
146     uint64_t getCurrentTimeAsUsecs();
147
148     /**
149      * @brief send async read request to a node and wait for response.
150      *
151      * This does the complete transaction and will return when it's finished.
152      *
153      * @param node target node (\todo needs 0xffc0 stuff)
154      * @param addr address to read from
155      * @param length amount of data to read in quadlets
156      * @param buffer pointer to buffer where data will be saved
157      *
158      * @return true on success or false on failure (sets errno)
159      */
160     bool read( fb_nodeid_t nodeId,
161            fb_nodeaddr_t addr,
162            size_t length,
163            fb_quadlet_t* buffer );
164
165     bool read_quadlet( fb_nodeid_t nodeId,
166                        fb_nodeaddr_t addr,
167                        fb_quadlet_t* buffer );
168
169     bool read_octlet( fb_nodeid_t nodeId,
170                       fb_nodeaddr_t addr,
171                       fb_octlet_t* buffer );
172
173     /**
174     * @brief send async write request to a node and wait for response.
175     *
176     * This does the complete transaction and will return when it's finished.
177     *
178     * @param node target node (\XXX needs 0xffc0 stuff)
179     * @param addr address to write to
180     * @param length amount of data to write in quadlets
181     * @param data pointer to data to be sent
182     *
183     * @return true on success or false on failure (sets errno)
184     */
185     bool write( fb_nodeid_t nodeId,
186         fb_nodeaddr_t addr,
187         size_t length,
188         fb_quadlet_t* data );
189
190     bool write_quadlet( fb_nodeid_t nodeId,
191                         fb_nodeaddr_t addr,
192                         fb_quadlet_t data );
193
194     bool write_octlet(  fb_nodeid_t nodeId,
195                         fb_nodeaddr_t addr,
196                         fb_octlet_t data );
197
198     /**
199      * @brief send 64-bit compare-swap lock request and wait for response.
200      *
201      * swaps the content of \ref addr with \ref swap_value , but only if
202      * the content of \ref addr equals \ref compare_with
203      *
204      * @note takes care of endiannes
205      *
206      * @param nodeId target node ID
207      * @param addr address within target node address space
208      * @param compare_with value to compare \ref addr with
209      * @param swap_value new value to put in \ref addr
210      * @param result the value (originally) in \ref addr
211      *
212      * @return true if succesful, false otherwise
213      */
214     bool lockCompareSwap64(  fb_nodeid_t nodeId,
215                         fb_nodeaddr_t addr,
216                         fb_octlet_t  compare_value,
217                         fb_octlet_t  swap_value,
218                         fb_octlet_t* result );
219
220     fb_quadlet_t* transactionBlock( fb_nodeid_t nodeId,
221                                     fb_quadlet_t* buf,
222                                     int len,
223                     unsigned int* resp_len );
224
225     bool transactionBlockClose();
226
227     raw1394handle_t getHandle() {return m_handle;};
228
229     int getVerboseLevel();
230
231     bool addBusResetHandler( Functor* functor );
232     bool remBusResetHandler( Functor* functor );
233
234     /**
235      * @brief get the current generation
236      *
237      * @return the current generation
238      **/
239     unsigned int getGeneration() {
240         return raw1394_get_generation( m_handle );
241     }
242
243     /**
244      * @brief register an AddressRangeMapping Handler
245      * @param h pointer to the handler to register
246      *
247      * @return true on success or false on failure
248      **/
249
250     bool registerARMHandler( ARMHandler *h );
251
252     /**
253      * @brief unregister ARM range
254      * @param h pointer to the handler to unregister
255      * @return true if successful, false otherwise
256      */
257     bool unregisterARMHandler( ARMHandler *h );
258
259     nodeaddr_t findFreeARMBlock( nodeaddr_t start, size_t length, size_t step );
260
261 // ISO channel stuff
262 public:
263     signed int getAvailableBandwidth();
264     signed int allocateIsoChannelGeneric(unsigned int bandwidth);
265     signed int allocateIsoChannelCMP(nodeid_t xmit_node, int xmit_plug,
266                                      nodeid_t recv_node, int recv_plug);
267     bool freeIsoChannel(signed int channel);
268
269     IsoHandlerManager& getIsoHandlerManager() {return *m_pIsoManager;};
270 private:
271     enum EAllocType {
272         AllocFree = 0, // not allocated (by us)
273         AllocGeneric = 1, // allocated with generic functions
274         AllocCMP=2 // allocated with CMP
275     };
276
277     struct ChannelInfo {
278         int channel;
279         int bandwidth;
280         enum EAllocType alloctype;
281         nodeid_t xmit_node;
282         int xmit_plug;
283         nodeid_t recv_node;
284         int recv_plug;
285     };
286
287     // the info for the channels we manage
288     struct ChannelInfo m_channels[64];
289
290     bool unregisterIsoChannel(unsigned int c);
291     bool registerIsoChannel(unsigned int c, struct ChannelInfo cinfo);
292
293 private:
294
295     bool startRHThread();
296     void stopRHThread();
297     static void* rHThread( void* arg );
298
299     void printBuffer( unsigned int level, size_t length, fb_quadlet_t* buffer ) const;
300     void printBufferBytes( unsigned int level, size_t length, byte_t* buffer ) const;
301
302     static int resetHandlerLowLevel( raw1394handle_t handle,
303                     unsigned int generation );
304     bool resetHandler( unsigned int generation );
305
306     static int armHandlerLowLevel(raw1394handle_t handle, unsigned long arm_tag,
307                      byte_t request_type, unsigned int requested_length,
308                      void *data);
309     bool armHandler(  unsigned long arm_tag,
310                      byte_t request_type, unsigned int requested_length,
311                      void *data);
312
313     raw1394handle_t m_handle;
314     raw1394handle_t m_resetHandle;
315     raw1394handle_t m_util_handle; // a handle for operations from the rt thread
316     int             m_port;
317     std::string     m_portName;
318
319     pthread_t       m_thread;
320     pthread_mutex_t m_mutex;
321     bool            m_threadRunning;
322
323     bool            m_realtime;
324     int             m_base_priority;
325
326     IsoHandlerManager*      m_pIsoManager;
327     CycleTimerHelper*       m_pCTRHelper;
328     bool                    m_have_new_ctr_read;
329
330     // the time source
331     Util::TimeSource*   m_pTimeSource;
332
333     typedef std::vector< Functor* > reset_handler_vec_t;
334     reset_handler_vec_t m_busResetHandlers;
335
336     // ARM stuff
337     arm_tag_handler_t m_default_arm_handler;
338
339     typedef std::vector< ARMHandler * > arm_handler_vec_t;
340     arm_handler_vec_t m_armHandlers;
341
342     fb_octlet_t byteSwap_octlet(fb_octlet_t value);
343
344 public:
345     void setVerboseLevel(int l);
346     void show();
347 private:
348     DECLARE_DEBUG_MODULE;
349 };
350
351 #endif // FFADO_IEEE1394SERVICE_H
Note: See TracBrowser for help on using the browser.