1 /* This file is part of the program psim.
3 Copyright (C) 1997,2008, Joel Sherrill <joel@OARcorp.com>
5 This program 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.
10 This program 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.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, see <http://www.gnu.org/licenses/>.
24 #include "device_table.h"
42 sem - provide access to a unix semaphore
48 This device implements an interface to a unix semaphore.
54 reg = <address> <size> (required)
56 Determine where the memory lives in the parents address space.
58 key = <integer> (required)
60 This is the key of the unix semaphore.
65 Enable tracing of the sem:
67 | bash$ psim -t sem-device \
70 Configure a UNIX semaphore using key 0x12345678 mapped into psim
71 address space at 0xfff00000:
73 | -o '/sem@0xfff00000/reg 0xfff00000 0x80000' \
74 | -o '/sem@0xfff00000/key 0x12345678' \
76 sim/ppc/run -o '/#address-cells 1' \
77 -o '/sem@0xfff00000/reg 0xfff00000 12' \
78 -o '/sem@0xfff00000/key 0x12345678' ../psim-hello/hello
83 offset 4 - lock operation
84 offset 8 - unlock operation
86 All reads return the current or resulting count.
94 typedef struct _hw_sem_device
{
95 unsigned_word physical_address
;
102 #ifndef HAVE_UNION_SEMUN
105 struct semid_ds
*buf
;
106 unsigned short int *array
;
107 #if defined(__linux__)
108 struct seminfo
*__buf
;
114 hw_sem_init_data(device
*me
)
116 hw_sem_device
*sem
= (hw_sem_device
*)device_data(me
);
117 const device_unit
*d
;
121 /* initialize the properties of the sem */
123 if (device_find_property(me
, "key") == NULL
)
124 error("sem_init_data() required key property is missing\n");
126 if (device_find_property(me
, "value") == NULL
)
127 error("sem_init_data() required value property is missing\n");
129 sem
->key
= (key_t
) device_find_integer_property(me
, "key");
130 DTRACE(sem
, ("semaphore key (%d)\n", sem
->key
) );
132 sem
->initial
= (int) device_find_integer_property(me
, "value");
133 DTRACE(sem
, ("semaphore initial value (%d)\n", sem
->initial
) );
135 d
= device_unit_address(me
);
136 sem
->physical_address
= d
->cells
[ d
->nr_cells
-1 ];
137 DTRACE(sem
, ("semaphore physical_address=0x%x\n", sem
->physical_address
));
139 /* Now to initialize the semaphore */
141 if ( sem
->initial
!= -1 ) {
143 sem
->id
= semget(sem
->key
, 1, IPC_CREAT
| 0660);
145 error("hw_sem_init_data() semget failed\n");
147 help
.val
= sem
->initial
;
148 status
= semctl( sem
->id
, 0, SETVAL
, help
);
150 error("hw_sem_init_data() semctl -- set value failed\n");
153 sem
->id
= semget(sem
->key
, 1, 0660);
155 error("hw_sem_init_data() semget failed\n");
158 sem
->count
= semctl( sem
->id
, 0, GETVAL
, help
);
159 if (sem
->count
== -1)
160 error("hw_sem_init_data() semctl -- get value failed\n");
161 DTRACE(sem
, ("semaphore OS value (%d)\n", sem
->count
) );
165 hw_sem_attach_address_callback(device
*me
,
171 device
*client
) /*callback/default*/
173 hw_sem_device
*sem
= (hw_sem_device
*)device_data(me
);
176 error("sem_attach_address_callback() invalid address space\n");
179 error("sem_attach_address_callback() invalid size\n");
181 sem
->physical_address
= addr
;
182 DTRACE(sem
, ("semaphore physical_address=0x%x\n", addr
));
186 hw_sem_io_read_buffer(device
*me
,
194 hw_sem_device
*sem
= (hw_sem_device
*)device_data(me
);
200 /* do we need to worry about out of range addresses? */
202 DTRACE(sem
, ("semaphore read addr=0x%x length=%d\n", addr
, nr_bytes
));
204 if (!(addr
>= sem
->physical_address
&& addr
<= sem
->physical_address
+ 11))
205 error("hw_sem_io_read_buffer() invalid address - out of range\n");
208 error("hw_sem_io_read_buffer() invalid address - alignment\n");
211 error("hw_sem_io_read_buffer() invalid length\n");
213 switch ( (addr
- sem
->physical_address
) / 4 ) {
215 case 0: /* OBTAIN CURRENT VALUE */
223 status
= semop(sem
->id
, &sb
, 1);
225 perror( "hw_sem.c: lock" );
226 error("hw_sem_io_read_buffer() sem lock\n");
229 DTRACE(sem
, ("semaphore lock %d\n", sem
->count
));
237 status
= semop(sem
->id
, &sb
, 1);
239 perror( "hw_sem.c: unlock" );
240 error("hw_sem_io_read_buffer() sem unlock\n");
242 DTRACE(sem
, ("semaphore unlock %d\n", sem
->count
));
246 error("hw_sem_io_read_buffer() invalid address - unknown error\n");
250 /* assume target is big endian */
251 u32
= H2T_4(semctl( sem
->id
, 0, GETVAL
, help
));
253 DTRACE(sem
, ("semaphore OS value (%d)\n", u32
) );
254 if (u32
== 0xffffffff) {
255 perror( "hw_sem.c: getval" );
256 error("hw_sem_io_read_buffer() semctl -- get value failed\n");
259 memcpy(dest
, &u32
, nr_bytes
);
264 static device_callbacks
const hw_sem_callbacks
= {
265 { generic_device_init_address
, hw_sem_init_data
},
266 { hw_sem_attach_address_callback
, }, /* address */
267 { hw_sem_io_read_buffer
, NULL
}, /* IO */
269 { NULL
, }, /* interrupt */
270 { NULL
, }, /* unit */
275 hw_sem_create(const char *name
,
276 const device_unit
*unit_address
,
279 hw_sem_device
*sem
= ZALLOC(hw_sem_device
);
283 const device_descriptor hw_sem_device_descriptor
[] = {
284 { "sem", hw_sem_create
, &hw_sem_callbacks
},
288 #endif /* _HW_SEM_C_ */