Skip to content

Commit b93d6e8

Browse files
authored
Merge pull request adafruit#2596 from hierophect/stm32-espruino-pico
STM32: Espruino Pico
2 parents 2b8f9b2 + 41b5f73 commit b93d6e8

File tree

13 files changed

+694
-4
lines changed

13 files changed

+694
-4
lines changed

.github/workflows/build.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,7 @@ jobs:
146146
- "electronut_labs_blip"
147147
- "electronut_labs_papyr"
148148
- "escornabot_makech"
149+
- "espruino_pico"
149150
- "feather_bluefruit_sense"
150151
- "feather_m0_adalogger"
151152
- "feather_m0_basic"
Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
/*
2+
GNU linker script for STM32F401 with bootloader (such as the Meowbit)
3+
*/
4+
5+
/* Specify the memory areas */
6+
MEMORY
7+
{
8+
FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 384K /* entire flash */
9+
FLASH_ISR (rx) : ORIGIN = 0x08000000, LENGTH = 16K /* sector 0 */
10+
FLASH_FS (rx) : ORIGIN = 0x08004000, LENGTH = 48K /* sectors 1,2,3 are 16K */
11+
FLASH_TEXT (rx) : ORIGIN = 0x08010000, LENGTH = 320K /* sector 4 is 64K, sectors 5,6,7 are 128K */
12+
RAM (xrw) : ORIGIN = 0x20000000, LENGTH = 96K
13+
}
14+
15+
/* produce a link error if there is not this amount of RAM for these sections */
16+
_minimum_stack_size = 2K;
17+
_minimum_heap_size = 16K;
18+
19+
/* Define tho top end of the stack. The stack is full descending so begins just
20+
above last byte of RAM. Note that EABI requires the stack to be 8-byte
21+
aligned for a call. */
22+
_estack = ORIGIN(RAM) + LENGTH(RAM);
23+
24+
/* RAM extents for the garbage collector */
25+
_ram_start = ORIGIN(RAM);
26+
_ram_end = ORIGIN(RAM) + LENGTH(RAM);
27+
28+
ENTRY(Reset_Handler)
29+
30+
/* define output sections */
31+
SECTIONS
32+
{
33+
/* The startup code goes first into FLASH */
34+
.isr_vector :
35+
{
36+
. = ALIGN(4);
37+
KEEP(*(.isr_vector)) /* Startup code */
38+
39+
/* This first flash block is 16K annd the isr vectors only take up
40+
about 400 bytes. Micropython pads this with files, but this didn't
41+
work with the size of Circuitpython's ff object. */
42+
43+
. = ALIGN(4);
44+
} >FLASH_ISR
45+
46+
/* The program code and other data goes into FLASH */
47+
.text :
48+
{
49+
. = ALIGN(4);
50+
*(.text*) /* .text* sections (code) */
51+
*(.rodata*) /* .rodata* sections (constants, strings, etc.) */
52+
/* *(.glue_7) */ /* glue arm to thumb code */
53+
/* *(.glue_7t) */ /* glue thumb to arm code */
54+
55+
. = ALIGN(4);
56+
_etext = .; /* define a global symbol at end of code */
57+
} >FLASH_TEXT
58+
59+
/* used by the startup to initialize data */
60+
_sidata = LOADADDR(.data);
61+
62+
/* This is the initialized data section
63+
The program executes knowing that the data is in the RAM
64+
but the loader puts the initial values in the FLASH (inidata).
65+
It is one task of the startup to copy the initial values from FLASH to RAM. */
66+
.data :
67+
{
68+
. = ALIGN(4);
69+
_sdata = .; /* create a global symbol at data start; used by startup code in order to initialise the .data section in RAM */
70+
*(.data*) /* .data* sections */
71+
72+
. = ALIGN(4);
73+
_edata = .; /* define a global symbol at data end; used by startup code in order to initialise the .data section in RAM */
74+
} >RAM AT> FLASH_TEXT
75+
76+
/* Uninitialized data section */
77+
.bss :
78+
{
79+
. = ALIGN(4);
80+
_sbss = .; /* define a global symbol at bss start; used by startup code */
81+
*(.bss*)
82+
*(COMMON)
83+
84+
. = ALIGN(4);
85+
_ebss = .; /* define a global symbol at bss end; used by startup code and GC */
86+
} >RAM
87+
88+
/* this is to define the start of the heap, and make sure we have a minimum size */
89+
.heap :
90+
{
91+
. = ALIGN(4);
92+
. = . + _minimum_heap_size;
93+
. = ALIGN(4);
94+
} >RAM
95+
96+
/* this just checks there is enough RAM for the stack */
97+
.stack :
98+
{
99+
. = ALIGN(4);
100+
. = . + _minimum_stack_size;
101+
. = ALIGN(4);
102+
} >RAM
103+
104+
.ARM.attributes 0 : { *(.ARM.attributes) }
105+
}
106+
107+
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Flashing the Espruino Pico
2+
3+
The Espruino Pico is normally updated via a bootloader activated by the Espruino web app. This approach is not practical for Circuitpython as it takes too much space from the internal filesystem - thus, you will need to follow the instructions for advanced reflashing using the built-in ROM bootloader on all STM32F4 MCUs (instructions sourced from https://www.espruino.com/Pico#advanced-reflashing)
4+
5+
- Short out the BOOT0/BTN solder jumper on the back of the board - you can do this by drawing over it with a pencil.
6+
- Install ST's DFU utility on Windows, or dfu-util for Mac or Linux
7+
- **Mac**: install with Homebrew: `brew install dfu-util`
8+
- **Linux**: install with apt-get: `sudo apt-get install dfu-util`
9+
- **Windows**: download [ST's application](https://www.st.com/en/development-tools/stsw-stm32080.html) or install the Linux subsystem for Windows 10 and follow the linux instructions.
10+
- Hold down the Pico's button while plugging it into USB (when overwriting Espruino's default firmware)
11+
- Navigate to the same directory as your firmware.bin file for Circuitpython and run the following command: `sudo dfu-util -a 0 -s 0x08000000 -D firmware.bin` or use the ST utility on Windows.
12+
- Restart the board.
13+
14+
15+
To reinstall Espruino, follow the same steps with the latest Espruino Pico binary from espruino.com/binaries. This will reinstall the usual Espruino bootloader. You must un-short the BOOT0/BTN jumper to re-use the original Espruino Bootloader again. If you used a Pencil mark then you may need to use cleaning fluid and a small brush to totally clear out the graphite.
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
/*
2+
* This file is part of the MicroPython project, http://micropython.org/
3+
*
4+
* The MIT License (MIT)
5+
*
6+
* Copyright (c) 2017 Scott Shawcroft for Adafruit Industries
7+
*
8+
* Permission is hereby granted, free of charge, to any person obtaining a copy
9+
* of this software and associated documentation files (the "Software"), to deal
10+
* in the Software without restriction, including without limitation the rights
11+
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12+
* copies of the Software, and to permit persons to whom the Software is
13+
* furnished to do so, subject to the following conditions:
14+
*
15+
* The above copyright notice and this permission notice shall be included in
16+
* all copies or substantial portions of the Software.
17+
*
18+
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19+
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20+
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21+
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22+
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23+
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24+
* THE SOFTWARE.
25+
*/
26+
27+
#include "boards/board.h"
28+
#include "mpconfigboard.h"
29+
30+
void board_init(void) {
31+
}
32+
33+
bool board_requests_safe_mode(void) {
34+
return false;
35+
}
36+
37+
void reset_board(void) {
38+
39+
}
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
/*
2+
* This file is part of the MicroPython project, http://micropython.org/
3+
*
4+
* The MIT License (MIT)
5+
*
6+
* Copyright (c) 2019 Lucian Copeland for Adafruit Industries
7+
*
8+
* Permission is hereby granted, free of charge, to any person obtaining a copy
9+
* of this software and associated documentation files (the "Software"), to deal
10+
* in the Software without restriction, including without limitation the rights
11+
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12+
* copies of the Software, and to permit persons to whom the Software is
13+
* furnished to do so, subject to the following conditions:
14+
*
15+
* The above copyright notice and this permission notice shall be included in
16+
* all copies or substantial portions of the Software.
17+
*
18+
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19+
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20+
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21+
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22+
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23+
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24+
* THE SOFTWARE.
25+
*/
26+
27+
//Micropython setup
28+
29+
#define MICROPY_HW_BOARD_NAME "Espruino Pico"
30+
#define MICROPY_HW_MCU_NAME "STM32F401xD"
31+
32+
#define FLASH_SIZE (0x60000)
33+
#define FLASH_PAGE_SIZE (0x4000)
34+
35+
#define AUTORESET_DELAY_MS 500
36+
#define BOARD_FLASH_SIZE (FLASH_SIZE - 0x4000)
37+
38+
#define BOARD_OSC_DIV 8
39+
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
USB_VID = 0x239A
2+
USB_PID = 0x808E
3+
USB_PRODUCT = "Espruino Pico"
4+
USB_MANUFACTURER = "Espruino"
5+
USB_DEVICES = "CDC,MSC"
6+
7+
INTERNAL_FLASH_FILESYSTEM = 1
8+
LONGINT_IMPL = NONE
9+
10+
MCU_SERIES = m4
11+
MCU_VARIANT = stm32f4
12+
MCU_SUB_VARIANT = stm32f401xe
13+
MCU_PACKAGE = 48
14+
CMSIS_MCU = STM32F401xE
15+
LD_FILE = boards/STM32F401xd_fs.ld # use for internal flash
16+
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
#include "shared-bindings/board/__init__.h"
2+
3+
STATIC const mp_rom_map_elem_t board_module_globals_table[] = {
4+
{ MP_ROM_QSTR(MP_QSTR_B15), MP_ROM_PTR(&pin_PB15) },
5+
{ MP_ROM_QSTR(MP_QSTR_B14), MP_ROM_PTR(&pin_PB14) },
6+
{ MP_ROM_QSTR(MP_QSTR_B13), MP_ROM_PTR(&pin_PB13) },
7+
{ MP_ROM_QSTR(MP_QSTR_B10), MP_ROM_PTR(&pin_PB10) },
8+
{ MP_ROM_QSTR(MP_QSTR_B1), MP_ROM_PTR(&pin_PB01) },
9+
{ MP_ROM_QSTR(MP_QSTR_A7), MP_ROM_PTR(&pin_PA07) },
10+
{ MP_ROM_QSTR(MP_QSTR_A6), MP_ROM_PTR(&pin_PA06) },
11+
{ MP_ROM_QSTR(MP_QSTR_A5), MP_ROM_PTR(&pin_PA05) },
12+
13+
{ MP_ROM_QSTR(MP_QSTR_B3), MP_ROM_PTR(&pin_PB03) },
14+
{ MP_ROM_QSTR(MP_QSTR_B4), MP_ROM_PTR(&pin_PB04) },
15+
{ MP_ROM_QSTR(MP_QSTR_B5), MP_ROM_PTR(&pin_PB05) },
16+
{ MP_ROM_QSTR(MP_QSTR_B6), MP_ROM_PTR(&pin_PB06) },
17+
{ MP_ROM_QSTR(MP_QSTR_B7), MP_ROM_PTR(&pin_PB07) },
18+
{ MP_ROM_QSTR(MP_QSTR_A8), MP_ROM_PTR(&pin_PA08) },
19+
20+
{ MP_ROM_QSTR(MP_QSTR_A4), MP_ROM_PTR(&pin_PA04) },
21+
{ MP_ROM_QSTR(MP_QSTR_A3), MP_ROM_PTR(&pin_PA03) },
22+
{ MP_ROM_QSTR(MP_QSTR_A2), MP_ROM_PTR(&pin_PA02) },
23+
{ MP_ROM_QSTR(MP_QSTR_A1), MP_ROM_PTR(&pin_PA01) },
24+
{ MP_ROM_QSTR(MP_QSTR_A0), MP_ROM_PTR(&pin_PA00) },
25+
{ MP_ROM_QSTR(MP_QSTR_A10), MP_ROM_PTR(&pin_PA10) },
26+
{ MP_ROM_QSTR(MP_QSTR_B9), MP_ROM_PTR(&pin_PB09) },
27+
{ MP_ROM_QSTR(MP_QSTR_B8), MP_ROM_PTR(&pin_PB08) },
28+
29+
{ MP_ROM_QSTR(MP_QSTR_BTN), MP_ROM_PTR(&pin_PC13) },
30+
{ MP_ROM_QSTR(MP_QSTR_LED1), MP_ROM_PTR(&pin_PB02) },
31+
{ MP_ROM_QSTR(MP_QSTR_LED2), MP_ROM_PTR(&pin_PB12) },
32+
};
33+
MP_DEFINE_CONST_DICT(board_module_globals, board_module_globals_table);

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy