circuitpython/shared-bindings/onewireio/OneWire.c

// This file is part of the CircuitPython project: https://circuitpython.org
//
// SPDX-FileCopyrightText: Copyright (c) 2017 Scott Shawcroft for Adafruit Industries
//
// SPDX-License-Identifier: MIT

#include <stdint.h>

#include "shared/runtime/context_manager_helpers.h"
#include "py/runtime.h"
#include "py/runtime0.h"
#include "shared-bindings/microcontroller/Pin.h"
#include "shared-bindings/onewireio/OneWire.h"
#include "shared-bindings/util.h"

//| class OneWire:
//|     def __init__(self, pin: microcontroller.Pin) -> None:
//|         """Create a OneWire object associated with the given pin.
//|
//|         The object implements the lowest level timing-sensitive bits of the protocol.
//|
//|         :param ~microcontroller.Pin pin: Pin connected to the OneWire bus
//|
//|         Read a short series of pulses::
//|
//|           import onewireio
//|           import board
//|
//|           onewire = onewireio.OneWire(board.D7)
//|           onewire.reset()
//|           onewire.write_bit(True)
//|           onewire.write_bit(False)
//|           print(onewire.read_bit())"""
//|         ...
//|
static mp_obj_t onewireio_onewire_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *all_args) {
    enum { ARG_pin };
    static const mp_arg_t allowed_args[] = {
        { MP_QSTR_pin, MP_ARG_REQUIRED | MP_ARG_OBJ },
    };
    mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
    mp_arg_parse_all_kw_array(n_args, n_kw, all_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
    const mcu_pin_obj_t *pin = validate_obj_is_free_pin(args[ARG_pin].u_obj, MP_QSTR_pin);

    onewireio_onewire_obj_t *self = mp_obj_malloc(onewireio_onewire_obj_t, &onewireio_onewire_type);

    common_hal_onewireio_onewire_construct(self, pin);
    return MP_OBJ_FROM_PTR(self);
}

//|     def deinit(self) -> None:
//|         """Deinitialize the OneWire bus and release any hardware resources for reuse."""
//|         ...
//|
static mp_obj_t onewireio_onewire_deinit(mp_obj_t self_in) {
    onewireio_onewire_obj_t *self = MP_OBJ_TO_PTR(self_in);
    common_hal_onewireio_onewire_deinit(self);
    return mp_const_none;
}
static MP_DEFINE_CONST_FUN_OBJ_1(onewireio_onewire_deinit_obj, onewireio_onewire_deinit);

static void check_for_deinit(onewireio_onewire_obj_t *self) {
    if (common_hal_onewireio_onewire_deinited(self)) {
        raise_deinited_error();
    }
}

//|     def __enter__(self) -> OneWire:
//|         """No-op used by Context Managers."""
//|         ...
//|
//  Provided by context manager helper.

//|     def __exit__(self) -> None:
//|         """Automatically deinitializes the hardware when exiting a context. See
//|         :ref:`lifetime-and-contextmanagers` for more info."""
//|         ...
//|
//  Provided by context manager helper.

//|     def reset(self) -> bool:
//|         """Reset the OneWire bus and read presence
//|
//|         :returns: False when at least one device is present
//|         :rtype: bool"""
//|         ...
//|
static mp_obj_t onewireio_onewire_obj_reset(mp_obj_t self_in) {
    onewireio_onewire_obj_t *self = MP_OBJ_TO_PTR(self_in);
    check_for_deinit(self);

    return mp_obj_new_bool(common_hal_onewireio_onewire_reset(self));
}
MP_DEFINE_CONST_FUN_OBJ_1(onewireio_onewire_reset_obj, onewireio_onewire_obj_reset);

//|     def read_bit(self) -> bool:
//|         """Read in a bit
//|
//|         :returns: bit state read
//|         :rtype: bool"""
//|         ...
//|
static mp_obj_t onewireio_onewire_obj_read_bit(mp_obj_t self_in) {
    onewireio_onewire_obj_t *self = MP_OBJ_TO_PTR(self_in);
    check_for_deinit(self);

    return mp_obj_new_bool(common_hal_onewireio_onewire_read_bit(self));
}
MP_DEFINE_CONST_FUN_OBJ_1(onewireio_onewire_read_bit_obj, onewireio_onewire_obj_read_bit);

//|     def write_bit(self, value: bool) -> None:
//|         """Write out a bit based on value."""
//|         ...
//|
//|
static mp_obj_t onewireio_onewire_obj_write_bit(mp_obj_t self_in, mp_obj_t bool_obj) {
    onewireio_onewire_obj_t *self = MP_OBJ_TO_PTR(self_in);
    check_for_deinit(self);

    common_hal_onewireio_onewire_write_bit(self, mp_obj_is_true(bool_obj));
    return mp_const_none;
}
MP_DEFINE_CONST_FUN_OBJ_2(onewireio_onewire_write_bit_obj, onewireio_onewire_obj_write_bit);

static const mp_rom_map_elem_t onewireio_onewire_locals_dict_table[] = {
    // Methods
    { MP_ROM_QSTR(MP_QSTR_deinit), MP_ROM_PTR(&onewireio_onewire_deinit_obj) },
    { MP_ROM_QSTR(MP_QSTR___enter__), MP_ROM_PTR(&default___enter___obj) },
    { MP_ROM_QSTR(MP_QSTR___exit__), MP_ROM_PTR(&default___exit___obj) },
    { MP_ROM_QSTR(MP_QSTR_reset), MP_ROM_PTR(&onewireio_onewire_reset_obj) },
    { MP_ROM_QSTR(MP_QSTR_read_bit), MP_ROM_PTR(&onewireio_onewire_read_bit_obj) },
    { MP_ROM_QSTR(MP_QSTR_write_bit), MP_ROM_PTR(&onewireio_onewire_write_bit_obj) },
};
static MP_DEFINE_CONST_DICT(onewireio_onewire_locals_dict, onewireio_onewire_locals_dict_table);

MP_DEFINE_CONST_OBJ_TYPE(
    onewireio_onewire_type,
    MP_QSTR_OneWire,
    MP_TYPE_FLAG_NONE,
    make_new, onewireio_onewire_make_new,
    locals_dict, &onewireio_onewire_locals_dict
    );