1 /* This file is part of the program psim.
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"
35 sem - provide access to a unix semaphore
41 This device implements an interface to a unix semaphore.
47 reg = <address> <size> (required)
49 Determine where the memory lives in the parents address space.
51 key = <integer> (required)
53 This is the key of the unix semaphore.
58 Enable tracing of the sem:
60 | bash$ psim -t sem-device \
63 Configure a UNIX semaphore using key 0x12345678 mapped into psim
64 address space at 0xfff00000:
66 | -o '/sem@0xfff00000/reg 0xfff00000 0x80000' \
67 | -o '/sem@0xfff00000/key 0x12345678' \
69 sim/ppc/run -o '/#address-cells 1' \
70 -o '/sem@0xfff00000/reg 0xfff00000 12' \
71 -o '/sem@0xfff00000/key 0x12345678' ../psim-hello/hello
76 offset 4 - lock operation
77 offset 8 - unlock operation
79 All reads return the current or resulting count.
87 typedef struct _hw_sem_device {
88 unsigned_word physical_address;
95 #ifndef HAVE_UNION_SEMUN
99 unsigned short int *array;
100 #if defined(__linux__)
101 struct seminfo *__buf;
107 hw_sem_init_data(device *me)
109 hw_sem_device *sem = (hw_sem_device*)device_data(me);
110 const device_unit *d;
114 /* initialize the properties of the sem */
116 if (device_find_property(me, "key") == NULL)
117 error("sem_init_data() required key property is missing\n");
119 if (device_find_property(me, "value") == NULL)
120 error("sem_init_data() required value property is missing\n");
122 sem->key = (key_t) device_find_integer_property(me, "key");
123 DTRACE(sem, ("semaphore key (%d)\n", sem->key) );
125 sem->initial = (int) device_find_integer_property(me, "value");
126 DTRACE(sem, ("semaphore initial value (%d)\n", sem->initial) );
128 d = device_unit_address(me);
129 sem->physical_address = d->cells[ d->nr_cells-1 ];
130 DTRACE(sem, ("semaphore physical_address=0x%x\n", sem->physical_address));
132 /* Now to initialize the semaphore */
134 if ( sem->initial != -1 ) {
136 sem->id = semget(sem->key, 1, IPC_CREAT | 0660);
138 error("hw_sem_init_data() semget failed\n");
140 help.val = sem->initial;
141 status = semctl( sem->id, 0, SETVAL, help );
143 error("hw_sem_init_data() semctl -- set value failed\n");
146 sem->id = semget(sem->key, 1, 0660);
148 error("hw_sem_init_data() semget failed\n");
151 sem->count = semctl( sem->id, 0, GETVAL, help );
152 if (sem->count == -1)
153 error("hw_sem_init_data() semctl -- get value failed\n");
154 DTRACE(sem, ("semaphore OS value (%d)\n", sem->count) );
158 hw_sem_attach_address_callback(device *me,
164 device *client) /*callback/default*/
166 hw_sem_device *sem = (hw_sem_device*)device_data(me);
169 error("sem_attach_address_callback() invalid address space\n");
172 error("sem_attach_address_callback() invalid size\n");
174 sem->physical_address = addr;
175 DTRACE(sem, ("semaphore physical_address=0x%x\n", addr));
179 hw_sem_io_read_buffer(device *me,
187 hw_sem_device *sem = (hw_sem_device*)device_data(me);
193 /* do we need to worry about out of range addresses? */
195 DTRACE(sem, ("semaphore read addr=0x%x length=%d\n", addr, nr_bytes));
197 if (!(addr >= sem->physical_address && addr <= sem->physical_address + 11))
198 error("hw_sem_io_read_buffer() invalid address - out of range\n");
201 error("hw_sem_io_read_buffer() invalid address - alignment\n");
204 error("hw_sem_io_read_buffer() invalid length\n");
206 switch ( (addr - sem->physical_address) / 4 ) {
208 case 0: /* OBTAIN CURRENT VALUE */
216 status = semop(sem->id, &sb, 1);
218 perror( "hw_sem.c: lock" );
219 error("hw_sem_io_read_buffer() sem lock\n");
222 DTRACE(sem, ("semaphore lock %d\n", sem->count));
230 status = semop(sem->id, &sb, 1);
232 perror( "hw_sem.c: unlock" );
233 error("hw_sem_io_read_buffer() sem unlock\n");
235 DTRACE(sem, ("semaphore unlock %d\n", sem->count));
239 error("hw_sem_io_read_buffer() invalid address - unknown error\n");
243 /* assume target is big endian */
244 u32 = H2T_4(semctl( sem->id, 0, GETVAL, help ));
246 DTRACE(sem, ("semaphore OS value (%d)\n", u32) );
247 if (u32 == 0xffffffff) {
248 perror( "hw_sem.c: getval" );
249 error("hw_sem_io_read_buffer() semctl -- get value failed\n");
252 memcpy(dest, &u32, nr_bytes);
257 static device_callbacks const hw_sem_callbacks = {
258 { generic_device_init_address, hw_sem_init_data },
259 { hw_sem_attach_address_callback, }, /* address */
260 { hw_sem_io_read_buffer, NULL }, /* IO */
262 { NULL, }, /* interrupt */
263 { NULL, }, /* unit */
268 hw_sem_create(const char *name,
269 const device_unit *unit_address,
272 hw_sem_device *sem = ZALLOC(hw_sem_device);
276 const device_descriptor hw_sem_device_descriptor[] = {
277 { "sem", hw_sem_create, &hw_sem_callbacks },
281 #endif /* _HW_SEM_C_ */