]> git.donarmstrong.com Git - kiibohd-controller.git/commitdiff
Adding UART and UART + USB muxed CLI output.
authorJacob Alexander <haata@kiibohd.com>
Sat, 28 Jun 2014 17:35:54 +0000 (10:35 -0700)
committerJacob Alexander <haata@kiibohd.com>
Sat, 28 Jun 2014 20:55:25 +0000 (13:55 -0700)
- The UART out may be useful for Bluetooth keyboards at some point

CMakeLists.txt
Output/uartOut/arm/uart_serial.c
Output/usbMuxUart/output_com.c [new file with mode: 0644]
Output/usbMuxUart/output_com.h [new file with mode: 0644]
Output/usbMuxUart/setup.cmake [new file with mode: 0644]

index 7cae1d35daf1d99575e669959ff88aa1c938f631..8360750233fa69ca3aca0b48083ea0f4674c452c 100644 (file)
@@ -53,7 +53,7 @@ set(   ScanModule "MDPure" )
 set(  MacroModule "PartialMap" )
 
 ##| Sends the current list of usb key codes through USB HID
-set( OutputModule "uartOut" )
+set( OutputModule "usbMuxUart" )
 
 ##| Debugging source to use, each module has it's own set of defines that it sets
 set(  DebugModule "full" )
index cd1502e3d2358f0f8b1a0d1d9dda0b551675f4f0..0b807c863e31009a41088d2c8e9febf222820133 100644 (file)
@@ -26,7 +26,7 @@
 
 // ----- Variables -----
 
-#define uart0_buffer_size 32 // 32 byte buffer
+#define uart0_buffer_size 128 // 128 byte buffer
 volatile uint8_t uart0_buffer_head = 0;
 volatile uint8_t uart0_buffer_tail = 0;
 volatile uint8_t uart0_buffer_items = 0;
@@ -40,10 +40,22 @@ void uart0_status_isr()
        cli(); // Disable Interrupts
 
        // UART0_S1 must be read for the interrupt to be cleared
-       if ( UART0_S1 & UART_S1_RDRF )
+       if ( UART0_S1 & ( UART_S1_RDRF | UART_S1_IDLE ) )
        {
+               uint8_t available = UART0_RCFIFO;
+
+               // If there was actually nothing
+               if ( available == 0 )
+               {
+                       // Cleanup
+                       available = UART0_D;
+                       UART0_CFIFO = UART_CFIFO_RXFLUSH;
+                       sei();
+                       return;
+               }
+
                // Read UART0 into buffer until FIFO is empty
-               while ( !( UART0_SFIFO & UART_SFIFO_RXEMPT ) )
+               while ( available-- > 0 )
                {
                        uart0_buffer[uart0_buffer_tail++] = UART0_D;
                        uart0_buffer_items++;
@@ -65,7 +77,6 @@ void uart0_status_isr()
                        {
                                uart0_buffer_head = 0;
                        }
-
                }
        }
 
@@ -84,18 +95,23 @@ void uart_serial_setup()
        PORTB_PCR16 = PORT_PCR_PE | PORT_PCR_PS | PORT_PCR_PFE | PORT_PCR_MUX(3); // RX Pin
        PORTB_PCR17 = PORT_PCR_DSE | PORT_PCR_SRE | PORT_PCR_MUX(3); // TX Pin
 
-       // Setup baud rate - 9600 Baud
+       // Setup baud rate - 115200 Baud
        // 48 MHz / ( 16 * Baud ) = BDH/L
-       // Baud: 9600 -> 48 MHz / ( 16 * 9600 ) = 312.5
-       // Thus baud setting = 313
+       // Baud: 115200 -> 48 MHz / ( 16 * 115200 ) = 26.0416667
+       // Thus baud setting = 26
        // NOTE: If finer baud adjustment is needed see UARTx_C4 -> BRFA in the datasheet
