Git Product home page Git Product logo

firmware's Introduction

Spacecraft-NX

What is this?

A fully opensource SX Core / Lite compatible firmware for chainloading into your own payloads.

Usage

  • Place a compatible payload, i.e. hekate, in your sdcard root folder under name payload.bin.
  • After initial training (up to 5 minutes), modchip is ready and should boot quickly.
  • Holding VOL+ during boot prevents the modchip from going to sleep. This subsequently allows interactions with hwfly-toolbox for additional modchip operations and diagnostics.
  • When glitching is successful but an sdcard issue prevent loading of payload.bin, diagnostics are provided on the screen. From this screen, OFW can be booted by pressing VOL+ & VOL- simultaneously.
  • Holding VOL+ and VOL- during power-on bypasses any payloads and boots into OFW. Buttons must be held until glitching completes.

LED Diagnostics

After installation, the firmware will train itself. This can be recognized by the yellow pulsing LED pattern and can take up to 5 minutes. When completed, subsequent boots will be much faster. Refer to the diagram below for a full overview of possible LED patterns, which may aid in diagnosis in case of non-working installations.

[LED patterns

Debug console

A debug console is available when the device is powered on by inserting a USB cable into your computer. Note that this will not work if the firmware is already running when you insert power, in that case the console must be turned off completely, and the USB cable re-inserted. The device will enumerate as a USB CDC device and listed as a Serial COM port in your device manager. You can then use a tty program such as PuTTY on Windows to open a connection to this COM port. Commands available in this debug console can be retrieved by pressing 'h' for help.

Updating

Updating can be done using one of 3 methods:

Method a) - Using USB bootloader (preferred)

  1. Fully power off the console.
  2. Insert USB cable. Take extreme caution not to insert incorrectly, this fully kills USB functionality on the chip.
  3. Run flash.bat. This updates both bootloader and firmware.
  4. Remove USB cable.
  5. Power on console.

Method b) - Using hwfly-toolbox

This method does not require opening device, but it cannot flash the bootloader. LED patterns in bootloader will not correspond with documented ones.

  1. Obtain hwfly toolbox from https://github.com/hwfly-nx/hwfly-toolbox/releases
  2. Place hwfly_toolbox.bin in sdcard:/bootloader/payloads/.
  3. Place sdloader.enc from hwfly firmware into sdcard root.
  4. Boot switch into hekate, then run hwfly_toolbox.bin payload.
  5. Update SD loader from toolbox menu.
  6. Power off console from menu.
  7. Place firmware.bin from hwfly firmware into sdcard root. Do not do so earlier. If you have previously flashed a beta firmware, also create empty file .force_update in sdcard root.
  8. Put SD in switch and power on while holding VOL+ (verify: modchip green light keep pulsing while hekate loads).
  9. Run hwfly_toolbox from hekate again.
  10. Update firmware from menu.
  11. Reboot & done.

Method c) - External programmer (j-link, st-link, gd-link)

See https://www.sthetix.info/flashing-updating-unbricking-the-chip/ for details. Supplied bootloader.bin should be flashed at 0x08000000. Supplied payload.bin should be flashed at 0x08003000.

Note: neither method will allow unflashable chips to become flashed. Unflashable ones have a BGA FPGA IC on the board. Flashable ones use a QFN FPGA.

firmware's People

Contributors

hwflyboi avatar balika011 avatar gabmacinas avatar rashevskyv avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.