blackmagic-sys 0.1.0

Bindings to Blackmagic-debug host functions
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

/*
 * This file is part of the Black Magic Debug project.
 *
 * Copyright (C) 2016 Gareth McMullin <gareth@blacksphere.co.nz>
 *
 * 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/>.
 */

#ifndef TARGET_LPC_COMMON_H
#define TARGET_LPC_COMMON_H

#include <stdint.h>
#include "target_internal.h"

typedef enum iap_cmd {
	IAP_CMD_READ_FACTORY_SETTINGS = 40,
	IAP_CMD_INIT = 49,
	IAP_CMD_PREPARE = 50,
	IAP_CMD_PROGRAM = 51,
	IAP_CMD_ERASE = 52,
	IAP_CMD_BLANKCHECK = 53,
	IAP_CMD_PARTID = 54,
	IAP_CMD_READ_BOOTROM_VERSION = 55,
	IAP_CMD_COMPARE = 56,
	IAP_CMD_REINVOKE_ISP = 57,
	IAP_CMD_READUID = 58,
	IAP_CMD_ERASE_PAGE = 59,
	IAP_CMD_SET_ACTIVE_BANK = 60,
	IAP_CMD_READ_SIGNATURE = 70,
	IAP_CMD_EXTENDED_READ_SIGNATURE = 73,
	IAP_CMD_READ_EEPROM_PAGE = 80,
	IAP_CMD_WRITE_EEPROM_PAGE = 81,
} iap_cmd_e;

typedef enum iap_status {
	IAP_STATUS_CMD_SUCCESS = 0,
	IAP_STATUS_INVALID_COMMAND = 1,
	IAP_STATUS_SRC_ADDR_ERROR = 2,
	IAP_STATUS_DST_ADDR_ERROR = 3,
	IAP_STATUS_SRC_ADDR_NOT_MAPPED = 4,
	IAP_STATUS_DST_ADDR_NOT_MAPPED = 5,
	IAP_STATUS_COUNT_ERROR = 6,
	IAP_STATUS_INVALID_SECTOR = 7,
	IAP_STATUS_SECTOR_NOT_BLANK = 8,
	IAP_STATUS_SECTOR_NOT_PREPARED = 9,
	IAP_STATUS_COMPARE_ERROR = 10,
	IAP_STATUS_BUSY = 11,
	IAP_STATUS_MISSING_PARAMETERS = 12,
	IAP_STATUS_UNALIGNED_ADDRESS = 13,
	IAP_STATUS_ADDRESS_NOT_MAPPED = 14,
	IAP_STATUS_FRO_NO_POWER = 23,
	IAP_STATUS_FLASH_NO_POWER = 24,
	IAP_STATUS_NO_CLOCK = 27,
	IAP_STATUS_REINVOKE_CFG_ERR = 28,
	IAP_STATUS_NO_VALID_IMAGE = 29,
	IAP_STATUS_FLASH_ERASE = 32,
	IAP_STATUS_INVALID_PAGE = 33,
} iap_status_e;

typedef struct iap_result {
	uint32_t return_code;
	uint32_t values[4];
} iap_result_s;

/* CPU Frequency */
#define CPU_CLK_KHZ 12000U

typedef struct lpc_flash {
	target_flash_s f;
	uint8_t base_sector;
	uint8_t bank;
	uint8_t reserved_pages;
	/* Info filled in by specific driver */
	void (*wdt_kick)(target_s *t);
	uint32_t iap_entry;
	uint32_t iap_ram;
	uint32_t iap_msp;
} lpc_flash_s;

lpc_flash_s *lpc_add_flash(target_s *target, target_addr_t addr, size_t length, size_t write_size);
iap_status_e lpc_iap_call(lpc_flash_s *flash, iap_result_s *result, iap_cmd_e cmd, ...);
bool lpc_flash_erase(target_flash_s *f, target_addr_t addr, size_t len);
bool lpc_flash_write_magic_vect(target_flash_s *f, target_addr_t dest, const void *src, size_t len);

#endif /* TARGET_LPC_COMMON_H */