MecrispCubeH74x < MecrispCube

%DASHBOARD{ section="dashboard_start" }%
%DASHBOARD{ section="banner"
 image="%PUBURLPATH%/MecrispCube/MecrispCubeH74x/NUCLEO-H743ZI2-header.jpg"
 title="Mecrisp-Cube for the !STM32H74x Powerhouse"
 titlestyle="color:#F00000;"
}%
%DASHBOARD{ section="box_start" title="Intro !MecrispCubeH74x" width="485" height="300"}%
DRAFT

New flavors for Mecrisp-Cube: 
   * _MecrispCubeH743_ for [[https://www.st.com/en/evaluation-tools/nucleo-h743zi.html][STM's NUCLEO-H743ZI]]
   * _MecrispCubeH747_ for [[https://docs.arduino.cc/hardware/portenta-h7][Arduino Portenta H7 Development Board]]

If you need a really fast MCU (ARM Cortex M7 @ 480 MHz) then the MecrispCubeH74x could be the right Mecrisp-Cube Forth for you. The !STM32H747 has even a second Core, a Cortex M4.

[[WebHome][Mecrisp-Cube]] Instant real-time programming with Forth.


Sources on 
   * [[https://github.com/spyren/Mecrisp-Cube/tree/H743][GitHub]] (H743 branch on Mecrisp-Cube)
   * [[https://github.com/spyren/Mecrisp-Cube/tree/H747][GitHub]] (H747 branch on Mecrisp-Cube)


%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="box_start" title="Contents" width="460" height="300"}%
%TOC%
%DASHBOARD{ section="box_end" }%
%DASHBOARD{ section="box_start"  width="992" height="300" }%
---+ Features
  
The standard [[WebHome#Already_done][Mecrisp-Cube features]] like RTOS, Filesystem, USB, etc.

   * 288 !KiB RAM dictionary 
   * 1 !MiB Flash dictionary, because of the fragmentation (32 byte instead of 16 byte blocks) the flash words needs about 30 % more memory.
   * Internal Flash drive 0:, 16 !MiB (external, Portenta has it on board)
   * microSD drive 1: on Breakout Board

   * BSPs
      * [[BoardSupportPackageH743][NUCLEO-H743ZI]]
      * [[BoardSupportPackageH747][Arduino Portenta H7]]

   * TCP/IP
      * Telnet ;-)


%DASHBOARD{ section="box_end" }%

%DASHBOARD{ section="box_start"  width="992" height="600" }%
---+  Getting Started

These instructions will get you a copy of the project up and running on your local 
machine (STM's NUCLEO-H743ZI board) for development and testing purposes. 

---++ Prerequisites

   * [[https://www.st.com/en/evaluation-tools/nucleo-h743zi.html][STM's NUCLEO-H743ZI]] 
   * Terminal emulator application for PC, e.g.: 
      * [[http://www.putty.org/][PuTTY]] - Windows and Linux
      * [[http://en.sourceforge.jp/projects/ttssh2/][Tera Term]] - Windows
      * [[http://realterm.sourceforge.net/][Realterm]] - Windows
      * minicom, microcom, screen - Linux
      * Use the built in Eclipse console (but no LF)
 
Flash the Mecrisp-Cube [[https://github.com/spyren/Mecrisp-Cube/raw/H743/Release/MecrispCubeH743.bin][binary]] (=MecrispCubeH743.bin=) or the [[https://github.com/spyren/Mecrisp-Cube/raw/H743/sdcard/boot/MecrispCubeH743Util.bin][util-binary]] (=MecrispCubeH743Util.bin=) to the Feather Board.

   1. Connect the Nucleo Board USB ST-LINK to the PC 
   2. Copy the [[https://github.com/spyren/Mecrisp-Cube/raw/H743/Release/MecrispCubeH743.bin][binary]] or the [[https://github.com/spyren/Mecrisp-Cube/raw/H743/sdcard/boot/MecrispCubeH743Util.bin][util-binary]] to the USB mass storage NODE_H743

Start the terminal emulator application on the PC. 
Check for the serial communication port (e.g. for Linux =/dev/ttyACM0=).
I set the putty terminal configuration to 

   * Implicit CR in every LF 
   * Local echo: Auto
   * Local line editing: Auto
   * Keyboard Backspace: Control-H
   * Keyboard Function: Keys VT100
   * Remote character set: CP850

<pre>
Mecrisp-Stellaris RA 2.5.4 by Matthias Koch.

Mecrisp-Cube 1.5.0 for STM32H7 Nucleo, 288/1024  KiB RAM/FLASH dictionary (C) 2022 peter@spyr.ch
  * Firmware Package STM32Cube H7 V1.10.0, USB-CDC (C) 2021 STMicroelectronics
  * CMSIS-RTOS V2 FreeRTOS wrapper, FreeRTOS Kernel V10.3.1 (C) 2020 Amazon.com
  * FatFs for internal flash and microSD - Generic FAT fs module  R0.12c (C) 2017 ChaN
  * tiny vi - part of BusyBox (C) 2000, 2001 Sterling HuxleyMecrisp-Cube 1.4.3 for STM32F405, 31/768 KiB RAM/FLASH dictionary (C) 2021 peter@spyr.ch
  * Firmware Package STM32Cube F4 V1.26.0, USB-CDC (C) 2021 STMicroelectronics
  * CMSIS-RTOS V2 FreeRTOS wrapper, FreeRTOS Kernel V10.3.1 (C) 2020 Amazon.com
  * FatFs for serial flash and microSD - Generic FAT fs module  R0.12c (C) 2017 ChaN
  * tiny vi - part of BusyBox (C) 2000, 2001 Sterling Huxley

include 0:/etc/rc.local

<b>23 5 / .[CR]</b> 4  ok.
<b>: hello ." World" ;[CR]</b>  ok.
<b>hello[CR]</b> World ok.
</pre>


---++ Additional Tools and Local Filesystem
Populate a microSD with the contents of [[https://github.com/spyren/Mecrisp-Cube/tree/F743/sdcard][sdcard]]. Put the microSD into the H743 slot and reset or power cycle the board.

The directory should look like this:
<pre>
<b>ls -l 1:[CR]</b>
drw-         0 2021-04-18T18:12:38 boot
drw-         0 2021-03-21T18:47:52 etc
drw-         0 2021-03-21T18:47:54 fsr
drw-         0 2021-03-21T18:47:54 home
drw-         0 2021-03-21T18:47:56 man
-rwa      7219 2021-01-08T19:42:36 README.md
ok.
</pre>

You can use the local CLI commands like =mkfs=, =mkdir= and =cp= to create a filesystem on the serial flash and fill it with files and folders. But this is tedious job because I haven't yet implemented a recursive copy for !MecrispCube. But there is prepared disk image 
(for details see MicroSdBlocks#Serial_Flash) on microSD and the tool =dd=. You can copy the disk image to the drive 0: (this takes about 2 Minutes):
<pre>
<b>dd 1:/boot/fd-2MiB.img 0:[CR]</b>
 ok.
<b>mount 0:[CR]</b>
 ok.
<b>ls 0:[CR]</b>
man                     fsr                     README.md               boot
etc                     home
 ok.
</pre>

The Mecrisp have some tools bundled in its distribution e.g. assembler, disassembler, dump, float. I put those tools and some more into the folder =/fsr=. With the "init.fs script" I compile my favorite ones into the flash directory:
<pre>
<b>compiletoflash[CR]</b>  ok.
<b>include /etc/init.fs[CR]</b>
init.fs Loading started
RAM Dictionary: 392991 KiB
utils.fs loading ...
conditional.fs loading ...
dump.fs loading ...
disassembler-m3.fs loading ...
float.fs loading ...
threads.fs loading ...
RAM Dictionary: 392981 KiB
init.fs finished  ok.
</pre>

For example, the word disassember is available now:
<pre>
<b>see dump[CR]</b>
080405F0: B500  push { lr }
080405F2: F7C2  bl  08002A3E  --> cr
080405F4: FA24
080405F6: CF08  ldmia r7 { r3 }
080405F8: F013  ands r2 r3 #F
080405FA: 020F
080405FC: F847  str r3 [ r7 #-4 ]!
080405FE: 3D04
08040600: 2A00  cmp r2 #0
08040602: D000  beq 08040606
08040604: 3610  adds r6 #10
08040606: CF08  ldmia r7 { r3 }
08040608: F847  str r6 [ r7 #-4 ]!
</pre>


---++ Installing

A step by step series of examples that tell you how to get a development env running

Install the IDE [[https://www.st.com/en/development-tools/stm32cubeide.html][STM32CubeIDE]], 
it is Eclipse and GCC based. 
[[https://www.st.com/en/development-tools/stm32cubemx.html][STM32CubeMX]]
is included in the IDE, you need a stand alone installation only if 
you do not want to use the !STM32CubeIDE.  

Get the sources from github:

<pre>
psi@homer:~> <b>git clone --branch H743 https://github.com/spyren/Mecrisp-Cube</b>
Cloning into 'Mecrisp-Cube'...
remote: Enumerating objects: 4969, done.
remote: Counting objects: 100% (47/47), done.
remote: Compressing objects: 100% (34/34), done.
remote: Total 4969 (delta 13), reused 47 (delta 13), pack-reused 4922
Receiving objects: 100% (4969/4969), 69.43 MiB | 3.54 MiB/s, done.
Resolving deltas: 100% (3481/3481), done.
Updating files: 100% (213/213), done.
</pre>

Import the project into the IDE:

<pre>
File -> Import -> General -> Existing Projects into Workspace -> Select root directory
Copy project into workspace
Browse to Mecrisp-Cube directory
</pre>

Generate code from the !STM32CubeMX =MecrispCubeH743.ioc= file:
<pre>
Project -> Generate Code 
</pre>

Restore changed source files
<pre>
$ git status
{list of changed files}
$ git restore {files to restore} 
</pre>


Select the Build Configuration (Debug if you want to debug the project) and Build the project:
<pre>
Project -> Build Configurations -> Set Active -> Debug/Release 
Project -> Build Project
</pre>


%DASHBOARD{ section="box_end" }%

%DASHBOARD{ section="box_start"  width="992" height="600" }%
---+ !STM32H7 Development Boards

---++ !STM32H743 H743ZI2 Nucleo Board

%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/NUCLEO-H743ZI2.jpg" type="thumb" caption=""}%

   * https://www.st.com/en/microcontrollers-microprocessors/stm32h743zi.html
   * https://os.mbed.com/platforms/ST-Nucleo-H743ZI2/
   * [[https://www.st.com/content/ccc/resource/technical/layouts_and_diagrams/schematic_pack/group1/79/99/be/65/3c/76/40/d6/MB1364-H743ZI-C01_Schematic/files/MB1364-H743ZI-C01_Schematic.pdf/jcr:content/translations/en.MB1364-H743ZI-C01_Schematic.pdf][Schematic Nucleo Board MB1364E]]
   * https://www.st.com/en/microcontrollers-microprocessors/stm32h743-753.html

   * [[https://www.circuito.io/blog/arduino-uno-pinout/][Arduino Uno Pinout Guide]]

%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/pinout_legend_2017-06-28-2.png" type="thumb" caption="Pinout Legend"}%

%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/nucleo_h743zi2_zio_left_2019_10_9.png" type="thumb" caption="ZIO/Arduino CN8 CN9 left"}%
%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/nucleo_h743zi2_zio_right_2019_10_9.png" type="thumb" caption="ZIO/Arduino CN7 CN10 right"}%
%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/nucleo_h743zi2_morpho_left_2019_10_9.png" type="thumb" caption="Morpho CN11 left"}%
%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/nucleo_h743zi2_morpho_right_2019_10_9.png" type="thumb" caption="Morpho CN12 right"}%


---++ !STM32H747 Arduino Portenta H7 Development Board

This Arduino Portenta H7 development board follows the Arduino MKR form factor, but enhanced with the Portenta family 80 pin high-density connector. 

Why should I use this board? It is less powerful than a Raspberry Pi and is even more expensive! The Raspi draws much more current and therefore cannot be operated with a battery. 

No Board Support Package yet.

https://docs.arduino.cc/hardware/portenta-h7

%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/portenta-h7-pinout.png" type="thumb" caption="Portenta H7 Pinout"}%

[[https://content.arduino.cc/assets/Arduino-PortentaH7-schematic-V1.0.pdf][Schematics]]

The much smaller board [[https://docs.arduino.cc/hardware/nicla-vision][Arduino Nicla Vision]] equipped with a 2MP camera.
%IMAGE{"%PUBURLPATH%/MecrispCube/MecrispCubeH74x/Arduino-Nicla-Vision.webp" type="thumb" caption=""}%


---++ Wio Lite AI Single Board

No Board Support Package yet.

   * https://www.seeedstudio.com/Wio-Lite-AI-Single-Board-p-5120.html
%DASHBOARD{ section="box_end" }%

%DASHBOARD{ section="dashboard_end" }%


-- %USERSIG{PeterSchmid - 2022-03-04}%

<a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a><br />This work by <a xmlns:cc="http://creativecommons.org/ns#" href="http://spyr.ch" property="cc:attributionName" rel="cc:attributionURL">Peter Schmid</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>.
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who
png	ABX00042-pinout.png	r1	manage	372.1 K	2022-03-06 - 15:41	PeterSchmid
webp	ABX00045_02.front_1000x750.webp	r1	manage	118.2 K	2022-03-06 - 15:41	PeterSchmid
webp	Arduino-Nicla-Vision.webp	r1	manage	178.9 K	2022-06-26 - 21:10	PeterSchmid
jpg	NUCLEO-H743ZI2-header.jpg	r1	manage	84.3 K	2022-03-06 - 15:04	PeterSchmid
jpg	NUCLEO-H743ZI2.jpg	r1	manage	1692.9 K	2022-03-06 - 15:04	PeterSchmid
png	nucleo_h743zi2_morpho_left_2019_10_9.png	r1	manage	458.5 K	2022-03-06 - 17:14	PeterSchmid
png	nucleo_h743zi2_morpho_right_2019_10_9.png	r1	manage	399.1 K	2022-03-06 - 17:14	PeterSchmid
png	nucleo_h743zi2_zio_left_2019_10_9.png	r1	manage	498.7 K	2022-03-06 - 17:14	PeterSchmid
png	nucleo_h743zi2_zio_right_2019_10_9.png	r1	manage	423.5 K	2022-03-06 - 17:14	PeterSchmid
png	pinout_legend_2017-06-28-2.png	r1	manage	33.9 K	2022-03-06 - 17:14	PeterSchmid
png	portenta-h7-pinout.png	r1	manage	372.1 K	2022-06-09 - 19:49	PeterSchmid
This topic: MecrispCube > WebHome > MecrispCubeH74x
Topic revision: r22 - 2022-12-28 - PeterSchmid