stm32samples/F3:F303/I2C_scan/proto.c

/*
 * This file is part of the i2cscan project.
 * Copyright 2023 Edward V. Emelianov <edward.emelianoff@gmail.com>.
 *
 * 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 3 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 <stm32f3.h>
#include <string.h>
#include "i2c.h"
#include "strfunc.h"
#include "usb.h"
#include "version.inc"

#define LOCBUFFSZ       (32)
// local buffer for I2C data to send
static uint8_t locBuffer[LOCBUFFSZ];
extern volatile uint32_t Tms;

static const char *OK = "OK\n";
static const char *helpstring =
        "https://github.com/eddyem/stm32samples/tree/master/F3:F303/I2C_scan build#" BUILD_NUMBER " @ " BUILD_DATE "\n"
        "i0..3 - setup I2C with speed 10k, 100k, 400k, 1M or 2M (experimental!)\n"
        "B - switch to big-endian format for 16-bit registers\n"
        "Ia addr - set I2C address\n"
        "Ig - dump content of I2Cbuf\n"
        "Iw bytes - send bytes (hex/dec/oct/bin) to I2C\n"
        "IW bytes - the same over DMA\n"
        "Ir reg n - read n bytes from I2C reg\n"
        "I2 reg16 n - read n words from 16-bit register\n"
        "In n - just read n bytes\n"
        "IN n - the same but with DMA\n"
        "Is - scan I2C bus\n"
        "L - switch to little-endian (default) format for 16-bit registers\n"
        "T - print current Tms\n"
;

TRUE_INLINE const char *setupI2C(const char *buf){
    if(!buf || !*buf){
        USND("Current speed: "); USB_putbyte('0' + i2c_curspeed); newline();
        return NULL;
    }
    buf = omit_spaces(buf);
    int speed = *buf - '0';
    if(speed < 0 || speed >= I2C_SPEED_AMOUNT){
        return "Wrong speed!\n";
    }
    i2c_setup((i2c_speed_t)speed);
    return OK;
}

static uint8_t I2Caddress = 0;
TRUE_INLINE const char *saI2C(const char *buf){
    uint32_t addr;
    USND("saI2C: '"); USND(buf); USND("'\n");
    const char *nxt = getnum(buf, &addr);
    if(nxt && nxt != buf){
        if(addr > 0x7f) return "Wrong address\n";
        I2Caddress = (uint8_t) addr << 1;
    }else addr = I2Caddress >> 1;
    USND("I2Caddr="); USND(uhex2str(addr)); newline();
    return OK;
}
static void rdI2C(const char *buf, int is16){
    uint32_t N = 0;
    int noreg = 0; // write register  (==1 - just read, ==2 - -//- using DMA)
    const char *nxt = NULL;
    if(*buf == 'n'){
        ++buf;
        noreg = 1;
    }else if(*buf == 'N'){
        ++buf;
        noreg = 2;
    }else{
        nxt = getnum(buf, &N);
        if(!nxt || buf == nxt || N > 0xffff || (!is16 &&  N > 0xff)){
            USND("Bad register number\n");
            return;
        }
        buf = nxt;
    }
    uint16_t reg = N;
    nxt = getnum(buf, &N);
    if(!nxt || buf == nxt || N > LOCBUFFSZ){
        USND("Bad length (<=32)\n");
        return;
    }
    const char *erd = "Error reading I2C\n";
    uint8_t *b8 = NULL; uint16_t *b16 = NULL;
    if(noreg){ // don't write register
        if(noreg == 1){
            USND("Simple read:\n");
            if(!(b8 = read_i2c(I2Caddress, N))){
                USND(erd);
                return;
            }
        }else{
            USND("Try to read using DMA .. ");
            if(!read_i2c_dma(I2Caddress, N)) USND(erd);
            else USND(OK);
            return;
        }
    }else{
        if(is16){
            if(!(b16 = read_i2c_reg16(I2Caddress, reg, N))){
                USND(erd);
                return;
            }
        }else{
            if(!(b8 = read_i2c_reg(I2Caddress, reg, N))){
                USND(erd);
                return;
            }
        }
    }
    if(N == 0){ USND(OK); return; }
    if(!noreg){USND("Register "); USND(uhex2str(reg)); USND(":\n");}
    if(!is16){ hexdump(USB_sendstr, b8, N); return; }
    for(int i = 0; i < (int)N; ++i){
        USND(uhex2str(b16[i])); USB_putbyte(' ');
        if((i & 7) == 7) newline();
    }
    if(N & 7) newline();
}
// read N numbers from buf, @return 0 if wrong or none
TRUE_INLINE uint16_t readNnumbers(const char *buf){
    uint32_t D;
    const char *nxt;
    uint16_t N = 0;
    while((nxt = getnum(buf, &D)) && nxt != buf && N < LOCBUFFSZ){
        buf = nxt;
        locBuffer[N++] = (uint8_t) D&0xff;
        USND("add byte: "); USND(uhex2str(D&0xff)); USND("\n");
    }
    USND("Send "); USND(u2str(N)); USND(" bytes\n");
    return N;
}
static const char *wrI2C(const char *buf, int isdma){
    uint16_t N = readNnumbers(buf);
    int result = isdma ? write_i2c_dma(I2Caddress, locBuffer, N) :
                         write_i2c(I2Caddress, locBuffer, N);
    if(!result) return "Error writing I2C\n";
    return OK;
}

const char *parse_cmd(const char *buf){
    if(!buf || !*buf) return NULL;
    if(buf[1]) switch(*buf){ // "long" commands
        case 'i':
            return setupI2C(buf + 1);
        break;
        case 'I':
            buf = omit_spaces(buf + 1);
            switch(*buf){
                case 'a': return saI2C(buf + 1);
                case 'r':
                    rdI2C(buf + 1, 0); return NULL;
                case '2':
                    rdI2C(buf + 1, 1); return NULL;
                case 'n':
                case 'N':
                    rdI2C(buf, 0); return NULL;
                case 'w': return wrI2C(buf + 1, 0);
                case 'W': return wrI2C(buf + 1, 1);
                case 's':
                    i2c_init_scan_mode(); return "Start scan\n";
                case 'g':
                    i2c_bufdudump(); return NULL;
                default:
                    return "Wrong I2C command, read help!\n";
            }
        break;
        default:
            return("Wrong command, try '?' for help\n");
    }
    switch(*buf){
        case 'i': return setupI2C(NULL); // current settings
        case 'B':
            endianness(1);
            return OK;
        break;
        case 'L':
            endianness(0);
            return OK;
        break;
        case 'T':
            USND("T=");
            USND(u2str(Tms));
            newline();
        break;
        default: // help
            USND(helpstring);
        break;
    }
    return NULL;
}