vcs.maemo.org Git - qemu/blob - vl.h

   1 /*
   2  * QEMU System Emulator header
   3  *
   4  * Copyright (c) 2003 Fabrice Bellard
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a copy
   7  * of this software and associated documentation files (the "Software"), to deal
   8  * in the Software without restriction, including without limitation the rights
   9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10  * copies of the Software, and to permit persons to whom the Software is
  11  * furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included in
  14  * all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22  * THE SOFTWARE.
  23  */
  24 #ifndef VL_H
  25 #define VL_H
  26
  27 /* we put basic includes here to avoid repeating them in device drivers */
  28 #include <stdlib.h>
  29 #include <stdio.h>
  30 #include <stdarg.h>
  31 #include <string.h>
  32 #include <inttypes.h>
  33 #include <time.h>
  34 #include <ctype.h>
  35 #include <errno.h>
  36 #include <unistd.h>
  37 #include <fcntl.h>
  38 #include <sys/stat.h>
  39
  40 #ifndef O_LARGEFILE
  41 #define O_LARGEFILE 0
  42 #endif
  43 #ifndef O_BINARY
  44 #define O_BINARY 0
  45 #endif
  46
  47 #ifdef _WIN32
  48 #define lseek64 _lseeki64
  49 #endif
  50
  51 #include "cpu.h"
  52
  53 #ifdef _BSD
  54 #define lseek64 lseek
  55 #define ftruncate64 ftruncate
  56 #define mkstemp64 mkstemp
  57 #define MAP_ANONYMOUS MAP_ANON
  58 #endif
  59
  60 #ifndef glue
  61 #define xglue(x, y) x ## y
  62 #define glue(x, y) xglue(x, y)
  63 #define stringify(s)    tostring(s)
  64 #define tostring(s)     #s
  65 #endif
  66
  67 #if defined(WORDS_BIGENDIAN)
  68 static inline uint32_t be32_to_cpu(uint32_t v)
  69 {
  70     return v;
  71 }
  72
  73 static inline uint16_t be16_to_cpu(uint16_t v)
  74 {
  75     return v;
  76 }
  77
  78 static inline uint32_t cpu_to_be32(uint32_t v)
  79 {
  80     return v;
  81 }
  82
  83 static inline uint16_t cpu_to_be16(uint16_t v)
  84 {
  85     return v;
  86 }
  87
  88 static inline uint32_t le32_to_cpu(uint32_t v)
  89 {
  90     return bswap32(v);
  91 }
  92
  93 static inline uint16_t le16_to_cpu(uint16_t v)
  94 {
  95     return bswap16(v);
  96 }
  97
  98 static inline uint32_t cpu_to_le32(uint32_t v)
  99 {
 100     return bswap32(v);
 101 }
 102
 103 static inline uint16_t cpu_to_le16(uint16_t v)
 104 {
 105     return bswap16(v);
 106 }
 107
 108 #else
 109
 110 static inline uint32_t be32_to_cpu(uint32_t v)
 111 {
 112     return bswap32(v);
 113 }
 114
 115 static inline uint16_t be16_to_cpu(uint16_t v)
 116 {
 117     return bswap16(v);
 118 }
 119
 120 static inline uint32_t cpu_to_be32(uint32_t v)
 121 {
 122     return bswap32(v);
 123 }
 124
 125 static inline uint16_t cpu_to_be16(uint16_t v)
 126 {
 127     return bswap16(v);
 128 }
 129
 130 static inline uint32_t le32_to_cpu(uint32_t v)
 131 {
 132     return v;
 133 }
 134
 135 static inline uint16_t le16_to_cpu(uint16_t v)
 136 {
 137     return v;
 138 }
 139
 140 static inline uint32_t cpu_to_le32(uint32_t v)
 141 {
 142     return v;
 143 }
 144
 145 static inline uint16_t cpu_to_le16(uint16_t v)
 146 {
 147     return v;
 148 }
 149 #endif
 150
 151
 152 /* vl.c */
 153 extern int reset_requested;
 154
 155 uint64_t muldiv64(uint64_t a, uint32_t b, uint32_t c);
 156
 157 void hw_error(const char *fmt, ...);
 158
 159 int load_image(const char *filename, uint8_t *addr);
 160 extern const char *bios_dir;
 161
 162 void pstrcpy(char *buf, int buf_size, const char *str);
 163 char *pstrcat(char *buf, int buf_size, const char *s);
 164
 165 int serial_open_device(void);
 166
 167 extern int vm_running;
 168
 169 typedef void VMStopHandler(void *opaque, int reason);
 170
 171 int qemu_add_vm_stop_handler(VMStopHandler *cb, void *opaque);
 172 void qemu_del_vm_stop_handler(VMStopHandler *cb, void *opaque);
 173
 174 void vm_start(void);
 175 void vm_stop(int reason);
 176
 177 extern int audio_enabled;
 178
 179 /* async I/O support */
 180
 181 typedef void IOReadHandler(void *opaque, const uint8_t *buf, int size);
 182 typedef int IOCanRWHandler(void *opaque);
 183
 184 int qemu_add_fd_read_handler(int fd, IOCanRWHandler *fd_can_read,
 185                              IOReadHandler *fd_read, void *opaque);
 186 void qemu_del_fd_read_handler(int fd);
 187
 188 /* network redirectors support */
 189
 190 #define MAX_NICS 8
 191
 192 typedef struct NetDriverState {
 193     int index; /* index number in QEMU */
 194     uint8_t macaddr[6];
 195     char ifname[16];
 196     void (*send_packet)(struct NetDriverState *nd,
 197                         const uint8_t *buf, int size);
 198     void (*add_read_packet)(struct NetDriverState *nd,
 199                             IOCanRWHandler *fd_can_read,
 200                             IOReadHandler *fd_read, void *opaque);
 201     /* tun specific data */
 202     int fd;
 203     /* slirp specific data */
 204 } NetDriverState;
 205
 206 extern int nb_nics;
 207 extern NetDriverState nd_table[MAX_NICS];
 208
 209 void qemu_send_packet(NetDriverState *nd, const uint8_t *buf, int size);
 210 void qemu_add_read_packet(NetDriverState *nd, IOCanRWHandler *fd_can_read,
 211                           IOReadHandler *fd_read, void *opaque);
 212
 213 /* timers */
 214
 215 typedef struct QEMUClock QEMUClock;
 216 typedef struct QEMUTimer QEMUTimer;
 217 typedef void QEMUTimerCB(void *opaque);
 218
 219 /* The real time clock should be used only for stuff which does not
 220    change the virtual machine state, as it is run even if the virtual
 221    machine is stopped. The real time clock has a frequency of 1000
 222    Hz. */
 223 extern QEMUClock *rt_clock;
 224
 225 /* Rge virtual clock is only run during the emulation. It is stopped
 226    when the virtual machine is stopped. Virtual timers use a high
 227    precision clock, usually cpu cycles (use ticks_per_sec). */
 228 extern QEMUClock *vm_clock;
 229
 230 int64_t qemu_get_clock(QEMUClock *clock);
 231
 232 QEMUTimer *qemu_new_timer(QEMUClock *clock, QEMUTimerCB *cb, void *opaque);
 233 void qemu_free_timer(QEMUTimer *ts);
 234 void qemu_del_timer(QEMUTimer *ts);
 235 void qemu_mod_timer(QEMUTimer *ts, int64_t expire_time);
 236 int qemu_timer_pending(QEMUTimer *ts);
 237
 238 extern int64_t ticks_per_sec;
 239 extern int pit_min_timer_count;
 240
 241 void cpu_enable_ticks(void);
 242 void cpu_disable_ticks(void);
 243
 244 /* VM Load/Save */
 245
 246 typedef FILE QEMUFile;
 247
 248 void qemu_put_buffer(QEMUFile *f, const uint8_t *buf, int size);
 249 void qemu_put_byte(QEMUFile *f, int v);
 250 void qemu_put_be16(QEMUFile *f, unsigned int v);
 251 void qemu_put_be32(QEMUFile *f, unsigned int v);
 252 void qemu_put_be64(QEMUFile *f, uint64_t v);
 253 int qemu_get_buffer(QEMUFile *f, uint8_t *buf, int size);
 254 int qemu_get_byte(QEMUFile *f);
 255 unsigned int qemu_get_be16(QEMUFile *f);
 256 unsigned int qemu_get_be32(QEMUFile *f);
 257 uint64_t qemu_get_be64(QEMUFile *f);
 258
 259 static inline void qemu_put_be64s(QEMUFile *f, const uint64_t *pv)
 260 {
 261     qemu_put_be64(f, *pv);
 262 }
 263
 264 static inline void qemu_put_be32s(QEMUFile *f, const uint32_t *pv)
 265 {
 266     qemu_put_be32(f, *pv);
 267 }
 268
 269 static inline void qemu_put_be16s(QEMUFile *f, const uint16_t *pv)
 270 {
 271     qemu_put_be16(f, *pv);
 272 }
 273
 274 static inline void qemu_put_8s(QEMUFile *f, const uint8_t *pv)
 275 {
 276     qemu_put_byte(f, *pv);
 277 }
 278
 279 static inline void qemu_get_be64s(QEMUFile *f, uint64_t *pv)
 280 {
 281     *pv = qemu_get_be64(f);
 282 }
 283
 284 static inline void qemu_get_be32s(QEMUFile *f, uint32_t *pv)
 285 {
 286     *pv = qemu_get_be32(f);
 287 }
 288
 289 static inline void qemu_get_be16s(QEMUFile *f, uint16_t *pv)
 290 {
 291     *pv = qemu_get_be16(f);
 292 }
 293
 294 static inline void qemu_get_8s(QEMUFile *f, uint8_t *pv)
 295 {
 296     *pv = qemu_get_byte(f);
 297 }
 298
 299 int64_t qemu_ftell(QEMUFile *f);
 300 int64_t qemu_fseek(QEMUFile *f, int64_t pos, int whence);
 301
 302 typedef void SaveStateHandler(QEMUFile *f, void *opaque);
 303 typedef int LoadStateHandler(QEMUFile *f, void *opaque, int version_id);
 304
 305 int qemu_loadvm(const char *filename);
 306 int qemu_savevm(const char *filename);
 307 int register_savevm(const char *idstr,
 308                     int instance_id,
 309                     int version_id,
 310                     SaveStateHandler *save_state,
 311                     LoadStateHandler *load_state,
 312                     void *opaque);
 313 void qemu_get_timer(QEMUFile *f, QEMUTimer *ts);
 314 void qemu_put_timer(QEMUFile *f, QEMUTimer *ts);
 315
 316 /* block.c */
 317 typedef struct BlockDriverState BlockDriverState;
 318
 319 BlockDriverState *bdrv_new(const char *device_name);
 320 void bdrv_delete(BlockDriverState *bs);
 321 int bdrv_open(BlockDriverState *bs, const char *filename, int snapshot);
 322 void bdrv_close(BlockDriverState *bs);
 323 int bdrv_read(BlockDriverState *bs, int64_t sector_num,
 324               uint8_t *buf, int nb_sectors);
 325 int bdrv_write(BlockDriverState *bs, int64_t sector_num,
 326                const uint8_t *buf, int nb_sectors);
 327 void bdrv_get_geometry(BlockDriverState *bs, int64_t *nb_sectors_ptr);
 328 int bdrv_commit(BlockDriverState *bs);
 329 void bdrv_set_boot_sector(BlockDriverState *bs, const uint8_t *data, int size);
 330
 331 #define BDRV_TYPE_HD     0
 332 #define BDRV_TYPE_CDROM  1
 333 #define BDRV_TYPE_FLOPPY 2
 334
 335 void bdrv_set_geometry_hint(BlockDriverState *bs,
 336                             int cyls, int heads, int secs);
 337 void bdrv_set_type_hint(BlockDriverState *bs, int type);
 338 void bdrv_get_geometry_hint(BlockDriverState *bs,
 339                             int *pcyls, int *pheads, int *psecs);
 340 int bdrv_get_type_hint(BlockDriverState *bs);
 341 int bdrv_is_removable(BlockDriverState *bs);
 342 int bdrv_is_read_only(BlockDriverState *bs);
 343 int bdrv_is_inserted(BlockDriverState *bs);
 344 int bdrv_is_locked(BlockDriverState *bs);
 345 void bdrv_set_locked(BlockDriverState *bs, int locked);
 346 void bdrv_set_change_cb(BlockDriverState *bs,
 347                         void (*change_cb)(void *opaque), void *opaque);
 348
 349 void bdrv_info(void);
 350 BlockDriverState *bdrv_find(const char *name);
 351
 352 /* ISA bus */
 353
 354 extern target_phys_addr_t isa_mem_base;
 355
 356 typedef void (IOPortWriteFunc)(void *opaque, uint32_t address, uint32_t data);
 357 typedef uint32_t (IOPortReadFunc)(void *opaque, uint32_t address);
 358
 359 int register_ioport_read(int start, int length, int size,
 360                          IOPortReadFunc *func, void *opaque);
 361 int register_ioport_write(int start, int length, int size,
 362                           IOPortWriteFunc *func, void *opaque);
 363 void isa_unassign_ioport(int start, int length);
 364
 365 /* PCI bus */
 366
 367 extern int pci_enabled;
 368
 369 extern target_phys_addr_t pci_mem_base;
 370
 371 typedef struct PCIDevice PCIDevice;
 372
 373 typedef void PCIConfigWriteFunc(PCIDevice *pci_dev,
 374                                 uint32_t address, uint32_t data, int len);
 375 typedef uint32_t PCIConfigReadFunc(PCIDevice *pci_dev,
 376                                    uint32_t address, int len);
 377 typedef void PCIMapIORegionFunc(PCIDevice *pci_dev, int region_num,
 378                                 uint32_t addr, uint32_t size, int type);
 379
 380 #define PCI_ADDRESS_SPACE_MEM           0x00
 381 #define PCI_ADDRESS_SPACE_IO            0x01
 382 #define PCI_ADDRESS_SPACE_MEM_PREFETCH  0x08
 383
 384 typedef struct PCIIORegion {
 385     uint32_t addr; /* current PCI mapping address. -1 means not mapped */
 386     uint32_t size;
 387     uint8_t type;
 388     PCIMapIORegionFunc *map_func;
 389 } PCIIORegion;
 390
 391 struct PCIDevice {
 392     /* PCI config space */
 393     uint8_t config[256];
 394
 395     /* the following fields are read only */
 396     int bus_num;
 397     int devfn;
 398     char name[64];
 399     PCIIORegion io_regions[6];
 400
 401     /* do not access the following fields */
 402     PCIConfigReadFunc *config_read;
 403     PCIConfigWriteFunc *config_write;
 404     int irq_index;
 405 };
 406
 407 PCIDevice *pci_register_device(const char *name, int instance_size,
 408                                int bus_num, int devfn,
 409                                PCIConfigReadFunc *config_read,
 410                                PCIConfigWriteFunc *config_write);
 411
 412 void pci_register_io_region(PCIDevice *pci_dev, int region_num,
 413                             uint32_t size, int type,
 414                             PCIMapIORegionFunc *map_func);
 415
 416 void pci_set_irq(PCIDevice *pci_dev, int irq_num, int level);
 417
 418 uint32_t pci_default_read_config(PCIDevice *d,
 419                                  uint32_t address, int len);
 420 void pci_default_write_config(PCIDevice *d,
 421                               uint32_t address, uint32_t val, int len);
 422
 423 void i440fx_init(void);
 424 void piix3_init(void);
 425 void pci_bios_init(void);
 426 void pci_info(void);
 427
 428 /* vga.c */
 429
 430 #define VGA_RAM_SIZE (4096 * 1024)
 431
 432 typedef struct DisplayState {
 433     uint8_t *data;
 434     int linesize;
 435     int depth;
 436     void (*dpy_update)(struct DisplayState *s, int x, int y, int w, int h);
 437     void (*dpy_resize)(struct DisplayState *s, int w, int h);
 438     void (*dpy_refresh)(struct DisplayState *s);
 439 } DisplayState;
 440
 441 static inline void dpy_update(DisplayState *s, int x, int y, int w, int h)
 442 {
 443     s->dpy_update(s, x, y, w, h);
 444 }
 445
 446 static inline void dpy_resize(DisplayState *s, int w, int h)
 447 {
 448     s->dpy_resize(s, w, h);
 449 }
 450
 451 int vga_initialize(DisplayState *ds, uint8_t *vga_ram_base,
 452                    unsigned long vga_ram_offset, int vga_ram_size,
 453                    int is_pci);
 454 void vga_update_display(void);
 455 void vga_screen_dump(const char *filename);
 456
 457 /* sdl.c */
 458 void sdl_display_init(DisplayState *ds);
 459
 460 /* ide.c */
 461 #define MAX_DISKS 4
 462
 463 extern BlockDriverState *bs_table[MAX_DISKS];
 464
 465 void isa_ide_init(int iobase, int iobase2, int irq,
 466                   BlockDriverState *hd0, BlockDriverState *hd1);
 467 void pci_ide_init(BlockDriverState **hd_table);
 468
 469 /* oss.c */
 470 typedef enum {
 471   AUD_FMT_U8,
 472   AUD_FMT_S8,
 473   AUD_FMT_U16,
 474   AUD_FMT_S16
 475 } audfmt_e;
 476
 477 void AUD_open (int rfreq, int rnchannels, audfmt_e rfmt);
 478 void AUD_reset (int rfreq, int rnchannels, audfmt_e rfmt);
 479 int AUD_write (void *in_buf, int size);
 480 void AUD_run (void);
 481 void AUD_adjust_estimate (int _leftover);
 482 int AUD_get_free (void);
 483 int AUD_get_live (void);
 484 int AUD_get_buffer_size (void);
 485 void AUD_init (void);
 486
 487 /* dma.c */
 488 typedef int (*DMA_transfer_handler) (void *opaque, target_ulong addr, int size);
 489 int DMA_get_channel_mode (int nchan);
 490 void DMA_hold_DREQ (int nchan);
 491 void DMA_release_DREQ (int nchan);
 492 void DMA_schedule(int nchan);
 493 void DMA_run (void);
 494 void DMA_init (void);
 495 void DMA_register_channel (int nchan,
 496                            DMA_transfer_handler transfer_handler, void *opaque);
 497
 498 /* sb16.c */
 499 void SB16_run (void);
 500 void SB16_init (void);
 501
 502 /* fdc.c */
 503 #define MAX_FD 2
 504 extern BlockDriverState *fd_table[MAX_FD];
 505
 506 typedef struct fdctrl_t fdctrl_t;
 507
 508 fdctrl_t *fdctrl_init (int irq_lvl, int dma_chann, int mem_mapped,
 509                        uint32_t io_base,
 510                        BlockDriverState **fds);
 511 int fdctrl_get_drive_type(fdctrl_t *fdctrl, int drive_num);
 512
 513 /* ne2000.c */
 514
 515 void isa_ne2000_init(int base, int irq, NetDriverState *nd);
 516 void pci_ne2000_init(NetDriverState *nd);
 517
 518 /* pckbd.c */
 519
 520 void kbd_put_keycode(int keycode);
 521
 522 #define MOUSE_EVENT_LBUTTON 0x01
 523 #define MOUSE_EVENT_RBUTTON 0x02
 524 #define MOUSE_EVENT_MBUTTON 0x04
 525 void kbd_mouse_event(int dx, int dy, int dz, int buttons_state);
 526
 527 void kbd_init(void);
 528
 529 /* mc146818rtc.c */
 530
 531 typedef struct RTCState RTCState;
 532
 533 RTCState *rtc_init(int base, int irq);
 534 void rtc_set_memory(RTCState *s, int addr, int val);
 535 void rtc_set_date(RTCState *s, const struct tm *tm);
 536
 537 /* serial.c */
 538
 539 typedef struct SerialState SerialState;
 540
 541 extern SerialState *serial_console;
 542
 543 SerialState *serial_init(int base, int irq, int fd);
 544 int serial_can_receive(SerialState *s);
 545 void serial_receive_byte(SerialState *s, int ch);
 546 void serial_receive_break(SerialState *s);
 547
 548 /* i8259.c */
 549
 550 void pic_set_irq(int irq, int level);
 551 void pic_init(void);
 552 uint32_t pic_intack_read(CPUState *env);
 553 void pic_info(void);
 554
 555 /* i8254.c */
 556
 557 #define PIT_FREQ 1193182
 558
 559 typedef struct PITState PITState;
 560
 561 PITState *pit_init(int base, int irq);
 562 void pit_set_gate(PITState *pit, int channel, int val);
 563 int pit_get_gate(PITState *pit, int channel);
 564 int pit_get_out(PITState *pit, int channel, int64_t current_time);
 565
 566 /* pc.c */
 567 void pc_init(int ram_size, int vga_ram_size, int boot_device,
 568              DisplayState *ds, const char **fd_filename, int snapshot,
 569              const char *kernel_filename, const char *kernel_cmdline,
 570              const char *initrd_filename);
 571
 572 /* ppc.c */
 573 void ppc_init (int ram_size, int vga_ram_size, int boot_device,
 574                DisplayState *ds, const char **fd_filename, int snapshot,
 575                const char *kernel_filename, const char *kernel_cmdline,
 576                const char *initrd_filename);
 577
 578 /* monitor.c */
 579 void monitor_init(void);
 580 void term_printf(const char *fmt, ...) __attribute__ ((__format__ (__printf__, 1, 2)));
 581 void term_flush(void);
 582 void term_print_help(void);
 583
 584 /* gdbstub.c */
 585
 586 #define DEFAULT_GDBSTUB_PORT 1234
 587
 588 int gdbserver_start(int port);
 589
 590 #endif /* VL_H */