Kiibohd Controller
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.

cli.c 13KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437
  1. /* Copyright (C) 2014-2015 by Jacob Alexander
  2. *
  3. * Permission is hereby granted, free of charge, to any person obtaining a copy
  4. * of this software and associated documentation files (the "Software"), to deal
  5. * in the Software without restriction, including without limitation the rights
  6. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  7. * copies of the Software, and to permit persons to whom the Software is
  8. * furnished to do so, subject to the following conditions:
  9. *
  10. * The above copyright notice and this permission notice shall be included in
  11. * all copies or substantial portions of the Software.
  12. *
  13. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  14. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  15. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  16. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  17. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  18. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  19. * THE SOFTWARE.
  20. */
  21. // ----- Includes -----
  22. // Compiler Includes
  23. //#include <stdarg.h>
  24. // Project Includes
  25. #include <buildvars.h>
  26. #include "cli.h"
  27. #include <led.h>
  28. #include <print.h>
  29. // ----- Variables -----
  30. // Basic command dictionary
  31. CLIDict_Entry( cliDebug, "Enables/Disables hex output of the most recent cli input." );
  32. CLIDict_Entry( help, "You're looking at it :P" );
  33. CLIDict_Entry( led, "Enables/Disables indicator LED. Try a couple times just in case the LED is in an odd state.\r\n\t\t\033[33mWarning\033[0m: May adversely affect some modules..." );
  34. CLIDict_Entry( reload, "Signals microcontroller to reflash/reload." );
  35. CLIDict_Entry( reset, "Resets the terminal back to initial settings." );
  36. CLIDict_Entry( restart, "Sends a software restart, should be similar to powering on the device." );
  37. CLIDict_Entry( version, "Version information about this firmware." );
  38. CLIDict_Def( basicCLIDict, "General Commands" ) = {
  39. CLIDict_Item( cliDebug ),
  40. CLIDict_Item( help ),
  41. CLIDict_Item( led ),
  42. CLIDict_Item( reload ),
  43. CLIDict_Item( reset ),
  44. CLIDict_Item( restart ),
  45. CLIDict_Item( version ),
  46. { 0, 0, 0 } // Null entry for dictionary end
  47. };
  48. // ----- Functions -----
  49. inline void prompt()
  50. {
  51. print("\033[2K\r"); // Erases the current line and resets cursor to beginning of line
  52. print("\033[1;34m:\033[0m "); // Blue bold prompt
  53. }
  54. // Initialize the CLI
  55. inline void CLI_init()
  56. {
  57. // Reset the Line Buffer
  58. CLILineBufferCurrent = 0;
  59. // Set prompt
  60. prompt();
  61. // Register first dictionary
  62. CLIDictionariesUsed = 0;
  63. CLI_registerDictionary( basicCLIDict, basicCLIDictName );
  64. // Initialize main LED
  65. init_errorLED();
  66. CLILEDState = 0;
  67. // Hex debug mode is off by default
  68. CLIHexDebugMode = 0;
  69. }
  70. // Query the serial input buffer for any new characters
  71. void CLI_process()
  72. {
  73. // Current buffer position
  74. uint8_t prev_buf_pos = CLILineBufferCurrent;
  75. // Process each character while available
  76. while ( 1 )
  77. {
  78. // No more characters to process
  79. if ( Output_availablechar() == 0 )
  80. break;
  81. // Retrieve from output module
  82. char cur_char = (char)Output_getchar();
  83. // Make sure buffer isn't full
  84. if ( CLILineBufferCurrent >= CLILineBufferMaxSize )
  85. {
  86. print( NL );
  87. erro_print("Serial line buffer is full, dropping character and resetting...");
  88. // Clear buffer
  89. CLILineBufferCurrent = 0;
  90. // Reset the prompt
  91. prompt();
  92. return;
  93. }
  94. // Place into line buffer
  95. CLILineBuffer[CLILineBufferCurrent++] = cur_char;
  96. }
  97. // Display Hex Key Input if enabled
  98. if ( CLIHexDebugMode && CLILineBufferCurrent > prev_buf_pos )
  99. {
  100. print("\033[s\r\n"); // Save cursor position, and move to the next line
  101. print("\033[2K"); // Erases the current line
  102. uint8_t pos = prev_buf_pos;
  103. while ( CLILineBufferCurrent > pos )
  104. {
  105. printHex( CLILineBuffer[pos++] );
  106. print(" ");
  107. }
  108. print("\033[u"); // Restore cursor position
  109. }
  110. // If buffer has changed, output to screen while there are still characters in the buffer not displayed
  111. while ( CLILineBufferCurrent > prev_buf_pos )
  112. {
  113. // Check for control characters
  114. switch ( CLILineBuffer[prev_buf_pos] )
  115. {
  116. case 0x0D: // Enter
  117. CLILineBuffer[CLILineBufferCurrent - 1] = ' '; // Replace Enter with a space (resolves a bug in args)
  118. // Remove the space if there is no command
  119. if ( CLILineBufferCurrent == 1 )
  120. CLILineBufferCurrent--;
  121. // Process the current line buffer
  122. CLI_commandLookup();
  123. // Reset the buffer
  124. CLILineBufferCurrent = 0;
  125. // Reset the prompt after processing has finished
  126. print( NL );
  127. prompt();
  128. // XXX There is a potential bug here when resetting the buffer (losing valid keypresses)
  129. // Doesn't look like it will happen *that* often, so not handling it for now -HaaTa
  130. return;
  131. case 0x09: // Tab
  132. // Tab completion for the current command
  133. CLI_tabCompletion();
  134. CLILineBufferCurrent--; // Remove the Tab
  135. // XXX There is a potential bug here when resetting the buffer (losing valid keypresses)
  136. // Doesn't look like it will happen *that* often, so not handling it for now -HaaTa
  137. return;
  138. case 0x1B: // Esc
  139. // Check for escape sequence
  140. // TODO
  141. return;
  142. case 0x08:
  143. case 0x7F: // Backspace
  144. // TODO - Does not handle case for arrow editing (arrows disabled atm)
  145. CLILineBufferCurrent--; // Remove the backspace
  146. // If there are characters in the buffer
  147. if ( CLILineBufferCurrent > 0 )
  148. {
  149. // Remove character from current position in the line buffer
  150. CLILineBufferCurrent--;
  151. // Remove character from tty
  152. print("\b \b");
  153. }
  154. break;
  155. default:
  156. // Place a null on the end (to use with string print)
  157. CLILineBuffer[CLILineBufferCurrent] = '\0';
  158. // Output buffer to screen
  159. dPrint( &CLILineBuffer[prev_buf_pos] );
  160. // Buffer reset
  161. prev_buf_pos++;
  162. break;
  163. }
  164. }
  165. }
  166. // Takes a string, returns two pointers
  167. // One to the first non-space character
  168. // The second to the next argument (first NULL if there isn't an argument). delimited by a space
  169. // Places a NULL at the first space after the first argument
  170. void CLI_argumentIsolation( char* string, char** first, char** second )
  171. {
  172. // Mark out the first argument
  173. // This is done by finding the first space after a list of non-spaces and setting it NULL
  174. char* cmdPtr = string - 1;
  175. while ( *++cmdPtr == ' ' ); // Skips leading spaces, and points to first character of cmd
  176. // Locates first space delimiter
  177. char* argPtr = cmdPtr + 1;
  178. while ( *argPtr != ' ' && *argPtr != '\0' )
  179. argPtr++;
  180. // Point to the first character of args or a NULL (no args) and set the space delimiter as a NULL
  181. (++argPtr)[-1] = '\0';
  182. // Set return variables
  183. *first = cmdPtr;
  184. *second = argPtr;
  185. }
  186. // Scans the CLILineBuffer for any valid commands
  187. void CLI_commandLookup()
  188. {
  189. // Ignore command if buffer is 0 length
  190. if ( CLILineBufferCurrent == 0 )
  191. return;
  192. // Set the last+1 character of the buffer to NULL for string processing
  193. CLILineBuffer[CLILineBufferCurrent] = '\0';
  194. // Retrieve pointers to command and beginning of arguments
  195. // Places a NULL at the first space after the command
  196. char* cmdPtr;
  197. char* argPtr;
  198. CLI_argumentIsolation( CLILineBuffer, &cmdPtr, &argPtr );
  199. // Scan array of dictionaries for a valid command match
  200. for ( uint8_t dict = 0; dict < CLIDictionariesUsed; dict++ )
  201. {
  202. // Parse each cmd until a null command entry is found, or an argument match
  203. for ( uint8_t cmd = 0; CLIDict[dict][cmd].name != 0; cmd++ )
  204. {
  205. // Compare the first argument and each command entry
  206. if ( eqStr( cmdPtr, (char*)CLIDict[dict][cmd].name ) == -1 )
  207. {
  208. // Run the specified command function pointer
  209. // argPtr is already pointing at the first character of the arguments
  210. (*(void (*)(char*))CLIDict[dict][cmd].function)( argPtr );
  211. return;
  212. }
  213. }
  214. }
  215. // No match for the command...
  216. print( NL );
  217. erro_dPrint("\"", CLILineBuffer, "\" is not a valid command...type \033[35mhelp\033[0m");
  218. }
  219. // Registers a command dictionary with the CLI
  220. void CLI_registerDictionary( const CLIDictItem *cmdDict, const char* dictName )
  221. {
  222. // Make sure this max limit of dictionaries hasn't been reached
  223. if ( CLIDictionariesUsed >= CLIMaxDictionaries )
  224. {
  225. erro_print("Max number of dictionaries defined already...");
  226. return;
  227. }
  228. // Add dictionary
  229. CLIDictNames[CLIDictionariesUsed] = (char*)dictName;
  230. CLIDict[CLIDictionariesUsed++] = (CLIDictItem*)cmdDict;
  231. }
  232. inline void CLI_tabCompletion()
  233. {
  234. // Ignore command if buffer is 0 length
  235. if ( CLILineBufferCurrent == 0 )
  236. return;
  237. // Set the last+1 character of the buffer to NULL for string processing
  238. CLILineBuffer[CLILineBufferCurrent] = '\0';
  239. // Retrieve pointers to command and beginning of arguments
  240. // Places a NULL at the first space after the command
  241. char* cmdPtr;
  242. char* argPtr;
  243. CLI_argumentIsolation( CLILineBuffer, &cmdPtr, &argPtr );
  244. // Tab match pointer
  245. char* tabMatch = 0;
  246. uint8_t matches = 0;
  247. // Scan array of dictionaries for a valid command match
  248. for ( uint8_t dict = 0; dict < CLIDictionariesUsed; dict++ )
  249. {
  250. // Parse each cmd until a null command entry is found, or an argument match
  251. for ( uint8_t cmd = 0; CLIDict[dict][cmd].name != 0; cmd++ )
  252. {
  253. // Compare the first argument piece to each command entry to see if it is "like"
  254. // NOTE: To save on processing, we only care about the commands and ignore the arguments
  255. // If there are arguments, and a valid tab match is found, buffer is cleared (args lost)
  256. // Also ignores full matches
  257. if ( eqStr( cmdPtr, (char*)CLIDict[dict][cmd].name ) == 0 )
  258. {
  259. // TODO Make list of commands if multiple matches
  260. matches++;
  261. tabMatch = (char*)CLIDict[dict][cmd].name;
  262. }
  263. }
  264. }
  265. // Only tab complete if there was 1 match
  266. if ( matches == 1 )
  267. {
  268. // Reset the buffer
  269. CLILineBufferCurrent = 0;
  270. // Reprint the prompt (automatically clears the line)
  271. prompt();
  272. // Display the command
  273. dPrint( tabMatch );
  274. // There are no index counts, so just copy the whole string to the input buffer
  275. while ( *tabMatch != '\0' )
  276. {
  277. CLILineBuffer[CLILineBufferCurrent++] = *tabMatch++;
  278. }
  279. }
  280. }
  281. // ----- CLI Command Functions -----
  282. void cliFunc_cliDebug( char* args )
  283. {
  284. // Toggle Hex Debug Mode
  285. if ( CLIHexDebugMode )
  286. {
  287. print( NL );
  288. info_print("Hex debug mode disabled...");
  289. CLIHexDebugMode = 0;
  290. }
  291. else
  292. {
  293. print( NL );
  294. info_print("Hex debug mode enabled...");
  295. CLIHexDebugMode = 1;
  296. }
  297. }
  298. void cliFunc_help( char* args )
  299. {
  300. // Scan array of dictionaries and print every description
  301. // (no alphabetical here, too much processing/memory to sort...)
  302. for ( uint8_t dict = 0; dict < CLIDictionariesUsed; dict++ )
  303. {
  304. // Print the name of each dictionary as a title
  305. print( NL "\033[1;32m" );
  306. _print( CLIDictNames[dict] ); // This print is requride by AVR (flash)
  307. print( "\033[0m" NL );
  308. // Parse each cmd/description until a null command entry is found
  309. for ( uint8_t cmd = 0; CLIDict[dict][cmd].name != 0; cmd++ )
  310. {
  311. dPrintStrs(" \033[35m", CLIDict[dict][cmd].name, "\033[0m");
  312. // Determine number of spaces to tab by the length of the command and TabAlign
  313. uint8_t padLength = CLIEntryTabAlign - lenStr( (char*)CLIDict[dict][cmd].name );
  314. while ( padLength-- > 0 )
  315. print(" ");
  316. _print( CLIDict[dict][cmd].description ); // This print is required by AVR (flash)
  317. print( NL );
  318. }
  319. }
  320. }
  321. void cliFunc_led( char* args )
  322. {
  323. CLILEDState ^= 1 << 1; // Toggle between 0 and 1
  324. errorLED( CLILEDState ); // Enable/Disable error LED
  325. }
  326. void cliFunc_reload( char* args )
  327. {
  328. // Request to output module to be set into firmware reload mode
  329. Output_firmwareReload();
  330. }
  331. void cliFunc_reset( char* args )
  332. {
  333. print("\033c"); // Resets the terminal
  334. }
  335. void cliFunc_restart( char* args )
  336. {
  337. // Trigger an overall software reset
  338. Output_softReset();
  339. }
  340. void cliFunc_version( char* args )
  341. {
  342. print( NL );
  343. print( " \033[1mRevision:\033[0m " CLI_Revision NL );
  344. print( " \033[1mBranch:\033[0m " CLI_Branch NL );
  345. print( " \033[1mTree Status:\033[0m " CLI_ModifiedStatus CLI_ModifiedFiles NL );
  346. print( " \033[1mRepo Origin:\033[0m " CLI_RepoOrigin NL );
  347. print( " \033[1mCommit Date:\033[0m " CLI_CommitDate NL );
  348. print( " \033[1mCommit Author:\033[0m " CLI_CommitAuthor NL );
  349. print( " \033[1mBuild Date:\033[0m " CLI_BuildDate NL );
  350. print( " \033[1mBuild OS:\033[0m " CLI_BuildOS NL );
  351. print( " \033[1mArchitecture:\033[0m " CLI_Arch NL );
  352. print( " \033[1mChip:\033[0m " CLI_Chip NL );
  353. print( " \033[1mCPU:\033[0m " CLI_CPU NL );
  354. print( " \033[1mDevice:\033[0m " CLI_Device NL );
  355. print( " \033[1mModules:\033[0m " CLI_Modules NL );
  356. }