sys64738
/
mspdebug
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

tilib_api: indirection layer for TI library dynamic loading.

This commit is contained in:
Daniel Beer 2015-06-08 11:37:25 +12:00
parent 5e47033700
commit 4ea3856202
4 changed files with 418 additions and 203 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Makefile
View File

@ -169,6 +169,7 @@ OBJ=\
drivers/fet3.o \ drivers/fet3.o \
drivers/bsllib.o \ drivers/bsllib.o \
drivers/rom_bsl.o \ drivers/rom_bsl.o \
drivers/tilib_api.o \
formats/binfile.o \ formats/binfile.o \
formats/coff.o \ formats/coff.o \
formats/elf32.o \ formats/elf32.o \

246
drivers/tilib.c
View File

@ -21,26 +21,15 @@
#include <unistd.h> #include <unistd.h>
#include "output.h" #include "output.h"
#include "dynload.h"
#include "tilib.h" #include "tilib.h"
#include "tilib_defs.h" #include "tilib_api.h"
#include "thread.h" #include "thread.h"
#include "ctrlc.h" #include "ctrlc.h"
#include "opdb.h" #include "opdb.h"
#if defined(__Windows__) || defined(__CYGWIN__)
static const char tilib_filename[] = "MSP430.DLL";
#define TIDLL __stdcall
#else
static const char tilib_filename[] = "libmsp430.so";
#define TIDLL
#endif
struct tilib_device { struct tilib_device {
struct device base; struct device base;
dynload_handle_t hnd;
thread_lock_t mb_lock; thread_lock_t mb_lock;
uint32_t mailbox; uint32_t mailbox;
@ -48,49 +37,6 @@ struct tilib_device {
char uifPath[1024]; char uifPath[1024];
fperm_t active_fperm; fperm_t active_fperm;
/* MSP430.h */
STATUS_T TIDLL (*MSP430_Initialize)(char *port, long *version);
STATUS_T TIDLL (*MSP430_VCC)(long voltage);
STATUS_T TIDLL (*MSP430_Configure)(long mode, long value);
STATUS_T TIDLL (*MSP430_OpenDevice)(char *Device, char *Password,
long PwLength, long DeviceCode,
long setId);
STATUS_T TIDLL (*MSP430_GetFoundDevice)(char *FoundDevice,
long count);
STATUS_T TIDLL (*MSP430_Close)(long vccOff);
STATUS_T TIDLL (*MSP430_Memory)(long address, char *buffer,
long count, long rw);
STATUS_T TIDLL (*MSP430_Reset)(long method, long execute,
long releaseJTAG);
STATUS_T TIDLL (*MSP430_Erase)(long type, long address, long length);
STATUS_T TIDLL (*MSP430_Secure)(void);
STATUS_T TIDLL (*MSP430_Error_Number)(void);
const char *TIDLL (*MSP430_Error_String)(long errNumber);
STATUS_T TIDLL (*MSP430_GetNumberOfUsbIfs)(long* number);
STATUS_T TIDLL (*MSP430_GetNameOfUsbIf)(long idx, char **name,
long *status);
/* MSP430_Debug.h */
STATUS_T TIDLL (*MSP430_Registers)(long *registers, long mask,
long rw);
STATUS_T TIDLL (*MSP430_Run)(long mode, long releaseJTAG);
STATUS_T TIDLL (*MSP430_State)(long *state, long stop,
long *pCPUCycles);
/* MSP430_EEM.h */
STATUS_T TIDLL (*MSP430_EEM_Init)(DLL430_EVENTNOTIFY_FUNC callback,
long clientHandle,
MessageID_t *pMsgIdBuffer);
STATUS_T TIDLL (*MSP430_EEM_SetBreakpoint)(uint16_t *pwBpHandle,
BpParameter_t *pBpBuffer);
/* MSP430_FET.h */
STATUS_T TIDLL (*MSP430_FET_FwUpdate)(char* lpszFileName,
DLL430_FET_NOTIFY_FUNC callback,
long clientHandle);
}; };
#define MID_SINGLE_STEP 0x01 #define MID_SINGLE_STEP 0x01
@ -136,112 +82,10 @@ static uint32_t event_fetch(struct tilib_device *dev)
return ret; return ret;
} }
static void *get_func(dynload_handle_t hnd, const char *name)
{
void *ret = dynload_sym(hnd, name);
if (!ret) {
printc_err("tilib: can't find symbol \"%s\": %s\n",
name, dynload_error());
return NULL;
}
return ret;
}
static int get_all_funcs(struct tilib_device *dev)
{
dev->MSP430_Initialize = get_func(dev->hnd, "MSP430_Initialize");
if (!dev->MSP430_Initialize)
return -1;
dev->MSP430_VCC = get_func(dev->hnd, "MSP430_VCC");
if (!dev->MSP430_VCC)
return -1;
dev->MSP430_Configure = get_func(dev->hnd, "MSP430_Configure");
if (!dev->MSP430_Configure)
return -1;
dev->MSP430_OpenDevice = get_func(dev->hnd, "MSP430_OpenDevice");
if (!dev->MSP430_OpenDevice)
return -1;
dev->MSP430_GetFoundDevice = get_func(dev->hnd,
"MSP430_GetFoundDevice");
if (!dev->MSP430_GetFoundDevice)
return -1;
dev->MSP430_Close = get_func(dev->hnd, "MSP430_Close");
if (!dev->MSP430_Close)
return -1;
dev->MSP430_Memory = get_func(dev->hnd, "MSP430_Memory");
if (!dev->MSP430_Memory)
return -1;
dev->MSP430_Reset = get_func(dev->hnd, "MSP430_Reset");
if (!dev->MSP430_Reset)
return -1;
dev->MSP430_Erase = get_func(dev->hnd, "MSP430_Erase");
if (!dev->MSP430_Erase)
return -1;
dev->MSP430_Secure = get_func(dev->hnd, "MSP430_Secure");
if (!dev->MSP430_Secure)
return -1;
dev->MSP430_Error_Number = get_func(dev->hnd, "MSP430_Error_Number");
if (!dev->MSP430_Error_Number)
return -1;
dev->MSP430_Error_String = get_func(dev->hnd, "MSP430_Error_String");
if (!dev->MSP430_Error_String)
return -1;
dev->MSP430_GetNumberOfUsbIfs =
get_func(dev->hnd, "MSP430_GetNumberOfUsbIfs");
if (!dev->MSP430_GetNumberOfUsbIfs)
return -1;
dev->MSP430_GetNameOfUsbIf =
get_func(dev->hnd, "MSP430_GetNameOfUsbIf");
if (!dev->MSP430_GetNameOfUsbIf)
return -1;
dev->MSP430_Registers = get_func(dev->hnd, "MSP430_Registers");
if (!dev->MSP430_Registers)
return -1;
dev->MSP430_Run = get_func(dev->hnd, "MSP430_Run");
if (!dev->MSP430_Run)
return -1;
dev->MSP430_State = get_func(dev->hnd, "MSP430_State");
if (!dev->MSP430_State)
return -1;
dev->MSP430_EEM_Init = get_func(dev->hnd, "MSP430_EEM_Init");
if (!dev->MSP430_EEM_Init)
return -1;
dev->MSP430_EEM_SetBreakpoint = get_func(dev->hnd,
"MSP430_EEM_SetBreakpoint");
if (!dev->MSP430_EEM_SetBreakpoint)
return -1;
dev->MSP430_FET_FwUpdate = get_func(dev->hnd, "MSP430_FET_FwUpdate");
if (!dev->MSP430_FET_FwUpdate)
return -1;
return 0;
}
static void report_error(struct tilib_device *dev, const char *what) static void report_error(struct tilib_device *dev, const char *what)
{ {
long err = dev->MSP430_Error_Number(); long err = tilib_api->MSP430_Error_Number();
const char *desc = dev->MSP430_Error_String(err); const char *desc = tilib_api->MSP430_Error_String(err);
printc_err("tilib: %s: %s (error = %ld)\n", what, desc, err); printc_err("tilib: %s: %s (error = %ld)\n", what, desc, err);
} }
@ -256,7 +100,8 @@ static int refresh_fperm(struct tilib_device *dev)
printc_dbg("%s locked flash access\n", printc_dbg("%s locked flash access\n",
opt ? "Enabling" : "Disabling"); opt ? "Enabling" : "Disabling");
if (dev->MSP430_Configure(LOCKED_FLASH_ACCESS, opt) < 0) { if (tilib_api->MSP430_Configure
(LOCKED_FLASH_ACCESS, opt) < 0) {
report_error(dev, "MSP430_Configure " report_error(dev, "MSP430_Configure "
"(LOCKED_FLASH_ACCESS)\n"); "(LOCKED_FLASH_ACCESS)\n");
return -1; return -1;
@ -268,7 +113,8 @@ static int refresh_fperm(struct tilib_device *dev)
printc_dbg("%s BSL access\n", printc_dbg("%s BSL access\n",
opt ? "Enabling" : "Disabling"); opt ? "Enabling" : "Disabling");
if (dev->MSP430_Configure(UNLOCK_BSL_MODE, opt) < 0) { if (tilib_api->MSP430_Configure
(UNLOCK_BSL_MODE, opt) < 0) {
report_error(dev, "MSP430_Configure " report_error(dev, "MSP430_Configure "
"(UNLOCK_BSL_MODE)\n"); "(UNLOCK_BSL_MODE)\n");
return -1; return -1;
@ -284,7 +130,7 @@ static int tilib_readmem(device_t dev_base, address_t addr,
{ {
struct tilib_device *dev = (struct tilib_device *)dev_base; struct tilib_device *dev = (struct tilib_device *)dev_base;
if (dev->MSP430_Memory(addr, (char *)mem, len, READ) < 0) { if (tilib_api->MSP430_Memory(addr, (char *)mem, len, READ) < 0) {
report_error(dev, "MSP430_Memory"); report_error(dev, "MSP430_Memory");
return -1; return -1;
} }
@ -299,7 +145,8 @@ static int tilib_writemem(device_t dev_base, address_t addr,
refresh_fperm(dev); refresh_fperm(dev);
if (dev->MSP430_Memory(addr, (char *)mem, len, WRITE) < 0) { if (tilib_api->MSP430_Memory(addr,
(char *)mem, len, WRITE) < 0) {
report_error(dev, "MSP430_Memory"); report_error(dev, "MSP430_Memory");
return -1; return -1;
} }
@ -331,7 +178,8 @@ static int tilib_erase(device_t dev_base, device_erase_type_t type,
/* We need to pass a non-zero length if we've selected segment /* We need to pass a non-zero length if we've selected segment
* erase. * erase.
*/ */
if (dev->MSP430_Erase(ti_erase_type(type), address, 1) < 0) { if (tilib_api->MSP430_Erase(ti_erase_type(type),
address, 1) < 0) {
report_error(dev, "MSP430_Erase"); report_error(dev, "MSP430_Erase");
return -1; return -1;
} }
@ -345,7 +193,7 @@ static int tilib_getregs(device_t dev_base, address_t *regs)
long regbuf[DEVICE_NUM_REGS]; long regbuf[DEVICE_NUM_REGS];
int i; int i;
if (dev->MSP430_Registers(regbuf, 0xffff, READ) < 0) { if (tilib_api->MSP430_Registers(regbuf, 0xffff, READ) < 0) {
report_error(dev, "MSP430_Registers"); report_error(dev, "MSP430_Registers");
return -1; return -1;
} }
@ -365,7 +213,7 @@ static int tilib_setregs(device_t dev_base, const address_t *regs)
for (i = 0; i < DEVICE_NUM_REGS; i++) for (i = 0; i < DEVICE_NUM_REGS; i++)
regbuf[i] = regs[i]; regbuf[i] = regs[i];
if (dev->MSP430_Registers(regbuf, 0xffff, WRITE) < 0) { if (tilib_api->MSP430_Registers(regbuf, 0xffff, WRITE) < 0) {
report_error(dev, "MSP430_Registers"); report_error(dev, "MSP430_Registers");
return -1; return -1;
} }
@ -452,8 +300,8 @@ static int refresh_bps(struct tilib_device *dev)
param.bpMode = BP_CLEAR; param.bpMode = BP_CLEAR;
} }
if (dev->MSP430_EEM_SetBreakpoint(&dev->bp_handles[i], if (tilib_api->MSP430_EEM_SetBreakpoint
&param) < 0) { (&dev->bp_handles[i], &param) < 0) {
report_error(dev, "MSP430_EEM_SetBreakpoint"); report_error(dev, "MSP430_EEM_SetBreakpoint");
return -1; return -1;
} }
@ -469,7 +317,7 @@ static int do_halt(struct tilib_device *dev)
long state; long state;
long cycles; long cycles;
if (dev->MSP430_State(&state, 1, &cycles) < 0) { if (tilib_api->MSP430_State(&state, 1, &cycles) < 0) {
report_error(dev, "MSP430_State"); report_error(dev, "MSP430_State");
return -1; return -1;
} }
@ -480,7 +328,7 @@ static int do_halt(struct tilib_device *dev)
static int do_step(struct tilib_device *dev) static int do_step(struct tilib_device *dev)
{ {
if (dev->MSP430_Run(SINGLE_STEP, 0) < 0) { if (tilib_api->MSP430_Run(SINGLE_STEP, 0) < 0) {
report_error(dev, "MSP430_Run"); report_error(dev, "MSP430_Run");
return -1; return -1;
} }
@ -494,7 +342,7 @@ static int tilib_ctl(device_t dev_base, device_ctl_t op)
switch (op) { switch (op) {
case DEVICE_CTL_RESET: case DEVICE_CTL_RESET:
if (dev->MSP430_Reset(RST_RESET, 0, 0) < 0) { if (tilib_api->MSP430_Reset(RST_RESET, 0, 0) < 0) {
report_error(dev, "MSP430_Reset"); report_error(dev, "MSP430_Reset");
return -1; return -1;
} }
@ -504,7 +352,7 @@ static int tilib_ctl(device_t dev_base, device_ctl_t op)
if (refresh_bps(dev) < 0) if (refresh_bps(dev) < 0)
return -1; return -1;
if (dev->MSP430_Run(RUN_TO_BREAKPOINT, 0) < 0) { if (tilib_api->MSP430_Run(RUN_TO_BREAKPOINT, 0) < 0) {
report_error(dev, "MSP430_Run"); report_error(dev, "MSP430_Run");
return -1; return -1;
} }
@ -517,7 +365,7 @@ static int tilib_ctl(device_t dev_base, device_ctl_t op)
return do_step(dev); return do_step(dev);
case DEVICE_CTL_SECURE: case DEVICE_CTL_SECURE:
if (dev->MSP430_Secure() < 0) { if (tilib_api->MSP430_Secure() < 0) {
report_error(dev, "MSP430_Secure"); report_error(dev, "MSP430_Secure");
return -1; return -1;
} }
@ -545,12 +393,12 @@ static void tilib_destroy(device_t dev_base)
struct tilib_device *dev = (struct tilib_device *)dev_base; struct tilib_device *dev = (struct tilib_device *)dev_base;
printc_dbg("MSP430_Run\n"); printc_dbg("MSP430_Run\n");
if (dev->MSP430_Run(FREE_RUN, 1) < 0) if (tilib_api->MSP430_Run(FREE_RUN, 1) < 0)
report_error(dev, "MSP430_Run"); report_error(dev, "MSP430_Run");
printc_dbg("MSP430_Close\n"); printc_dbg("MSP430_Close\n");
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
dynload_close(dev->hnd); tilib_api_exit();
thread_lock_destroy(&dev->mb_lock); thread_lock_destroy(&dev->mb_lock);
free(dev); free(dev);
} }
@ -607,7 +455,7 @@ static void fw_progress(unsigned int msg_id, unsigned long w_param,
static int do_fw_update(struct tilib_device *dev, const char *filename) static int do_fw_update(struct tilib_device *dev, const char *filename)
{ {
printc("Starting firmware update (this may take some time)...\n"); printc("Starting firmware update (this may take some time)...\n");
if (dev->MSP430_FET_FwUpdate((char *)filename, if (tilib_api->MSP430_FET_FwUpdate((char *)filename,
fw_progress, (long)dev) < 0) { fw_progress, (long)dev) < 0) {
report_error(dev, "MSP430_FET_FwUpdate"); report_error(dev, "MSP430_FET_FwUpdate");
return -1; return -1;
@ -622,7 +470,7 @@ static int do_init(struct tilib_device *dev, const struct device_args *args)
union DEVICE_T device; union DEVICE_T device;
printc_dbg("MSP430_Initialize: %s\n", dev->uifPath); printc_dbg("MSP430_Initialize: %s\n", dev->uifPath);
if (dev->MSP430_Initialize(dev->uifPath, &version) < 0) { if (tilib_api->MSP430_Initialize(dev->uifPath, &version) < 0) {
report_error(dev, "MSP430_Initialize"); report_error(dev, "MSP430_Initialize");
return -1; return -1;
} }
@ -632,7 +480,7 @@ static int do_init(struct tilib_device *dev, const struct device_args *args)
args->require_fwupdate); args->require_fwupdate);
if (do_fw_update(dev, args->require_fwupdate) < 0) { if (do_fw_update(dev, args->require_fwupdate) < 0) {
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
return -1; return -1;
} }
} else if (version < 0) { } else if (version < 0) {
@ -640,13 +488,13 @@ static int do_init(struct tilib_device *dev, const struct device_args *args)
if (args->flags & DEVICE_FLAG_DO_FWUPDATE) { if (args->flags & DEVICE_FLAG_DO_FWUPDATE) {
if (do_fw_update(dev, NULL) < 0) { if (do_fw_update(dev, NULL) < 0) {
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
return -1; return -1;
} }
} else { } else {
printc("Re-run with --allow-fw-update to perform " printc("Re-run with --allow-fw-update to perform "
"a firmware update.\n"); "a firmware update.\n");
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
return -1; return -1;
} }
} else { } else {
@ -654,9 +502,9 @@ static int do_init(struct tilib_device *dev, const struct device_args *args)
} }
printc_dbg("MSP430_VCC: %d mV\n", args->vcc_mv); printc_dbg("MSP430_VCC: %d mV\n", args->vcc_mv);
if (dev->MSP430_VCC(args->vcc_mv) < 0) { if (tilib_api->MSP430_VCC(args->vcc_mv) < 0) {
report_error(dev, "MSP430_VCC"); report_error(dev, "MSP430_VCC");
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
return -1; return -1;
} }
@ -664,17 +512,17 @@ static int do_init(struct tilib_device *dev, const struct device_args *args)
delay_s(1); delay_s(1);
printc_dbg("MSP430_OpenDevice\n"); printc_dbg("MSP430_OpenDevice\n");
if (dev->MSP430_OpenDevice("DEVICE_UNKNOWN", "", 0, 0, 0) < 0) { if (tilib_api->MSP430_OpenDevice("DEVICE_UNKNOWN", "", 0, 0, 0) < 0) {
report_error(dev, "MSP430_OpenDevice"); report_error(dev, "MSP430_OpenDevice");
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
return -1; return -1;
} }
printc_dbg("MSP430_GetFoundDevice\n"); printc_dbg("MSP430_GetFoundDevice\n");
if (dev->MSP430_GetFoundDevice(device.buffer, if (tilib_api->MSP430_GetFoundDevice(device.buffer,
sizeof(device.buffer)) < 0) { sizeof(device.buffer)) < 0) {
report_error(dev, "MSP430_GetFoundDevice"); report_error(dev, "MSP430_GetFoundDevice");
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
return -1; return -1;
} }
@ -686,10 +534,10 @@ static int do_init(struct tilib_device *dev, const struct device_args *args)
printc_dbg("MSP430_EEM_Init\n"); printc_dbg("MSP430_EEM_Init\n");
thread_lock_init(&dev->mb_lock); thread_lock_init(&dev->mb_lock);
if (dev->MSP430_EEM_Init(event_notify, (long)dev, if (tilib_api->MSP430_EEM_Init(event_notify, (long)dev,
(MessageID_t *)&my_message_ids) < 0) { (MessageID_t *)&my_message_ids) < 0) {
report_error(dev, "MSP430_EEM_Init"); report_error(dev, "MSP430_EEM_Init");
dev->MSP430_Close(0); tilib_api->MSP430_Close(0);
thread_lock_destroy(&dev->mb_lock); thread_lock_destroy(&dev->mb_lock);
return -1; return -1;
} }
@ -704,7 +552,7 @@ static int do_findUif(struct tilib_device *dev)
long uifIndex = 0; long uifIndex = 0;
printc_dbg("MSP430_GetNumberOfUsbIfs\n"); printc_dbg("MSP430_GetNumberOfUsbIfs\n");
if (dev->MSP430_GetNumberOfUsbIfs(&attachedUifCount) < 0) { if (tilib_api->MSP430_GetNumberOfUsbIfs(&attachedUifCount) < 0) {
report_error(dev, "MSP430_GetNumberOfUsbIfs"); report_error(dev, "MSP430_GetNumberOfUsbIfs");
return -1; return -1;
} }
@ -715,7 +563,8 @@ static int do_findUif(struct tilib_device *dev)
long status = 0; long status = 0;
printc_dbg("MSP430_GetNameOfUsbIf\n"); printc_dbg("MSP430_GetNameOfUsbIf\n");
if (dev->MSP430_GetNameOfUsbIf(uifIndex, &name, &status) < 0) { if (tilib_api->MSP430_GetNameOfUsbIf(uifIndex,
&name, &status) < 0) {
report_error(dev, "MSP430_GetNameOfUsbIf"); report_error(dev, "MSP430_GetNameOfUsbIf");
return -1; return -1;
} }
@ -748,16 +597,7 @@ static device_t tilib_open(const struct device_args *args)
memset(dev, 0, sizeof(*dev)); memset(dev, 0, sizeof(*dev));
dev->base.type = &device_tilib; dev->base.type = &device_tilib;
dev->hnd = dynload_open(tilib_filename); if (tilib_api_init() < 0) {
if (!dev->hnd) {
printc_err("tilib: can't find %s: %s\n",
tilib_filename, dynload_error());
free(dev);
return NULL;
}
if (get_all_funcs(dev) < 0) {
dynload_close(dev->hnd);
free(dev); free(dev);
return NULL; return NULL;
} }
@ -774,7 +614,7 @@ static device_t tilib_open(const struct device_args *args)
} else { } else {
// No path was supplied, use the first UIF we can find // No path was supplied, use the first UIF we can find
if (do_findUif(dev) < 0) { if (do_findUif(dev) < 0) {
dynload_close(dev->hnd); tilib_api_exit();
free(dev); free(dev);
return NULL; return NULL;
} }
@ -782,7 +622,7 @@ static device_t tilib_open(const struct device_args *args)
if (do_init(dev, args) < 0) { if (do_init(dev, args) < 0) {
printc_err("tilib: device initialization failed\n"); printc_err("tilib: device initialization failed\n");
dynload_close(dev->hnd); tilib_api_exit();
free(dev); free(dev);
return NULL; return NULL;
} }

301
drivers/tilib_api.c Normal file
View File

@ -0,0 +1,301 @@
/* MSPDebug - debugging tool for MSP430 MCUs
* Copyright (C) 2009-2015 Daniel Beer
*
* 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 St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#include <stddef.h>
#include "util/output.h"
#include "tilib_api.h"
#include "dynload.h"
static dynload_handle_t lib_handle;
const struct tilib_api_table *tilib_api;
#if defined(__Windows__) || defined(__CYGWIN__)
static const char tilib_filename[] = "MSP430.DLL";
#define TIDLL __stdcall
#else
static const char tilib_filename[] = "libmsp430.so";
#define TIDLL
#endif
static void *get_func(const char *name)
{
void *ret = dynload_sym(lib_handle, name);
if (!ret) {
printc_err("tilib_api: can't find symbol \"%s\": %s\n",
name, dynload_error());
return NULL;
}
return ret;
}
/************************************************************************
* Old API (pre-SLAC460L)
*/
struct tilib_old_api {
/* MSP430.h */
STATUS_T TIDLL (*MSP430_Initialize)(char *port, long *version);
STATUS_T TIDLL (*MSP430_VCC)(long voltage);
STATUS_T TIDLL (*MSP430_Configure)(long mode, long value);
STATUS_T TIDLL (*MSP430_OpenDevice)(char *Device, char *Password,
long PwLength, long DeviceCode,
long setId);
STATUS_T TIDLL (*MSP430_GetFoundDevice)(char *FoundDevice,
long count);
STATUS_T TIDLL (*MSP430_Close)(long vccOff);
STATUS_T TIDLL (*MSP430_Memory)(long address, char *buffer,
long count, long rw);
STATUS_T TIDLL (*MSP430_Reset)(long method, long execute,
long releaseJTAG);
STATUS_T TIDLL (*MSP430_Erase)(long type, long address, long length);
STATUS_T TIDLL (*MSP430_Secure)(void);
STATUS_T TIDLL (*MSP430_Error_Number)(void);
const char *TIDLL (*MSP430_Error_String)(long errNumber);
STATUS_T TIDLL (*MSP430_GetNumberOfUsbIfs)(long* number);
STATUS_T TIDLL (*MSP430_GetNameOfUsbIf)(long idx, char **name,
long *status);
/* MSP430_Debug.h */
STATUS_T TIDLL (*MSP430_Registers)(long *registers, long mask,
long rw);
STATUS_T TIDLL (*MSP430_Run)(long mode, long releaseJTAG);
STATUS_T TIDLL (*MSP430_State)(long *state, long stop,
long *pCPUCycles);
/* MSP430_EEM.h */
STATUS_T TIDLL (*MSP430_EEM_Init)(DLL430_EVENTNOTIFY_FUNC callback,
long clientHandle,
MessageID_t *pMsgIdBuffer);
STATUS_T TIDLL (*MSP430_EEM_SetBreakpoint)(uint16_t *pwBpHandle,
BpParameter_t *pBpBuffer);
/* MSP430_FET.h */
STATUS_T TIDLL (*MSP430_FET_FwUpdate)(char* lpszFileName,
DLL430_FET_NOTIFY_FUNC callback,
long clientHandle);
};
static struct tilib_old_api old;
static STATUS_T old_Initialize(char *port, long *version)
{
return old.MSP430_Initialize(port, version);
}
static STATUS_T old_VCC(long voltage)
{
return old.MSP430_VCC(voltage);
}
static STATUS_T old_Configure(long mode, long value)
{
return old.MSP430_Configure(mode, value);
}
static STATUS_T old_OpenDevice(char *Device, char *Password,
long PwLength, long DeviceCode,
long setId)
{
return old.MSP430_OpenDevice(Device, Password, PwLength,
DeviceCode, setId);
}
static STATUS_T old_GetFoundDevice(char *FoundDevice, long count)
{
return old.MSP430_GetFoundDevice(FoundDevice, count);
}
static STATUS_T old_Close(long vccOff)
{
return old.MSP430_Close(vccOff);
}
static STATUS_T old_Memory(long address, char *buffer, long count, long rw)
{
return old.MSP430_Memory(address, buffer, count, rw);
}
static STATUS_T old_Reset(long method, long execute, long releaseJTAG)
{
return old.MSP430_Reset(method, execute, releaseJTAG);
}
static STATUS_T old_Erase(long type, long address, long length)
{
return old.MSP430_Erase(type, address, length);
}
static STATUS_T old_Secure(void)
{
return old.MSP430_Secure();
}
static STATUS_T old_Error_Number(void)
{
return old.MSP430_Error_Number();
}
static const char *old_Error_String(long errNumber)
{
return old.MSP430_Error_String(errNumber);
}
static STATUS_T old_GetNumberOfUsbIfs(long* number)
{
return old.MSP430_GetNumberOfUsbIfs(number);
}
static STATUS_T old_GetNameOfUsbIf(long idx, char **name, long *status)
{
return old.MSP430_GetNameOfUsbIf(idx, name, status);
}
static STATUS_T old_Registers(long *registers, long mask, long rw)
{
return old.MSP430_Registers(registers, mask, rw);
}
static STATUS_T old_Run(long mode, long releaseJTAG)
{
return old.MSP430_Run(mode, releaseJTAG);
}
static STATUS_T old_State(long *state, long stop, long *pCPUCycles)
{
return old.MSP430_State(state, stop, pCPUCycles);
}
static STATUS_T old_EEM_Init(DLL430_EVENTNOTIFY_FUNC callback,
long clientHandle, MessageID_t *pMsgIdBuffer)
{
return old.MSP430_EEM_Init(callback, clientHandle, pMsgIdBuffer);
}
static STATUS_T old_EEM_SetBreakpoint(uint16_t *pwBpHandle,
BpParameter_t *pBpBuffer)
{
return old.MSP430_EEM_SetBreakpoint(pwBpHandle, pBpBuffer);
}
static STATUS_T old_FET_FwUpdate(char* lpszFileName,
DLL430_FET_NOTIFY_FUNC callback,
long clientHandle)
{
return old.MSP430_FET_FwUpdate(lpszFileName, callback, clientHandle);
}
static const struct tilib_api_table old_tab = {
.MSP430_Initialize = old_Initialize,
.MSP430_VCC = old_VCC,
.MSP430_Configure = old_Configure,
.MSP430_OpenDevice = old_OpenDevice,
.MSP430_GetFoundDevice = old_GetFoundDevice,
.MSP430_Close = old_Close,
.MSP430_Memory = old_Memory,
.MSP430_Reset = old_Reset,
.MSP430_Erase = old_Erase,
.MSP430_Secure = old_Secure,
.MSP430_Error_Number = old_Error_Number,
.MSP430_Error_String = old_Error_String,
.MSP430_GetNumberOfUsbIfs = old_GetNumberOfUsbIfs,
.MSP430_GetNameOfUsbIf = old_GetNameOfUsbIf,
.MSP430_Registers = old_Registers,
.MSP430_Run = old_Run,
.MSP430_State = old_State,
.MSP430_EEM_Init = old_EEM_Init,
.MSP430_EEM_SetBreakpoint = old_EEM_SetBreakpoint,
.MSP430_FET_FwUpdate = old_FET_FwUpdate,
};
static int init_old_api(void)
{
if (!(old.MSP430_Initialize = get_func("MSP430_Initialize")))
return -1;
if (!(old.MSP430_VCC = get_func("MSP430_VCC")))
return -1;
if (!(old.MSP430_Configure = get_func("MSP430_Configure")))
return -1;
if (!(old.MSP430_OpenDevice = get_func("MSP430_OpenDevice")))
return -1;
if (!(old.MSP430_GetFoundDevice = get_func("MSP430_GetFoundDevice")))
return -1;
if (!(old.MSP430_Close = get_func("MSP430_Close")))
return -1;
if (!(old.MSP430_Memory = get_func("MSP430_Memory")))
return -1;
if (!(old.MSP430_Reset = get_func("MSP430_Reset")))
return -1;
if (!(old.MSP430_Erase = get_func("MSP430_Erase")))
return -1;
if (!(old.MSP430_Secure = get_func("MSP430_Secure")))
return -1;
if (!(old.MSP430_Error_Number = get_func("MSP430_Error_Number")))
return -1;
if (!(old.MSP430_Error_String = get_func("MSP430_Error_String")))
return -1;
if (!(old.MSP430_GetNumberOfUsbIfs =
get_func("MSP430_GetNumberOfUsbIfs")))
return -1;
if (!(old.MSP430_GetNameOfUsbIf = get_func("MSP430_GetNameOfUsbIf")))
return -1;
if (!(old.MSP430_Registers = get_func("MSP430_Registers")))
return -1;
if (!(old.MSP430_Run = get_func("MSP430_Run")))
return -1;
if (!(old.MSP430_State = get_func("MSP430_State")))
return -1;
if (!(old.MSP430_EEM_Init = get_func("MSP430_EEM_Init")))
return -1;
if (!(old.MSP430_EEM_SetBreakpoint =
get_func("MSP430_EEM_SetBreakpoint")))
return -1;
if (!(old.MSP430_FET_FwUpdate = get_func("MSP430_FET_FwUpdate")))
return -1;
tilib_api = &old_tab;
return 0;
}
/************************************************************************
* Top-level init
*/
int tilib_api_init(void)
{
lib_handle = dynload_open(tilib_filename);
if (!lib_handle) {
printc_err("tilib_api: can't find %s: %s\n",
tilib_filename, dynload_error());
return -1;
}
if (init_old_api() < 0) {
dynload_close(lib_handle);
return -1;
}
return 0;
}
void tilib_api_exit(void)
{
dynload_close(lib_handle);
}

73
drivers/tilib_api.h Normal file
View File

@ -0,0 +1,73 @@
/* MSPDebug - debugging tool for MSP430 MCUs
* Copyright (C) 2009-2015 Daniel Beer
*
* 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 St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef TILIB_API_H_
#define TILIB_API_H_
#include "tilib_defs.h"
struct tilib_api_table {
/* MSP430.h */
STATUS_T (*MSP430_Initialize)(char *port, long *version);
STATUS_T (*MSP430_VCC)(long voltage);
STATUS_T (*MSP430_Configure)(long mode, long value);
STATUS_T (*MSP430_OpenDevice)(char *Device, char *Password,
long PwLength, long DeviceCode,
long setId);
STATUS_T (*MSP430_GetFoundDevice)(char *FoundDevice,
long count);
STATUS_T (*MSP430_Close)(long vccOff);
STATUS_T (*MSP430_Memory)(long address, char *buffer,
long count, long rw);
STATUS_T (*MSP430_Reset)(long method, long execute,
long releaseJTAG);
STATUS_T (*MSP430_Erase)(long type, long address, long length);
STATUS_T (*MSP430_Secure)(void);
STATUS_T (*MSP430_Error_Number)(void);
const char *(*MSP430_Error_String)(long errNumber);
STATUS_T (*MSP430_GetNumberOfUsbIfs)(long* number);
STATUS_T (*MSP430_GetNameOfUsbIf)(long idx, char **name,
long *status);
/* MSP430_Debug.h */
STATUS_T (*MSP430_Registers)(long *registers, long mask,
long rw);
STATUS_T (*MSP430_Run)(long mode, long releaseJTAG);
STATUS_T (*MSP430_State)(long *state, long stop,
long *pCPUCycles);
/* MSP430_EEM.h */
STATUS_T (*MSP430_EEM_Init)(DLL430_EVENTNOTIFY_FUNC callback,
long clientHandle,
MessageID_t *pMsgIdBuffer);
STATUS_T (*MSP430_EEM_SetBreakpoint)(uint16_t *pwBpHandle,
BpParameter_t *pBpBuffer);
/* MSP430_FET.h */
STATUS_T (*MSP430_FET_FwUpdate)(char* lpszFileName,
DLL430_FET_NOTIFY_FUNC callback,
long clientHandle);
};
extern const struct tilib_api_table *tilib_api;
int tilib_api_init(void);
void tilib_api_exit(void);
#endif