From c1d9ff29a3da95a136fb7d937f640b85d2cd2b9d Mon Sep 17 00:00:00 2001 From: stefan-b-jakobsson Date: Wed, 26 Jun 2024 20:57:24 +0300 Subject: [PATCH 1/5] Add SMC recovery with Mac OS + minipro + T48 --- README.md | 1 + X16 Reference - 15 - Upgrade Guide.md | 2 +- ...ence - Appendix G - SMC recovery Mac OS.md | 61 +++++++++++++++++++ 3 files changed, 63 insertions(+), 1 deletion(-) create mode 100644 X16 Reference - Appendix G - SMC recovery Mac OS.md diff --git a/README.md b/README.md index 4f3aca7..d8a01b5 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,7 @@ first. * [Appendix D: Official Expansion Cards](X16%20Reference%20-%20Appendix%20D%20-%20Official%20Expansion%20Cards.md#appendix-d-official-expansion-cards) * [Appendix E: Diagnostic Bank](X16%20Reference%20-%20Appendix%20E%20-%20Diagnostic%20Bank.md#appendix-e-diagnostic-bank) * [Appendix F: The 65C816 Processor](X16%20Reference%20-%20Appendix%20F%20-%2065C816%20Processor.md#appendix-f-the-65c816-processor) +* [Appendix G: SMC Recovery with Mac OS](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20recovery%20Mac%20OS.md) ## External Links diff --git a/X16 Reference - 15 - Upgrade Guide.md b/X16 Reference - 15 - Upgrade Guide.md index abaddf8..9055786 100644 --- a/X16 Reference - 15 - Upgrade Guide.md +++ b/X16 Reference - 15 - Upgrade Guide.md @@ -32,7 +32,7 @@ TODO: link to instructions for each solution in the matrix | ↓ Hardware / OS → | Windows | Linux | Mac OS | Commander X16 | |-|-|-|-|-| -| Commander X16 | - | - | - | - | +| Commander X16 | - | - | [TL866-3G/T48](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20recovery%20Mac%20OS.md) | - | | USBtinyISP | arduino | arduino | arduino | - | | XGecu TL866II+ | Xgpro | - | - | - | | XGecu TL866-3G / T48 | Xgpro | - | - | - | diff --git a/X16 Reference - Appendix G - SMC recovery Mac OS.md b/X16 Reference - Appendix G - SMC recovery Mac OS.md new file mode 100644 index 0000000..3ad926e --- /dev/null +++ b/X16 Reference - Appendix G - SMC recovery Mac OS.md @@ -0,0 +1,61 @@ +# Appendix G: SMC Firmware Recovery + +## Using a Mac to Upgrade or Recover the SMC + +**Target Component:** SMC (ATtiny861A) +**Programmer:** TL866-3G/T48 +**Software:** minipro ver. 0.7 +**Host OS:** Mac OS + +### Installing the minipro Utility +To install the minipro utility, follow these steps. For a complete list of installation alternatives, visit the [minipro GitLab page](https://gitlab.com/DavidGriffith/minipro). + +To install using Homebrew, run the following command: +``` +brew install minipro +``` + +### Downloading Firmware + +Use only the official releases of the SMC firmware, which can be found on the [X16 Community GitHub page](https://github.com/X16Community/x16-smc/releases). + +Download the firmware in Intel hex file format, such as SMC-47.0.0-firmware_with_bootloader.hex. Note that the .bin file cannot be used for the update described here. + +### Creating a Fuses Config File + +Create a file named fuses.cfg with the following content: + +``` +lfuse = 0xf1 +hfuse = 0xd4 +efuse = 0xfe +lock = 0xff +``` + +Do not alter the content of this config file. + +### Programming the SMC + +1. Power Off the Board: Ensure that the board is disconnected from mains power. + +2. Remove the SMC: The SMC (ATtiny861A) needs to be removed from the X16 board. +Note the orientation of the SMC, marked by a small notch near pin 1. +Carefully remove the SMC using a chip puller or a non-scratching prying tool. +It is recommended to use an anti-static wristband during the removal and reinstallation of the SMC. + +3. Program the SMC: + +* Place the SMC in the TL866-3G/T48 programmer. + +* Connect the programmer's USB cable to your computer. + +* Run the following command to program the SMC: +``` +minipro -p ATTINY861@DIP20 -c config -w fuses.cfg -c code -w firmware_with_bootloader.hex +``` + +4. Reinstall the SMC: Remove the SMC from the programmer and reinstall it on the X16 board, ensuring it is oriented the same way as before. + +5. Test the SMC: Reconnect mains power to the board. Press the Power button to verify if the board works correctly. + +These instructions should guide you through the process of upgrading or recovering the SMC firmware effectively. From 9ff1f8621068b6d3438192ebae754e7aa38f4aa5 Mon Sep 17 00:00:00 2001 From: stefan-b-jakobsson Date: Thu, 27 Jun 2024 08:17:52 +0300 Subject: [PATCH 2/5] Improve language --- X16 Reference - Appendix G - SMC recovery Mac OS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/X16 Reference - Appendix G - SMC recovery Mac OS.md b/X16 Reference - Appendix G - SMC recovery Mac OS.md index 3ad926e..e75376f 100644 --- a/X16 Reference - Appendix G - SMC recovery Mac OS.md +++ b/X16 Reference - Appendix G - SMC recovery Mac OS.md @@ -8,13 +8,13 @@ **Host OS:** Mac OS ### Installing the minipro Utility -To install the minipro utility, follow these steps. For a complete list of installation alternatives, visit the [minipro GitLab page](https://gitlab.com/DavidGriffith/minipro). - -To install using Homebrew, run the following command: +To install minipro using Homebrew, run the following command: ``` brew install minipro ``` +For a complete list of installation alternatives, visit the [minipro GitLab page](https://gitlab.com/DavidGriffith/minipro). + ### Downloading Firmware Use only the official releases of the SMC firmware, which can be found on the [X16 Community GitHub page](https://github.com/X16Community/x16-smc/releases). From 921d49ebd28cfe5de51707ea36b7215ccd525136 Mon Sep 17 00:00:00 2001 From: stefan-b-jakobsson Date: Thu, 27 Jun 2024 08:28:11 +0300 Subject: [PATCH 3/5] Move link in matrix to correct position --- X16 Reference - 15 - Upgrade Guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/X16 Reference - 15 - Upgrade Guide.md b/X16 Reference - 15 - Upgrade Guide.md index 9055786..2e83984 100644 --- a/X16 Reference - 15 - Upgrade Guide.md +++ b/X16 Reference - 15 - Upgrade Guide.md @@ -32,10 +32,10 @@ TODO: link to instructions for each solution in the matrix | ↓ Hardware / OS → | Windows | Linux | Mac OS | Commander X16 | |-|-|-|-|-| -| Commander X16 | - | - | [TL866-3G/T48](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20recovery%20Mac%20OS.md) | - | +| Commander X16 | - | - | - | - | | USBtinyISP | arduino | arduino | arduino | - | | XGecu TL866II+ | Xgpro | - | - | - | -| XGecu TL866-3G / T48 | Xgpro | - | - | - | +| XGecu TL866-3G / T48 | Xgpro | - | [minipro](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20recovery%20Mac%20OS.md) | - | ## VERA From 48880bcb3362b7cf3d611d0c506ef8b8c40610c7 Mon Sep 17 00:00:00 2001 From: stefan-b-jakobsson Date: Thu, 27 Jun 2024 09:26:11 +0300 Subject: [PATCH 4/5] Making it more generic --- ... - Appendix G - SMC Update and Recovery.md | 25 ++++++++----------- 1 file changed, 10 insertions(+), 15 deletions(-) rename X16 Reference - Appendix G - SMC recovery Mac OS.md => X16 Reference - Appendix G - SMC Update and Recovery.md (71%) diff --git a/X16 Reference - Appendix G - SMC recovery Mac OS.md b/X16 Reference - Appendix G - SMC Update and Recovery.md similarity index 71% rename from X16 Reference - Appendix G - SMC recovery Mac OS.md rename to X16 Reference - Appendix G - SMC Update and Recovery.md index e75376f..f54feae 100644 --- a/X16 Reference - Appendix G - SMC recovery Mac OS.md +++ b/X16 Reference - Appendix G - SMC Update and Recovery.md @@ -1,21 +1,17 @@ -# Appendix G: SMC Firmware Recovery - -## Using a Mac to Upgrade or Recover the SMC +# Appendix G: SMC Update and Recovery **Target Component:** SMC (ATtiny861A) -**Programmer:** TL866-3G/T48 -**Software:** minipro ver. 0.7 -**Host OS:** Mac OS +**Programmer:** TL866 series (including TL866-3G/T48) +**Software:** minipro ver 0.7 -### Installing the minipro Utility -To install minipro using Homebrew, run the following command: -``` -brew install minipro -``` +### Installing the minipro Command Line Utility + +This update procedure was tested with minipro ver 0.7. + +For a complete list of minipro installation alternatives, visit the [minipro GitLab page](https://gitlab.com/DavidGriffith/minipro). -For a complete list of installation alternatives, visit the [minipro GitLab page](https://gitlab.com/DavidGriffith/minipro). -### Downloading Firmware +### Downloading SMC Firmware Use only the official releases of the SMC firmware, which can be found on the [X16 Community GitHub page](https://github.com/X16Community/x16-smc/releases). @@ -45,7 +41,7 @@ It is recommended to use an anti-static wristband during the removal and reinsta 3. Program the SMC: -* Place the SMC in the TL866-3G/T48 programmer. +* Place the SMC in the TL866 series programmer. * Connect the programmer's USB cable to your computer. @@ -58,4 +54,3 @@ minipro -p ATTINY861@DIP20 -c config -w fuses.cfg -c code -w firmware_with_bootl 5. Test the SMC: Reconnect mains power to the board. Press the Power button to verify if the board works correctly. -These instructions should guide you through the process of upgrading or recovering the SMC firmware effectively. From 83455c5664317dbc9f6a7b5662b6a1b997c14c60 Mon Sep 17 00:00:00 2001 From: stefan-b-jakobsson Date: Thu, 27 Jun 2024 09:28:13 +0300 Subject: [PATCH 5/5] Update links --- README.md | 2 +- X16 Reference - 15 - Upgrade Guide.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d8a01b5..f1e44b3 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,7 @@ first. * [Appendix D: Official Expansion Cards](X16%20Reference%20-%20Appendix%20D%20-%20Official%20Expansion%20Cards.md#appendix-d-official-expansion-cards) * [Appendix E: Diagnostic Bank](X16%20Reference%20-%20Appendix%20E%20-%20Diagnostic%20Bank.md#appendix-e-diagnostic-bank) * [Appendix F: The 65C816 Processor](X16%20Reference%20-%20Appendix%20F%20-%2065C816%20Processor.md#appendix-f-the-65c816-processor) -* [Appendix G: SMC Recovery with Mac OS](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20recovery%20Mac%20OS.md) +* [Appendix G: SMC Recovery with Mac OS](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20Update%20and%20Recovery.md) ## External Links diff --git a/X16 Reference - 15 - Upgrade Guide.md b/X16 Reference - 15 - Upgrade Guide.md index 2e83984..bd49d8f 100644 --- a/X16 Reference - 15 - Upgrade Guide.md +++ b/X16 Reference - 15 - Upgrade Guide.md @@ -35,7 +35,7 @@ TODO: link to instructions for each solution in the matrix | Commander X16 | - | - | - | - | | USBtinyISP | arduino | arduino | arduino | - | | XGecu TL866II+ | Xgpro | - | - | - | -| XGecu TL866-3G / T48 | Xgpro | - | [minipro](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20recovery%20Mac%20OS.md) | - | +| XGecu TL866-3G / T48 | Xgpro | - | [minipro](X16%20Reference%20-%20Appendix%20G%20-%20SMC%20Update%20and%20Recovery.md) | - | ## VERA