-       uint16_t baud = 313; // Max setting of 8191
+       uint16_t baud = 26; // Max setting of 8191
        UART0_BDH = (uint8_t)(baud >> 8);
        UART0_BDL = (uint8_t)baud;
+       UART0_C4 = 0x02;
 
        // 8 bit, No Parity, Idle Character bit after stop
        UART0_C1 = UART_C1_ILT;
 
+       // Interrupt notification watermark
+       UART0_TWFIFO = 2;
+       UART0_RWFIFO = 4;
+
        // TX FIFO Disabled, TX FIFO Size 1 (Max 8 datawords), RX FIFO Enabled, RX FIFO Size 1 (Max 8 datawords)
        // TX/RX FIFO Size:
        //  0x0 - 1 dataword
@@ -111,9 +127,9 @@ void uart_serial_setup()
        // UART_C3_TXINV
        UART0_C3 |= 0x00;
 
-       // TX Disabled, RX Enabled, RX Interrupt Enabled
-       // UART_C2_TE UART_C2_RE UART_C2_RIE
-       UART0_C2 = UART_C2_TE | UART_C2_RE | UART_C2_RIE;
+       // TX Enabled, RX Enabled, RX Interrupt Enabled, Generate idles
+       // UART_C2_TE UART_C2_RE UART_C2_RIE UART_C2_ILIE
+       UART0_C2 = UART_C2_TE | UART_C2_RE | UART_C2_RIE | UART_C2_ILIE;
 
        // Add interrupt to the vector table
        NVIC_ENABLE_IRQ( IRQ_UART0_STATUS );
@@ -161,7 +177,10 @@ void uart_serial_flush_input()
 // Transmit a character.  0 returned on success, -1 on error
 int uart_serial_putchar( uint8_t c )
 {
-       return uart_serial_write( &c, 1 );
+       while ( !( UART0_SFIFO & UART_SFIFO_TXEMPT ) ); // Wait till there is room to send
+       UART0_D = c;
+
+       return 0;
 }
 
 
