/* * GRUB -- GRand Unified Bootloader * Copyright (C) 2000,2001,2002,2003,2004,2005,2007,2008,2009 Free Software Foundation, Inc. * * GRUB is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * GRUB is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with GRUB. If not, see . */ #include #include #include #include #include #include #include #include #include #include #define TEXT_WIDTH 80 #define TEXT_HEIGHT 24 static unsigned int xpos, ypos; static unsigned int keep_track = 1; static unsigned int registered = 0; /* An input buffer. */ static char input_buf[8]; static unsigned int npending = 0; static struct grub_term_output grub_serial_term_output; /* Argument options. */ static const struct grub_arg_option options[] = { {"unit", 'u', 0, N_("Set the serial unit."), 0, ARG_TYPE_INT}, {"port", 'p', 0, N_("Set the serial port address."), 0, ARG_TYPE_STRING}, {"speed", 's', 0, N_("Set the serial port speed."), 0, ARG_TYPE_INT}, {"word", 'w', 0, N_("Set the serial port word length."), 0, ARG_TYPE_INT}, {"parity", 'r', 0, N_("Set the serial port parity."), 0, ARG_TYPE_STRING}, {"stop", 't', 0, N_("Set the serial port stop bits."), 0, ARG_TYPE_INT}, {"ascii", 'a', 0, N_("Terminal is ASCII-only."), 0, ARG_TYPE_NONE}, {"utf8", 'l', 0, N_("Terminal is logical-ordered UTF-8."), 0, ARG_TYPE_NONE}, {"visual-utf8", 'v', 0, N_("Terminal is visually-ordered UTF-8."), 0, ARG_TYPE_NONE}, {0, 0, 0, 0, 0, 0} }; /* Serial port settings. */ struct serial_port { grub_port_t port; unsigned short divisor; unsigned short word_len; unsigned int parity; unsigned short stop_bits; }; /* Serial port settings. */ static struct serial_port serial_settings; #ifdef GRUB_MACHINE_PCBIOS static const unsigned short *serial_hw_io_addr = (const unsigned short *) GRUB_MEMORY_MACHINE_BIOS_DATA_AREA_ADDR; #define GRUB_SERIAL_PORT_NUM 4 #else #include static const grub_port_t serial_hw_io_addr[] = GRUB_MACHINE_SERIAL_PORTS; #define GRUB_SERIAL_PORT_NUM (ARRAY_SIZE(serial_hw_io_addr)) #endif /* Return the port number for the UNITth serial device. */ static inline grub_port_t serial_hw_get_port (const unsigned int unit) { if (unit < GRUB_SERIAL_PORT_NUM) return serial_hw_io_addr[unit]; else return 0; } /* Fetch a key. */ static int serial_hw_fetch (void) { if (grub_inb (serial_settings.port + UART_LSR) & UART_DATA_READY) return grub_inb (serial_settings.port + UART_RX); return -1; } /* Put a character. */ static void serial_hw_put (const int c) { unsigned int timeout = 100000; /* Wait until the transmitter holding register is empty. */ while ((grub_inb (serial_settings.port + UART_LSR) & UART_EMPTY_TRANSMITTER) == 0) { if (--timeout == 0) /* There is something wrong. But what can I do? */ return; } grub_outb (c, serial_settings.port + UART_TX); } static void serial_translate_key_sequence (void) { unsigned int i; static struct { char key; char ascii; } three_code_table[] = { {'A', 16}, {'B', 14}, {'C', 6}, {'D', 2}, {'F', 5}, {'H', 1}, {'4', 4} }; static struct { short key; char ascii; } four_code_table[] = { {('1' | ('~' << 8)), 1}, {('3' | ('~' << 8)), 4}, {('5' | ('~' << 8)), 7}, {('6' | ('~' << 8)), 3} }; if (npending < 3) return; /* The buffer must start with "ESC [". */ if (input_buf[0] != '\e' || input_buf[1] != '[') return; for (i = 0; i < ARRAY_SIZE (three_code_table); i++) if (three_code_table[i].key == input_buf[2]) { input_buf[0] = three_code_table[i].ascii; npending -= 2; grub_memmove (input_buf + 1, input_buf + 3, npending - 1); return; } if (npending >= 4) { short key = input_buf[3] | (input_buf[4] << 8); for (i = 0; i < ARRAY_SIZE (four_code_table); i++) if (four_code_table[i].key == key) { input_buf[0] = four_code_table[i].ascii; npending -= 3; grub_memmove (input_buf + 1, input_buf + 4, npending - 1); return; } } } static int fill_input_buf (const int nowait) { int i; for (i = 0; i < 10000 && npending < sizeof (input_buf); i++) { int c; c = serial_hw_fetch (); if (c >= 0) { input_buf[npending++] = c; /* Reset the counter to zero, to wait for the same interval. */ i = 0; } if (nowait) break; } /* Translate some key sequences. */ serial_translate_key_sequence (); return npending; } /* Convert speed to divisor. */ static unsigned short serial_get_divisor (unsigned int speed) { unsigned int i; /* The structure for speed vs. divisor. */ struct divisor { unsigned int speed; unsigned short div; }; /* The table which lists common configurations. */ /* 1843200 / (speed * 16) */ static struct divisor divisor_tab[] = { { 2400, 0x0030 }, { 4800, 0x0018 }, { 9600, 0x000C }, { 19200, 0x0006 }, { 38400, 0x0003 }, { 57600, 0x0002 }, { 115200, 0x0001 } }; /* Set the baud rate. */ for (i = 0; i < sizeof (divisor_tab) / sizeof (divisor_tab[0]); i++) if (divisor_tab[i].speed == speed) /* UART in Yeeloong runs twice the usual rate. */ #ifdef GRUB_MACHINE_MIPS_YEELOONG return 2 * divisor_tab[i].div; #else return divisor_tab[i].div; #endif return 0; } /* The serial version of checkkey. */ static int grub_serial_checkkey (void) { if (fill_input_buf (1)) return input_buf[0]; else return -1; } /* The serial version of getkey. */ static int grub_serial_getkey (void) { int c; while (! fill_input_buf (0)) ; c = input_buf[0]; if (c == 0x7f) c = GRUB_TERM_BACKSPACE; grub_memmove (input_buf, input_buf + 1, --npending); return c; } /* Initialize a serial device. PORT is the port number for a serial device. SPEED is a DTE-DTE speed which must be one of these: 2400, 4800, 9600, 19200, 38400, 57600 and 115200. WORD_LEN is the word length to be used for the device. Likewise, PARITY is the type of the parity and STOP_BIT_LEN is the length of the stop bit. The possible values for WORD_LEN, PARITY and STOP_BIT_LEN are defined in the header file as macros. */ static grub_err_t serial_hw_init (void) { unsigned char status = 0; /* Turn off the interrupt. */ grub_outb (0, serial_settings.port + UART_IER); /* Set DLAB. */ grub_outb (UART_DLAB, serial_settings.port + UART_LCR); /* Set the baud rate. */ grub_outb (serial_settings.divisor & 0xFF, serial_settings.port + UART_DLL); grub_outb (serial_settings.divisor >> 8, serial_settings.port + UART_DLH); /* Set the line status. */ status |= (serial_settings.parity | serial_settings.word_len | serial_settings.stop_bits); grub_outb (status, serial_settings.port + UART_LCR); /* In Yeeloong serial port has only 3 wires. */ #ifndef GRUB_MACHINE_MIPS_YEELOONG /* Enable the FIFO. */ grub_outb (UART_ENABLE_FIFO, serial_settings.port + UART_FCR); /* Turn on DTR, RTS, and OUT2. */ grub_outb (UART_ENABLE_MODEM, serial_settings.port + UART_MCR); #endif /* Drain the input buffer. */ while (grub_serial_checkkey () != -1) (void) grub_serial_getkey (); /* FIXME: should check if the serial terminal was found. */ return GRUB_ERR_NONE; } /* The serial version of putchar. */ static void grub_serial_putchar (const struct grub_unicode_glyph *c) { /* Keep track of the cursor. */ if (keep_track) { switch (c->base) { case '\a': break; case '\b': case 127: if (xpos > 0) xpos--; break; case '\n': if (ypos < TEXT_HEIGHT - 1) ypos++; break; case '\r': xpos = 0; break; default: if ((c->base & 0xC0) == 0x80) break; if (xpos + c->estimated_width >= TEXT_WIDTH + 1) { xpos = 0; if (ypos < TEXT_HEIGHT - 1) ypos++; serial_hw_put ('\r'); serial_hw_put ('\n'); } xpos += c->estimated_width; break; } } serial_hw_put (c->base); } static grub_uint16_t grub_serial_getwh (void) { return (TEXT_WIDTH << 8) | TEXT_HEIGHT; } static grub_uint16_t grub_serial_getxy (void) { return ((xpos << 8) | ypos); } static void grub_serial_gotoxy (grub_uint8_t x, grub_uint8_t y) { if (x > TEXT_WIDTH || y > TEXT_HEIGHT) { grub_error (GRUB_ERR_OUT_OF_RANGE, "invalid point (%u,%u)", x, y); } else { keep_track = 0; grub_terminfo_gotoxy (x, y, &grub_serial_term_output); keep_track = 1; xpos = x; ypos = y; } } static void grub_serial_cls (void) { keep_track = 0; grub_terminfo_cls (&grub_serial_term_output); keep_track = 1; xpos = ypos = 0; } static void grub_serial_setcolorstate (const grub_term_color_state state) { keep_track = 0; switch (state) { case GRUB_TERM_COLOR_STANDARD: case GRUB_TERM_COLOR_NORMAL: grub_terminfo_reverse_video_off (&grub_serial_term_output); break; case GRUB_TERM_COLOR_HIGHLIGHT: grub_terminfo_reverse_video_on (&grub_serial_term_output); break; default: break; } keep_track = 1; } static void grub_serial_setcursor (const int on) { if (on) grub_terminfo_cursor_on (&grub_serial_term_output); else grub_terminfo_cursor_off (&grub_serial_term_output); } static struct grub_term_input grub_serial_term_input = { .name = "serial", .checkkey = grub_serial_checkkey, .getkey = grub_serial_getkey, }; static struct grub_term_output grub_serial_term_output = { .name = "serial", .putchar = grub_serial_putchar, .getwh = grub_serial_getwh, .getxy = grub_serial_getxy, .gotoxy = grub_serial_gotoxy, .cls = grub_serial_cls, .setcolorstate = grub_serial_setcolorstate, .setcursor = grub_serial_setcursor, .flags = GRUB_TERM_CODE_TYPE_ASCII, }; static grub_err_t grub_cmd_serial (grub_extcmd_t cmd, int argc __attribute__ ((unused)), char **args __attribute__ ((unused))) { struct grub_arg_list *state = cmd->state; struct serial_port backup_settings = serial_settings; grub_err_t hwiniterr; if (state[0].set) { unsigned int unit; unit = grub_strtoul (state[0].arg, 0, 0); serial_settings.port = serial_hw_get_port (unit); if (!serial_settings.port) return grub_error (GRUB_ERR_BAD_ARGUMENT, "bad unit number"); } if (state[1].set) serial_settings.port = (grub_port_t) grub_strtoul (state[1].arg, 0, 0); if (state[2].set) { unsigned long speed; speed = grub_strtoul (state[2].arg, 0, 0); serial_settings.divisor = serial_get_divisor ((unsigned int) speed); if (serial_settings.divisor == 0) { serial_settings = backup_settings; return grub_error (GRUB_ERR_BAD_ARGUMENT, "bad speed"); } } if (state[3].set) { if (! grub_strcmp (state[3].arg, "5")) serial_settings.word_len = UART_5BITS_WORD; else if (! grub_strcmp (state[3].arg, "6")) serial_settings.word_len = UART_6BITS_WORD; else if (! grub_strcmp (state[3].arg, "7")) serial_settings.word_len = UART_7BITS_WORD; else if (! grub_strcmp (state[3].arg, "8")) serial_settings.word_len = UART_8BITS_WORD; else { serial_settings = backup_settings; return grub_error (GRUB_ERR_BAD_ARGUMENT, "bad word length"); } } if (state[4].set) { if (! grub_strcmp (state[4].arg, "no")) serial_settings.parity = UART_NO_PARITY; else if (! grub_strcmp (state[4].arg, "odd")) serial_settings.parity = UART_ODD_PARITY; else if (! grub_strcmp (state[4].arg, "even")) serial_settings.parity = UART_EVEN_PARITY; else { serial_settings = backup_settings; return grub_error (GRUB_ERR_BAD_ARGUMENT, "bad parity"); } } if (state[5].set) { if (! grub_strcmp (state[5].arg, "1")) serial_settings.stop_bits = UART_1_STOP_BIT; else if (! grub_strcmp (state[5].arg, "2")) serial_settings.stop_bits = UART_2_STOP_BITS; else { serial_settings = backup_settings; return grub_error (GRUB_ERR_BAD_ARGUMENT, "bad number of stop bits"); } } grub_serial_term_output.flags &= ~GRUB_TERM_CODE_TYPE_MASK; if (state[7].set) grub_serial_term_output.flags |= GRUB_TERM_CODE_TYPE_UTF8_LOGICAL; else if (state[8].set) grub_serial_term_output.flags |= GRUB_TERM_CODE_TYPE_UTF8_VISUAL; else grub_serial_term_output.flags |= GRUB_TERM_CODE_TYPE_ASCII; /* Initialize with new settings. */ hwiniterr = serial_hw_init (); if (hwiniterr == GRUB_ERR_NONE) { /* Register terminal if not yet registered. */ if (registered == 0) { grub_term_register_input ("serial", &grub_serial_term_input); grub_term_register_output ("serial", &grub_serial_term_output); registered = 1; } } else { /* Initialization with new settings failed. */ if (registered == 1) { /* If the terminal is registered, attempt to restore previous settings. */ serial_settings = backup_settings; if (serial_hw_init () != GRUB_ERR_NONE) { /* If unable to restore settings, unregister terminal. */ grub_term_unregister_input (&grub_serial_term_input); grub_term_unregister_output (&grub_serial_term_output); registered = 0; } } } return hwiniterr; } static grub_extcmd_t cmd; GRUB_MOD_INIT(serial) { cmd = grub_register_extcmd ("serial", grub_cmd_serial, GRUB_COMMAND_FLAG_BOTH, "serial [OPTIONS...]", "Configure serial port.", options); /* Set default settings. */ serial_settings.port = serial_hw_get_port (0); #ifdef GRUB_MACHINE_MIPS_YEELOONG serial_settings.divisor = serial_get_divisor (115200); #else serial_settings.divisor = serial_get_divisor (9600); #endif serial_settings.word_len = UART_8BITS_WORD; serial_settings.parity = UART_NO_PARITY; serial_settings.stop_bits = UART_1_STOP_BIT; } GRUB_MOD_FINI(serial) { grub_unregister_extcmd (cmd); if (registered == 1) /* Unregister terminal only if registered. */ { grub_term_unregister_input (&grub_serial_term_input); grub_term_unregister_output (&grub_serial_term_output); } }