@microbit/microbit-fs/dist/esm/hex-mem-info.js

Manipulate files in a micro:bit MicroPython Intel Hex file.

/**
 * Retrieves the device information stored inside a MicroPython hex file.
 *
 * (c) 2020 Micro:bit Educational Foundation and the microbit-fs contributors.
 * SPDX-License-Identifier: MIT
 */
import MemoryMap from 'nrf-intel-hex';
import * as flashRegions from './flash-regions.js';
import * as uicr from './uicr.js';
/**
 * Attempts to retrieve the device memory data from an MicroPython Intel Hex
 * memory map.
 *
 * @param {MemoryMap} intelHexMap MicroPython Intel Hex memory map to scan.
 * @returns {DeviceMemInfo} Device data.
 */
function getHexMapDeviceMemInfo(intelHexMap) {
    let errorMsg = '';
    try {
        return uicr.getHexMapUicrData(intelHexMap);
    }
    catch (err) {
        errorMsg += err.message + '\n';
    }
    try {
        return flashRegions.getHexMapFlashRegionsData(intelHexMap);
    }
    catch (err) {
        throw new Error(errorMsg + err.message);
    }
}
/**
 * Attempts to retrieve the device memory data from an MicroPython Intel Hex.
 *
 * @param intelHex - MicroPython Intel Hex string.
 * @returns {DeviceMemInfo} Device data.
 */
function getIntelHexDeviceMemInfo(intelHex) {
    return getHexMapDeviceMemInfo(MemoryMap.fromHex(intelHex));
}
export { getHexMapDeviceMemInfo, getIntelHexDeviceMemInfo };
//# sourceMappingURL=hex-mem-info.js.map