]> git.donarmstrong.com Git - kiibohd-controller.git/blobdiff - Macro/PartialMap/macro.c
Fixing warning messages found using clang.
[kiibohd-controller.git] / Macro / PartialMap / macro.c
index a86efb09e42b916069f8b6b2ca522f4cd2a4596e..68869c89895adbc78186bc5461a45cb2add43701 100644 (file)
@@ -81,20 +81,32 @@ typedef enum ResultMacroEval {
 // ----- Variables -----
 
 // Macro Module command dictionary
-const char macroCLIDictName[] = "Macro Module Commands";
-const CLIDictItem macroCLIDict[] = {
-       { "capList",     "Prints an indexed list of all non USB keycode capabilities.", cliFunc_capList },
-       { "capSelect",   "Triggers the specified capabilities. First two args are state and stateType." NL "\t\t\033[35mK11\033[0m Keyboard Capability 0x0B", cliFunc_capSelect },
-       { "keyHold",     "Send key-hold events to the macro module. Duplicates have undefined behaviour." NL "\t\t\033[35mS10\033[0m Scancode 0x0A", cliFunc_keyHold },
-       { "keyPress",    "Send key-press events to the macro module. Duplicates have undefined behaviour." NL "\t\t\033[35mS10\033[0m Scancode 0x0A", cliFunc_keyPress },
-       { "keyRelease",  "Send key-release event to macro module. Duplicates have undefined behaviour." NL "\t\t\033[35mS10\033[0m Scancode 0x0A", cliFunc_keyRelease },
-       { "layerList",   "List available layers.", cliFunc_layerList },
-       { "layerState",  "Modify specified indexed layer state <layer> <state byte>." NL "\t\t\033[35mL2\033[0m Indexed Layer 0x02" NL "\t\t0 Off, 1 Shift, 2 Latch, 4 Lock States", cliFunc_layerState },
-       { "macroDebug",  "Disables/Enables sending USB keycodes to the Output Module and prints U/K codes.", cliFunc_macroDebug },
-       { "macroList",   "List the defined trigger and result macros.", cliFunc_macroList },
-       { "macroProc",   "Pause/Resume macro processing.", cliFunc_macroProc },
-       { "macroShow",   "Show the macro corresponding to the given index." NL "\t\t\033[35mT16\033[0m Indexed Trigger Macro 0x10, \033[35mR12\033[0m Indexed Result Macro 0x0C", cliFunc_macroShow },
-       { "macroStep",   "Do N macro processing steps. Defaults to 1.", cliFunc_macroStep },
+CLIDict_Entry( capList,     "Prints an indexed list of all non USB keycode capabilities." );
+CLIDict_Entry( capSelect,   "Triggers the specified capabilities. First two args are state and stateType." NL "\t\t\033[35mK11\033[0m Keyboard Capability 0x0B" );
+CLIDict_Entry( keyHold,     "Send key-hold events to the macro module. Duplicates have undefined behaviour." NL "\t\t\033[35mS10\033[0m Scancode 0x0A" );
+CLIDict_Entry( keyPress,    "Send key-press events to the macro module. Duplicates have undefined behaviour." NL "\t\t\033[35mS10\033[0m Scancode 0x0A" );
+CLIDict_Entry( keyRelease,  "Send key-release event to macro module. Duplicates have undefined behaviour." NL "\t\t\033[35mS10\033[0m Scancode 0x0A" );
+CLIDict_Entry( layerList,   "List available layers." );
+CLIDict_Entry( layerState,  "Modify specified indexed layer state <layer> <state byte>." NL "\t\t\033[35mL2\033[0m Indexed Layer 0x02" NL "\t\t0 Off, 1 Shift, 2 Latch, 4 Lock States" );
+CLIDict_Entry( macroDebug,  "Disables/Enables sending USB keycodes to the Output Module and prints U/K codes." );
+CLIDict_Entry( macroList,   "List the defined trigger and result macros." );
+CLIDict_Entry( macroProc,   "Pause/Resume macro processing." );
+CLIDict_Entry( macroShow,   "Show the macro corresponding to the given index." NL "\t\t\033[35mT16\033[0m Indexed Trigger Macro 0x10, \033[35mR12\033[0m Indexed Result Macro 0x0C" );
+CLIDict_Entry( macroStep,   "Do N macro processing steps. Defaults to 1." );
+
+CLIDict_Def( macroCLIDict, "Macro Module Commands" ) = {
+       CLIDict_Item( capList ),
+       CLIDict_Item( capSelect ),
+       CLIDict_Item( keyHold ),
+       CLIDict_Item( keyPress ),
+       CLIDict_Item( keyRelease ),
+       CLIDict_Item( layerList ),
+       CLIDict_Item( layerState ),
+       CLIDict_Item( macroDebug ),
+       CLIDict_Item( macroList ),
+       CLIDict_Item( macroProc ),
+       CLIDict_Item( macroShow ),
+       CLIDict_Item( macroStep ),
        { 0, 0, 0 } // Null entry for dictionary end
 };
 
@@ -138,6 +150,10 @@ uint16_t macroResultMacroPendingListSize = 0;
 // Sets the given layer with the specified layerState
 void Macro_layerState( uint8_t state, uint8_t stateType, uint16_t layer, uint8_t layerState )
 {
+       // Ignore if layer does not exist
+       if ( layer >= LayerNum )
+               return;
+
        // Is layer in the LayerIndexStack?
        uint8_t inLayerIndexStack = 0;
        uint16_t stackItem = 0;
@@ -230,8 +246,7 @@ void Macro_layerLatch_capability( uint8_t state, uint8_t stateType, uint8_t *arg
 
        // Only use capability on press
        // TODO Analog
-       // XXX To make sense, this code be on press or release. Or it could even be a sticky shift (why? dunno) -HaaTa
-       if ( stateType == 0x00 && state != 0x01 ) // All normal key conditions except press
+       if ( stateType == 0x00 && state != 0x03 ) // Only on release
                return;
 
        // Get layer index from arguments
@@ -296,7 +311,7 @@ void Macro_layerShift_capability( uint8_t state, uint8_t stateType, uint8_t *arg
 
 // Looks up the trigger list for the given scan code (from the active layer)
 // NOTE: Calling function must handle the NULL pointer case
-nat_ptr_t *Macro_layerLookup( uint8_t scanCode )
+nat_ptr_t *Macro_layerLookup( uint8_t scanCode, uint8_t latch_expire )
 {
        // If no trigger macro is defined at the given layer, fallthrough to the next layer
        for ( uint16_t layerIndex = 0; layerIndex < macroLayerIndexStackSize; layerIndex++ )
@@ -306,10 +321,10 @@ nat_ptr_t *Macro_layerLookup( uint8_t scanCode )
 
                // Check if latch has been pressed for this layer
                // XXX Regardless of whether a key is found, the latch is removed on first lookup
-               uint8_t latch = LayerState[ layerIndex ] & 0x02;
-               if ( latch )
+               uint8_t latch = LayerState[ macroLayerIndexStack[ layerIndex ] ] & 0x02;
+               if ( latch && latch_expire )
                {
-                       LayerState[ layerIndex ] &= ~0x02;
+                       Macro_layerState( 0, 0, macroLayerIndexStack[ layerIndex ], 0x02 );
                }
 
                // Only use layer, if state is valid
@@ -415,7 +430,7 @@ inline void Macro_ledState( uint8_t ledCode, uint8_t state )
 
 // Append result macro to pending list, checking for duplicates
 // Do nothing if duplicate
-inline void Macro_appendResultMacroToPendingList( TriggerMacro *triggerMacro )
+inline void Macro_appendResultMacroToPendingList( const TriggerMacro *triggerMacro )
 {
        // Lookup result macro index
        var_uint_t resultMacroIndex = triggerMacro->result;
@@ -446,18 +461,18 @@ inline void Macro_appendResultMacroToPendingList( TriggerMacro *triggerMacro )
        {
                if ( macroTriggerListBuffer[ keyIndex ].scanCode == scanCode )
                {
-                       ResultMacroList[ resultMacroIndex ].state     = macroTriggerListBuffer[ keyIndex ].state;
-                       ResultMacroList[ resultMacroIndex ].stateType = macroTriggerListBuffer[ keyIndex ].type;
+                       ResultMacroRecordList[ resultMacroIndex ].state     = macroTriggerListBuffer[ keyIndex ].state;
+                       ResultMacroRecordList[ resultMacroIndex ].stateType = macroTriggerListBuffer[ keyIndex ].type;
                }
        }
 
        // Reset the macro position
-       ResultMacroList[ resultMacroIndex ].pos = 0;
+       ResultMacroRecordList[ resultMacroIndex ].pos = 0;
 }
 
 
 // Determine if long ResultMacro (more than 1 seqence element)
-inline uint8_t Macro_isLongResultMacro( ResultMacro *macro )
+inline uint8_t Macro_isLongResultMacro( const ResultMacro *macro )
 {
        // Check the second sequence combo length
        // If non-zero return non-zero (long sequence)
@@ -470,7 +485,7 @@ inline uint8_t Macro_isLongResultMacro( ResultMacro *macro )
 
 
 // Determine if long TriggerMacro (more than 1 sequence element)
-inline uint8_t Macro_isLongTriggerMacro( TriggerMacro *macro )
+inline uint8_t Macro_isLongTriggerMacro( const TriggerMacro *macro )
 {
        // Check the second sequence combo length
        // If non-zero return non-zero (long sequence)
@@ -601,20 +616,21 @@ inline TriggerMacroVote Macro_evalLongTriggerMacroVote( TriggerGuide *key, Trigg
 
 
 // Evaluate/Update TriggerMacro
-inline TriggerMacroEval Macro_evalTriggerMacro( var_uint_t triggerMacroIndex )
+TriggerMacroEval Macro_evalTriggerMacro( var_uint_t triggerMacroIndex )
 {
        // Lookup TriggerMacro
-       TriggerMacro *macro = &TriggerMacroList[ triggerMacroIndex ];
+       const TriggerMacro *macro = &TriggerMacroList[ triggerMacroIndex ];
+       TriggerMacroRecord *record = &TriggerMacroRecordList[ triggerMacroIndex ];
 
        // Check if macro has finished and should be incremented sequence elements
-       if ( macro->state == TriggerMacro_Release )
+       if ( record->state == TriggerMacro_Release )
        {
-               macro->state = TriggerMacro_Waiting;
-               macro->pos = macro->pos + macro->guide[ macro->pos ] * TriggerGuideSize + 1;
+               record->state = TriggerMacro_Waiting;
+               record->pos = record->pos + macro->guide[ record->pos ] * TriggerGuideSize + 1;
        }
 
        // Current Macro position
-       var_uint_t pos = macro->pos;
+       var_uint_t pos = record->pos;
 
        // Length of the combo being processed
        uint8_t comboLength = macro->guide[ pos ] * TriggerGuideSize;
@@ -691,19 +707,19 @@ inline TriggerMacroEval Macro_evalTriggerMacro( var_uint_t triggerMacroIndex )
        }
        // If ready for transition and in Press state, set to Waiting and increment combo position
        // Position is incremented (and possibly remove the macro from the pending list) on the next iteration
-       else if ( overallVote & TriggerMacroVote_Release && macro->state == TriggerMacro_Press )
+       else if ( overallVote & TriggerMacroVote_Release && record->state == TriggerMacro_Press )
        {
-               macro->state = TriggerMacro_Release;
+               record->state = TriggerMacro_Release;
 
                // If this is the last combo in the sequence, remove from the pending list
-               if ( macro->guide[ macro->pos + macro->guide[ macro->pos ] * TriggerGuideSize + 1 ] == 0 )
+               if ( macro->guide[ record->pos + macro->guide[ record->pos ] * TriggerGuideSize + 1 ] == 0 )
                        return TriggerMacroEval_DoResultAndRemove;
        }
        // If passing and in Waiting state, set macro state to Press
        else if ( overallVote & TriggerMacroVote_Pass
-            && ( macro->state == TriggerMacro_Waiting || macro->state == TriggerMacro_Press ) )
+            && ( record->state == TriggerMacro_Waiting || record->state == TriggerMacro_Press ) )
        {
-               macro->state = TriggerMacro_Press;
+               record->state = TriggerMacro_Press;
 
                // If in press state, and this is the final combo, send request for ResultMacro
                // Check to see if the result macro only has a single element
@@ -756,10 +772,11 @@ inline TriggerMacroEval Macro_evalTriggerMacro( var_uint_t triggerMacroIndex )
 inline ResultMacroEval Macro_evalResultMacro( var_uint_t resultMacroIndex )
 {
        // Lookup ResultMacro
-       ResultMacro *macro = &ResultMacroList[ resultMacroIndex ];
+       const ResultMacro *macro = &ResultMacroList[ resultMacroIndex ];
+       ResultMacroRecord *record = &ResultMacroRecordList[ resultMacroIndex ];
 
        // Current Macro position
-       var_uint_t pos = macro->pos;
+       var_uint_t pos = record->pos;
 
        // Length of combo being processed
        uint8_t comboLength = macro->guide[ pos ];
@@ -780,7 +797,7 @@ inline ResultMacroEval Macro_evalResultMacro( var_uint_t resultMacroIndex )
                void (*capability)(uint8_t, uint8_t, uint8_t*) = (void(*)(uint8_t, uint8_t, uint8_t*))(CapabilitiesList[ guide->index ].func);
 
                // Call capability
-               capability( macro->state, macro->stateType, &guide->args );
+               capability( record->state, record->stateType, &guide->args );
 
                // Increment counters
                funcCount++;
@@ -788,12 +805,12 @@ inline ResultMacroEval Macro_evalResultMacro( var_uint_t resultMacroIndex )
        }
 
        // Move to next item in the sequence
-       macro->pos = comboItem;
+       record->pos = comboItem;
 
        // If the ResultMacro is finished, remove
        if ( macro->guide[ comboItem ] == 0 )
        {
-               macro->pos = 0;
+               record->pos = 0;
                return ResultMacroEval_Remove;
        }
 
@@ -814,8 +831,12 @@ inline void Macro_updateTriggerMacroPendingList()
                if ( macroTriggerListBuffer[ key ].state == 0x00 && macroTriggerListBuffer[ key ].state != 0x01 )
                        continue;
 
+               // TODO Analog
+               // If this is a release case, indicate to layer lookup for possible latch expiry
+               uint8_t latch_expire = macroTriggerListBuffer[ key ].state == 0x03;
+
                // Lookup Trigger List
-               nat_ptr_t *triggerList = Macro_layerLookup( macroTriggerListBuffer[ key ].scanCode );
+               nat_ptr_t *triggerList = Macro_layerLookup( macroTriggerListBuffer[ key ].scanCode, latch_expire );
 
                // Number of Triggers in list
                nat_ptr_t triggerListSize = triggerList[0];
@@ -844,8 +865,8 @@ inline void Macro_updateTriggerMacroPendingList()
                                macroTriggerMacroPendingList[ macroTriggerMacroPendingListSize++ ] = triggerMacroIndex;
 
                                // Reset macro position
-                               TriggerMacroList[ triggerMacroIndex ].pos   = 0;
-                               TriggerMacroList[ triggerMacroIndex ].state = TriggerMacro_Waiting;
+                               TriggerMacroRecordList[ triggerMacroIndex ].pos   = 0;
+                               TriggerMacroRecordList[ triggerMacroIndex ].state = TriggerMacro_Waiting;
                        }
                }
        }
@@ -966,16 +987,16 @@ inline void Macro_setup()
        // Initialize TriggerMacro states
        for ( var_uint_t macro = 0; macro < TriggerMacroNum; macro++ )
        {
-               TriggerMacroList[ macro ].pos   = 0;
-               TriggerMacroList[ macro ].state = TriggerMacro_Waiting;
+               TriggerMacroRecordList[ macro ].pos   = 0;
+               TriggerMacroRecordList[ macro ].state = TriggerMacro_Waiting;
        }
 
        // Initialize ResultMacro states
        for ( var_uint_t macro = 0; macro < ResultMacroNum; macro++ )
        {
-               ResultMacroList[ macro ].pos       = 0;
-               ResultMacroList[ macro ].state     = 0;
-               ResultMacroList[ macro ].stateType = 0;
+               ResultMacroRecordList[ macro ].pos       = 0;
+               ResultMacroRecordList[ macro ].state     = 0;
+               ResultMacroRecordList[ macro ].stateType = 0;
        }
 }
 
@@ -1312,7 +1333,8 @@ void macroDebugShowTrigger( var_uint_t index )
                return;
 
        // Trigger Macro Show
-       TriggerMacro *macro = &TriggerMacroList[ index ];
+       const TriggerMacro *macro = &TriggerMacroList[ index ];
+       TriggerMacroRecord *record = &TriggerMacroRecordList[ index ];
 
        print( NL );
        info_msg("Trigger Macro Index: ");
@@ -1360,7 +1382,7 @@ void macroDebugShowTrigger( var_uint_t index )
 
        // Display current position
        print( NL "Position: " );
-       printInt16( (uint16_t)macro->pos ); // Hopefully large enough :P (can't assume 32-bit)
+       printInt16( (uint16_t)record->pos ); // Hopefully large enough :P (can't assume 32-bit)
 
        // Display result macro index
        print( NL "Result Macro Index: " );
@@ -1368,7 +1390,7 @@ void macroDebugShowTrigger( var_uint_t index )
 
        // Display trigger macro state
        print( NL "Trigger Macro State: " );
-       switch ( macro->state )
+       switch ( record->state )
        {
        case TriggerMacro_Press:   print("Press");   break;
        case TriggerMacro_Release: print("Release"); break;
@@ -1383,7 +1405,8 @@ void macroDebugShowResult( var_uint_t index )
                return;
 
        // Trigger Macro Show
-       ResultMacro *macro = &ResultMacroList[ index ];
+       const ResultMacro *macro = &ResultMacroList[ index ];
+       ResultMacroRecord *record = &ResultMacroRecordList[ index ];
 
        print( NL );
        info_msg("Result Macro Index: ");
@@ -1452,13 +1475,13 @@ void macroDebugShowResult( var_uint_t index )
 
        // Display current position
        print( NL "Position: " );
-       printInt16( (uint16_t)macro->pos ); // Hopefully large enough :P (can't assume 32-bit)
+       printInt16( (uint16_t)record->pos ); // Hopefully large enough :P (can't assume 32-bit)
 
        // Display final trigger state/type
        print( NL "Final Trigger State (State/Type): " );
-       printHex( macro->state );
+       printHex( record->state );
        print("/");
-       printHex( macro->stateType );
+       printHex( record->stateType );
 }
 
 void cliFunc_macroShow( char* args )