2018-01-28 01:00:21 +00:00
|
|
|
// Licensed to the Apache Software Foundation (ASF) under one
|
|
|
|
// or more contributor license agreements. See the NOTICE file
|
|
|
|
// distributed with this work for additional information
|
|
|
|
// regarding copyright ownership. The ASF licenses this file
|
|
|
|
// to you under the Apache License, Version 2.0 (the
|
|
|
|
// "License"); you may not use this file except in compliance
|
|
|
|
// with the License. You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing,
|
|
|
|
// software distributed under the License is distributed on an
|
|
|
|
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
|
|
// KIND, either express or implied. See the License for the
|
|
|
|
// specific language governing permissions and limitations
|
|
|
|
// under the License.
|
|
|
|
//
|
|
|
|
// Description: PS/2 keyboard interface
|
|
|
|
//
|
|
|
|
// Author.....: Niels A. Moseley
|
|
|
|
// Date.......: 28-1-2018
|
2018-01-29 10:00:38 +00:00
|
|
|
//
|
2018-01-28 01:00:21 +00:00
|
|
|
|
|
|
|
module ps2keyboard (
|
2018-01-29 10:00:38 +00:00
|
|
|
input clk25, // 25MHz clock
|
|
|
|
input rst, // active high reset
|
2018-01-28 01:00:21 +00:00
|
|
|
|
|
|
|
// I/O interface to keyboard
|
2018-01-29 10:00:38 +00:00
|
|
|
input key_clk, // clock input from keyboard / device
|
|
|
|
input key_din, // data input from keyboard / device
|
2018-01-28 01:00:21 +00:00
|
|
|
|
|
|
|
// I/O interface to computer
|
2018-01-29 10:00:38 +00:00
|
|
|
input cs, // chip select, active high
|
|
|
|
input address, // =0 RX buffer, =1 RX status
|
|
|
|
output reg [7:0] dout // 8-bit output bus.
|
2018-01-28 01:00:21 +00:00
|
|
|
);
|
|
|
|
|
|
|
|
// signals in the slow PS/2 clock domain
|
|
|
|
reg [3:0] rxcnt; // count how many bits have been shift into rxshiftbuf
|
|
|
|
reg [10:0] rxshiftbuf; // 11 bit shift receive register
|
|
|
|
reg rx_flag = 0; // this flag changes state (0->1 or 1->0) when
|
|
|
|
// valid data is available in rxshiftbuf
|
|
|
|
|
|
|
|
// signals in the high-speed clock (clk25) domain
|
|
|
|
reg [7:0] rx; // receive buffer
|
|
|
|
reg rxflag_ff; // flip-flop state for clk domain xing
|
|
|
|
reg rx_rdy; // data ready to be read
|
|
|
|
|
2018-01-28 22:41:27 +00:00
|
|
|
// keyboard translation signals
|
|
|
|
reg [7:0] ascii; // ASCII code of received character
|
|
|
|
reg ascii_rdy; // new ASCII character received
|
2018-01-28 22:56:02 +00:00
|
|
|
reg shift; // state of the shift key
|
2018-01-28 22:41:27 +00:00
|
|
|
reg [2:0] cur_state;
|
|
|
|
reg [2:0] next_state;
|
2018-01-29 10:00:38 +00:00
|
|
|
|
2018-01-28 01:00:21 +00:00
|
|
|
//
|
|
|
|
// PS/2 data from a device changes when the clock
|
|
|
|
// is low, so we latch when the clock transitions
|
|
|
|
// to a high state
|
|
|
|
//
|
|
|
|
|
2018-01-29 10:00:38 +00:00
|
|
|
always @(posedge key_clk or posedge rst)
|
2018-01-28 01:00:21 +00:00
|
|
|
begin
|
2018-01-29 10:00:38 +00:00
|
|
|
if (rst == 1'b1)
|
2018-01-28 01:00:21 +00:00
|
|
|
begin
|
|
|
|
// reset the serial buffer
|
|
|
|
rxshiftbuf <= 11'b0;
|
|
|
|
rxcnt <= 0;
|
|
|
|
rx_flag <= 0;
|
|
|
|
end
|
|
|
|
else
|
|
|
|
begin
|
|
|
|
// shift in LSB first from keyboard
|
|
|
|
rxshiftbuf <= {key_din, rxshiftbuf[10:1]};
|
|
|
|
rxcnt <= rxcnt + 4'b1;
|
|
|
|
if (rxcnt == 4'd10)
|
|
|
|
begin
|
|
|
|
// 10 bits have been shifted in
|
|
|
|
// we should have a complete
|
|
|
|
// scan code here, including
|
|
|
|
// start, parity and stop bits.
|
|
|
|
rxcnt <= 0;
|
|
|
|
rx_flag <= !rx_flag; // change state to signal new data
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
//
|
|
|
|
// clock domain crossing from slow PS/2 clock to
|
|
|
|
// high-speed clock domain:
|
|
|
|
//
|
|
|
|
// --------------| |
|
|
|
|
// | _______ | XOR |----> rx_valid_stb
|
|
|
|
// flag ---| D Q |----| |
|
|
|
|
// | |
|
|
|
|
// clk ----|> |
|
|
|
|
// |_______|
|
|
|
|
//
|
|
|
|
// when flag toggles state, tx_valid_stb will become
|
|
|
|
// '1' for exactly one (high-speed) clock cycle.
|
|
|
|
//
|
|
|
|
|
2018-01-28 22:41:27 +00:00
|
|
|
//
|
|
|
|
// IBM Keyboard code page translation
|
|
|
|
// state machine for US keyboard layout
|
|
|
|
//
|
|
|
|
// http://www.computer-engineering.org/ps2keyboard/scancodes2.html
|
|
|
|
//
|
|
|
|
|
|
|
|
localparam S_KEYNORMAL = 3'b000;
|
|
|
|
localparam S_KEYF0 = 3'b001; // regular key release state
|
|
|
|
localparam S_KEYE0 = 3'b010; // extended key state
|
|
|
|
localparam S_KEYE0F0 = 3'b011; // extended release state
|
|
|
|
|
2018-01-29 10:00:38 +00:00
|
|
|
always @(posedge clk25 or posedge rst)
|
2018-01-28 01:00:21 +00:00
|
|
|
begin
|
2018-01-29 10:00:38 +00:00
|
|
|
if (rst)
|
2018-01-28 01:00:21 +00:00
|
|
|
begin
|
2018-01-28 22:41:27 +00:00
|
|
|
rxflag_ff <= 0;
|
|
|
|
rx <= 0;
|
|
|
|
rx_rdy <= 0;
|
|
|
|
ascii_rdy <= 0;
|
2018-01-28 22:56:02 +00:00
|
|
|
shift <= 0;
|
2018-01-28 22:41:27 +00:00
|
|
|
cur_state <= S_KEYNORMAL;
|
2018-01-28 01:00:21 +00:00
|
|
|
end
|
|
|
|
else
|
|
|
|
begin
|
|
|
|
// check for new RX data from the keyboard
|
|
|
|
rxflag_ff <= rx_flag;
|
|
|
|
|
|
|
|
if ((rxflag_ff ^ rx_flag) == 1'b1)
|
|
|
|
begin
|
|
|
|
// we detected a change in the rx_flag
|
|
|
|
// so we have valid data in the rxshiftbuf
|
|
|
|
rx <= rxshiftbuf[8:1];
|
|
|
|
rx_rdy <= 1;
|
|
|
|
end
|
2018-01-29 10:00:38 +00:00
|
|
|
|
2018-01-28 01:00:21 +00:00
|
|
|
// handle I/O from CPU
|
|
|
|
if (cs == 1'b1)
|
|
|
|
begin
|
|
|
|
if (address == 1'b0)
|
|
|
|
begin
|
|
|
|
// RX buffer address
|
2018-01-28 23:39:24 +00:00
|
|
|
dout <= {1'b1, ascii[6:0]};
|
2018-01-28 22:41:27 +00:00
|
|
|
ascii_rdy <= 1'b0;
|
2018-01-28 01:00:21 +00:00
|
|
|
end
|
|
|
|
else
|
|
|
|
begin
|
|
|
|
// RX status register
|
2018-01-28 22:41:27 +00:00
|
|
|
dout <= {ascii_rdy, 7'b0};
|
2018-01-28 01:00:21 +00:00
|
|
|
end
|
|
|
|
end
|
2018-01-28 22:41:27 +00:00
|
|
|
|
|
|
|
// keyboard translation state machine
|
|
|
|
if (rx_rdy == 1'b1)
|
|
|
|
begin
|
|
|
|
rx_rdy <= 1'b0;
|
|
|
|
case(cur_state)
|
|
|
|
S_KEYNORMAL:
|
|
|
|
begin
|
|
|
|
if (rx == 8'hF0)
|
|
|
|
next_state = S_KEYF0;
|
|
|
|
else if (rx == 8'hE0)
|
|
|
|
next_state = S_KEYE0;
|
|
|
|
else
|
|
|
|
begin
|
|
|
|
ascii_rdy <= 1'b1; // new key has arrived!
|
2018-01-28 22:56:02 +00:00
|
|
|
if (!shift)
|
|
|
|
case(rx)
|
|
|
|
8'h1C: ascii <= "A";
|
|
|
|
8'h32: ascii <= "B";
|
|
|
|
8'h21: ascii <= "C";
|
|
|
|
8'h23: ascii <= "D";
|
|
|
|
8'h24: ascii <= "E";
|
|
|
|
8'h2B: ascii <= "F";
|
|
|
|
8'h34: ascii <= "G";
|
|
|
|
8'h33: ascii <= "H";
|
|
|
|
8'h43: ascii <= "I";
|
|
|
|
8'h3B: ascii <= "J";
|
|
|
|
8'h42: ascii <= "K";
|
|
|
|
8'h4B: ascii <= "L";
|
|
|
|
8'h3A: ascii <= "M";
|
|
|
|
8'h31: ascii <= "N";
|
|
|
|
8'h44: ascii <= "O";
|
|
|
|
8'h4D: ascii <= "P";
|
|
|
|
8'h15: ascii <= "Q";
|
|
|
|
8'h2D: ascii <= "R";
|
|
|
|
8'h1B: ascii <= "S";
|
|
|
|
8'h2C: ascii <= "T";
|
|
|
|
8'h3C: ascii <= "U";
|
|
|
|
8'h2A: ascii <= "V";
|
|
|
|
8'h1D: ascii <= "W";
|
|
|
|
8'h22: ascii <= "X";
|
|
|
|
8'h35: ascii <= "Y";
|
|
|
|
8'h1A: ascii <= "Z";
|
|
|
|
|
|
|
|
8'h45: ascii <= "0";
|
|
|
|
8'h16: ascii <= "1";
|
|
|
|
8'h1E: ascii <= "2";
|
|
|
|
8'h26: ascii <= "3";
|
|
|
|
8'h25: ascii <= "4";
|
|
|
|
8'h2E: ascii <= "5";
|
|
|
|
8'h36: ascii <= "6";
|
|
|
|
8'h3D: ascii <= "7";
|
|
|
|
8'h3E: ascii <= "8";
|
|
|
|
8'h46: ascii <= "9";
|
|
|
|
|
|
|
|
8'h4E: ascii <= "-";
|
|
|
|
8'h55: ascii <= "=";
|
2018-01-29 10:00:38 +00:00
|
|
|
8'h5D: ascii <= "\\";
|
2018-01-28 22:56:02 +00:00
|
|
|
8'h66: ascii <= 8'd8; // backspace
|
|
|
|
8'h29: ascii <= " ";
|
|
|
|
|
|
|
|
8'h5A: ascii <= 8'd13; // enter
|
|
|
|
8'h54: ascii <= "[";
|
|
|
|
8'h5B: ascii <= "]";
|
|
|
|
8'h4C: ascii <= ";";
|
|
|
|
8'h52: ascii <= "'";
|
|
|
|
8'h41: ascii <= ",";
|
|
|
|
8'h49: ascii <= ".";
|
2018-01-29 10:00:38 +00:00
|
|
|
8'h4A: ascii <= "/";
|
2018-01-28 22:56:02 +00:00
|
|
|
8'h59: shift <= 1'b1; // right shfit
|
|
|
|
8'h12: shift <= 1'b1; // left shift
|
2018-01-29 10:00:38 +00:00
|
|
|
default: ascii <= ".";
|
2018-01-28 22:56:02 +00:00
|
|
|
endcase
|
|
|
|
else
|
|
|
|
case(rx)
|
|
|
|
8'h1C: ascii <= "A";
|
|
|
|
8'h32: ascii <= "B";
|
|
|
|
8'h21: ascii <= "C";
|
|
|
|
8'h23: ascii <= "D";
|
|
|
|
8'h24: ascii <= "E";
|
|
|
|
8'h2B: ascii <= "F";
|
|
|
|
8'h34: ascii <= "G";
|
|
|
|
8'h33: ascii <= "H";
|
|
|
|
8'h43: ascii <= "I";
|
|
|
|
8'h3B: ascii <= "J";
|
|
|
|
8'h42: ascii <= "K";
|
|
|
|
8'h4B: ascii <= "L";
|
|
|
|
8'h3A: ascii <= "M";
|
|
|
|
8'h31: ascii <= "N";
|
|
|
|
8'h44: ascii <= "O";
|
|
|
|
8'h4D: ascii <= "P";
|
|
|
|
8'h15: ascii <= "Q";
|
|
|
|
8'h2D: ascii <= "R";
|
|
|
|
8'h1B: ascii <= "S";
|
|
|
|
8'h2C: ascii <= "T";
|
|
|
|
8'h3C: ascii <= "U";
|
|
|
|
8'h2A: ascii <= "V";
|
|
|
|
8'h1D: ascii <= "W";
|
|
|
|
8'h22: ascii <= "X";
|
|
|
|
8'h35: ascii <= "Y";
|
|
|
|
8'h1A: ascii <= "Z";
|
|
|
|
|
|
|
|
8'h45: ascii <= ")";
|
|
|
|
8'h16: ascii <= "!";
|
|
|
|
8'h1E: ascii <= "@";
|
|
|
|
8'h26: ascii <= "#";
|
|
|
|
8'h25: ascii <= "$";
|
|
|
|
8'h2E: ascii <= "%";
|
|
|
|
8'h36: ascii <= "^";
|
|
|
|
8'h3D: ascii <= "&";
|
|
|
|
8'h3E: ascii <= "*";
|
|
|
|
8'h46: ascii <= "(";
|
|
|
|
|
|
|
|
8'h4E: ascii <= "_";
|
|
|
|
8'h55: ascii <= "+";
|
|
|
|
8'h5D: ascii <= "|";
|
|
|
|
8'h66: ascii <= 8'd8; // backspace
|
|
|
|
8'h29: ascii <= " ";
|
|
|
|
|
|
|
|
8'h5A: ascii <= 8'd13; // enter
|
|
|
|
8'h54: ascii <= "{";
|
|
|
|
8'h5B: ascii <= "}";
|
|
|
|
8'h4C: ascii <= ":";
|
|
|
|
8'h52: ascii <= "\"";
|
|
|
|
8'h41: ascii <= "<";
|
|
|
|
8'h49: ascii <= ">";
|
|
|
|
8'h4A: ascii <= "?";
|
|
|
|
8'h59: shift <= 1'b1; // right shfit
|
|
|
|
8'h12: shift <= 1'b1; // left shift
|
2018-01-29 10:00:38 +00:00
|
|
|
|
|
|
|
default: ascii <= ".";
|
2018-01-28 22:56:02 +00:00
|
|
|
endcase
|
2018-01-28 22:41:27 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
S_KEYF0:
|
2018-01-28 22:56:02 +00:00
|
|
|
// when we end up here, a 0xF0 byte was received
|
|
|
|
// which usually means a key release event
|
|
|
|
begin
|
|
|
|
if ((rx == 8'h59) || (rx == 8'h12))
|
|
|
|
shift <= 1'b0;
|
|
|
|
next_state = S_KEYNORMAL;
|
|
|
|
end
|
2018-01-28 22:41:27 +00:00
|
|
|
S_KEYE0:
|
|
|
|
begin
|
|
|
|
if (rx == 8'hF0)
|
|
|
|
next_state = S_KEYE0F0;
|
|
|
|
else
|
|
|
|
next_state = S_KEYNORMAL;
|
|
|
|
end
|
|
|
|
S_KEYE0F0:
|
|
|
|
begin
|
|
|
|
next_state = S_KEYNORMAL;
|
|
|
|
end
|
2018-01-29 10:00:38 +00:00
|
|
|
default:
|
|
|
|
begin
|
|
|
|
next_state = S_KEYNORMAL;
|
|
|
|
end
|
2018-01-28 22:41:27 +00:00
|
|
|
endcase;
|
|
|
|
end
|
|
|
|
else
|
|
|
|
begin
|
|
|
|
next_state = cur_state;
|
|
|
|
end
|
|
|
|
|
|
|
|
cur_state <= next_state;
|
2018-01-28 01:00:21 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
endmodule
|
|
|
|
|