Documentation for “Zerocat Chipflasher” as of Wed, 01 Jan 2025 22:07:50 +0100
Repository:
Version: v2.1.0-0-850cd7bce
Branch: master

../../firmware2/src/kick2.spin.flashrom.html

Propeller Spin/PASM Compiler 'OpenSpin' (c)2012-2016 Parallax Inc. DBA Parallax Semiconductor.
Version 1.00.78
Compiling...
../../firmware2/src/kick2.spin
|-pins.spin
|-ASCII.spin
|-error.spin
  |-pins.spin
  |-time.spin
|-serprog.spin
  |-pins.spin
  |-error.spin
    |-pins.spin
    |-time.spin
  |-time.spin
  |-ADC-monitor.spin
    |-pins.spin
  |-FullDuplexSerial.spin
  |-serprog-SPI-PASM.spin
    |-pins.spin
  |-serprog-SPI-PASM-Pulse.spin
    |-pins.spin
Done.
Program size is 8152 bytes

______________________________________________________________________________
********************************************************* File starts here ***
Zerocat Chipflasher --- Flash free firmware, kick the Management Engine.

Copyright (C) 2020, 2021, 2022, 2024  Kai Mertens 

File kick2.spin --- The top object file for this firmware2 project.

This file is part of Zerocat Chipflasher.

See end of file for terms of use.

******************************************************************************


IMPORTANT NOTICE
================


* On PCBv1, the SPI CE# line is pulled up via trimmer.

    Adjust a reasonable value, not too small.

* On PCBv2, the SPI CE# line is pulled up via R23 and R10.

    These resistors are populated with 90 Ohm each, forming a pull-up
    value of 45 Ohm on the first series of devices, shipped in 2024 and
    earlier.

    That is too small!

    (On the chip flasher development board, this pull-up is set to
    47.62 Ohm, which works in test setups with hand-made wiring.)

    As a workaround, cut one end of R10 with a pince and twist the
    resistor aside, carefully. The remaining pull-up value is 90 Ohm
    (the value of R23), which should be a reasonable value for most use
    cases.

    In 2025, the PCBv2 candidate for FSF Respect Your Freedom (RYF)
    certification will provide sockets for R23 and R10, such that this
    pull-up can be adjusted. However, the formed resistor value must
    not be smaller than 42 Ohm, otherwise the Propeller pins 0 and 1
    will be damaged.

    These equations apply:

                    1                  1         1
        R_pull  =  ---  ,      x  =  -----  +  -----
                    x                 R23       R10




# Object Configuration (set via Makefile)

Tell us which interface to use:

* connect
* flashrom
* terminal
* none


# Interface Description

Object "../../firmware2/src/kick2" Interface:

PUB  kick2

Program:  2034 Longs
Variable: 191 Longs


# Loaded Objects

Load pin configuration object.
Load ASCII object.
Load error object.
Load serprog object.


# Constants

* System Speed
* Basic Timing
* Project's Memory Usage


# Functions

__________
PUB  kick2

 This is the Chipflasher's new firmware, coded in Spin/PASM.


******************************************************************************
Terms of Use:

Zerocat Chipflasher 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.

Zerocat Chipflasher 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 Zerocat Chipflasher.  If not, see <http://www.gnu.org/licenses/>.

************************************************************** End of File ***