Hardware

Shell Lab S1 is mini controller with USB socket.

Controller + Screw terminal

Connect illustration

Expand module: NPN-MOS

Expand module: Reed Relays

Software

Serial Communication FAQ
C Programming FAQ

Shell Lab Testbench App

USB VCP Driver(Windows)

General firmware

Include commands: gpio/led/pwm/adc/i2c/spi/ds1w/pulse

Shell Lab S1 (HEX)

Customized firmware

Morse code control command (HEX)

Example

Relays waterflow Download

# runs in ShellLab Testbench Application
RA,RB,RC,RD='0.0','0.1','0.2','0.3'  # PA0~PA3
s = ShellLab(PORT)
s.pinOutput([RA,RB,RC,RD])
while True:
    s.pinSet(RA)
    time.sleep(0.2)
    s.pinClr(RA)
    s.pinSet(RB)
    time.sleep(0.2)
    s.pinClr(RB)
    s.pinSet(RC)
    time.sleep(0.2)
    s.pinClr(RC)
    s.pinSet(RD)
    time.sleep(0.2)
    s.pinClr(RD)

use C-API to compile the waterfall

#include < stdio.h >
#include < unistd.h >
#ifdef WIN32
#include < windows.h >
#endif
#include "mcush_api.h"

#ifdef WIN32
const char device_name[] = "\\\\.\\COM14";
#else
const char device_name[] = "/dev/ttyACM0";
#endif

void delay_ms(int ms)
{
#ifdef WIN32
    Sleep(ms);  // in ms
#else
    usleep(ms*1000);  // in us
#endif
}

int main( int argc, char *argv[] )
{
    mcush_dev_t dev;
    char buf[512];
    int i;

    if( mcush_open( &dev, device_name, 9600, 5 ) <= 0 )
    {
        printf("fail to open port\n");
        return 0;
    }

    if( mcush_connect( &dev ) <= 0 )
    {
        printf("fail to connect the device\n");
        return 0;
    }

    if( mcush_scpi_idn( &dev, buf ) > 0 )
        printf( "%s", buf );

    mcush_write_command( &dev, "gpio -p0 -o 0x0F -c 0x0F" );
    i = 0;
    while( 1 )
    {
        sprintf( buf, "gpio -p0 -c%d", 1 << i );
        mcush_write_command( &dev, buf );
        i++;
        if( i>=4 )
            i = 0;
        sprintf( buf, "gpio -p0 -s%d", 1 << i );
        mcush_write_command( &dev, buf );

        delay_ms(250);
    }

    mcush_close( &dev );
    return 0;
}

DC motor soft start/stop control with PWM download

# runs in ShellLab Testbench Application
s = ShellLab(PORT)
INA, INB = '0.4', '0.5'
s.pinOutputLow([INA, INB])
s.pwm_init(init_value=0)
forward = True
while True:
    direction_pin = INA if forward else INB
    s.pinSet(direction_pin)
    # speed up 0-->100
    s.pinSet(direction_pin)
    val = 0
    while val < 100:
        val = 100 if val > 90 else (val+10)
        s.pwm( index=0, value=val )
        info( val )
        time.sleep(0.1)
    # wait
    time.sleep(2)
    # speed down 100->0
    while val > 0:
        val = 0 if val<10 else (val-10)
        s.pwm( index=0, value=val )
        info( val )
        time.sleep(0.1)
    s.pinClr(direction_pin)
    # wait
    time.sleep(2)
    # switch direction
    forward = not forward

Controlled with Raspberry

Controlled with Orangepi

test with mcush_util

#!/bin/sh
# Shell Lab S1 relay control demo with mcush_util
# download/compile/install mcush_util firstly
# Shanghai Linkong Software Tech. Co., Ltd.
# www.linkongsoft.com
set -e
PORT=/dev/ttyACM0
RELAY_PIN=0.0

# model match
mcush_util -p$PORT -mShellLab-S1 -r

# init as output
mcush_util -nq -p$PORT run "gpio -p$RELAY_PIN -o -c" "e -s"

counter=0
while [ $counter -lt 100 ]; do
    counter=$((counter+1))
    echo $counter "ON"
    mcush_util -nq -p$PORT run "gpio -p$RELAY_PIN -s" "led -i0 -s" "delay 500"
    echo $counter "OFF"
    mcush_util -nq -p$PORT run "gpio -p$RELAY_PIN -c" "led -i0 -c" "delay 200"
done