diff --git a/Output/usbMuxUart/output_com.c b/Output/usbMuxUart/output_com.c
new file mode 100644 (file)
index 0000000..daf601d
--- /dev/null
@@ -0,0 +1,312 @@
+/* Copyright (C) 2014 by Jacob Alexander
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+// ----- Includes -----
+
+// Compiler Includes
+#include <Lib/OutputLib.h>
+
+// Project Includes
+#include <cli.h>
+#include <print.h>
+#include <scan_loop.h>
+
+// USB Includes
+#if defined(_at90usb162_) || defined(_atmega32u4_) || defined(_at90usb646_) || defined(_at90usb1286_)
+#elif defined(_mk20dx128_) || defined(_mk20dx128vlf5_) || defined(_mk20dx256_)
+#include "../uartOut/arm/uart_serial.h"
+#include "../pjrcUSB/arm/usb_dev.h"
+#include "../pjrcUSB/arm/usb_keyboard.h"
+#include "../pjrcUSB/arm/usb_serial.h"
+#endif
+
+// Local Includes
+#include "output_com.h"
+
+
+
+// ----- Function Declarations -----
+
+void cliFunc_kbdProtocol( char* args );
+void cliFunc_readLEDs   ( char* args );
+void cliFunc_readUART   ( char* args );
+void cliFunc_sendKeys   ( char* args );
+void cliFunc_sendUART   ( char* args );
+void cliFunc_setKeys    ( char* args );
+void cliFunc_setMod     ( char* args );
+
+
+// ----- Variables -----
+
+// Output Module command dictionary
+char*       outputCLIDictName = "USB Module Commands - NOT WORKING";
+CLIDictItem outputCLIDict[] = {
+       { "kbdProtocol", "Keyboard Protocol Mode: 0 - Boot, 1 - OS/NKRO Mode", cliFunc_kbdProtocol },
+       { "readLEDs",    "Read LED byte:" NL "\t\t1 NumLck, 2 CapsLck, 4 ScrlLck, 16 Kana, etc.", cliFunc_readLEDs },
+       { "readUART",    "Read UART buffer until empty.", cliFunc_readUART },
+       { "sendKeys",    "Send the prepared list of USB codes and modifier byte.", cliFunc_sendKeys },
+       { "sendUART",    "Send characters over UART0.", cliFunc_sendUART },
+       { "setKeys",     "Prepare a space separated list of USB codes (decimal). Waits until \033[35msendKeys\033[0m.", cliFunc_setKeys },
+       { "setMod",      "Set the modfier byte:" NL "\t\t1 LCtrl, 2 LShft, 4 LAlt, 8 LGUI, 16 RCtrl, 32 RShft, 64 RAlt, 128 RGUI", cliFunc_setMod },
+       { 0, 0, 0 } // Null entry for dictionary end
+};
+
+
+// Which modifier keys are currently pressed
+// 1=left ctrl,    2=left shift,   4=left alt,    8=left gui
+// 16=right ctrl, 32=right shift, 64=right alt, 128=right gui
+         uint8_t USBKeys_Modifiers    = 0;
+         uint8_t USBKeys_ModifiersCLI = 0; // Separate CLI send buffer
+
+// Currently pressed keys, max is defined by USB_MAX_KEY_SEND
+         uint8_t USBKeys_Array   [USB_MAX_KEY_SEND];
+         uint8_t USBKeys_ArrayCLI[USB_MAX_KEY_SEND]; // Separate CLI send buffer
+
+// The number of keys sent to the usb in the array
+         uint8_t USBKeys_Sent    = 0;
+         uint8_t USBKeys_SentCLI = 0;
+
+// 1=num lock, 2=caps lock, 4=scroll lock, 8=compose, 16=kana
+volatile uint8_t USBKeys_LEDs = 0;
+
+// Protocol setting from the host.
+// 0 - Boot Mode (Default, until set by the host)
+// 1 - NKRO Mode
+volatile uint8_t USBKeys_Protocol = 1;
+
+// the idle configuration, how often we send the report to the
+// host (ms * 4) even when it hasn't changed
+         uint8_t USBKeys_Idle_Config = 125;
+
+// count until idle timeout
+         uint8_t USBKeys_Idle_Count = 0;
+
+
+// ----- Functions -----
+
+// USB Module Setup
+inline void Output_setup()
+{
+       // Initialize the USB, and then wait for the host to set configuration.
+       // If the Teensy is powered without a PC connected to the USB port,
+       // this will wait forever.
+       usb_init();
+/*
+#include <led.h>
+init_errorLED();
+errorLED( 1 );
+while(1);
+*/
+       // Setup UART
+       uart_serial_setup();
+
+       while ( !usb_configured() ) /* wait */ ;
+
+       // Register USB Output CLI dictionary
+       CLI_registerDictionary( outputCLIDict, outputCLIDictName );
+}
+
+
+// USB Data Send
+inline void Output_send(void)
+{
+       // TODO undo potentially old keys
+       for ( uint8_t c = USBKeys_Sent; c < USBKeys_MaxSize; c++ )
+               USBKeys_Array[c] = 0;
+
+       // Send keypresses
+       usb_keyboard_send();
+
+       // Clear modifiers and keys
+       USBKeys_Modifiers = 0;
+       USBKeys_Sent      = 0;
+
+       // Signal Scan Module we are finishedA
+       Scan_finishedWithUSBBuffer( USBKeys_Sent <= USBKeys_MaxSize ? USBKeys_Sent : USBKeys_MaxSize );
+}
+
+
+// Sets the device into firmware reload mode
+inline void Output_firmwareReload()
+{
+#if defined(_at90usb162_) || defined(_atmega32u4_) || defined(_at90usb646_) || defined(_at90usb1286_)
+#elif defined(_mk20dx128_) || defined(_mk20dx128vlf5_) || defined(_mk20dx256_)
+       uart_device_reload();
+#endif
+}
+
+
+// USB Input buffer available
+inline unsigned int Output_availablechar()
+{
+       return usb_serial_available() + uart_serial_available();
+}
+
+
+// USB Get Character from input buffer
+inline int Output_getchar()
+{
+#if defined(_at90usb162_) || defined(_atmega32u4_) || defined(_at90usb646_) || defined(_at90usb1286_)
+#elif defined(_mk20dx128_) || defined(_mk20dx128vlf5_) || defined(_mk20dx256_)
+       if ( usb_serial_available() > 0 )
+       {
+               return usb_serial_getchar();
+       }
+
+       if ( uart_serial_available() > 0 )
+       {
+               return uart_serial_getchar();
+       }
+
+       return -1;
+#endif
+}
+
+
+// USB Send Character to output buffer
+inline int Output_putchar( char c )
+{
+       // First send to UART
+       uart_serial_putchar( c );
+
+       // Then send to USB
+       return usb_serial_putchar( c );
+}
+
+
+// USB Send String to output buffer, null terminated
+inline int Output_putstr( char* str )
+{
+#if defined(_at90usb162_) || defined(_atmega32u4_) || defined(_at90usb646_) || defined(_at90usb1286_) // AVR
+#elif defined(_mk20dx128_) || defined(_mk20dx128vlf5_) || defined(_mk20dx256_) // ARM
+       uint32_t count = 0;
+#endif
+       // Count characters until NULL character, then send the amount counted
+       while ( str[count] != '\0' )
+               count++;
+
+       // Make sure USB is configured first
+       if ( usb_configured() )
+       {
+               // First send to UART
+               uart_serial_write( str, count );
+       }
+
+       // Then send to USB
+       return usb_serial_write( str, count );
+}
+
+
+// Soft Chip Reset
+inline void Output_softReset()
+{
+#if defined(_at90usb162_) || defined(_atmega32u4_) || defined(_at90usb646_) || defined(_at90usb1286_)
+#elif defined(_mk20dx128_) || defined(_mk20dx128vlf5_) || defined(_mk20dx256_)
+       SOFTWARE_RESET();
+#endif
+}
+
+
+// ----- CLI Command Functions -----
+
+void cliFunc_kbdProtocol( char* args )
+{
+       print( NL );
+       info_msg("Keyboard Protocol: ");
+       printInt8( USBKeys_Protocol );
+}
+
+
+void cliFunc_readLEDs( char* args )
+{
+       print( NL );
+       info_msg("LED State (This doesn't work yet...): ");
+       printInt8( USBKeys_LEDs );
+}
+
+
+void cliFunc_readUART( char* args )
+{
+       print( NL );
+
+       // Read UART buffer until empty
+       while ( uart_serial_available() > 0 )
+       {
+               char out[] = { (char)uart_serial_getchar(), '\0' };
+               dPrint( out );
+       }
+}
+
+
+void cliFunc_sendKeys( char* args )
+{
+       // Copy USBKeys_ArrayCLI to USBKeys_Array
+       for ( uint8_t key = 0; key < USBKeys_SentCLI; ++key )
+       {
+               USBKeys_Array[key] = USBKeys_ArrayCLI[key];
+       }
+       USBKeys_Sent = USBKeys_SentCLI;
+
+       // Set modifier byte
+       USBKeys_Modifiers = USBKeys_ModifiersCLI;
+}
+
+
+void cliFunc_sendUART( char* args )
+{
+       // Write all args to UART
+       uart_serial_write( args, lenStr( args ) );
+}
+
+
+void cliFunc_setKeys( char* args )
+{
+       char* curArgs;
+       char* arg1Ptr;
+       char* arg2Ptr = args;
+
+       // Parse up to USBKeys_MaxSize args (whichever is least)
+       for ( USBKeys_SentCLI = 0; USBKeys_SentCLI < USBKeys_MaxSize; ++USBKeys_SentCLI )
+       {
+               curArgs = arg2Ptr;
+               CLI_argumentIsolation( curArgs, &arg1Ptr, &arg2Ptr );
+
+               // Stop processing args if no more are found
+               if ( *arg1Ptr == '\0' )
+                       break;
+
+               // Add the USB code to be sent
+               USBKeys_ArrayCLI[USBKeys_SentCLI] = decToInt( arg1Ptr );
+       }
+}
+
+
+void cliFunc_setMod( char* args )
+{
+       // Parse number from argument
+       //  NOTE: Only first argument is used
+       char* arg1Ptr;
+       char* arg2Ptr;
+       CLI_argumentIsolation( args, &arg1Ptr, &arg2Ptr );
+
+       USBKeys_ModifiersCLI = decToInt( arg1Ptr );
+}
+
diff --git a/Output/usbMuxUart/output_com.h b/Output/usbMuxUart/output_com.h
new file mode 100644 (file)
index 0000000..84b22ae
--- /dev/null
@@ -0,0 +1,76 @@
+/* Copyright (C) 2013-2014 by Jacob Alexander
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef __output_com_h
+#define __output_com_h
+
+// ----- Includes -----
+
+// Compiler Includes
+#include <stdint.h>
+
+// Local Includes
+#include <buildvars.h> // Defines USB Parameters, partially generated by CMake
+
+
+
+// ----- Defines -----
+
+// Indicator for other modules through USBKeys_MaxSize for how capable the USB module is when sending large number of keypresses
+#define USB_MAX_KEY_SEND 6
+
+
+
+// ----- Variables -----
+
+// Variables used to communciate to the output module
+// XXX Even if the output module is not USB, this is internally understood keymapping scheme
+extern                       uint8_t USBKeys_Modifiers;
+extern                       uint8_t USBKeys_Array[USB_MAX_KEY_SEND];
+extern                       uint8_t USBKeys_Sent;
+extern volatile              uint8_t USBKeys_LEDs;
+
+                static const uint8_t USBKeys_MaxSize = USB_MAX_KEY_SEND;
+extern volatile              uint8_t USBKeys_Protocol; // 0 - Boot Mode, 1 - NKRO Mode
+
+// Misc variables (XXX Some are only properly utilized using AVR)
+extern                       uint8_t USBKeys_Idle_Config;
+extern                       uint8_t USBKeys_Idle_Count;
+
+
+
+// ----- Functions -----
+
+void Output_setup();
+void Output_send();
+
+void Output_firmwareReload();
+void Output_softReset();
+
+// Relies on USB serial module
+unsigned int Output_availablechar();
+
+int Output_getchar();
+int Output_putchar( char c );
+int Output_putstr( char* str );
+
+#endif
+
diff --git a/Output/usbMuxUart/setup.cmake b/Output/usbMuxUart/setup.cmake
new file mode 100644 (file)
index 0000000..4d15ec2
--- /dev/null
@@ -0,0 +1,48 @@
+###| CMake Kiibohd Controller Muxed UART and USB Output Module |###
+#
+# Written by Jacob Alexander in 2014 for the Kiibohd Controller
+#
+# Released into the Public Domain
+#
+###
+
+
+###
+# Module C files
+#
+
+
+#| AVR Compiler
+if ( ${COMPILER_FAMILY} MATCHES "avr" )
+
+       set( OUTPUT_SRCS
+       )
+
+#| ARM Compiler
+elseif ( ${COMPILER_FAMILY} MATCHES "arm" )
+
+       set( OUTPUT_SRCS
+               output_com.c
+               ../pjrcUSB/arm/usb_desc.c
+               ../pjrcUSB/arm/usb_dev.c
+               ../pjrcUSB/arm/usb_keyboard.c
+               ../pjrcUSB/arm/usb_mem.c
+               ../pjrcUSB/arm/usb_serial.c
+               ../uartOut/arm/uart_serial.c
+       )
+
+endif ()
+
+
+###
+# Module Specific Options
+#
+
+###
+# Compiler Family Compatibility
+#
+set( OutputModuleCompatibility
+       arm
+#      avr # TODO
+)
+