* Generate api docs from source code * Add a bunch of doxygen comments * more doxygen comments * Add the in-progress api docs * script to generate docs from travis * Add doc generation to the travis job * make travis_docs.sh commit the work it does * make sure the docs script exits cleanly
		
			
				
	
	
		
			244 lines
		
	
	
		
			6.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			244 lines
		
	
	
		
			6.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* Copyright 2017 Fred Sundvik
 | 
						|
 *
 | 
						|
 * This program 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 2 of the License, or
 | 
						|
 * (at your option) any later version.
 | 
						|
 *
 | 
						|
 * This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 | 
						|
 */
 | 
						|
 | 
						|
#include "report.h"
 | 
						|
#include "host.h"
 | 
						|
#include "keycode_config.h"
 | 
						|
#include "debug.h"
 | 
						|
#include "util.h"
 | 
						|
 | 
						|
/** \brief has_anykey
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
uint8_t has_anykey(report_keyboard_t* keyboard_report)
 | 
						|
{
 | 
						|
    uint8_t cnt = 0;
 | 
						|
    for (uint8_t i = 1; i < KEYBOARD_REPORT_SIZE; i++) {
 | 
						|
        if (keyboard_report->raw[i])
 | 
						|
            cnt++;
 | 
						|
    }
 | 
						|
    return cnt;
 | 
						|
}
 | 
						|
 | 
						|
/** \brief get_first_key
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
uint8_t get_first_key(report_keyboard_t* keyboard_report)
 | 
						|
{
 | 
						|
#ifdef NKRO_ENABLE
 | 
						|
    if (keyboard_protocol && keymap_config.nkro) {
 | 
						|
        uint8_t i = 0;
 | 
						|
        for (; i < KEYBOARD_REPORT_BITS && !keyboard_report->nkro.bits[i]; i++)
 | 
						|
            ;
 | 
						|
        return i<<3 | biton(keyboard_report->nkro.bits[i]);
 | 
						|
    }
 | 
						|
#endif
 | 
						|
#ifdef USB_6KRO_ENABLE
 | 
						|
    uint8_t i = cb_head;
 | 
						|
    do {
 | 
						|
        if (keyboard_report->keys[i] != 0) {
 | 
						|
            break;
 | 
						|
        }
 | 
						|
        i = RO_INC(i);
 | 
						|
    } while (i != cb_tail);
 | 
						|
    return keyboard_report->keys[i];
 | 
						|
#else
 | 
						|
    return keyboard_report->keys[0];
 | 
						|
#endif
 | 
						|
}
 | 
						|
 | 
						|
/** \brief add key byte
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void add_key_byte(report_keyboard_t* keyboard_report, uint8_t code)
 | 
						|
{
 | 
						|
#ifdef USB_6KRO_ENABLE
 | 
						|
    int8_t i = cb_head;
 | 
						|
    int8_t empty = -1;
 | 
						|
    if (cb_count) {
 | 
						|
        do {
 | 
						|
            if (keyboard_report->keys[i] == code) {
 | 
						|
                return;
 | 
						|
            }
 | 
						|
            if (empty == -1 && keyboard_report->keys[i] == 0) {
 | 
						|
                empty = i;
 | 
						|
            }
 | 
						|
            i = RO_INC(i);
 | 
						|
        } while (i != cb_tail);
 | 
						|
        if (i == cb_tail) {
 | 
						|
            if (cb_tail == cb_head) {
 | 
						|
                // buffer is full
 | 
						|
                if (empty == -1) {
 | 
						|
                    // pop head when has no empty space
 | 
						|
                    cb_head = RO_INC(cb_head);
 | 
						|
                    cb_count--;
 | 
						|
                }
 | 
						|
                else {
 | 
						|
                    // left shift when has empty space
 | 
						|
                    uint8_t offset = 1;
 | 
						|
                    i = RO_INC(empty);
 | 
						|
                    do {
 | 
						|
                        if (keyboard_report->keys[i] != 0) {
 | 
						|
                            keyboard_report->keys[empty] = keyboard_report->keys[i];
 | 
						|
                            keyboard_report->keys[i] = 0;
 | 
						|
                            empty = RO_INC(empty);
 | 
						|
                        }
 | 
						|
                        else {
 | 
						|
                            offset++;
 | 
						|
                        }
 | 
						|
                        i = RO_INC(i);
 | 
						|
                    } while (i != cb_tail);
 | 
						|
                    cb_tail = RO_SUB(cb_tail, offset);
 | 
						|
                }
 | 
						|
            }
 | 
						|
        }
 | 
						|
    }
 | 
						|
    // add to tail
 | 
						|
    keyboard_report->keys[cb_tail] = code;
 | 
						|
    cb_tail = RO_INC(cb_tail);
 | 
						|
    cb_count++;
 | 
						|
#else
 | 
						|
    int8_t i = 0;
 | 
						|
    int8_t empty = -1;
 | 
						|
    for (; i < KEYBOARD_REPORT_KEYS; i++) {
 | 
						|
        if (keyboard_report->keys[i] == code) {
 | 
						|
            break;
 | 
						|
        }
 | 
						|
        if (empty == -1 && keyboard_report->keys[i] == 0) {
 | 
						|
            empty = i;
 | 
						|
        }
 | 
						|
    }
 | 
						|
    if (i == KEYBOARD_REPORT_KEYS) {
 | 
						|
        if (empty != -1) {
 | 
						|
            keyboard_report->keys[empty] = code;
 | 
						|
        }
 | 
						|
    }
 | 
						|
#endif
 | 
						|
}
 | 
						|
 | 
						|
/** \brief del key byte
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void del_key_byte(report_keyboard_t* keyboard_report, uint8_t code)
 | 
						|
{
 | 
						|
#ifdef USB_6KRO_ENABLE
 | 
						|
    uint8_t i = cb_head;
 | 
						|
    if (cb_count) {
 | 
						|
        do {
 | 
						|
            if (keyboard_report->keys[i] == code) {
 | 
						|
                keyboard_report->keys[i] = 0;
 | 
						|
                cb_count--;
 | 
						|
                if (cb_count == 0) {
 | 
						|
                    // reset head and tail
 | 
						|
                    cb_tail = cb_head = 0;
 | 
						|
                }
 | 
						|
                if (i == RO_DEC(cb_tail)) {
 | 
						|
                    // left shift when next to tail
 | 
						|
                    do {
 | 
						|
                        cb_tail = RO_DEC(cb_tail);
 | 
						|
                        if (keyboard_report->keys[RO_DEC(cb_tail)] != 0) {
 | 
						|
                            break;
 | 
						|
                        }
 | 
						|
                    } while (cb_tail != cb_head);
 | 
						|
                }
 | 
						|
                break;
 | 
						|
            }
 | 
						|
            i = RO_INC(i);
 | 
						|
        } while (i != cb_tail);
 | 
						|
    }
 | 
						|
#else
 | 
						|
    for (uint8_t i = 0; i < KEYBOARD_REPORT_KEYS; i++) {
 | 
						|
        if (keyboard_report->keys[i] == code) {
 | 
						|
            keyboard_report->keys[i] = 0;
 | 
						|
        }
 | 
						|
    }
 | 
						|
#endif
 | 
						|
}
 | 
						|
 | 
						|
#ifdef NKRO_ENABLE
 | 
						|
/** \brief add key bit
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void add_key_bit(report_keyboard_t* keyboard_report, uint8_t code)
 | 
						|
{
 | 
						|
    if ((code>>3) < KEYBOARD_REPORT_BITS) {
 | 
						|
        keyboard_report->nkro.bits[code>>3] |= 1<<(code&7);
 | 
						|
    } else {
 | 
						|
        dprintf("add_key_bit: can't add: %02X\n", code);
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
/** \brief del key bit
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void del_key_bit(report_keyboard_t* keyboard_report, uint8_t code)
 | 
						|
{
 | 
						|
    if ((code>>3) < KEYBOARD_REPORT_BITS) {
 | 
						|
        keyboard_report->nkro.bits[code>>3] &= ~(1<<(code&7));
 | 
						|
    } else {
 | 
						|
        dprintf("del_key_bit: can't del: %02X\n", code);
 | 
						|
    }
 | 
						|
}
 | 
						|
#endif
 | 
						|
 | 
						|
/** \brief add key to report
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void add_key_to_report(report_keyboard_t* keyboard_report, uint8_t key)
 | 
						|
{
 | 
						|
#ifdef NKRO_ENABLE
 | 
						|
    if (keyboard_protocol && keymap_config.nkro) {
 | 
						|
        add_key_bit(keyboard_report, key);
 | 
						|
        return;
 | 
						|
    }
 | 
						|
#endif
 | 
						|
    add_key_byte(keyboard_report, key);
 | 
						|
}
 | 
						|
 | 
						|
/** \brief del key from report
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void del_key_from_report(report_keyboard_t* keyboard_report, uint8_t key)
 | 
						|
{
 | 
						|
#ifdef NKRO_ENABLE
 | 
						|
    if (keyboard_protocol && keymap_config.nkro) {
 | 
						|
        del_key_bit(keyboard_report, key);
 | 
						|
        return;
 | 
						|
    }
 | 
						|
#endif
 | 
						|
    del_key_byte(keyboard_report, key);
 | 
						|
}
 | 
						|
 | 
						|
/** \brief clear key from report
 | 
						|
 *
 | 
						|
 * FIXME: Needs doc
 | 
						|
 */
 | 
						|
void clear_keys_from_report(report_keyboard_t* keyboard_report)
 | 
						|
{
 | 
						|
    // not clear mods
 | 
						|
    for (int8_t i = 1; i < KEYBOARD_REPORT_SIZE; i++) {
 | 
						|
        keyboard_report->raw[i] = 0;
 | 
						|
    }
 | 
						|
}
 |