SI4010 Programmer/Debugger

si4010prog is a tool to program and debug the Silicon Labs SI4010 micro controller.

C2 Bus Master

The si4010prog program requires some sort of C2 Bus master hardware to interact with the C2 bus.

• Cypress FX2: The best tested interface. See drivers/c2_fx2/README.md
• Linux GPIO: Driver using Linux GPIO. See drivers/c2_gpio/README.md
• Linux LPT: Deprecated, LPT port base bus master
• FT232: C2 bus using the FT232(H) chip. See drivers/c2_ft232/README.md

See the drivers/ directory for more available bus masters, or run si4010prog -d help to get a full list of available bus masters.

Compiling the Software

To compile si4010prog run:

cd build
cmake ../
make

Optionally you can configure the build to enable/disable some features using ccmake or similar cmake gui.

Known Issues

• Currently there is no way to check if the micro controller is running.
• Issuing a halt command when micro controller already halted cause protocol break. This can only be fixed by doing a 'reset'.
• Timing of official FT232R(L) chips is broken
• MCU doesn't seem to halt after a C2 reset if device program level is 'user' and the USER_CONT bit is set. In this case a 'reset identify' will work but any other command fails. Workaround is to run: 'si4010 reset run halt setpc:0'

Usage Examples

• Identify device

    # si4010prog identify
    Device ID: 0x24; Revision ID: 0x02
  

• Load program into xram and run:

    # si4010prog reset prg:test.ihx run
    Resetting SI4010
    Programming CODE memory using "test.ihx"
    Resuming SI4010 MCU
  

• Halt running process, get program counter, and dump 16 byte at address 0x08

    # si4010prog halt getpc dram:0x8,16
    Halting SI4010 MCU
    Getting program counter:
    0x01f1
    Dumping 16 bytes of RAM at 0x08:
      0x0000 01daa1a2a3000000 0000000000000000                                      ................
  

NVM programming

See 'nvm_programming.markdown'