DS2FlkcTableQueryBuilder.java

/*
 * RomRaider Open-Source Tuning, Logging and Reflashing
 * Copyright (C) 2006-2015 RomRaider.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 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, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

package com.romraider.logger.ecu.comms.learning.flkctable;

import java.util.ArrayList;
import java.util.List;

import org.apache.log4j.Logger;

import com.romraider.logger.ecu.comms.query.EcuQuery;
import com.romraider.logger.ecu.comms.query.EcuQueryData;
import com.romraider.logger.ecu.comms.query.EcuQueryImpl;
import com.romraider.logger.ecu.definition.EcuAddress;
import com.romraider.logger.ecu.definition.EcuAddressImpl;
import com.romraider.logger.ecu.definition.EcuData;
import com.romraider.logger.ecu.definition.EcuDataConvertor;
import com.romraider.logger.ecu.definition.EcuParameterImpl;
import com.romraider.logger.ecu.ui.paramlist.ParameterRow;

/**
 * Build an EcuQuery for each of the cells in the FLKC RAM table. 
 */
public class DS2FlkcTableQueryBuilder {
    private static final Logger LOGGER =
            Logger.getLogger(DS2FlkcTableQueryBuilder.class);

    public DS2FlkcTableQueryBuilder() {
    }

    /**
     * Build an EcuQuery for each cell of the Knock Adaptation RAM table.
     * <i>Note this returns an extra null query for column 0 of each row
     * which is later populated with the row header (RPM Ranges) data.</i>
     * @param flkc - a ParameterRow item that helps to identify the
     * ECU bitness and provide a Converter for the raw data.
     * @param flkcAddr - the address in RAM of the start of the table.
     * @param rows - the number of rows in the table.
     * @param columns - the number of columns in the table.
     * @return EcuQueries divided into groups to query each row separately to
     * avoid maxing out the ECU send/receive buffer.
     */
    public final List<List<EcuQuery>> build(
            ParameterRow flkc,
            int flkcAddr,
            int rows,
            int columns) {

        final List<List<EcuQuery>> flkcQueryRows = new ArrayList<List<EcuQuery>>();
        final EcuData parameter = (EcuData) flkc.getLoggerData();
        int dataSize = EcuQueryData.getDataLength(parameter);
        LOGGER.debug(
                String.format(
                        "Knock Data format rows:%d col:%d " +
                        "dataSize:%d Knock Index:%s",
                        rows, columns, dataSize,
                        parameter.getId()));

        int i = 0;
        for (int j = 0; j < rows; j++) {
            final List<EcuQuery> flkcQueryCols = new ArrayList<EcuQuery>();
            flkcQueryCols.add(null);
            for (int k = 0; k < columns; k++) {
                String id = "Knock-r" + j + "c" + k;
                final String addrStr = String.format("0x%06X", flkcAddr + (i * dataSize));
                LOGGER.debug(
                        String.format(
                                "Knock Data row:%d col:%d addr:%s",
                                j, k, addrStr));
                final EcuAddress ea = new EcuAddressImpl(addrStr, dataSize, -1);
                new String();
                final EcuParameterImpl epi =
                    new EcuParameterImpl(id, addrStr, id, ea,
                            parameter.getGroup(),
                            parameter.getSubgroup(),
                            String.valueOf(parameter.getGroupSize()),
                        new EcuDataConvertor[] {
                            parameter.getSelectedConvertor()
                        }
                    );
                flkcQueryCols.add(new EcuQueryImpl((EcuData) epi));
                i++;
            }
            flkcQueryRows.add(flkcQueryCols);
        }
        return flkcQueryRows;
    }
}