Synch transfer fix
[SCSI2SD-V6.git] / src / firmware / spinlock.h
1 //      Copyright (C) 2016 Michael McMaster <michael@codesrc.com>
2 //
3 //      This file is part of SCSI2SD.
4 //
5 //      SCSI2SD is free software: you can redistribute it and/or modify
6 //      it under the terms of the GNU General Public License as published by
7 //      the Free Software Foundation, either version 3 of the License, or
8 //      (at your option) any later version.
9 //
10 //      SCSI2SD is distributed in the hope that it will be useful,
11 //      but WITHOUT ANY WARRANTY; without even the implied warranty of
12 //      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 //      GNU General Public License for more details.
14 //
15 //      You should have received a copy of the GNU General Public License
16 //      along with SCSI2SD.  If not, see <http://www.gnu.org/licenses/>.
17 #ifndef S2S_SPINLOCK_H
18 #define S2S_SPINLOCK_H
19
20 #include "stm32f2xx.h"
21
22
23 #define s2s_lock_t volatile uint32_t
24 #define s2s_lock_init 0
25
26 // Spinlock functions for Cortex-M3, based on ARM Application Note 321,
27 // ARM Cortex-M Programming Guide to Memory Barrier Instructions, 4.19
28 // http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dai0321a/BIHEJCHB.html
29 //
30 // s2s_spin_lock must NOT be used when mixing the main loop with a ISR, since
31 // the main code will never get a chance to unlock while the ISR is active.
32 // Use trylock in the ISR instead.
33
34 int s2s_spin_trylock(s2s_lock_t* lock);
35 void s2s_spin_lock(s2s_lock_t* lock);
36 void s2s_spin_unlock(s2s_lock_t* lock);
37
38 #endif